Method: purchases.subscriptions.acknowledge

Confirma a compra de uma assinatura.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
packageName

string

O nome do pacote do aplicativo da assinatura comprada. Por exemplo, com.some.thing.
subscriptionId

string

Observação: desde 21 de maio de 2025, o subscriptionId não é obrigatório e não é recomendado para assinaturas com complementos. O ID da assinatura comprada (por exemplo, "monthly001").
token

string

O token fornecido ao dispositivo do usuário quando a assinatura foi comprada.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "developerPayload": string,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
Campos
developerPayload

string

Payload que vai ser anexado à compra.
externalAccountIds

object (ExternalAccountIds)

Opcional. Identificador da conta de usuário no seu app.

Corpo da resposta

Se a solicitação for concluída, o corpo da resposta estará vazio.

Exemplo

Confira um exemplo de solicitação:

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"
  }'

Escopos de autorização

Requer o seguinte escopo OAuth:

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

ExternalAccountIds

Identificador da conta de usuário no seu app.

Representação JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
Campos
obfuscatedAccountId

string

Opcional. Especifica uma string ofuscada opcional associada exclusivamente à conta de usuário do comprador no seu app.

Se você transmitir esse valor, o Google Play poderá usá-lo para detectar atividades irregulares. Não use esse campo para armazenar informações de identificação pessoal (PII), como e-mails em texto não criptografado. Tentar armazenar PII neste campo vai bloquear as compras. O Google Play recomenda usar criptografia ou um hash unidirecional para gerar um identificador ofuscado a ser enviado ao Google Play.

Esse identificador é limitado a 64 caracteres.

Esse campo só pode ser definido para compras de renovação de assinatura. Consulte https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid para definir esse campo em compras feitas usando o fluxo de faturamento no app padrão.
obfuscatedProfileId

string

Opcional. Especifica uma string ofuscada opcional associada exclusivamente ao perfil do usuário comprador no seu app.

Se você transmitir esse valor, o Google Play poderá usá-lo para detectar atividades irregulares. Não use esse campo para armazenar informações de identificação pessoal (PII), como e-mails em texto não criptografado. Tentar armazenar PII neste campo vai bloquear as compras. O Google Play recomenda usar criptografia ou um hash unidirecional para gerar um identificador ofuscado a ser enviado ao Google Play.

Esse identificador é limitado a 64 caracteres.

Esse campo só pode ser definido para compras de renovação de assinatura. Consulte https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid para definir esse campo em compras feitas usando o fluxo de faturamento no app padrão.