REST Resource: customers

Risorsa: cliente

Quando l'account di un cliente Google è registrato presso un rivenditore, gli abbonamenti del cliente ai servizi Google sono gestiti da questo rivenditore. Un cliente è descritto da un nome di dominio principale e da un indirizzo fisico.

Rappresentazione JSON
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
Campi
customerId

string

Questa proprietà verrà sempre restituita in una risposta come identificatore univoco generato da Google. In una richiesta, questa proprietà può essere il dominio principale o l'identificatore univoco generato da Google.

customerDomain

string

La stringa del nome di dominio principale del cliente. customerDomain è obbligatorio quando si crea un nuovo cliente. Non includere il prefisso www nel dominio quando aggiungi un cliente.

postalAddress

object (Address)

I dati dell'indirizzo di un cliente. Ogni campo ha un limite di 255 caratteri.

phoneNumber

string

Numero di telefono di contatto del cliente. Deve iniziare con "+" seguito dal codice paese. Il resto del numero può essere costituito da numeri contigui o rispettare le convenzioni di formato locale, ma deve essere un numero di telefono reale e non, ad esempio, "123". Questo campo viene ignorato se non è valido.

alternateEmail

string

Come l'indirizzo "Email cliente" negli strumenti per i rivenditori, questo indirizzo è il contatto secondario utilizzato in caso di problemi con il servizio del cliente, ad esempio un'interruzione del servizio o un problema di sicurezza. Questa proprietà è obbligatoria quando viene creato un nuovo cliente "domain" e non deve utilizzare lo stesso dominio di customerDomain. Il campo alternateEmail non è necessario per creare un cliente "team".

resourceUiUrl

string

URL alla dashboard della Console di amministrazione del cliente. L'URL di sola lettura viene generato dal servizio API. Viene utilizzato se l'applicazione client richiede al cliente di completare un'attività nella Console di amministrazione.

customerDomainVerified

boolean

Indica se il dominio principale del cliente è stato verificato.

kind

string

Identifica la risorsa come cliente. Valore: reseller#customer

customerType

enum (CustomerType)

Identifica il tipo di cliente. I valori accettabili includono:

  • domain: implica un cliente con dominio verificato (valore predefinito).
  • team: indica un cliente con indirizzo email verificato.

Per saperne di più, consulta team gestiti.

primaryAdmin

object (PrimaryAdmin)

I dettagli del primo amministratore del cliente, presenti in caso di cliente TEAM.

Indirizzo

Modello JSON per l'indirizzo di un cliente.

Rappresentazione JSON
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
Campi
countryCode

string

Per informazioni su countryCode, consulta gli elementi dei codici paese ISO 3166. Verifica che il paese sia approvato per la rivendita dei prodotti Google. Questa proprietà è obbligatoria per la creazione di un nuovo cliente.

kind

string

Identifica la risorsa come indirizzo del cliente. Valore: customers#address

region

string

Un esempio di valore region è CA per lo stato della California.

addressLine2

string

Riga 2 dell'indirizzo.

locality

string

Un esempio di valore locality è la città di San Francisco.

addressLine3

string

Riga 3 dell'indirizzo.

postalCode

string

Un esempio di postalCode è un codice postale come 94043. Questa proprietà è obbligatoria per la creazione di un nuovo cliente.

addressLine1

string

L'indirizzo fisico di un cliente. Un indirizzo può essere composto da una a tre righe. addressline2 e addressLine3 sono facoltativi.

organizationName

string

Il nome dell'azienda o della divisione aziendale. Questo campo è obbligatorio.

contactName

string

Il nome del contatto del cliente. Questo campo è obbligatorio.

CustomerType

Tipo di cliente

Enum
customerTypeUnspecified Tipo di cliente non noto
domain Clienti con dominio o proprietari di un dominio
team Clienti senza dominio o con verifica email

PrimaryAdmin

Modello JSON per l'amministratore principale in caso di clienti TEAM

Rappresentazione JSON
{
  "primaryEmail": string
}
Campi
primaryEmail

string

L'indirizzo email aziendale dell'amministratore principale del cliente.

Il link di verifica email viene inviato a questo indirizzo email al momento della creazione del cliente. Gli amministratori principali hanno accesso alla Console di amministrazione del cliente, inclusa la possibilità di invitare ed espellere gli utenti e gestire le esigenze amministrative del cliente.

Metodi

get

Recupera un account cliente.

insert

Ordina l'account di un nuovo cliente.

patch

Aggiorna le impostazioni dell'account di un cliente.

update

Aggiorna le impostazioni dell'account di un cliente.