Documentazione di Steamworks
GetHistoryCommandDetails/v0001
Questa funzione restituisce tutti i registri degli audit di un utente per un periodo di tempo specificato. Il periodo di tempo da restituire include qualsiasi evento che si verifica successivamente a starttime e precedentemente o in concomitanza di endtime.

Chiamata da: Strumento di supporto

Metodo HTTP: GET
Questo metodo restituisce un elenco di azioni dettagliate che il server della risorsa eseguirà se il comando è confermato. Per le azioni complesse, l'agente di supporto può facoltativamente abilitare o disabilitare frammenti del comando della transazione. Se l'agente di supporto conferma i dettagli, viene effettuata la chiamata a HistoryExecuteCommand/v0001.

Parametri:

NomeTipoNecessarioDescrizione
keystringQuesto è il "codice del server delle risorse" che hai fornito nelle impostazioni Economia di Steam della tua applicazione sul sito per i partner.
appiduint32L'appID a 32 bit dell'applicazione associata alle risorse.
steamiduint64Lo SteamID a 64 bit dell'utente per cui restituire le risorse.
contextiduint64L'ID a 64 bit del contesto in cui tali risorse sono disponibili.
commandstringIl nome del comando della cronologia.
argumentsuint32La stringa degli argomenti restituita da GetUserHistory per il comando.

Restituzioni

L'output di questo metodo deve essere codificato nel formato JSON.

Risposta:
  • result
    • success: se il metodo è riuscito, restituisce "true". Se il server della risorsa restituisce "false", imposta la stringa error che ne fornisce una spiegazione.
    • error: una stringa che descrive il motivo per cui la chiamata è fallita. Questo messaggio verrà incluso nel registro degli errori, disponibile alla scheda Economia del sito di Steamworks.
    • actions: una matrice di azioni che il server della risorsa eseguirà se l'agente conferma il comando.
      • id: l'ID della risorsa che sarà influenzata da questa azione.
      • icon_url(opzionale): l'icona da utilizzare per la risorsa. Questa immagine deve essere in formato JPEG, GIF o PNG e di dimensioni minime di 96 pixel x 96 pixel. I formati PNG o GIF sono da preferire in quanto supportano la trasparenza.
      • name: il nome della risorsa su cui eseguire l'azione.
      • command: il sottocomando da eseguire sulla risorsa. Questo valore viene restituito alla conferma.
      • note (opzionale): ulteriori informazioni da visualizzare sotto il nome nella finestra di dialogo di conferma.
      • argument (opzionale): la stringa di argomenti da restituire se alla conferma l'azione è ancora selezionata.
      • steamid (opzionale): lo SteamID a 64 bit dell'utente che attualmente possiede la risorsa. Il nome dell'utente viene visualizzato accanto al nome della risorsa.
      • optional (opzionale): se restituisce "true", l'agente di supporto è in grado di deselezionare questa azione e saltarla nel comando. Impostazione predefinita: true.
      • default (opzionale): lo stato predefinito della casella di spunta nella finestra di dialogo di conferma. Impostazione predefinita: true.

Esempio di output

{ "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":"" }