Method: orders.reviewrefund

Indiquer votre préférence de remboursement et l'utilisation de l'achat pour une demande de rejet de débit

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
packageName

string

Obligatoire. Nom de package de l'application pour laquelle cet abonnement ou cet article intégré a été acheté (par exemple, "com.exemple.XXX").
orderId

string

Obligatoire. ID de la commande fourni à l'utilisateur lors de la souscription de l'abonnement ou de l'achat dans l'application.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
Champs
pendingRefundToken

string

Obligatoire. Jeton de remboursement en attente inclus dans la notification d'examen du remboursement en attente.
sampleContentProvided

boolean

Obligatoire. Indique si vous avez fourni un échantillon sans frais, un essai ou des informations sur la fonctionnalité avant l'achat.
refundPreference

enum (RefundPreference)

Obligatoire. Indique votre préférence, en fonction de votre logique opérationnelle, quant à savoir si le Play Store doit accorder le remboursement.
consumptionPercentageMilliunits

integer

Facultatif. Pourcentage de l'achat via l'application consommé par le client, en milliunités. Minimum : 0,maximum : 100 000. Pour les applications payantes, cette étape peut être omise. Exemple : 45200 représente 45,2%.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

Facultatif. Liste des événements, chacun représentant une instance où l'utilisateur a consommé ou utilisé l'article ou le service acheté. Les listes de plus de 1 000 éléments seront refusées.

Corps de la réponse

Si la requête aboutit, le corps de la réponse est vide.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

RefundPreference

Indique votre préférence, en fonction de votre logique opérationnelle, quant à savoir si le Play Store doit accorder le remboursement.

Enums
REFUND_PREFERENCE_UNSPECIFIED La préférence de remboursement orders.refund n'est pas spécifiée. Cette valeur n'est pas utilisée.
DECLINE Le développeur préfère que Play refuse le remboursement.
APPROVE Le développeur préfère que Play accorde le remboursement intégralement.
NEUTRAL Le développeur n'a aucune préférence concernant la décision de Google Play d'émettre un remboursement.

ConsumptionUsageEvent

Liste des événements, chacun représentant une instance où l'utilisateur a consommé ou utilisé l'article ou le service acheté.

Représentation JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
Champs
obfuscatedAccountId

string

Facultatif. Chaîne obscurcie associée de manière unique au compte utilisateur de l'acheteur dans l'application. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

Facultatif. Chaîne obscurcie associée de manière unique au profil utilisateur de l'acheteur dans l'application. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

Facultatif. Heure à laquelle l'utilisateur a consommé, utilisé, téléchargé, ouvert ou regardé le contenu en streaming.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
ipAddress

string

Facultatif. Adresse IP à partir de laquelle la consommation a eu lieu.
consumptionItemDescription

string

Facultatif. Texte libre permettant aux développeurs de fournir plus d'informations sur l'article consommé. Ne doit pas dépasser 5 000 caractères.
location

object (CoarseLocation)

Facultatif. Emplacement géographique où la consommation a eu lieu.

CoarseLocation

Informations géographiques approximatives sur le lieu de la consommation.

Représentation JSON 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
Champs
regionCode

string

Obligatoire. Code région CLDR du pays ou de la région associés à l'adresse. Cette valeur n'est jamais déduite. Vous devez vous assurer qu'elle est correcte. Exemple : "CH" pour la Suisse.
administrativeArea

string

Facultatif. Plus haute subdivision administrative utilisée pour les adresses postales d'un pays ou d'une région. Par exemple, il peut s'agir d'un État, d'une province, d'un oblast ou d'une préfecture. Pour l'Espagne, il s'agit de la province et non de la communauté autonome (par exemple, "Barcelone" et non "Catalogne"). De nombreux pays n'utilisent pas de région administrative dans leurs adresses postales. Par exemple, ce champ doit rester vide en Suisse.
locality

string

Facultatif. Fait généralement référence à la ville de l'adresse. Exemples : une "city" aux États-Unis, une "comune" en Italie, une "post town" au Royaume-Uni. Dans les régions du monde où les localités ne sont pas bien définies ou ne s'intègrent pas bien dans cette structure, laissez locality vide.
sublocality

string

Facultatif. Sous-localité de l'adresse. Il peut s'agir, par exemple, d'un quartier, d'un arrondissement ou d'un district. Pour la plupart des adresses, vous pouvez l'omettre.