REST Resource: partners.customers

Ressource : Company

Revendeur, fournisseur ou client dans les API des revendeurs et des clients sans contact.

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

string

Uniquement en sortie. Nom de ressource de l'API de l'entreprise. Le nom de la ressource est l'un des formats suivants:

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

Attribué par le serveur.
companyId

string (int64 format)

Uniquement en sortie. Identifiant de l'entreprise. Attribué par le serveur.
companyName

string

Obligatoire. Nom de l'entreprise. Exemple : XYZ Corp. Visible auprès des employés de l'entreprise sur le portail d'inscription sans contact.
ownerEmails[]

string

Obligatoire. Uniquement en entrée. Adresse e-mail des utilisateurs du client avec le rôle de propriétaire. Veuillez indiquer au moins un owner_email. Les propriétaires partagent le même accès que les administrateurs, mais peuvent également ajouter, supprimer et modifier des utilisateurs du portail de votre organisation.
adminEmails[]

string

Facultatif. Adresse e-mail des utilisateurs du client ayant un rôle d'administrateur. Chaque adresse e-mail doit être associée à un compte Google.
termsStatus

enum (TermsStatus)

Uniquement en sortie. Indique si un utilisateur de l'entreprise a accepté les dernières conditions d'utilisation. Consultez les TermsStatus.
skipWelcomeEmail

boolean

Uniquement en entrée. Si elle est définie sur "True", l'e-mail de bienvenue n'est pas envoyé au client. Nous vous recommandons d'ignorer l'e-mail de bienvenue si les appareils sont revendiqués avec un service DEVICE_PROTECTION supplémentaire, car le client recevra des e-mails distincts au moment de la revendication de l'appareil. Ce champ est ignoré s'il ne s'agit pas d'un client sans contact.
languageCode

string

Uniquement en entrée. Paramètres régionaux préférés du client, représentés par un code de langue BCP47. Ce champ est validé au moment de la saisie. Les requêtes contenant des codes de langue non compatibles seront refusées. :
googleWorkspaceAccount

object (GoogleWorkspaceAccount)

Uniquement en sortie. Compte Google Workspace associé à ce client. Utilisé uniquement pour les entreprises clientes.

StatutConditions

Une entreprise doit accepter les conditions d'utilisation de l'inscription sans contact. Un seul utilisateur peut accepter les conditions d'utilisation de son entreprise à l'aide du portail Web.

Les conditions d'utilisation sont gérées par versions. Cela signifie que lorsque les conditions d'utilisation changent, au moins un utilisateur doit accepter les nouvelles conditions. Tant que le premier utilisateur n'a pas accepté les nouvelles conditions d'utilisation, l'état des conditions d'utilisation de l'entreprise est TERMS_STATUS_STALE.

Enums
TERMS_STATUS_NOT_ACCEPTED Aucun des utilisateurs de l'entreprise n'a accepté les conditions d'utilisation.
TERMS_STATUS_ACCEPTED Un ou plusieurs utilisateurs de l'entreprise ont accepté les conditions d'utilisation.
TERMS_STATUS_STALE Aucun des utilisateurs de l'entreprise n'a accepté les conditions d'utilisation actuelles, mais au moins un utilisateur a déjà accepté les conditions d'utilisation précédentes.

Compte Google Workspace

Un client Google Workspace.

Représentation JSON 
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
Champs
customerId

string

Obligatoire. Numéro client.
preProvisioningTokens[]

string

Uniquement en sortie. Jetons de pré-provisionnement utilisés précédemment pour revendiquer des appareils.

Méthodes

create

 Crée un client pour l'inscription sans contact.

list

 Répertorie les clients inscrits auprès du revendeur identifiés par l'argument partnerId.