Method: purchases.subscriptionsv2.scheduleplantransition

Programa uma transição de plano para uma assinatura.

Solicitação HTTP

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

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
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
Campos
productId

string

Obrigatório. O produto por assinatura (por exemplo, "premium_plan") com uma transição que precisa ser programada.

earliestTransitionEffectiveTime

string (Timestamp format)

Obrigatório. A primeira data e hora em que a transição do plano pode entrar em vigor. A transição real será realizada durante a renovação nesse momento ou depois.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

[Obrigatório] O modo para a transição do plano. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
definiteTransition

object (DefiniteTransition)

Ao usar esse modo, a transição do usuário para o novo plano é definitiva e não pode ser cancelada.

tentativeTransition

object (TentativeTransition)

Ao usar esse modo, a transição do usuário para o novo plano é provisória e pode ser cancelada.

Fim dos campos mutuamente exclusivos.
etag

string

Se este campo for definido, a API vai falhar caso a ETag não corresponda à ETag mais recente desta assinatura. A ETag é recuperada de purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

Corpo da resposta

Resposta para a API purchases.subscriptionsv2.schedulePlanTransition.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
Campos
planTransitionDetails

object (PlanTransitionDetails)

Os detalhes da transição de plano do item de assinatura.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

DefiniteTransition

Esse tipo não tem campos.

Usado para indicar que a transição do plano é definitiva.

TentativeTransition

Esse tipo não tem campos.

Usado para indicar que a transição do plano é provisória.