Method: subscriptions.delete

Résilie, suspend ou transfère un abonnement à direct.

Requête HTTP

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

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 du client ou de son identifiant unique. Si le nom de domaine d'un client change, l'ancien nom de domaine ne peut pas ê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 stocker l'identifiant unique dans vos systèmes, le cas échéant.

subscriptionId

string

Cette propriété est obligatoire. subscriptionId est l'identifiant d'abonnement propre à 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 les données persistantes. Vous pouvez également trouver le subscriptionId à l'aide de la méthode récupérer tous les abonnements revendeur.

Paramètres de requête

Paramètres
deletionType

enum (DeletionType)

La chaîne de requête deletionType permet de résilier, passer à un forfait inférieur ou suspendre un abonnement.

Corps de la requête

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

Corps de la réponse

Message qui représente un corps HTTP arbitraire. Il ne doit être utilisé que pour les formats de charge utile ne pouvant pas être représentés sous la forme JSON, tels que les fichiers binaires bruts ou les pages HTML.

Ce message peut aussi bien être utilisé dans les méthodes d'API de streaming que dans les autres dans la requête, ainsi que dans la réponse.

Il peut être utilisé en tant que champ de requête de niveau supérieur, ce qui est pratique si vous souhaitez extraire des paramètres de l'URL ou du modèle HTTP dans les champs de requête, et si vous souhaitez également accéder au corps HTTP brut.

Exemple :

message GetResourceRequest {
  // A unique request id.
  string requestId = 1;

  // The raw HTTP body is bound to this field.
  google.api.HttpBody http_body = 2;

}

service ResourceService {
  rpc GetResource(GetResourceRequest)
    returns (google.api.HttpBody);
  rpc UpdateResource(google.api.HttpBody)
    returns (google.protobuf.Empty);

}

Exemple avec les méthodes de streaming :

service CaldavService {
  rpc GetCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);
  rpc UpdateCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);

}

L'utilisation de ce type de méthode modifie uniquement le traitement du corps des requêtes et des réponses. Toutes les autres fonctionnalités continuent à fonctionner de la même manière.

Si la requête aboutit, la réponse est une réponse HTTP générique dont le format est défini par la méthode.

Représentation JSON
{
  "contentType": string,
  "data": string,
  "extensions": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Champs
contentType

string

Valeur d'en-tête HTTP Content-Type spécifiant le type de contenu du corps de la requête.

data

string (bytes format)

Corps de la requête/réponse HTTP en tant que données binaires brutes.

Chaîne encodée en base64.

extensions[]

object

Métadonnées de réponse spécifiques à l'application. Doivent être définies dans la première réponse pour les API de streaming.

Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.

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.

DeletionType

Enums
deletion_type_undefined
cancel Annule immédiatement l'abonnement. Cela ne s'applique pas aux abonnements G Suite.
transfer_to_direct

Transfère un abonnement directement à Google. Le client est immédiatement mis en relation avec Google avec la facturation directe et il bénéficie d'un bref délai sans interruption de service. Le client peut alors choisir de configurer la facturation directement auprès de Google, en utilisant une carte de crédit, ou de transférer la facturation à un autre revendeur.