Method: purchases.voidedpurchases.list

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

string

Il nome del pacchetto dell'applicazione per cui è necessario restituire gli acquisti annullati (ad esempio "com.some.thing").

Parametri di ricerca

Parametri
pageSelection.maxResults

integer (uint32 format)

Definisce il numero di risultati che l'operazione di elenco deve restituire. 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 il paging indicizzato è abilitato.

pageSelection.token

string

Definisce il token della pagina da restituire, in genere preso da TokenPagination. Questa opzione può essere utilizzata solo se il paging dei token è abilitato.

startTime

string (int64 format)

Il tempo, in millisecondi dall'epoca, relativo all'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 considerato come annullato dai nostri sistemi e non nel momento effettivo restituito nella risposta.

endTime

string (int64 format)

Il tempo, in millisecondi dall'epoca, dell'ultimo acquisto annullato che vuoi vedere nella risposta. Il valore di questo parametro non può essere maggiore dell'ora attuale 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 effettivo restituito nella risposta.

type

integer

Il tipo di acquisti annullati che vuoi vedere 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 una tantum e gli abbonamenti. In caso contrario, riceverai più ordini di abbonamento con lo stesso PurchaseToken, perché gli ordini di rinnovo dell'abbonamento condividono lo stesso PurchaseToken.

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 sull'impaginazione.

tokenPagination

object (TokenPagination)

Informazioni sull'impaginazione per l'impaginazione dei token.

voidedPurchases[]

object (VoidedPurchase)

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/androidpublisher

PageSelection

Tipo del parametro di richiesta pageSelection che definisce quali e quanti risultati devono restituire un'operazione voidedpurchases.list.

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

integer (uint32 format)

Definisce il numero di risultati che l'operazione di elenco deve restituire. 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 il paging indicizzato è abilitato.

token

string

Definisce il token della pagina da restituire, in genere preso da TokenPagination. Questa opzione può essere utilizzata solo se il paging dei token è abilitato.