Method: subscriptions.suspend

Suspende una suscripción activa.

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

  • La facturación está detenida para las suscripciones a FLEXIBLE.
  • Para suscripciones a 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 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 durante períodos breves, ya que las suspensiones de más de 60 días pueden ocasionar la cancelación de 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 su identificador único. Si cambia el nombre de dominio de un cliente, no se podrá usar el nombre de dominio anterior para acceder al cliente, pero siempre se podrá 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 propiedad es obligatoria. El subscriptionId es el identificador de la suscripción y es único para cada cliente. Dado que subscriptionId cambia cuando se actualiza una suscripción, te recomendamos que no uses este ID como clave para datos persistentes. Y el subscriptionId se puede encontrar con el método recuperar todas las suscripciones de revendedores.

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.