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

• Restituisce i dati minimi dell'account 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. Recupera 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.

• Resi 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 dominio verificato per il dominio, chiedi al cliente di acquistare un abbonamento diretto tramite Google e verificare il proprio dominio, acquisire i team esistenti e poi trasferire l'abbonamento al tuo account.

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

  1. Verifica che i record dei clienti non contengano dati obsoleti con una potenziale mancata corrispondenza tra il nome di dominio principale di un cliente e l'identificatore univoco del cliente Google. Quando un Account Google eliminato in precedenza viene reintegrato, viene trattato come 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

Utilizzando l'API Reseller, non puoi aggiornare 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 cliente, ad esempio 94043.
• COUNTRY_CODE: il codice paese ISO di due caratteri del tuo 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"
}