Method: purchases.voidedpurchases.list

Elenca gli acquisti annullati, rimborsati o di cui è stato eseguito lo storno di addebito.

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

string

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

integer (uint32 format)

Definisce il numero di risultati che deve restituire l'operazione di elenco. Il numero predefinito dipende dalla raccolta di risorse.
pageSelection.startIndex

integer (uint32 format)

Definisce l'indice del primo elemento da restituire. Questa opzione può essere utilizzata solo se è attivata la paginazione indicizzata.
pageSelection.token

string

Definisce il token della pagina da restituire, in genere preso da TokenPagination. Questo può essere utilizzato solo se è attivata la paginazione dei token.
startTime

string (int64 format)

La data e l'ora in cui si è verificato l'acquisto annullato più vecchio che vuoi visualizzare nella risposta, espressa in millisecondi dall'epoca. Il valore di questo parametro non può risalire a più di 30 giorni fa e viene ignorato se è impostato un token di paginazione. Il valore predefinito è l'ora corrente meno 30 giorni. Nota: questo filtro viene applicato all'ora in cui il record viene considerato annullato dai nostri sistemi e non all'ora di annullamento effettiva restituita nella risposta.
endTime

string (int64 format)

La data e l'ora, in millisecondi dall'epoca, dell'acquisto annullato più recente che vuoi visualizzare nella risposta. Il valore di questo parametro non può essere maggiore dell'ora corrente e viene ignorato se è impostato un token di paginazione. Il valore predefinito è l'ora corrente. Nota: questo filtro viene applicato all'ora in cui il record viene considerato annullato dai nostri sistemi e non all'ora di annullamento effettiva restituita nella risposta.
type

integer

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 di ricevere gli acquisti di abbonamenti annullati, devi passare all'utilizzo di orderId nella risposta, che identifica in modo univoco gli acquisti e gli abbonamenti una tantum. In caso contrario, riceverai più ordini di abbonamento con lo stesso PurchaseToken, perché gli ordini di rinnovo dell'abbonamento condividono lo stesso PurchaseToken.
includeQuantityBasedPartialRefund

boolean

Facoltativo. Se includere gli acquisti annullati dei rimborsi parziali basati sulla quantità, che sono applicabili solo agli acquisti di più quantità. Se true, è 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 (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
Campi
pageInfo

object (PageInfo)

Informazioni generali sulla paginazione.
tokenPagination

object (TokenPagination)

Informazioni sulla paginazione dei token.
voidedPurchases[]

object (VoidedPurchase)

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 restituire un'operazione voidedpurchases.list.

Rappresentazione JSON 
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
Campi
maxResults

integer (uint32 format)

Definisce il numero di risultati che deve restituire l'operazione di elenco. Il numero predefinito dipende dalla raccolta di risorse.
startIndex

integer (uint32 format)

Definisce l'indice del primo elemento da restituire. Questa opzione può essere utilizzata solo se è attivata la paginazione indicizzata.
token

string

Definisce il token della pagina da restituire, in genere preso da TokenPagination. Questo può essere utilizzato solo se è attivata la paginazione dei token.