Method: subscriptions.changePlan

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Actualiza un plan de suscripción. Usa este método a fin de actualizar un plan para 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 de actualizar un plan varía según el plan y los productos. Para obtener más información, consulta la descripción en Administra las 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 el identificador único del cliente. Si el nombre de dominio de un cliente cambia, el nombre de dominio anterior no se puede utilizar para acceder al cliente, pero el identificador único del cliente (como lo muestra la API) siempre se puede utilizar. Recomendamos almacenar el identificador único en sus sistemas cuando corresponda.
subscriptionId

string

Esta es una propiedad obligatoria. El subscriptionId es el identificador de suscripción y es único para cada cliente. Dado que un subscriptionId cambia cuando se actualiza una suscripción, recomendamos no usar este ID como clave para los datos persistentes. Además, el subscriptionId se puede encontrar mediante el método recuperar todas las suscripciones del distribuidor.

Cuerpo de la solicitud

El cuerpo de la solicitud incluye 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 Descripción general de OAuth 2.0.

Solicitud de cambio de plan

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 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
  • FLEXIBLE: el plan flexible
  • TRIAL: el plan de prueba gratuito de 30 días

seats

object (Seats)

Esta es una propiedad obligatoria. La propiedad de licencias es la cantidad de licencias de licencias de los usuarios.
purchaseOrderId

string

Esta es una propiedad opcional. La información de esta orden de compra (PO) es para que los distribuidores la utilicen en el seguimiento del uso de la empresa. Si se proporciona un valor purchaseOrderId, este aparece en las respuestas de la API y aparece en la factura. La propiedad acepta hasta 80 caracteres de texto sin formato.
dealCode

string

Código emitido por Google (100 caracteres como máximo) para precios con descuento en los planes de suscripción. El código de oferta debe incluirse 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 se deje vacía y se aplique la tarifa con descuento existente (si no está vacía, solo proporcione el código del acuerdo 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án los precios normales.