REST Resource: customers.configurations

Ресурс: Конфигурация

Конфигурация собирает параметры подготовки для устройств Android. Каждая конфигурация сочетает в себе следующее:

  • Контроллер политики устройств EMM (DPC), установленный на устройствах.
  • На устройствах применяются политики EMM.
  • Метаданные отображаются на устройстве, чтобы помочь пользователям во время настройки.

Клиенты могут добавлять столько конфигураций, сколько им необходимо. Однако автоматическая регистрация работает лучше всего, когда клиент устанавливает конфигурацию по умолчанию, которая применяется ко всем новым устройствам, приобретаемым организацией.

JSON-представление
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
Поля
name

string

Только вывод. Имя ресурса API в формате customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] . Назначается сервером.

configurationId

string ( int64 format)

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

configurationName

string

Необходимый. Короткое имя, описывающее назначение конфигурации. Например, отдел продаж или временные сотрудники . Портал автоматической регистрации отображает это имя ИТ-администраторам.

dpcResourcePath

string

Необходимый. Имя ресурса выбранного DPC (контроллера политики устройства) в формате customers/[CUSTOMER_ID]/dpcs/* . Чтобы получить список поддерживаемых ЦОД, вызовите customers.dpcs.list .

dpcExtras

string

Дополнительные сведения об обеспечении EMM в формате JSON, которые передаются в центр обработки данных.

companyName

string

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

contactEmail

string

Необходимый. Адрес электронной почты, по которому пользователи устройств могут связаться для получения помощи. Автоматическая регистрация показывает этот адрес электронной почты пользователям устройств перед инициализацией устройства. Значение проверяется при вводе.

contactPhone

string

Необходимый. Номер телефона, по которому пользователи устройства могут позвонить с другого устройства для получения помощи. Автоматическая регистрация показывает этот номер пользователям устройств перед подготовкой устройства. Принимаются цифры, пробелы, знак плюса, дефисы и круглые скобки.

customMessage

string

Сообщение, содержащее одно или два предложения, которое помогает пользователям устройств получить помощь или предоставить им более подробную информацию о том, что происходит с их устройством. При автоматической регистрации это сообщение отображается до подготовки устройства.

isDefault

boolean

Необходимый. Является ли это конфигурацией по умолчанию, в которой автоматическая регистрация применяется к любым новым устройствам, которые организация приобретет в будущем. Только одна конфигурация клиента может использоваться по умолчанию. Установка для этого значения значения true изменяет значение isDefault предыдущей конфигурации по умолчанию на false .

forcedResetTime

string ( Duration format)

Необязательный. Тайм-аут перед принудительным сбросом настроек устройства, если устройство не проходит подготовку в мастере настройки, обычно из-за отсутствия сетевого подключения во время мастера настройки. Диапазон значений от 0 до 6 часов, при этом 2 часа — значение по умолчанию, если не установлено.

Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

Методы

create

Создает новую конфигурацию.

delete

Удаляет неиспользуемую конфигурацию.

get

Получает сведения о конфигурации.

list

Перечисляет конфигурации клиента.

patch

Обновляет значения полей конфигурации.