REST Resource: customers

Risorsa: cliente

Quando l'account di un cliente Google è registrato presso un rivenditore, gli abbonamenti del cliente ai servizi Google vengono gestiti da questo rivenditore. Un cliente viene 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. Il campo customerDomain è obbligatorio durante la creazione di un nuovo cliente. Non includere il prefisso www nel dominio quando aggiungi un cliente.

postalAddress

object (Address)

L'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 prefisso internazionale. Il resto del numero può essere numeri contigui o rispettare le convenzioni per il formato locale dei telefoni, ma deve essere un numero di telefono reale e non, ad esempio, "123". Questo campo viene ignorato automaticamente se non valido.

alternateEmail

string

Ad esempio "Email del cliente" negli strumenti dei rivenditori, questo indirizzo email è il contatto secondario utilizzato nel caso in cui succeda qualcosa al servizio del cliente, ad esempio un'interruzione del servizio o un problema di sicurezza. Questa proprietà è obbligatoria per la creazione di un nuovo "dominio" cliente e non deve utilizzare lo stesso dominio di customerDomain. Il campo alternateEmail non è necessario per creare un "team" al cliente.

resourceUiUrl

string

URL della dashboard della Console di amministrazione del cliente. L'URL di sola lettura viene generato dal servizio API. Viene utilizzato se la tua 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 accettati includono:

  • domain: si riferisce a un cliente con dominio verificato (impostazione predefinita).
  • team: riguarda un cliente con indirizzo email verificato.

Per saperne di più, consulta i 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 stato approvato per la rivendita dei prodotti Google. Questa proprietà è obbligatoria quando viene creato 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 quando viene creato un nuovo cliente.

addressLine1

string

L'indirizzo fisico di un cliente. Un indirizzo può essere composto da una a tre righe. I campi 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 sconosciuto
domain Clienti che possiedono un dominio o un dominio
team Clienti senza dominio o con indirizzo email verificato

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 eliminare gli utenti e di gestire le esigenze amministrative del cliente.

Metodi

get

Consente di ottenere un account cliente.

insert

Ordina l'account di un nuovo cliente.

patch

Consente di aggiornare le impostazioni di un account cliente.

update

Consente di aggiornare le impostazioni di un account cliente.