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 cercarlo 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.

Resi di risposta

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

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

• Restituisci i dati minimi dell'account del cliente. Se la risposta restituisce solo customerId, customerDomain e customerType, il cliente verrà 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. Recuperare tutti gli abbonamenti trasferibili per il cliente per capire se è possibile trasferire l'abbonamento e conoscere il numero minimo di utenze utente per il trasferimento.
  2. Trasferisci l'abbonamento.

• Restituisci Multiple teams exist on this domain. Al dominio sono associati 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 acquistare un abbonamento diretto tramite Google e verificare il dominio, acquisire il controllo dei team esistenti e poi trasferire l'abbonamento al tuo account.

• Restituisci un errore HTTP 404. Il cliente non ha esperienza di Google e non ha un account. Per gestire questo cliente:

  1. Verifica che i record dei tuoi clienti non contengano dati precedenti dei clienti che presentano una potenziale mancata corrispondenza tra il nome di dominio principale di un cliente e l'identificatore di cliente Google univoco. Un Account Google eliminato in precedenza viene ripristinato come nuovo account e ha un nuovo valore customerId, anche se l'account potrebbe mantenere lo stesso valore customerDomain.
  2. Ordinare un nuovo account cliente.
  3. Crea un abbonamento per questo nuovo account cliente.

Aggiornare le impostazioni di un cliente

Con l'API dei rivenditori, 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: nome del cliente, ad esempio Alex Cruz.
• ORGANIZATION_NAME: 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 a 2 caratteri del cliente.
• EMAIL_ADDRESS: l'indirizzo email del cliente, ad esempio, [e-mail].

Una risposta JSON corretta restituisce un codice di stato HTTP 200 e le impostazioni aggiornate del 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"
}