Atualiza um plano de assinatura. Use esse método para atualizar um plano de teste de 30 dias ou uma assinatura de plano flexível para um plano com compromisso anual com pagamentos mensais ou anuais.
A forma de atualização de um plano varia de acordo com o plano e os produtos. Para mais informações, consulte a descrição em Gerenciar assinaturas.
Solicitação HTTP
POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan
Pode ser o nome de domínio principal ou o identificador exclusivo do cliente. Se o nome de domínio de um cliente mudar, o nome de domínio antigo não poderá ser usado para acessar o cliente, mas o identificador exclusivo do cliente (conforme retornado pela API) poderá sempre ser usado. Recomendamos armazenar o identificador exclusivo nos seus sistemas, quando aplicável.
subscriptionId
string
Essa é uma propriedade obrigatória. O subscriptionId é o identificador de assinatura e é exclusivo para cada cliente. Como um subscriptionId muda quando uma assinatura é atualizada, recomendamos não usar esse ID como chave para dados persistentes. E o subscriptionId pode ser encontrado usando o método Recuperar todas as assinaturas do revendedor.
Identifica o recurso como uma solicitação de plano de alteração de assinatura. Valor: subscriptions#changePlanRequest
planName
string
A propriedade planName é obrigatória. Esse é o nome do plano de pagamento da assinatura. Para mais informações sobre os planos de pagamento do Google, consulte os conceitos de API.
Os valores possíveis são:
ANNUAL_MONTHLY_PAY: o plano de compromisso anual com pagamentos mensais
ANNUAL_YEARLY_PAY: o plano de compromisso anual com pagamentos anuais
FLEXIBLE: o plano flexível
TRIAL: plano de teste sem custo financeiro de 30 dias
Essa é uma propriedade obrigatória. A propriedade de licenças é o número de licenças por usuário.
purchaseOrderId
string
Essa propriedade é opcional. Estas informações de ordem de compra (OC) são destinadas aos revendedores para rastrear o uso nas próprias empresas. Se um valor purchaseOrderId for fornecido, ele aparecerá nas respostas da API e na fatura. A propriedade aceita até 80 caracteres de texto simples.
dealCode
string
Código emitido pelo Google (máximo de 100 caracteres) para descontos nos planos de assinatura. O código de oferta precisa ser incluído na solicitação de changePlan para receber o desconto. Esta propriedade é opcional. Se um código da transação já tiver sido adicionado a uma assinatura, esta propriedade pode ficar em branco e a taxa com desconto atual ainda será aplicada. Se não estiver, forneça apenas o código da transação que já está presente na assinatura. Se um código de oferta nunca tiver sido adicionado a uma assinatura e esta propriedade for deixada em branco, o preço normal será aplicado.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-09-09 UTC."],[[["Updates a subscription's plan, allowing changes from trial or flexible plans to annual commitments with monthly or yearly payments, with varying update processes based on the specific plan and products."],["Requires sending a POST request to a specific URL, including the `customerId` and `subscriptionId` as path parameters."],["The request body must contain a `ChangePlanRequest` object specifying the desired plan name, number of seats, and optional purchase order ID and deal code."],["Successful responses return a `Subscription` object representing the updated subscription."],["Requires authorization with the `https://www.googleapis.com/auth/apps.order` scope."]]],[]]