Recuperare e aggiornare i dati dell'account di un cliente

Per recuperare e aggiornare le informazioni di un cliente utilizzando l'API dei rivenditori, puoi cercare i tuoi clienti in due modi:

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

Recupera i dati dell'account di un cliente

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

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

Sostituisci CUSTOMER_ID con il numero univoco del tuo cliente identificatore di dominio o nome di dominio.

Resi delle risposte

Quando recuperi i dati dell'account di un cliente, potresti ricevere uno dei seguenti le seguenti risposte:

• Restituisci le impostazioni complete del cliente. Il cliente è uno dei tuoi per i clienti esistenti. Con l'API dei rivenditori, puoi gestire le impostazioni dell'account e di abbonamento del cliente.

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

  1. Recuperare tutti gli abbonamenti trasferibili per il cliente per capire se è possibile trasferire l'abbonamento e numero minimo di utenze utente per il trasferimento.
  2. Trasferisci l'abbonamento.

• Restituisci Multiple teams exist on this domain. Questo dominio a uno o più clienti team. Per aggiungere un altro team a questo dominio, segui questi passaggi:

  1. Ordinare un account cliente.
  2. Per creare un cliente con dominio verificato per il dominio, chiedi al cliente di acquistano un abbonamento diretto tramite Google e verificano il proprio dominio, acquisiscono i team esistenti e poi trasferisci l'abbonamento sul tuo account.

• Restituisci un errore HTTP 404. Il cliente non ha mai utilizzato Google e non avere un account. Per gestire questo cliente:

  1. Verifica che i record dei tuoi clienti non contengano dati dei clienti precedenti con un la potenziale mancata corrispondenza tra il nome di dominio principale del cliente e il nome Identificatore di cliente Google. Quando un Account Google eliminato in precedenza viene reintegrato, viene considerato come un nuovo account e ha un nuovo customerId anche se l'account può conservare lo stesso valore di customerDomain valore.
  2. Ordina un nuovo account cliente.
  3. Creare un abbonamento per questo nuovo account cliente.

Aggiornare le impostazioni di un cliente

Se utilizzi l'API dei rivenditori, non puoi aggiornare customerType, ma puoi verifica il dominio di un cliente team e diventa cliente domain.

Per aggiornare le impostazioni di un cliente, usa la seguente richiesta di PUT e includi L'identificatore univoco del tuo 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: 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 [e-mail].

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

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