- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- DefiniteTransition
- TentativeTransition
- Faça um teste
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 |
Obrigatório. O pacote do aplicativo da assinatura comprada. Por exemplo, com.some.thing. |
token |
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 ( |
| Campos | |
|---|---|
productId |
Obrigatório. O produto por assinatura (por exemplo, "premium_plan") com uma transição que precisa ser programada. |
earliestTransitionEffectiveTime |
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: |
| [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 |
Ao usar esse modo, a transição do usuário para o novo plano é definitiva e não pode ser cancelada. |
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 |
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 ( |
| Campos | |
|---|---|
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.