REST Resource: partners.customers

Ресурс: Компания

Реселлер, поставщик или клиент в автоматических API реселлера и клиента.

JSON-представление
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
Поля
name

string

Только вывод. Имя ресурса API компании. Имя ресурса имеет один из следующих форматов:

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

Назначается сервером.

companyId

string ( int64 format)

Только вывод. Идентификатор компании. Назначается сервером.

companyName

string

Необходимый. Название компании. Например, корпорация XYZ . Отображается сотрудникам компании на портале автоматической регистрации.

ownerEmails[]

string

Необходимый. Только ввод. Адрес электронной почты пользователей клиента в роли владельца. Требуется хотя бы один owner_email . Владельцы имеют тот же доступ, что и администраторы, но также могут добавлять, удалять и редактировать пользователей портала вашей организации.

adminEmails[]

string

Необязательный. Адрес электронной почты пользователей клиента в роли администратора. Каждый адрес электронной почты должен быть связан с учетной записью Google.

termsStatus

enum ( TermsStatus )

Только вывод. Принял ли какой-либо пользователь из компании последнюю версию Условий обслуживания (ToS). См. TermsStatus .

skipWelcomeEmail

boolean

Только ввод. Если установлено значение true, приветственное письмо клиенту не будет отправлено. Рекомендуется пропустить приветственное электронное письмо, если на устройства будет заявлена ​​дополнительная услуга DEVICE_PROTECTION, так как клиент получит отдельные электронные письма во время заявки на устройство. Это поле игнорируется, если это не клиент Zero-touch.

languageCode

string

Только ввод. Предпочтительный языковой стандарт клиента представлен в виде языкового кода BCP47. Это поле проверяется при вводе, и запросы, содержащие неподдерживаемые коды языков, будут отклонены. Поддерживаемые коды языков: арабский (ar) китайский (Гонконг) (zh-HK) китайский (упрощенный) (zh-CN) китайский (традиционный) (zh-TW) чешский (cs) датский (da) голландский (nl) английский ( Великобритания) (en-GB) английский (США) (en-US) филиппинский (fil) финский (fi) французский (fr) немецкий (de) иврит (iw) хинди (hi) венгерский (hu) индонезийский (id) итальянский ( it) Японский (ja) Корейский (ko) Норвежский (Bokmal) (no) Польский (pl) Португальский (Бразилия) (pt-BR) Португальский (Португалия) (pt-PT) Русский (ru) Испанский (es) Испанский (латиница) Америка) (es-419) Шведский (sv) Тайский (th) Турецкий (tr) Украинский (uk) Вьетнамский (vi)

googleWorkspaceAccount

object ( GoogleWorkspaceAccount )

Только вывод. Аккаунт Google Workspace, связанный с этим клиентом. Используется только для компаний-клиентов.

Условия Статус

Принятие компанией Условий обслуживания (ToS) автоматической регистрации. Один пользователь может принять Условия обслуживания для своей компании с помощью веб-портала.

Условия обслуживания имеют версии. Это означает, что при изменении Условий обслуживания хотя бы один пользователь должен принять новые Условия обслуживания. Пока первый пользователь не примет новые Условия обслуживания, статус условий компании — TERMS_STATUS_STALE .

Перечисления
TERMS_STATUS_NOT_ACCEPTED Ни один из пользователей компании не принял Условия обслуживания.
TERMS_STATUS_ACCEPTED Один (или несколько) пользователей компании приняли Условия обслуживания.
TERMS_STATUS_STALE Ни один из пользователей компании не принял текущие Условия обслуживания, но как минимум один пользователь принял предыдущие Условия обслуживания.

GoogleWorkspaceАккаунт

Клиент Google Workspace.

JSON-представление
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
Поля
customerId

string

Необходимый. Идентификатор клиента.

preProvisioningTokens[]

string

Только вывод. Токены предварительной подготовки, которые ранее использовались для утверждения устройств.

Методы

create

Создает клиента для автоматической регистрации.

list

Перечисляет клиентов, зарегистрированных у торгового посредника, определенного аргументом partnerId .