Ordinare un nuovo account cliente

Prima di creare un nuovo account cliente, tieni presente quanto segue:

  • Potrebbero essere applicate limitazioni per i codici paese. Per verificare che il paese del cliente sia approvato per la rivendita, controlla la Console Partner Sales.
  • Se l'account viene creato eseguendo l'upgrade da un account Gmail consumer a un'email aziendale con un nome di dominio, assicurati che nell'account siano sbloccate impostazioni aggiuntive di Google Workspace. Per ulteriori informazioni, consulta Creare email aziendali per il tuo team e Creare un alias email aziendale.

Creare un account cliente

  1. Per creare un account cliente, utilizza la seguente richiesta POST e includi il token di autorizzazione:

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

  2. Nell'account del nuovo cliente, crea un utente. Se la risposta restituisce un codice di stato HTTP 409 Conflict, il valore customerId esistente. Prima di registrare l'account del cliente, devi trasferire gli abbonamenti del cliente.

  3. Se applicabile, modifica la lingua predefinita del cliente.

  4. Promuovi l'utente al ruolo di super amministratore. Quando crei l'account amministratore, puoi generare una password randomtemporanea o chiedere al cliente di fornire una password.

  5. Comunica al cliente che deve accedere alla Console di amministrazione e firmare il contratto di Google Workspace tramite il rivenditore per attivare il suo account. I rivenditori non sono autorizzati a firmare i Termini di servizio per conto del cliente.

Tipi di clienti

Puoi creare due tipi di clienti su Google Workspace:

  • Clienti con dominio verificato. Questi clienti hanno bisogno di Gmail e di accesso amministrativo completo. Quando crei questo tipo di cliente, imposta customerType su domain.
  • Clienti con indirizzo email verificato. Questi clienti non possiedono né gestiscono il proprio dominio. Quando crei questo tipo di cliente, imposta customerType su team. Questi tipi di clienti possono acquistare le versioni Essentials ed Enterprise Essentials di Google Workspace.

Il seguente corpo della richiesta JSON è un esempio di cliente con dominio verificato:

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

Sostituisci quanto segue:

  • DOMAIN_NAME: il dominio del cliente, ad esempio example.com
  • NAME: il nome del cliente, ad esempio Alex Cruz.
  • ORGANIZATION_NAME: il nome dell'organizzazione del tuo cliente, ad esempio Example Organization.
  • POSTAL_CODE: il codice postale del tuo cliente, ad esempio 94043.
  • COUNTRY_CODE: il codice paese ISO di due lettere del tuo cliente.
  • EMAIL_ADDRESS: l'indirizzo email del tuo cliente, ad esempio cruz@example.com.

Una risposta riuscita restituisce un codice di stato HTTP 200 e le informazioni del nuovo cliente:

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

Il seguente corpo della richiesta JSON è un esempio di cliente con indirizzo email verificato:

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

Una risposta riuscita restituisce un codice di stato HTTP 200 e le informazioni del nuovo cliente:

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

Modificare la lingua predefinita di un cliente

La lingua predefinita di un cliente viene applicata solo ai nuovi utenti al momento della loro creazione. Gli utenti esistenti mantengono la lingua corrente anche dopo l'aggiornamento della lingua predefinita. Pertanto, devi impostare la lingua predefinita del cliente prima di creare utenti.

La lingua predefinita di un cliente appena creato è l'inglese. Per modificare la lingua predefinita, utilizza le chiamate PATCH o UPDATE dall'endpoint Customers dell'API Directory.

Utilizza l'API Directory per aggiornare il valore predefinito language per un cliente:

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

Includi il seguente corpo della richiesta JSON:

{
  "language":"LANGUAGE_CODE"
}

Sostituisci quanto segue:

  • CUSTOMER_ID: un identificatore univoco per il tuo cliente, ad esempio C0123456
  • LANGUAGE_CODE: un codice lingua accettato, ad esempio es per lo spagnolo.

Una risposta JSON riuscita restituisce un codice di stato HTTP 200 e la risorsa cliente aggiornata:

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

Passaggi successivi