Method: purchases.voidedpurchases.list

Hier sind 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 App, für die stornierte 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 Seite, die zurückgegeben werden soll. Es wird normalerweise von TokenPagination entnommen. Dieser Parameter kann nur verwendet werden, wenn das Paging von Tokens aktiviert ist.

startTime

string (int64 format)

Die Zeit in Millisekunden seit der Epoche des ältesten stornierten Kaufs, der in der Antwort angezeigt werden soll. 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 angesehen wird, und nicht auf die tatsächlich in der Antwort zurückgegebene Leerlaufzeit.

endTime

string (int64 format)

Die Zeit in Millisekunden seit der Epoche des letzten stornierten Kaufs, der in der Antwort angezeigt werden soll. Der Wert dieses Parameters kann nicht größer als die aktuelle Zeit 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 angesehen wird, und nicht auf die tatsächlich in der Antwort zurückgegebene Leerlaufzeit.

type

integer

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

Hinweis: Bevor Sie den Erhalt ungültiger Abokäufe anfordern, müssen Sie in der Antwort auf die Verwendung von orderId umstellen, die Einmalkäufe und Abos eindeutig identifiziert. Andernfalls erhalten Sie mehrere Abobestellungen mit demselben PurchaseToken, weil für Verlängerungen von Abos dasselbe PurchaseToken verwendet wird.

includeQuantityBasedPartialRefund

boolean

Optional. Gibt an, ob annullierte Käufe von mengenbasierten Teilerstattungen berücksichtigt werden sollen, die nur für Käufe mit variabler Stückzahl gelten. Falls wahr, können zusätzliche stornierte Käufe mit dem Wert „voidedQuantity“ zurückgegeben werden, das die Erstattungsmenge einer mengenbasierten Teilerstattung 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 pageSelection-Anfrageparameters, der definiert, welche und wie viele Ergebnisse ein voidedpurchases.list-Vorgang 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 Seite, die zurückgegeben werden soll. Es wird normalerweise von TokenPagination entnommen. Dieser Parameter kann nur verwendet werden, wenn das Paging von Tokens aktiviert ist.