REST Resource: partners.customers

Risorsa: azienda

Un rivenditore, fornitore o cliente nelle API zero-touch per rivenditori e clienti.

Rappresentazione JSON
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
Campi
name

string

Solo output. Il nome della risorsa API dell'azienda. Il nome della risorsa è in uno dei seguenti formati:

  • partners/[PARTNER_ID]/customers/[CUSTOMER_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]

Assegnato dal server.

companyId

string (int64 format)

Solo output. L'ID dell'azienda. Assegnato dal server.

companyName

string

Obbligatorio. Il nome dell'azienda. Ad esempio XYZ Corp. Mostrato ai dipendenti dell'azienda nel portale della registrazione zero-touch.

ownerEmails[]

string

Obbligatorio. Solo input. Indirizzo email degli utenti del cliente nel ruolo di proprietario. È richiesto almeno un owner_email. I Proprietari condividono lo stesso accesso degli Amministratori, ma possono anche aggiungere, eliminare e modificare gli utenti del portale della tua organizzazione.

adminEmails[]

string

(Facoltativo) Indirizzo email degli utenti del cliente nel ruolo di amministratore. Ogni indirizzo email deve essere associato a un Account Google.

termsStatus

enum (TermsStatus)

Solo output. Se un utente dell'azienda ha accettato i Termini di servizio (TdS) più recenti. Leggi i TermsStatus.

skipWelcomeEmail

boolean

Solo input. Se il criterio viene impostato su true, l'email di benvenuto non verrà inviata al cliente. Ti consigliamo di ignorare l'email di benvenuto se i dispositivi verranno rivendicati con il servizio DEVICE_PROTECTION aggiuntivo, in quanto il cliente riceverà email separate al momento della rivendicazione del dispositivo. Questo campo viene ignorato se non si tratta di un cliente zero-touch.

languageCode

string

Solo input. L'impostazione internazionale preferita del cliente rappresentata come codice lingua BCP47. Questo campo viene convalidato quando i dati sono inseriti e le richieste contenenti codici lingua non supportati verranno rifiutate.

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

Solo output. L'account Google Workspace associato a questo cliente. Utilizzato solo per le aziende dei clienti.

TermsStatus

L'accettazione da parte di un'azienda dei Termini di servizio (TdS) della registrazione zero-touch. Un singolo utente può accettare i TdS per la propria azienda utilizzando il portale web.

Viene eseguito il controllo delle versioni dei TdS. Ciò significa che, quando vengono modificati i TdS, almeno un utente deve accettare i nuovi TdS. Finché il primo utente non accetta i nuovi TdS, lo stato dei termini dell'azienda è TERMS_STATUS_STALE.

Enum
TERMS_STATUS_NOT_ACCEPTED Nessuno degli utenti dell'azienda ha accettato i TdS.
TERMS_STATUS_ACCEPTED Uno (o più) utenti dell'azienda hanno accettato i TdS.
TERMS_STATUS_STALE Nessuno degli utenti dell'azienda ha accettato i TdS attuali, ma almeno un utente li ha accettati precedenti.

GoogleWorkspaceAccount

Un cliente Google Workspace.

Rappresentazione JSON
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
Campi
customerId

string

Obbligatorio. L'ID cliente.

preProvisioningTokens[]

string

Solo output. I token di pre-provisioning utilizzati in precedenza per rivendicare i dispositivi.

Metodi

create

Crea un cliente per la registrazione zero-touch.

list

Elenca i clienti registrati per il rivenditore identificato dall'argomento partnerId.