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 stornierte Käufe zurückgegeben werden müssen (z. B. „com.beispiel.app“).

Abfrageparameter

Parameter
pageSelection.maxResults

integer (uint32 format)

Hiermit wird festgelegt, wie viele Ergebnisse der Listenvorgang zurückgeben soll. Die Standardzahl hängt von der Ressourcensammlung ab.
pageSelection.startIndex

integer (uint32 format)

Definiert den Index des ersten Elements, das zurückgegeben werden soll. Diese Option kann nur verwendet werden, wenn die Indexierung der Seitenumgebung aktiviert ist.
pageSelection.token

string

Definiert das Token der Seite, die zurückgegeben werden soll. Normalerweise wird es aus „TokenPagination“ übernommen. Diese Funktion kann nur verwendet werden, wenn die Token-Paginierung 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 und wird ignoriert, wenn ein Paginierungstoken festgelegt ist. Der Standardwert ist die aktuelle Uhrzeit abzüglich 30 Tage. Hinweis: Dieser Filter wird auf die Zeit angewendet, zu der der Eintrag in unseren Systemen als ungültig betrachtet wird, und nicht auf die tatsächliche Zeit, die in der Antwort zurückgegeben wird.
endTime

string (int64 format)

Die Zeit in Millisekunden seit der Epoche des neuesten stornierten Kaufs, der in der Antwort angezeigt werden soll. Der Wert dieses Parameters darf nicht höher als die aktuelle Uhrzeit sein. Wenn ein Paginierungstoken festgelegt ist, wird er ignoriert. Der Standardwert ist die aktuelle Uhrzeit. Hinweis: Dieser Filter wird auf die Uhrzeit angewendet, zu der der Eintrag in unseren Systemen als ungültig betrachtet wird, und nicht auf die tatsächliche Zeit, die in der Antwort zurückgegeben wird.
type

integer

Die Art der stornierten Käufe, die in der Antwort angezeigt werden sollen. Mögliche Werte: 0. In der Antwort werden nur ungültige In-App-Produktkäufe 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 anforderst, dass stornierte Abokäufe gesendet werden, musst du in der Antwort die „orderId“ verwenden, die einmalige Käufe und Abos eindeutig identifiziert. Andernfalls erhältst du mehrere Abobestellungen mit demselben PurchaseToken, da Bestellungen zur Aboverlängerung dasselbe PurchaseToken verwenden.
includeQuantityBasedPartialRefund

boolean

Optional. Ob stornierte Käufe bei mengenbasierten teilweisen Erstattungen berücksichtigt werden sollen, die nur für Käufe in variabler Stückzahl gelten. Wenn „wahr“ festgelegt ist, können weitere stornierte Käufe mit „voidedQuantity“ zurückgegeben werden, wobei „voidedQuantity“ die Erstattungsmenge einer mengenbasierten teilweisen Erstattung angibt. Der Standardwert ist "false".

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort für die API „voidedpurchases.list“.

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)

Informationen zur Paginierung für Token.
voidedPurchases[]

object (VoidedPurchase)

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

PageSelection

Der Typ des Anfrageparameters „pageSelection“, der festlegt, welche und wie viele Ergebnisse ein Vorgang vom Typ „voidedpurchases.list“ zurückgeben soll.

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

integer (uint32 format)

Hiermit wird festgelegt, 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 Elements, das zurückgegeben werden soll. Diese Option kann nur verwendet werden, wenn die Indexierung der Seitenumgebung aktiviert ist.
token

string

Definiert das Token der Seite, die zurückgegeben werden soll. Normalerweise wird es aus „TokenPagination“ übernommen. Diese Funktion kann nur verwendet werden, wenn die Token-Paginierung aktiviert ist.