Method: subscriptions.suspend

Suspend un abonnement actif.

Vous pouvez utiliser cette méthode pour suspendre un abonnement payant actuellement à l'état ACTIVE.

  • La facturation est suspendue pour FLEXIBLE abonnements.
  • Pour les abonnements ANNUAL_MONTHLY_PAY ou ANNUAL_YEARLY_PAY :
    • La suspension d'un abonnement ne modifie pas la date de renouvellement initialement prévue.
    • Un abonnement suspendu ne peut pas être renouvelé.Si vous activez l'abonnement après la date de renouvellement initiale, un nouvel abonnement annuel sera créé à compter du jour de l'activation.

Nous vous recommandons vivement de ne suspendre vos abonnements que pendant de courtes périodes, car toute suspension supérieure à 60 jours peut entraîner l'annulation de l'abonnement.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Il peut s'agir du nom de domaine principal ou de l'identifiant unique du client. Si le nom de domaine d'un client change, l'ancien nom de domaine ne peut plus être utilisé pour accéder au client, mais l'identifiant unique du client (tel que renvoyé par l'API) peut toujours être utilisé. Nous vous recommandons de conserver l'identifiant unique dans vos systèmes, le cas échéant.

subscriptionId

string

Cette propriété est obligatoire. subscriptionId est l'identifiant d'abonnement et est unique à chaque client. Étant donné qu'une subscriptionId change lors de la mise à jour d'un abonnement, nous vous recommandons de ne pas utiliser cet ID comme clé pour des données persistantes. Vous pouvez également trouver l'subscriptionId en utilisant la méthode permettant de récupérer tous les abonnements des revendeurs.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Subscription.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/apps.order

Pour en savoir plus, consultez le guide relatif aux autorisations.