Recuperare e aggiornare i dati dell'account di un cliente

Per recuperare e aggiornare le informazioni di un cliente utilizzando l'API Reseller, hai due modi per cercare il cliente:

• 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 o il nome di dominio univoco del tuo 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. Con l'API Reseller, puoi gestire le impostazioni dell'account e dell'abbonamento di questo cliente.

• Restituisce i dati minimi dell'account del cliente. Se la risposta restituisce solo customerId, customerDomain e customerType, il cliente è gestito da Google o da un altro rivenditore. Non puoi creare un altro cliente con indirizzo email verificato per il cliente. Per gestire questo cliente, segui questi passaggi:

  1. Recupero di tutti gli abbonamenti trasferibili per il cliente per capire se l'abbonamento può essere trasferito e il numero minimo di licenze utente per il trasferimento.
  2. Trasferisci l'abbonamento.

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

  1. Ordina un account cliente.
  2. Per creare un cliente con dominio verificato per il dominio, chiedigli di acquistare un abbonamento diretto tramite Google e verificare il proprio dominio, rilevare i team esistenti e poi trasferire l'abbonamento al tuo account.

• Restituisce un errore HTTP 404. Il cliente non ha mai utilizzato Google e non ha un account. Per gestire questo cliente, segui questi passaggi:

  1. Verifica che i record dei clienti non contengano dati precedenti con una potenziale mancata corrispondenza del nome di dominio principale di un cliente e dell'identificatore cliente Google univoco. Quando un Account Google eliminato in precedenza viene reintegrato, viene considerato un nuovo account e ha un nuovo valore customerId anche se l'account potrebbe mantenere lo stesso valore customerDomain.
  2. Ordina un nuovo account cliente.
  3. Crea un abbonamento per questo nuovo account cliente.

Aggiornare le impostazioni di un cliente

Con l'API Reseller non puoi aggiornare il customerType, ma puoi verificare il dominio di un cliente team e 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 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 [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"
}