Steamworks-Dokumentation
GetHistoryCommandDetails/v0001
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
Gibt eine detaillierte Liste der Aktionen zurück, die der Asset-Server ausführt, wenn der Befehl bestätigt wird. Bei komplexen Aktionen kann der Supportmitarbeiter optional auch Teile des Transaktionsbefehls aktivieren oder deaktivieren. Wenn der Supportmitarbeiter die Details bestätigt, wird HistoryExecuteCommand/v0001 aufgerufen.

Parameter:

NameTypErforderlich?Beschreibung
keystringDies ist der „Asset-Server-Schlüssel“, den Sie in den Steam-Wirtschaftseinstellungen Ihrer Anwendung auf der Partnerseite angegeben haben.
appiduint32Die 32-Bit-App-ID der Anwendung, auf die sich das Element bezieht.
steamiduint64Die 64-Bit-Steam-ID des Nutzers, dessen Elemente zurückgegeben werden sollen.
contextiduint64Die 64-Bit-ID des Elementkontexts.
commandstringDer Name des Verlaufsbefehls.
argumentsuint32Der Argumente-String, der von GetUserHistory für diesen Befehl zurückgegeben wurde.

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, der den Grund dafür erklärt.
    • 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.
    • actions : Ein Array von Aktionen, die der Asset-Server ausführen wird, wenn der Supportmitarbeiter den Befehl bestätigt.
      • id: Die ID des Elements, auf das sich die Aktion auswirkt.
      • 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.
      • name: Der Name des Elements, auf das sich die Aktion auswirkt.
      • command: Der Unterbefehl, der in diesem Element ausgeführt werden soll. Dieser Wert wird bei Bestätigung zurück übertragen.
      • note (optional): Zusätzliche Informationen, die im Bestätigungsdialogfeld unterhalb des Namens angezeigt werden sollen.
      • argument (optional): Der Argument-String, der zurückgegeben werden soll, wenn diese Aktion zum Zeitpunkt der Bestätigung erneut ausgewählt wird.
      • steamid (optional): Die 64-Bit-Steam-ID des Benutzers, in dessen Besitz sich das Element derzeit befindet. Der Name des Nutzers wird neben dem Elementnamen angezeigt.
      • optional (optional): Bei „true“ kann der Supportmitarbeiter die Auswahl dieser Aktion aufheben und sie im Befehl überspringen. Standardwert: true
      • default (optional): Der Standardstatus des Kontrollkästchens im Bestätigungsdialogfeld. Standardwert: true

Beispielausgabe

{ "result":1, "actions": [ { "id":"2111437", "icon_url":"http://media.steampowered.com/apps/440/icons/berliners_bucket_helm.2c1288625a8ab4c16e3c804a6649254b1a9325ca.png", "name":"Berliner's Bucket Helm", "command":"Restore", "note":"Purchased" }, { "id":"2121062", "icon_url":"http://media.steampowered.com/apps/440/icons/gift_fashion.37487e85b245787048aacefe67105bbe44a20e0c.png", "name":"Manniversary Package", "command":"Delete", "note":"Timed Drop" }, ], "displaytext":"" }