Prima di creare un nuovo account cliente, tieni presente quanto segue:
- Potrebbero essere applicate restrizioni in base al codice paese. Per verificare che il paese del cliente sia approvato per la rivendita, controlla Partner Sales Console.
- Se l'account viene creato eseguendo l'upgrade da un account Gmail consumer a un indirizzo email aziendale con un nome di dominio, assicurati che nell'account siano sbloccate ulteriori impostazioni di Google Workspace. Per ulteriori informazioni, vedi Creare email aziendali per il tuo team e Creare un alias email aziendale.
Creare un account cliente
Per creare un account cliente, usa la seguente richiesta
POST
e includi il token di autorizzazione:POST https://reseller.googleapis.com/apps/reseller/v1/customers
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 del cliente, devi trasferire gli abbonamenti del cliente.Se applicabile, modifica la lingua predefinita del cliente.
Promuovi l'utente al ruolo di super amministratore. Durante la creazione dell'account amministratore, puoi generare una password casuale temporanea o chiedere al cliente di fornire una password.
Avvisa il cliente che deve accedere alla Console di amministrazione e firmare Google Workspace tramite il contratto rivenditore per attivare il suo account. Ai rivenditori non è consentito 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 hanno bisogno dell'accesso completo come amministratore. Quando crei questo tipo di cliente, imposta
customerType
sudomain
. - Clienti con indirizzo email verificato. Questi clienti non possiedono né gestiscono
il proprio dominio. Quando crei questo tipo di cliente, imposta
customerType
suteam
. Questo tipo di clienti può 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 esempioexample.com
NAME
: nome del cliente, ad esempioAlex Cruz
.ORGANIZATION_NAME
: nome dell'organizzazione del cliente, ad esempioExample Organization
.POSTAL_CODE
: il codice postale del cliente, ad esempio94043
.COUNTRY_CODE
: il codice paese ISO a 2 caratteri del cliente.EMAIL_ADDRESS
: l'indirizzo email del cliente, ad esempio,cruz@example.com
.
Una risposta corretta restituisce un codice di stato HTTP 200
e le informazioni sul 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 corretta restituisce un codice di stato HTTP 200
e le informazioni sul 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 quando vengono creati. Gli utenti esistenti mantengono la lingua attuale anche dopo l'aggiornamento di quella predefinita. Pertanto, devi impostare la lingua predefinita del cliente prima di creare utenti.
Per un cliente appena creato la lingua predefinita è l'inglese. Per cambiare la lingua predefinita, utilizza le chiamate PATCH
o UPDATE
dall'endpoint Customers dell'API Directory.
Utilizza l'API Directory per aggiornare il valore language
predefinito 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 del cliente, ad esempioC0123456
LANGUAGE_CODE
: un codice lingua accettato, ad esempioes
per lo spagnolo.
Una risposta JSON corretta restituisce un codice di stato HTTP 200
e la risorsa del 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" } }