Ordinare un nuovo account cliente

Prima di creare un nuovo account cliente, considera quanto segue:

  • Potrebbero essere applicate limitazioni relative ai codici paese. Per verificare che l'account del cliente paese è approvato per la rivendita, consulta la Partner Sales Console.
  • Se l'account viene creato eseguendo l'upgrade da una versione consumer di Gmail a un indirizzo email aziendale con un nome di dominio, assicurati che l'account ha ulteriori impostazioni di Google Workspace sbloccate. Per ulteriori informazioni, vedi Creare email aziendali per il tuo team e Crea un alias email aziendale.

Creare un account cliente

  1. Per creare un account cliente, usa la seguente richiesta di 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, customerId esiste già. Prima di registrare l'account cliente, devi trasferire gli abbonamenti del cliente.

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

  4. Promuovi il al ruolo di super amministratore. Durante la creazione dell'account amministratore, puoi generare una richiesta una password casuale o chiedere al cliente di fornire una password.

  5. Comunica al cliente che deve accedere alla Console di amministrazione e firma il Contratto Google Workspace mediante rivenditore per attivare il proprio account. Ai rivenditori non è consentito firmare i Termini di servizio su per conto del cliente.

Tipi di clienti

Su Google Workspace puoi creare due tipi di clienti:

  • Clienti con dominio verificato. Questi clienti hanno bisogno di Gmail con l'accesso amministrativo completo. Quando crei questo tipo di cliente, imposta il parametro Da customerType a domain.
  • Clienti con indirizzo email verificato. Questi clienti non possiedono né gestiscono dominio. Quando crei questo tipo di cliente, imposta customerType su team. Questo tipo di clienti può acquistare 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: l'organizzazione del tuo cliente un nome personalizzato, ad esempio Example Organization.
  • POSTAL_CODE: il CAP o il codice postale del tuo cliente per ad esempio 94043.
  • COUNTRY_CODE: i 2 caratteri del cliente Codice paese ISO.
  • EMAIL_ADDRESS: l'indirizzo email del tuo cliente per ad esempio cruz@example.com.

Una risposta corretta restituisce un codice di stato HTTP 200 e la richiesta informazioni:

{
  "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 corpo della richiesta JSON che segue è 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 corretta restituisce un codice di stato HTTP 200 e la richiesta informazioni:

{
  "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 quando è stato creato. Gli utenti esistenti manterranno la lingua corrente anche dopo il tuo accesso aggiorna la lingua predefinita. Di conseguenza, devi impostare l'impostazione predefinita prima di creare utenti.

Un cliente appena creato ha la lingua predefinita, l'inglese. Per modificare lingua predefinita, utilizza PATCH o UPDATE chiamate dall'API Directory Clienti endpoint.

Utilizza l'API Directory per aggiornare il valore predefinito di 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 valore accettato codice lingua , ad esempio es per lo spagnolo.

Una risposta JSON andata a buon fine restituisce un codice di stato HTTP 200 e risorsa del cliente:

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