Method: subscriptions.suspend

Suspende una suscripción activa.

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

  • En el caso de las suscripciones a FLEXIBLE, se pausa la facturación.
  • Para suscripciones a ANNUAL_MONTHLY_PAY o ANNUAL_YEARLY_PAY:
    • Suspender la suscripción no cambia la fecha de renovación acordada originalmente.
    • Una suscripción suspendida no se renueva.  Si activas 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.

Te recomendamos que suspendas las suscripciones solo por períodos cortos, ya que las suspensiones superiores a 60 días pueden provocar que se cancelen.

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 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 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.