Method: subscriptions.list

Listes des abonnements gérés par le revendeur. La liste peut inclure tous les abonnements, tous les abonnements d'un client ou tous les abonnements transférables d'un client.

Cette méthode peut également filtrer la réponse par un customerNamePrefix. Pour en savoir plus, consultez la section Gérer les abonnements.

Requête HTTP

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
customerAuthToken

string

La chaîne de requête customerAuthToken est obligatoire lorsque vous créez un compte revendeur qui transfère l'abonnement d'un client direct ou d'un autre client revendeur à votre gestion de revendeur. Il s'agit d'un jeton d'authentification hexadécimal nécessaire pour effectuer le transfert d'abonnement. Pour en savoir plus, consultez le Centre d'aide pour les administrateurs.
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, vous ne pouvez plus utiliser l'ancien nom de domaine pour accéder au client, mais vous pouvez toujours utiliser son identifiant unique (tel que renvoyé par l'API). Nous vous recommandons de stocker l'identifiant unique dans vos systèmes, le cas échéant.
customerNamePrefix

string

Lorsque vous récupérez tous vos abonnements et filtrez les clients spécifiques, vous pouvez saisir un préfixe pour un nom de client. Prenons l'exemple d'un groupe de clients incluant exam.com, example20.com et example.com:

  • exa : renvoie tous les noms de client commençant par "exa", ce qui peut inclure exam.com, example20.com et example.com. Un préfixe de nom est semblable à l'utilisation de l'astérisque d'une expression régulière, exa*.
  • example : renvoie example20.com et example.com.
maxResults

integer (uint32 format)

Lorsque vous récupérez une grande liste, maxResults correspond au nombre maximal de résultats par page. La valeur nextPageToken vous redirige vers la page suivante. La valeur par défaut est 20.
pageToken

string

Jeton permettant de spécifier la page suivante de la liste

Corps de la requête

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

Corps de la réponse

Un abonnement gère la relation entre le forfait de paiement d'un client Google et le SKU d'un produit, les licences utilisateur, l'état de l'essai sans frais de 30 jours et les options de renouvellement. Le rôle principal d'un revendeur est de gérer les abonnements des clients Google.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
Champs
kind

string

Identifie la ressource en tant que collection d'abonnements. Valeur: reseller#subscriptions
subscriptions[]

object (Subscription)

Abonnements affichés sur cette page de résultats.
nextPageToken

string

Jeton de continuité servant à parcourir les ensembles de résultats volumineux. Indiquez cette valeur dans une requête ultérieure pour renvoyer la page de résultats suivante.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez le guide d'autorisation.