REST Resource: partners.customers

Risorsa: azienda

Un rivenditore, un fornitore o un cliente nelle API zero-touch per i rivenditori e i 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. Visualizzato 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 elemento 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

Campo facoltativo. Indirizzo email degli utenti del cliente con il ruolo di amministratore. Ogni indirizzo email deve essere associato a un Account Google.
termsStatus

enum (TermsStatus)

Solo output. Indica se qualsiasi utente dell'azienda ha accettato i Termini di servizio (TdS) più recenti. Leggi i TermsStatus.
skipWelcomeEmail

boolean

Solo input. Se impostato su true, l'email di benvenuto non verrà inviata al cliente. Consigliamo di ignorare l'email di benvenuto se i dispositivi verranno rivendicati con il servizio DEVICE_PROTECTION aggiuntivo, perché 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. Le impostazioni internazionali preferite del cliente rappresentate come codice lingua BCP47. Questo campo viene convalidato in seguito all'input e le richieste contenenti codici di lingua non supportati verranno rifiutate. Codici di lingua supportati: arabo (ar) Coreano (hindi) (hindi)
googleWorkspaceAccount

object (GoogleWorkspaceAccount)

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

StatoTermini

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

I TdS sono sottoposti al controllo delle versioni. Ciò significa che, quando cambiano i TdS, almeno un utente deve accettare i nuovi TdS. Finché il primo utente non accetta i nuovi TdS, lo stato dei termini della società è 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 ha accettato i TdS precedenti.

Account GoogleWorkspace

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 al rivenditore identificati dall'argomento partnerId.