- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- PageSelection
- Prova!
Elenca gli acquisti che sono stati annullati, rimborsati o stornati.
Richiesta HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
packageName |
Il nome del pacchetto dell'applicazione per cui devono essere restituiti gli acquisti annullati (ad esempio, "com.some.thing"). |
Parametri di query
Parametri | |
---|---|
pageSelection.maxResults |
Definisce il numero di risultati che l'operazione di elenco deve restituire. Il numero predefinito dipende dalla raccolta delle risorse. |
pageSelection.startIndex |
Definisce l'indice del primo elemento da restituire. Questa opzione può essere utilizzata solo se è abilitato il paging indicizzato. |
pageSelection.token |
Definisce il token della pagina da restituire, solitamente preso da TokenPagination. Questa opzione può essere utilizzata solo se è abilitato il paging dei token. |
startTime |
Il tempo, in millisecondi a partire dall'epoca, dell'acquisto annullato meno recente che vuoi vedere nella risposta. Il valore di questo parametro non può risalire a più di 30 giorni prima e viene ignorato se viene impostato un token di impaginazione. Il valore predefinito è l'ora attuale meno 30 giorni. Nota: questo filtro viene applicato nel momento in cui il record viene visto come nullo dai nostri sistemi e non nel momento in cui l'effettivo tempo di inattività restituito nella risposta. |
endTime |
Il tempo, in millisecondi a partire dall'epoca, dell'ultimo acquisto annullato che vuoi vedere nella risposta. Il valore di questo parametro non può essere superiore all'ora corrente e viene ignorato se viene impostato un token di impaginazione. Il valore predefinito è l'ora attuale. Nota: questo filtro viene applicato nel momento in cui il record viene visto come nullo dai nostri sistemi e non nel momento in cui l'effettivo tempo di inattività restituito nella risposta. |
type |
Il tipo di acquisti annullati che vuoi visualizzare nella risposta. I valori possibili sono: 0. Nella risposta verranno restituiti solo gli acquisti di prodotti in-app annullati. Questo è il valore predefinito. 1. Nella risposta verranno restituiti sia gli acquisti in-app annullati sia gli acquisti di abbonamenti annullati. Nota: prima di richiedere la ricezione di acquisti di abbonamenti annullati, devi passare all'utilizzo di orderId nella risposta che identifica in modo univoco gli acquisti una tantum e gli abbonamenti. Altrimenti, riceverai più ordini di abbonamento con lo stesso PurchaseToken, perché gli ordini di rinnovo dell'abbonamento condividono lo stesso PurchaseToken. |
includeQuantityBasedPartialRefund |
(Facoltativo) Indica se includere gli acquisti annullati di rimborsi parziali basati sulla quantità, applicabili solo agli acquisti di più quantità. Se è vero, è possibile restituire altri acquisti annullati con voidedQuantity che indica la quantità del rimborso di un rimborso parziale basato sulla quantità. Il valore predefinito è false. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Risposta per l'API voidedpurchases.list.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "pageInfo": { object ( |
Campi | |
---|---|
pageInfo |
Informazioni generali sull'impaginazione. |
tokenPagination |
Informazioni sull'impaginazione per l'impaginazione dei token. |
voidedPurchases[] |
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidpublisher
PageSelection
Tipo di parametro di richiesta pageSelection che definisce quali e quanti risultati deve essere restituito da un'operazione voidedpurchases.list.
Rappresentazione JSON |
---|
{ "maxResults": integer, "startIndex": integer, "token": string } |
Campi | |
---|---|
maxResults |
Definisce il numero di risultati che l'operazione di elenco deve restituire. Il numero predefinito dipende dalla raccolta delle risorse. |
startIndex |
Definisce l'indice del primo elemento da restituire. Questa opzione può essere utilizzata solo se è abilitato il paging indicizzato. |
token |
Definisce il token della pagina da restituire, solitamente preso da TokenPagination. Questa opzione può essere utilizzata solo se è abilitato il paging dei token. |