Récupérer et mettre à jour les informations de compte d'un client

Pour récupérer et modifier les informations d'un client à l'aide de l'API Reseller, vous pouvez rechercher un client de deux manières :

• Identifiant unique du client, par exemple C0123456.
• Nom de domaine du client, par exemple example.com.

Récupérer les informations du compte d'un client

Pour récupérer les informations du compte d'un client, utilisez la requête GET suivante et incluez le jeton d'autorisation :

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Remplacez CUSTOMER_ID par l'identifiant unique ou le nom de domaine du client.

Réponses renvoyées

Lorsque vous récupérez les informations du compte d'un client, vous pouvez recevoir l'une des réponses suivantes :

• Renvoie les paramètres complets du client : le client est l'un de vos clients existants. À l'aide de l'API Reseller, vous pouvez gérer les paramètres du compte et de l'abonnement de ce client.

• Renvoie des informations minimales sur le compte client : si la réponse ne renvoie que customerId, customerDomain et customerType, le client est géré par Google ou un autre revendeur. Vous ne pouvez pas créer un autre client validé par e-mail pour lui. Pour gérer ce client, procédez comme suit :

  1. Récupérez tous les abonnements transférables du client pour comprendre la transférabilité et le nombre minimal de licences utilisateur.
  2. Transférez l'abonnement.

• Renvoie Multiple teams exist on this domain : ce domaine est associé à un ou plusieurs clients d'équipe. Pour ajouter une autre équipe à ce domaine, procédez comme suit :

  1. Commandez un compte client.
  2. Pour créer un client validé par domaine, demandez au client d' acheter un abonnement direct et de valider son domaine, puis transférez l'abonnement.

• Renvoie une erreur HTTP 404 : le client est nouveau sur Google et ne possède pas de compte. Pour gérer ce client, procédez comme suit :

  1. Vérifiez que vos enregistrements ne contiennent pas d'anciennes données client avec une différence entre le nom de domaine principal et l'identifiant Google unique du client. Lorsqu'un compte supprimé est rétabli, il est traité comme un nouveau compte avec un nouveau customerId.
  2. Commandez un nouveau compte client.
  3. Créez un abonnement pour le nouveau compte client.

Modifier les paramètres d'un client

À l'aide de l'API Reseller, vous ne pouvez pas modifier le customerType, mais vous pouvez valider le domaine d'un client team pour qu'il devienne un client domain.

Pour modifier les paramètres d'un client, utilisez la requête PUT suivante et incluez l'identifiant unique de votre client :

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Le corps de la requête JSON modifie les paramètres client suivants :

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Remplacez les éléments suivants :

• DOMAIN_NAME: domaine du client, par exemple example.com.
• NAME : nom du client, par exemple Alex Cruz.
• ORGANIZATION_NAME: nom de l'organisation du client, par exemple Example Organization.
• POSTAL_CODE: code postal du client, par exemple 94043.
• COUNTRY_CODE : code pays ISO à deux caractères du client.
• EMAIL_ADDRESS: adresse e-mail du client, par exemple [e-mail].

Une réponse JSON réussie renvoie un code d'état HTTP 200 et les paramètres client mis à jour :

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}