REST Resource: purchases.products

Ressource : ProductPurchase

Une ressource ProductPurchase indique l'état de l'achat d'un produit intégré par un utilisateur.

Représentation JSON 
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
Champs
kind

string

Ce type représente un objet inappPurchase dans le service androidpublisher.
purchaseTimeMillis

string (int64 format)

L'heure à laquelle le produit a été acheté, en millisecondes écoulées depuis l'epoch (1er janvier 1970).
purchaseState

integer

L'état de l'achat de la commande, Les valeurs possibles sont : 0. Acheté 1. Annulée 2. En attente
consumptionState

integer

État de consommation du produit intégré. Les valeurs possibles sont : 0. À consommer 1. A consommé
developerPayload

string

Une chaîne spécifiée par le développeur contenant des informations supplémentaires sur une commande.
orderId

string

ID de la commande associée à l'achat du produit intégré.
purchaseType

integer

Type d'achat du produit intégré à l'application. Ce champ n'est défini que si cet achat n'a pas été effectué à l'aide du flux de facturation standard des achats via les applications. Les valeurs possibles sont : 0. Test (c'est-à-dire acheté à partir d'un compte de test de licence) 1. Promotionnel (c'est-à-dire acheté à l'aide d'un code promotionnel) N'inclut pas les achats effectués avec des points Play. 2. Avec récompense (c'est-à-dire en regardant une annonce vidéo au lieu de payer)
acknowledgementState

integer

État de confirmation de réception du produit intégré. Les valeurs possibles sont : 0. 1 à confirmer Confirmé
purchaseToken

string

Jeton d'achat généré pour identifier cet achat. Peut ne pas être présent.
productId

string

Code SKU du produit intégré. Peut ne pas être présent.
quantity

integer

Quantité associée à l'achat du produit intégré. Si elle n'est pas indiquée, la quantité est définie sur 1.
obfuscatedExternalAccountId

string

Version obscurcie de l'ID associé de manière unique au compte de l'utilisateur dans votre application. N'est présent que s'il a été spécifié à l'aide de https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid lors de l'achat.
obfuscatedExternalProfileId

string

Version obscurcie de l'ID associé de manière unique au profil de l'utilisateur dans votre application. N'est présent que s'il a été spécifié à l'aide de https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid lors de l'achat.
regionCode

string

Code de région de facturation ISO 3166-1 alpha-2 de l'utilisateur au moment où le produit lui a été accordé.
refundableQuantity

integer

Quantité éligible au remboursement, c'est-à-dire la quantité qui n'a pas encore été remboursée. La valeur reflète les remboursements partiels et totaux basés sur la quantité.

Méthodes

acknowledge

 Confirme l'achat d'un article intégré à l'application.

consume

 Consomme un achat pour un article intégré à l'application.

get

 Vérifie l'état d'achat et de consommation d'un article intégré.

Codes d'erreur

Les opérations de cette ressource renvoient les codes d'erreur HTTP suivants :

Code d'erreur Motif Solution
5xx Erreur générique sur le serveur Google Play. Réessayez d'envoyer votre demande.

Si le problème persiste, contactez votre responsable de compte Google Play ou envoyez une demande d'assistance. Pensez à consulter le tableau de bord d'état Play pour connaître les éventuelles interruptions de service connues.
409 Erreur de mise à jour simultanée.

Une tentative de mise à jour d'un objet en cours de mise à jour a été effectuée. Par exemple, un achat est confirmé en appelant la méthode acknowledgePurchase() de la bibliothèque Play Billing et la méthode purchases.products.acknowledge de l'API Play Developer en même temps.

 Réessayez d'envoyer votre demande.