Commander un nouveau compte client

Avant de créer un compte client, tenez compte des points suivants:

Créer un compte client

  1. Pour créer un compte client, utilisez la requête POST suivante et incluez le jeton d'autorisation:

    POST https://reseller.googleapis.com/apps/reseller/v1/customers

  2. Dans le compte du nouveau client, créer un utilisateur. Si la réponse renvoie un code d'état HTTP 409 Conflict, customerId existe déjà. Avant d'enregistrer le compte client, vous devez transférer les abonnements du client.

  3. Le cas échéant, modifiez la langue par défaut du client.

  4. Faites la promotion du d'utilisateur au rôle de super-administrateur. Lors de la création du compte administrateur, vous pouvez soit générer un compte un mot de passe aléatoire ou demander au client de fournir un mot de passe.

  5. Informez le client qu'il doit se connecter à la console d'administration et signer le contrat Google Workspace via Revendeur pour activer leur compte. Les revendeurs ne sont pas autorisés à signer les Conditions d'utilisation sur au nom du client.

Types de clients

Vous pouvez créer deux types de clients sur Google Workspace:

  • Clients dont le domaine a été validé : Ces clients ont besoin de Gmail un accès administrateur complet. Lorsque vous créez ce type de client, définissez le De customerType à domain.
  • Clients dont l'adresse e-mail a été validée : Ces clients ne possèdent ni ne gèrent domaine. Lorsque vous créez ce type de client, définissez customerType sur team Ce type de client peut acheter Essentials et Enterprise Essentials de Google Workspace.

Le corps de requête JSON suivant est un exemple de client dont le domaine a été validé:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "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 : cruz@example.com.

Une réponse positive renvoie un code d'état HTTP 200 et l'adresse e-mail du nouveau client informations:

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

Le corps de requête JSON suivant est un exemple de client dont l'adresse e-mail a été validée:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
 "alternateEmail": "EMAIL_ADDRESS"
}

Une réponse positive renvoie un code d'état HTTP 200 et l'adresse e-mail du nouveau client informations:

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

Modifier la langue par défaut d'un client

La langue par défaut d'un client ne s'applique qu'aux nouveaux utilisateurs créé. Les utilisateurs existants conservent leur langue actuelle, même après vous modifier la langue par défaut. Vous devez donc définir la valeur par défaut du client avant de créer des utilisateurs.

La langue par défaut d'un nouveau client est l'anglais. Pour modifier le paramètre langue par défaut, utilisez la PATCH ou UPDATE à partir de l'API Directory Clients point de terminaison unique.

Utilisez l'API Directory pour mettre à jour la valeur language par défaut pour un client:

PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID

Incluez le corps de requête JSON suivant:

{
  "language":"LANGUAGE_CODE"
}

Remplacez les éléments suivants :

  • CUSTOMER_ID: identifiant unique de votre client (par exemple, C0123456)
  • LANGUAGE_CODE: valeur acceptée code de langue (par exemple, es pour l'espagnol).

Une réponse JSON réussie renvoie un code d'état HTTP 200 et la valeur mise à jour ressource pour les clients:

{
  "alternateEmail": "EMAIL_ADDRESS",
  "customerCreationTime": "2022-12-12T23:04:10.620Z",
  "customerDomain": "DOMAIN_NAME",
  "id": "CUSTOMER_ID",
  "kind": "admin#directory#customer",
  "language": "LANGUAGE_CODE",
  "postalAddress": {
    "contactName": "NAME",
    "countryCode": "COUNTRY_CODE",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE"
  }
}

Étapes suivantes