Actualiza un plan de suscripción. Usa este método para actualizar un plan con una prueba de 30 días o una suscripción de plan flexible a un plan de compromiso anual con pagos mensuales o anuales.
La forma en que se actualiza un plan difiere según el plan y los productos. Si quieres obtener más información, consulta la descripción en Administra suscripciones.
Solicitud HTTP
POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan
Puede ser el nombre de dominio principal del cliente o el identificador único del cliente. Si el nombre de dominio de un cliente cambia, el nombre de dominio anterior no se puede usar para acceder al cliente, pero se puede usar siempre el identificador único del cliente (como lo muestra la API). Te recomendamos que almacenes el identificador único en tus sistemas cuando corresponda.
subscriptionId
string
Esta propiedad es obligatoria. El subscriptionId es el identificador de la suscripción y es único para cada cliente. Dado que una subscriptionId cambia cuando se actualiza una suscripción, recomendamos no usar este ID como clave para datos persistentes. Además, subscriptionId se puede encontrar con el método recuperar todas las suscripciones de revendedores.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de ChangePlanRequest.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Subscription.
Identifica el recurso como una solicitud de plan de cambio de suscripción. Valor: subscriptions#changePlanRequest
planName
string
La propiedad planName es obligatoria. Este es el nombre del plan de pagos de la suscripción. Para obtener más información sobre los planes de pagos de Google, consulta los conceptos de la API.
Los valores posibles son los siguientes:
ANNUAL_MONTHLY_PAY: El plan de compromiso anual con pagos mensuales
ANNUAL_YEARLY_PAY - El plan de compromiso anual con pagos anuales
Esta propiedad es obligatoria. La propiedad de licencias es la cantidad de licencias de usuario.
purchaseOrderId
string
Esta propiedad es opcional. La información de esta orden de compra (PO) es para que los revendedores la utilicen para hacer un seguimiento del uso que hacen la empresa. Si se proporciona un valor purchaseOrderId, este aparece en las respuestas de la API y en la factura. La propiedad acepta hasta 80 caracteres de texto sin formato.
dealCode
string
Código emitido por Google (100 caracteres máx.) para descuentos en precios de planes de suscripción. Se debe incluir el código de oferta en la solicitud de changePlan para recibir la tarifa con descuento. Esta propiedad es opcional. Si ya se agregó un código de oferta a una suscripción, es posible que esta propiedad quede vacía y que se siga aplicando la tarifa con descuento existente (si no está vacía, proporciona solo el código de oferta que ya está presente en la suscripción). Si nunca se agregó un código de acuerdo a una suscripción y esta propiedad se deja en blanco, se aplicará el precio normal.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]],[]]
