Gibt alle Auditeinträge für einen Nutzer im angegebenen Zeitraum zurück. Der zurückgegebene Zeitraum liegt zwischen
starttime und
endtime.
Aufgerufen von: Supportwerkzeug
HTTP-Methode: GET
Parameter:
| Name | Typ | Erforderlich? | Beschreibung |
|---|
| key | string | ✔ | Dies ist der „Asset-Server-Schlüssel“, den Sie in den Steam-Wirtschaftseinstellungen Ihrer Anwendung auf der Partnerseite angegeben haben. |
| appid | uint32 | ✔ | Die 32-Bit-App-ID der Anwendung, auf die sich das Element bezieht. |
| steamid | uint64 | ✔ | Die 64-Bit-Steam-ID des Nutzers, dessen Elemente zurückgegeben werden sollen. |
| contextid | uint64 | ✔ | Die 64-Bit-ID des Kontext-Containers, dessen Elemente abgerufen werden sollen. |
| starttime | uint32 | ✔ | Der Startzeitpunkt des Zeitraums, dessen Verlaufsdaten abgerufen werden sollen. Der Zeitpunkt wird in Sekunden seit dem 1. Januar 1970 ausgedrückt. |
| endtime | uint32 | ✔ | Der Endzeitpunkt des Zeitraums, dessen Verlaufsdaten abgerufen werden sollen. Der Zeitpunkt wird in Sekunden seit dem 1. Januar 1970 ausgedrückt. |
Rückgabewert
Die Ausgabe dieser Methode sollte im JSON-Format kodiert sein.
Antwort: -
result
-
success – "true", wenn die Methode erfolgreich war. Wenn der Asset-Server "false" zurückgibt, sollte error auf einen String eingestellt werden, in dem der Grund dafür erklärt wird.
-
error – Ein String, der beschreibt, warum dieser Aufruf fehlgeschlagen ist. Diese Nachricht wird im Fehlerprotokoll aufgezeichnet, das im Tab „Wirtschaft“ auf der Webseite von Steamworks verfügbar ist.
-
transactions – Ein Array von Transaktionen, die im angegebenen Zeitraum in diesem Kontext auf dem Account des Nutzers stattgefunden haben.
-
timestamp: Der Zeitpunkt, zu dem das Ereignis stattgefunden hat. Wird in Sekunden seit dem 1. Januar 1970 ausgedrückt.
-
action: Eine kurze Beschreibung der Transaktion.
-
actor_steamid (optional): Die 64-Bit-Steam-ID des Benutzers, von dem die Transaktion ausgegangen ist.
-
action_steamid (optional): Die 64-Bit-Steam-ID des anderen in die Transaktion involvierten Benutzers.
-
records : Ein Array von Detaileinträgen innerhalb einer Transaktion Diese Einträge können Elemente oder andere Änderungen am Kontext darstellen.
-
action: Der Name der Aktion, die in der Transaktion ausgeführt wurde.
-
id (optional): Die Element-ID des Elements.
-
name: Der Name des Elements, auf das sich der Eintrag bezieht.
-
url: Eine URL mit zusätzlichen Informationen über diesen Eintrag.
-
icon_url (optional): Das Symbol, das für das Element verwendet werden soll. Das Bild muss im Format JPEG, GIF oder PNG vorliegen und mindestens 96 × 96 Pixel groß sein. PNG und GIF werden bevorzugt, da sie Transparenz unterstützen. Steam verteilt alle Bilder, die Benutzern angezeigt werden, über CDN, sodass die Anzahl der Zugriffe auf diese URL relativ gering bleiben wird.
-
context_action (optional): Eine Beschreibung, wie sich die Aktion auf das Element in dem entsprechenden Kontext ausgewirkt hat. Unterstützt werden entweder add, remove, oder modify.
-
prefix (optional): Präfixstring, der dem Elementnamen in diesem Eintrag vorangestellt werden soll.
-
color (optional): Ein RGB-Hex-Farbstring zur Darstellung des Präfixes.
-
has_details: „true“, wenn IGameInventory/SupportGetAssetHistory gültige Daten für dieses Element zurückgibt.
-
detail_appid (optional): Die App-ID, in der die Details gesucht werden sollen. Dies ist nur dann sinnvoll, wenn zwei Spiele irgendeine Form von gemeinsamem System betreiben. Die Standardeinstellung ist die App-ID, aus der der Verlauf übernommen wird.
-
detail_context (optional): Die 64-Bit-ID des Kontexts, in dem die Details gesucht werden sollen. Die Standardeinstellung ist der Kontext, aus dem der Kontextverlauf übernommen wird.
-
commands : Eine Liste von Befehlen, die für diese Transaktion im Supportwerkzeug angezeigt werden sollen.
-
name: Der Name des Befehls.
-
arguments: Der Argument-String, der beim Aufruf von GetHistoryCommandDetails zurück an den Asset-Server übergeben wird. Der Steam-Economy-Server interpretiert diese Daten nicht. Sie können daher alles angeben, was im Spiel zur Identifizierung der Transaktion dient, für die der Befehl bestimmt ist.
Beispielausgabe
{
"result": {
"transactions": [
{
"records": [
{
"action": "Timed Drop",
"id": 559964086,
"name": "Bushwacka",
"icon_url": "http://media.steampowered.com/apps/440/icons/c_croc_knife.ae304e977e7127b3ea5ddc862614b627604489a9.png",
"prefix": "Add",
"color": "55FF55"
}
]
,
"commands": [
{
"name": "Undo",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAHhHs04AYWN0aW9ucwAAMQACYWN0aW9uAAcAAAAHaWQA\ntl9gIQAAAAAICAgIAA=="
},
{
"name": "Rollback",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAHhHs04ICAA="
}
]
,
"timestamp": 1320372088,
"action": "Timed Drop: Points: 14114"
},
{
"records": [
{
"action": "Achievement Award",
"id": 556669733,
"name": "Bombinomicon",
"icon_url": "http://media.steampowered.com/apps/440/icons/bombonomicon.6dc3119f20faa08d10161fa876c57265ae46c282.png",
"prefix": "Add",
"color": "55FF55"
}
]
,
"commands": [
{
"name": "Undo",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAPqqsE4AYWN0aW9ucwAAMQACYWN0aW9uAAMAAAAHaWQA\nJRsuIQAAAAAICAgIAA=="
},
{
"name": "Rollback",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAPqqsE4ICAA="
}
]
,
"timestamp": 1320200954,
"action": "Achievement Award: TF_HALLOWEEN_LOOT_ISLAND"
},
{
"records": [
{
"action": "Trade",
"id": 506851037,
"name": "Bushwacka",
"icon_url": "http://media.steampowered.com/apps/440/icons/c_croc_knife.ae304e977e7127b3ea5ddc862614b627604489a9.png",
"prefix": "Add",
"color": "55FF55"
},
{
"action": "Trade",
"id": 352354754,
"name": "Mann Co. Supply Crate",
"icon_url": "http://media.steampowered.com/apps/440/icons/crate.7299648976c7a022df68b7d35bf4a7cd05800855.png",
"prefix": "Remove",
"color": "FF5555"
},
{
"action": "Trade",
"id": 352354753,
"name": "Mann Co. Supply Crate",
"icon_url": "http://media.steampowered.com/apps/440/icons/crate.7299648976c7a022df68b7d35bf4a7cd05800855.png",
"prefix": "Remove",
"color": "FF5555"
}
]
,
"commands": [
{
"name": "Undo",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wANkejU4AYWN0aW9ucwAAMQACYWN0aW9uABgAAAAHaWQA\n3e41HgAAAAAIADIAAmFjdGlvbgAiAAAAB2lkAMKBABUAAAAACAAzAAJhY3Rpb24AIgAAAAdp\nZADBgQAVAAAAAAgANAACYWN0aW9uACIAAAAHaWQAFwwBHgAAAAAIADUAAmFjdGlvbgAiAAAA\nB2lkALVwYxkAAAAACAA2AAJhY3Rpb24AIgAAAAdpZADd\/5kWAAAAAAgANwACYWN0aW9uACIA\nAAAHaWQAr8WaFgAAAAAIADgAAmFjdGlvbgAiAAAAB2lkAAe9LhcAAAAACAA5AAJhY3Rpb24A\nIgAAAAdpZABcC\/wdAAAAAAgICAgA"
},
{
"name": "Rollback",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wANkejU4ICAA="
}
]
,
"timestamp": 1317871321,
"action": "Trade",
"action_steamid": 76561198007577949
},
]
,
"success": true
}
}
