Method: purchases.subscriptions.acknowledge

Confirme un achat d'abonnement.

Requête HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
packageName

string

Nom de package de l'application pour laquelle cet abonnement a été souscrit (par exemple, "com.exemple.XXX").
subscriptionId

string

Remarque : Depuis le 21 mai 2025, subscriptionId n'est pas obligatoire et n'est pas recommandé pour les abonnements avec modules complémentaires. ID de l'abonnement acheté (par exemple, "mensuel001").
token

string

Jeton fourni à l'appareil de l'utilisateur lors de la souscription de l'abonnement.

Corps de la requête

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

Représentation JSON 
{
  "developerPayload": string,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
Champs
developerPayload

string

Charge utile à joindre à l'achat.
externalAccountIds

object (ExternalAccountIds)

Facultatif. Identifiant du compte utilisateur dans votre application.

Corps de la réponse

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

Échantillon

Voici un exemple de requête :

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly_premium_001/tokens/abcDEF123ghiJKL456mnoPQR789:acknowledge' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "developerPayload": "AppSpecificInfo-UserID-12345"
  }'

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

ExternalAccountIds

Identifiant du compte utilisateur dans votre application.

Représentation JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
Champs
obfuscatedAccountId

string

Facultatif. Spécifie une chaîne obscurcie facultative associée de manière unique au compte utilisateur de l'acheteur dans votre application.

Si vous transmettez cette valeur, Google Play peut l'utiliser pour détecter une activité irrégulière. N'utilisez pas ce champ pour stocker des informations permettant d'identifier personnellement l'utilisateur, comme des adresses e-mail en texte clair. Si vous tentez de stocker des informations permettant d'identifier personnellement l'utilisateur dans ce champ, les achats seront bloqués. Google Play vous recommande d'utiliser le chiffrement ou un hachage à sens unique pour générer un identifiant obscurci à envoyer à Google Play.

Cet identifiant est limité à 64 caractères.

Ce champ ne peut être défini que pour les achats de réabonnement. Consultez https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid pour définir ce champ pour les achats effectués à l'aide du flux de facturation des achats in-app standard.
obfuscatedProfileId

string

Facultatif. Spécifie une chaîne obscurcie facultative associée de manière unique au profil utilisateur de l'acheteur dans votre application.

Si vous transmettez cette valeur, Google Play peut l'utiliser pour détecter une activité irrégulière. N'utilisez pas ce champ pour stocker des informations permettant d'identifier personnellement l'utilisateur, comme des adresses e-mail en texte clair. Si vous tentez de stocker des informations permettant d'identifier personnellement l'utilisateur dans ce champ, les achats seront bloqués. Google Play vous recommande d'utiliser le chiffrement ou un hachage à sens unique pour générer un identifiant obscurci à envoyer à Google Play.

Cet identifiant est limité à 64 caractères.

Ce champ ne peut être défini que pour les achats de réabonnement. Consultez https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid pour définir ce champ pour les achats effectués à l'aide du flux de facturation des achats in-app standard.