Method: orders.reviewrefund

Erstattungspräferenz und Kaufnutzung für einen Antrag auf Rückbuchung angeben

HTTP-Anfrage

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:reviewrefund

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
packageName

string

Erforderlich. Der Paketname der App, für die dieses Abo oder In-App-Artikel gekauft wurde (z. B. „com.beispiel.app“).
orderId

string

Erforderlich. Die Bestell-ID, die dem Nutzer beim Kauf des Abos oder der In-App-Bestellung mitgeteilt wurde.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
Felder
pendingRefundToken

string

Erforderlich. Das Token für die ausstehende Erstattung, das in der Benachrichtigung zur Überprüfung der ausstehenden Erstattung enthalten ist.
sampleContentProvided

boolean

Erforderlich. Gibt an, ob Sie vor dem Kauf eine kostenlose Probeversion, Testversion oder Informationen zur Funktionalität bereitgestellt haben.
refundPreference

enum (RefundPreference)

Erforderlich. Gibt an, ob der Play Store die Erstattung gewähren soll, basierend auf Ihrer Betriebslogik.
consumptionPercentageMilliunits

integer

Optional. Prozentsatz des In-App-Kaufs, den der Kunde genutzt hat, in Millieinheiten. Minimum: 0,Maximum: 100.000. Bei kostenpflichtigen Apps kann dieser Wert weggelassen werden. Beispiel : 45200 entspricht 45,2%.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

Optional. Liste der Ereignisse, die jeweils eine Instanz darstellen, in der der Nutzer den gekauften Artikel oder Dienst genutzt hat. Listen mit mehr als 1.000 Elementen werden abgelehnt.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

RefundPreference

Gibt an, ob der Play Store die Erstattung gewähren soll, basierend auf Ihrer Betriebslogik.

Enums
REFUND_PREFERENCE_UNSPECIFIED Erstattungspräferenz für Bestellungen nicht angegeben. Dieser Wert wird nicht verwendet.
DECLINE Der Entwickler möchte, dass Play die Erstattung ablehnt.
APPROVE Der Entwickler möchte, dass Play die Erstattung vollständig gewährt.
NEUTRAL Der Entwickler hat keine Präferenz bezüglich der Entscheidung von Google Play, eine Erstattung zu gewähren.

ConsumptionUsageEvent

Liste der Ereignisse, die jeweils eine Instanz darstellen, in der der Nutzer den gekauften Artikel oder Dienst genutzt hat.

JSON-Darstellung 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
Felder
obfuscatedAccountId

string

Optional. Verschleierter String, der eindeutig mit dem Nutzerkonto des Käufers in der App verknüpft ist. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

Optional. Verschleierter String, der eindeutig mit dem Nutzerprofil des Käufers in der App verknüpft ist. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

Optional. Zeitpunkt, zu dem der Nutzer die Inhalte genutzt, verwendet, heruntergeladen, geöffnet oder gestreamt hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
ipAddress

string

Optional. Die IP-Adresse, von der aus die Nutzung erfolgt ist.
consumptionItemDescription

string

Optional. Freitext, mit dem Entwickler weitere Informationen zum genutzten Artikel angeben können. Die maximale Länge beträgt 5.000 Zeichen.
location

object (CoarseLocation)

Optional. Geografischer Standort, an dem die Nutzung erfolgt ist.

CoarseLocation

Details zum ungefähren geografischen Standort, an dem die Nutzung erfolgt ist.

JSON-Darstellung 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
Felder
regionCode

string

Erforderlich. CLDR-Regionscode des Landes bzw. der Region der Adresse. Dieser Wert wird nie abgeleitet und Sie müssen darauf achten, dass er korrekt ist. Beispiel: „CH“ für die Schweiz.
administrativeArea

string

Optional. Höchste administrative Untergliederung, die für Postadressen eines Landes oder einer Region verwendet wird. Dies kann beispielsweise ein Bundesland, eine Provinz, eine Oblast oder eine Präfektur sein. In Spanien ist das beispielsweise die Provinz und nicht das autonome Gebiet, also z. B. „Barcelona“ und nicht „Katalonien“. In vielen Ländern werden in der Postadresse keine Verwaltungsgebiete verwendet. In der Schweiz sollte dieses Feld beispielsweise leer bleiben.
locality

string

Optional. Bezieht sich in der Regel auf die Stadt-/Ortsangabe der Adresse. Beispiele: Stadt in den USA, italienische Gemeinde, Post Town in Großbritannien. In Regionen der Welt, in denen Orte nicht gut definiert sind oder nicht gut in diese Struktur passen, lassen Sie locality leer.
sublocality

string

Optional. Unterlokalität der Adresse. Ortsteile können beispielsweise Stadtviertel, Stadtteile und Bezirke sein. Bei den meisten Adressen können Sie dieses Feld weglassen.