Method: subscriptions.changePlan

Actualiza un plan de suscripción. Usa este método para actualizar un plan de prueba de 30 días o una suscripción a un 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. Para obtener más información, consulta la descripción en Administrar suscripciones.

Solicitud HTTP

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Puede ser el nombre de dominio principal del cliente o su identificador único. Si cambia el nombre de dominio de un cliente, no se puede usar el nombre de dominio anterior para acceder a él, pero siempre se puede usar 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 es una propiedad obligatoria. subscriptionId es el identificador de suscripción y es único para cada cliente. Dado que un subscriptionId cambia cuando se actualiza una suscripción, te recomendamos que no uses este ID como clave para los datos persistentes. Y puedes encontrar el subscriptionId con el método recuperar todas las suscripciones de revendedor.

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.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/apps.order

Para obtener más información, consulta la Guía de autorización.

ChangePlanRequest

Plantilla JSON para la solicitud de RPC de subscriptions.changePlan.

Representación JSON 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
Campos
kind

string

Identifica el recurso como una solicitud de cambio de plan de suscripción. Valor: subscriptions#changePlanRequest
planName

string

La propiedad planName es obligatoria. 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 Conceptos de la API.

Los valores posibles son los siguientes:

  • ANNUAL_MONTHLY_PAY: Es el plan de compromiso anual con pagos mensuales.
  • ANNUAL_YEARLY_PAY: Es el plan de compromiso anual con pagos anuales.
  • FLEXIBLE: El plan flexible
  • TRIAL: Es el plan de prueba gratuita de 30 días.

seats

object (Seats)

Esta es una propiedad obligatoria. La propiedad de asientos es la cantidad de licencias de asientos de usuario.
purchaseOrderId

string

Esta es una propiedad opcional. Esta información de la orden de compra (OC) es para que los revendedores la usen para el seguimiento de su empresa. Si se proporciona un valor purchaseOrderId, este aparecerá en las respuestas de la API y en la factura. La propiedad acepta hasta 80 caracteres de texto sin formato.
dealCode

string

Es un código emitido por Google (máximo 100 caracteres) para obtener precios con descuento en los planes de suscripción. El código de oferta se debe incluir 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, esta propiedad se puede dejar vacía y se seguirá aplicando la tarifa con descuento existente (si no está vacía, solo proporciona el código de oferta que ya está presente en la suscripción). Si nunca se agregó un código de oferta a una suscripción y esta propiedad se deja en blanco, se aplicará el precio normal.