- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- PageSelection
- Prova!
Elenca gli acquisti 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 è necessario restituire gli acquisti annullati (ad esempio "com.some.thing"). |
Parametri di ricerca
Parametri | |
---|---|
pageSelection.maxResults |
Definisce il numero di risultati che l'operazione di elenco deve restituire. Il numero predefinito dipende dalla raccolta di risorse. |
pageSelection.startIndex |
Definisce l'indice del primo elemento da restituire. Questa opzione può essere utilizzata solo se il paging indicizzato è abilitato. |
pageSelection.token |
Definisce il token della pagina da restituire, in genere preso da TokenPagination. Questa opzione può essere utilizzata solo se il paging del token è abilitato. |
startTime |
Il tempo, in millisecondi dall'epoca, dell'acquisto annullato meno recente che vuoi visualizzare 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 corrente meno 30 giorni. Nota: questo filtro viene applicato nel momento in cui il record viene considerato come annullato dai nostri sistemi e non nel momento in cui viene restituito questo valore nella risposta. |
endTime |
Il tempo, in millisecondi dall'epoca, del più recente acquisto annullato che vuoi visualizzare nella risposta. Il valore di questo parametro non può essere maggiore dell'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 considerato come annullato dai nostri sistemi e non nel momento in cui viene restituito questo valore nella risposta. |
type |
Il tipo di acquisti annullati che vuoi visualizzare nella risposta. I valori possibili sono: 0. Nella risposta verranno restituiti soltanto gli acquisti di prodotti in-app annullati. Questo è il valore predefinito. 1. Sia gli acquisti in-app annullati sia gli acquisti di abbonamenti annullati verranno restituiti nella risposta. Nota: prima di richiedere di ricevere acquisti di abbonamenti annullati, devi passare all'utilizzo dell'ID ordine nella risposta che identifica in modo univoco gli acquisti singoli 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 |
Campo facoltativo. Indica se includere gli acquisti annullati di rimborsi parziali basati sulla quantità, applicabili solo agli acquisti di più quantità. Se il valore è true, ulteriori acquisti annullati possono essere restituiti con un valore 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 quale e quanti risultati deve restituire 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 di risorse. |
startIndex |
Definisce l'indice del primo elemento da restituire. Questa opzione può essere utilizzata solo se il paging indicizzato è abilitato. |
token |
Definisce il token della pagina da restituire, in genere preso da TokenPagination. Questa opzione può essere utilizzata solo se il paging del token è abilitato. |