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, которые передаются в DPC.

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

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