Method: purchases.voidedpurchases.list

Hier werden die Käufe aufgeführt, die storniert, erstattet oder zurückgebucht wurden.

HTTP-Anfrage

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
packageName

string

Der Paketname der Anwendung, für die ungültige Käufe zurückgegeben werden müssen (z. B. „com.some.thing“).

Abfrageparameter

Parameter
pageSelection.maxResults

integer (uint32 format)

Definiert, wie viele Ergebnisse der Listenvorgang zurückgeben soll. Die Standardanzahl hängt von der Ressourcensammlung ab.
pageSelection.startIndex

integer (uint32 format)

Definiert den Index des ersten zurückzugebenden Elements. Dies kann nur verwendet werden, wenn das indexierte Paging aktiviert ist.
pageSelection.token

string

Definiert das Token der zurückzugebenden Seite, normalerweise aus TokenPagination. Dies kann nur verwendet werden, wenn das Token-Pging aktiviert ist.
startTime

string (int64 format)

Die Zeit in Millisekunden seit der Epoche des ältesten ungültigen Kaufs, den Sie in der Antwort sehen möchten. Der Wert dieses Parameters darf nicht älter als 30 Tage sein. Er wird ignoriert, wenn ein Paginierungstoken festgelegt ist. Der Standardwert ist die aktuelle Zeit minus 30 Tage. Hinweis: Dieser Filter wird auf den Zeitpunkt angewendet, zu dem der Datensatz von unseren Systemen als ungültig eingestuft wird, und nicht auf den tatsächlichen Zeitpunkt, der in der Antwort zurückgegeben wird.
endTime

string (int64 format)

Die Zeit in Millisekunden seit der Epoche des letzten ungültigen Kaufs, den Sie in der Antwort sehen möchten. Der Wert dieses Parameters darf nicht größer als die aktuelle Uhrzeit sein. Er wird ignoriert, wenn ein Paginierungstoken festgelegt ist. Der Standardwert ist die aktuelle Uhrzeit. Hinweis: Dieser Filter wird auf den Zeitpunkt angewendet, zu dem der Datensatz von unseren Systemen als ungültig eingestuft wird, und nicht auf den tatsächlichen Zeitpunkt, der in der Antwort zurückgegeben wird.
type

integer

Die Art der ungültigen Käufe, die in der Antwort angezeigt werden sollen. Mögliche Werte sind: 0. Nur ungültige In-App-Produktkäufe werden in der Antwort zurückgegeben. „Immer“ ist der Standardwert. 1. Sowohl ungültige In-App-Käufe als auch ungültige Abokäufe werden in der Antwort zurückgegeben.

Hinweis: Bevor du ungültige Abokäufe anfordern kannst, musst du in der Antwort auf „orderId“ umstellen, um einmalige Käufe und Abos eindeutig zu identifizieren. Andernfalls erhalten Sie mehrere Abobestellungen mit demselben PurchaseToken, da diese für Aboverlängerungen das gleiche PurchaseToken haben.
includeQuantityBasedPartialRefund

boolean

Optional. Gibt an, ob ungültige Käufe von mengenbasierten teilweisen Erstattungen berücksichtigt werden sollen, die nur bei Käufen in variabler Stückzahl gelten. Falls wahr, können zusätzliche ungültige Käufe mit voidedQuantity zurückgegeben werden, das die Erstattungsmenge einer mengenbasierten teilweisen Erstattung angibt. Der Standardwert ist "false".

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort für die voidedpurchases.list API.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "pageInfo": {
    object (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
Felder
pageInfo

object (PageInfo)

Allgemeine Informationen zur Paginierung.
tokenPagination

object (TokenPagination)

Paginierungsinformationen für die Token-Paginierung.
voidedPurchases[]

object (VoidedPurchase)

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

PageSelection

Typ des Anfrageparameters pageSelection, der definiert, welche und wie viele Ergebnisse eine voidedpurchases.list-Operation zurückgeben soll.

JSON-Darstellung 
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
Felder
maxResults

integer (uint32 format)

Definiert, wie viele Ergebnisse der Listenvorgang zurückgeben soll. Die Standardanzahl hängt von der Ressourcensammlung ab.
startIndex

integer (uint32 format)

Definiert den Index des ersten zurückzugebenden Elements. Dies kann nur verwendet werden, wenn das indexierte Paging aktiviert ist.
token

string

Definiert das Token der zurückzugebenden Seite, normalerweise aus TokenPagination. Dies kann nur verwendet werden, wenn das Token-Pging aktiviert ist.