REST Resource: customers

Risorsa: cliente

Quando l'account di un cliente Google è registrato con un rivenditore, gli abbonamenti del cliente ai servizi Google vengono gestiti da tale rivenditore. Un cliente è descritto da un nome di dominio principale e 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. È necessario customerDomain per la creazione di un nuovo cliente. Non includere il prefisso www nel dominio quando aggiungi un cliente.
postalAddress

object (Address)

Informazioni sull'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 contigue o rispettare le convenzione di formato locale del telefono, ma deve essere un numero di telefono reale e non, ad esempio, "123". Questo campo viene ignorato automaticamente se non è valido.
alternateEmail

string

Come "Email del cliente" negli strumenti dei rivenditori, questa email è il contatto secondario utilizzato se succede qualcosa al servizio del cliente, ad esempio un'interruzione del servizio o un problema di sicurezza. Questa proprietà è obbligatoria quando si crea un nuovo cliente"dominio"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. Questo campo viene utilizzato se l'applicazione client richiede al cliente di completare un'attività nella Console di amministrazione.
customerDomainVerified

boolean

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 (impostazione predefinita).
  • team: implica un cliente con indirizzo email verificato.

Per ulteriori informazioni, vedi Team gestiti.
primaryAdmin

object (PrimaryAdmin)

I primi dati amministrativi del cliente, presenti nel caso del 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 del codice paese ISO 3166. Verifica che il paese sia approvato per la rivendita di prodotti Google. Questa proprietà è obbligatoria quando crei un nuovo cliente.
kind

string

Identifica la risorsa come l'indirizzo di un 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 quando crei un nuovo cliente.
addressLine1

string

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

string

Il nome dell'azienda o della divisione dell'azienda. È obbligatoria.
contactName

string

Il nome del contatto del cliente. È obbligatoria.

TipoCliente

Tipo del cliente

Enum
customerTypeUnspecified Tipo di cliente sconosciuto
domain Clienti con dominio o di proprietà del dominio
team Clienti privi di dominio o con indirizzo email verificato

Amministratore principale

Modello JSON per gli amministratori principali nel 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 e rimuovere 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 di un account cliente.

update

 Aggiorna le impostazioni di un account cliente.