Recuperare e aggiornare i dati dell'account di un cliente

Per recuperare e aggiornare le informazioni di un cliente utilizzando l'API Reseller, puoi cercare un cliente in due modi:

• Identificatore univoco del cliente, ad esempio C0123456.
• Nome di dominio del cliente, ad esempio example.com.

Recuperare i dati dell'account di un cliente

Per recuperare i dati dell'account di un cliente, utilizza la seguente richiesta GET e includi il token di autorizzazione:

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Sostituisci CUSTOMER_ID con l'identificatore univoco o il nome di dominio del cliente.

Restituisce risposta

Quando recuperi i dati dell'account di un cliente, potresti ricevere una delle seguenti risposte:

• Restituisce le impostazioni complete del cliente: il cliente è uno dei tuoi clienti esistenti. Utilizzando l'API Reseller, puoi gestire questo account cliente e le impostazioni di abbonamento.

• Restituisce informazioni minime sull'account cliente: se la risposta restituisce solo customerId, customerDomain e customerType, Google o un altro rivenditore gestisce il cliente. Non puoi creare un altro cliente con indirizzo email verificato. Per gestire questo cliente, segui questi passaggi:

  1. Recupera tutti gli abbonamenti trasferibili per il cliente per comprendere la trasferibilità e il numero minimo di licenze utente.
  2. Trasferisci l'abbonamento.

• Restituisce Multiple teams exist on this domain: a questo dominio sono associati uno o più clienti team. Per aggiungere un altro team a questo dominio:

  1. Ordina un account cliente.
  2. Per creare un cliente con verifica del dominio, chiedi al cliente di acquistare un abbonamento diretto e verificare il proprio dominio, poi trasferire l'abbonamento.

• Restituisce un errore HTTP 404: il cliente è nuovo per Google e non ha un account. Per gestire questo cliente, segui questi passaggi:

  1. Verifica che i tuoi record non contengano dati dei clienti precedenti con una mancata corrispondenza tra il nome di dominio principale e l'identificatore univoco del cliente Google. Quando un account eliminato viene reintegrato, viene considerato come un nuovo account con un nuovo customerId.
  2. Ordina un nuovo account cliente.
  3. Crea un abbonamento per il nuovo account cliente.

Aggiornare le impostazioni di un cliente

Utilizzando l'API Reseller, non puoi aggiornare customerType, ma puoi verificare il dominio di un cliente team per diventare un cliente domain.

Per aggiornare le impostazioni di un cliente, utilizza la seguente richiesta PUT e includi l'identificatore univoco del cliente:

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Il corpo della richiesta JSON aggiorna le seguenti impostazioni del cliente:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "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 cliente, ad esempio Example Organization.
• POSTAL_CODE: il codice postale del cliente, ad esempio 94043.
• COUNTRY_CODE: il codice paese ISO di due caratteri del cliente.
• EMAIL_ADDRESS: l'indirizzo email del cliente, ad esempio [e-mail].

Una risposta JSON riuscita restituisce un codice di stato HTTP 200 e le impostazioni del cliente aggiornate:

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