Method: purchases.subscriptionsv2.revoke

subscriptionsv2.revoke revoga a compra da assinatura do usuário.

Solicitação HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:revoke

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

Parâmetros de caminho

Parâmetros
packageName

string

Obrigatório. O pacote do aplicativo da assinatura comprada. Por exemplo, "com.some.thing".

token

string

Obrigatório. O token enviado 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
{
  "revocationContext": {
    object (RevocationContext)
  }
}
Campos
revocationContext

object (RevocationContext)

Obrigatório. Detalhes adicionais sobre a revogação da assinatura.

Corpo da resposta

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

Exemplo

Confira a seguir um exemplo de solicitação:

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptionsv2/tokens/sample_purchase_token:revoke' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "revocationContext": {
      "proratedRefund": {}
    }
  }'

Escopos de autorização

Requer o seguinte escopo OAuth:

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

RevocationContext

Contexto de revogação da API purchases.subscriptionsv2.revoke.

Representação JSON
{

  // Union field RefundType can be only one of the following:
  "fullRefund": {
    object (FullRefund)
  },
  "proratedRefund": {
    object (ProratedRefund)
  },
  "itemBasedRefund": {
    object (ItemBasedRefund)
  }
  // End of list of possible types for union field RefundType.
}
Campos
Campo de união RefundType. Determina o tipo de reembolso que deve ser concedido. É necessário especificar um tipo de reembolso em uma solicitação válida. RefundType pode ser apenas de um dos tipos a seguir:
fullRefund

object (FullRefund)

Opcional. Usado quando os usuários precisam ser reembolsados com o valor total da cobrança mais recente em cada item da assinatura.

proratedRefund

object (ProratedRefund)

Opcional. Usado quando os usuários precisam ser reembolsados com um valor proporcional ao período restante da assinatura.

itemBasedRefund

object (ItemBasedRefund)

Opcional. Usado quando um item específico precisa ser reembolsado em uma assinatura com itens complementares.

FullRefund

Esse tipo não tem campos.

Usado para determinar se o tipo de reembolso em RevocationContext é total.

ProratedRefund

Esse tipo não tem campos.

Usado para determinar se o tipo de reembolso em RevocationContext é proporcional.

ItemBasedRefund

Usado para determinar qual item específico revogar em uma assinatura com vários itens.

Representação JSON
{
  "productId": string
}
Campos
productId

string

Obrigatório. Se a assinatura tiver complementos, o ID do produto do item da assinatura a ser revogado.