Method: subscriptions.delete

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Annule, 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. Le subscriptionId est l'identifiant d'abonnement et est propre à chaque client. Étant donné que 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. subscriptionId est disponible via la méthode de récupération de tous les abonnements revendeur.

Paramètres de requête

Paramètres
deletionType

enum (DeletionType)

La chaîne de requête deletionType permet d'annuler, de revenir à une version antérieure ou de suspendre un abonnement.

Corps de la requête

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

Corps de la réponse

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.

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.

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 Présentation d'OAuth 2.0.

Type de suppression

Enums
deletion_type_undefined
cancel Résilier l'abonnement immédiatement Cette règle ne s'applique pas aux abonnements G Suite.
transfer_to_direct

Transfère un abonnement directement à Google. Le client est immédiatement transféré vers un contrat de facturation directe avec Google et dispose d'un court délai sans interruption de service. Le client peut ensuite choisir de configurer la facturation directement auprès de Google à l'aide d'une carte de crédit ou de transférer la gestion de son compte à un autre revendeur.