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

Pour récupérer et mettre à jour les informations d'un client à l'aide de l'API Reseller, vous disposez de l'une des deux méthodes suivantes pour rechercher votre client:

• 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 de 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 de votre client un identifiant unique ou un nom de domaine.

Réponse renvoyée

Lorsque vous récupérez les informations sur le compte d'un client, il se peut que vous receviez l'un des réponses suivantes:

• Renvoyer l'intégralité des paramètres client Le client fait partie de vos clients existants. À l'aide de l'API Reseller, vous pouvez gérer ces les paramètres de compte et d'abonnement du client.

• Renvoyer les informations minimales sur le compte du client Si la réponse est uniquement renvoie customerId, customerDomain et customerType, soit Le client est géré par Google ou un autre revendeur. Vous ne pouvez pas en créer d'autre dont l'adresse e-mail a été validée. Pour gérer ce client, procédez comme suit:

  1. Récupérer tous les abonnements transférables du client pour savoir si l'abonnement peut être transféré nombre minimal de licences utilisateur pour le transfert.
  2. Transférez l'abonnement.

• Renvoie Multiple teams exist on this domain. Ce domaine est associé à un ou plusieurs clients. Ajouter une équipe à ce domaine, procédez comme suit:

  1. Commander un compte client.
  2. Pour créer un client avec validation du domaine, demandez-lui de procéder comme suit : souscrire un abonnement direct via Google et valider leur domaine, prendre la main sur des équipes existantes puis transférer l'abonnement vers votre compte.

• Renvoie une erreur HTTP 404. Le client est nouveau sur Google et n'a pas posséder un compte. Pour gérer ce client, procédez comme suit:

  1. Vérifiez que vos dossiers client ne contiennent pas d'anciennes données client à l'aide d'un incohérence potentielle entre le nom de domaine principal d'un client et l'unique Identifiant client Google. Lorsqu'un compte Google précédemment supprimé est rétablis, ils sont considérés comme un nouveau compte et sont associés à un nouveau customerId même si le compte conserve le même customerDomain .
  2. Commander un nouveau compte client.
  3. Créer un abonnement pour ce nouveau compte client.

Modifier les paramètres d'un client

Avec l'API Reseller, vous ne pouvez pas mettre à jour le customerType, mais vous pouvez valider le domaine d'un client team et devenir un client domain.

Pour mettre à jour 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 met à jour 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 de votre client (par exemple, example.com
• NAME: nom de votre client (par exemple, Alex Cruz).
• ORGANIZATION_NAME: organisation de votre client nom (par exemple, Example Organization).
• POSTAL_CODE: code postal de votre client, par Exemple : 94043.
• COUNTRY_CODE: les deux caractères de votre client Code pays ISO :
• EMAIL_ADDRESS: adresse e-mail de votre client, par Exemple : [e-mail].

Une réponse JSON réussie renvoie un code d'état HTTP 200 et la valeur mise à jour paramètres du client:

{
  "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"
}