Method: subscriptions.suspend

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

Suspende una suscripción activa.

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

  • Para FLEXIBLE suscripciones, se pausa la facturación.
  • Para suscripciones ANNUAL_MONTHLY_PAY o ANNUAL_YEARLY_PAY:
    • Suspender 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 un período breve, ya que, si se suspenden más de 60 días, es posible que se cancele.

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 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 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 Descripción general de OAuth 2.0.