Method: subscriptions.suspend

Suspende una suscripción activa.

Puedes usar este método para suspender una suscripción pagada que actualmente se encuentre en el estado ACTIVE.

  • Para las suscripciones de FLEXIBLE, se pausa la facturación.
  • Para suscripciones ANNUAL_MONTHLY_PAY o ANNUAL_YEARLY_PAY:
    • La suspensión de la suscripción no cambia la fecha de renovación que se comprometió originalmente.
    • Una suscripción suspendida no se renueva.Si activa la suscripción después de la fecha de renovación original, se creará una nueva suscripción anual a partir del día de la activación.

Le recomendamos que suspenda las suscripciones solo durante períodos cortos, ya que las suspensiones de períodos de más de 60 días pueden dar lugar a que se cancele la suscripción.

Solicitud HTTP

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

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 siempre se puede utilizar el identificador único del cliente (como lo muestra la API). Recomendamos almacenar el identificador único en sus sistemas cuando corresponda.
subscriptionId

string

Esta es una propiedad obligatoria. El subscriptionId es el identificador de la suscripción y es único para cada cliente. Debido a que un subscriptionId cambia cuando se actualiza una suscripción, recomendamos no usar este ID como clave para datos persistentes. Y puedes encontrar el subscriptionId con el método recuperar todas las suscripciones del revendedor.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

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.