REST Resource: customers.devices

Ресурс: Устройство

Устройство Android или Chrome OS, зарегистрированное для автоматической регистрации.

JSON-представление
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ],
  "configuration": string
}
Поля
deviceId

string ( int64 format)

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

deviceIdentifier

object ( DeviceIdentifier )

Идентификаторы оборудования, идентифицирующие произведенное устройство. Чтобы узнать больше, прочитайте Идентификаторы .

name

string

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

deviceMetadata

object ( DeviceMetadata )

Метаданные, прикрепленные к устройству. Структурировано как пары ключ-значение.

claims[]

object ( DeviceClaim )

Только вывод. Заявки на подготовку для устройства. Устройства, заявленные для автоматической регистрации, имеют утверждение типа SECTION_TYPE_ZERO_TOUCH . Вызовите customers.devices.unclaim , чтобы удалить устройство из автоматической регистрации.

configuration

string

Конфигурация, примененная к устройству, имеет формат customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] . Значение равно null , если к устройству не применена конфигурация.

Идентификатор устройства

Инкапсулирует идентификаторы оборудования и продуктов для идентификации произведенного устройства. Чтобы понять требования к наборам идентификаторов, прочтите Идентификаторы .

JSON-представление
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.

  // Union field hardware_id2 can be only one of the following:
  "imei2": string,
  "meid2": string
  // End of list of possible types for union field hardware_id2.
}
Поля
serialNumber

string

Серийный номер производителя устройства. Это значение может не быть уникальным для разных моделей устройств.

manufacturer

string

Название производителя устройства. Соответствует встроенному значению устройства, возвращенному из android.os.Build.MANUFACTURER . Допустимые значения указаны у производителей Android .

model

string

Название модели устройства. Допустимые значения указаны для моделей Android и моделей Chrome OS .

deviceType

enum ( DeviceType )

Тип устройства

chromeOsAttestedDeviceId

string

Идентификатор, предоставляемый OEM-производителями и используемый в процессе производства и продаж. Применимо только к устройствам Chrome OS.

Поле объединения hardware_id . Идентификатор оборудования на основе идентификатора модема. hardware_id может быть только одним из следующих:
imei

string

Номер IMEI устройства. Проверено при вводе.

meid

string

MEID-номер устройства.

Поле объединения hardware_id2 . Второй идентификатор оборудования для устройств с двумя SIM-картами. Если он установлен, он должен быть того же типа идентификатора, что и первый идентификатор оборудования. hardware_id2 может быть только одним из следующих:
imei2

string

Второй номер IMEI устройства.

meid2

string

Второй номер MEID устройства.

Тип устройства

Операционная система устройства.

Перечисления
DEVICE_TYPE_ANDROID Android-устройство
DEVICE_TYPE_CHROME_OS Устройство с ОС Chrome

Метаданные устройства

Записи метаданных, которые можно прикрепить к Device . Чтобы узнать больше, прочтите Метаданные устройства .

JSON-представление
{
  "entries": {
    string: string,
    ...
  }
}
Поля
entries

map (key: string, value: string)

Записи метаданных, записанные как пары ключ-значение.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

Утверждение устройства

Запись об устройстве, заявленном торговым посредником для клиента. Устройства, заявленные для автоматической регистрации, имеют утверждение типа SECTION_TYPE_ZERO_TOUCH . Дополнительную информацию см. в разделе Утверждение устройств для клиентов .

JSON-представление
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "additionalService": enum (AdditionalService)
}
Поля
sectionType

enum ( DeviceProvisioningSectionType )

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

ownerCompanyId

string ( int64 format)

Идентификатор клиента, приобретшего устройство.

googleWorkspaceCustomerId

string

Идентификатор аккаунта Google Workspace, которому принадлежит устройство Chrome OS.

additionalService

enum ( AdditionalService )

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

Девицепровисионингсекионтипе

Тип раздела записи подготовки.

Перечисления
SECTION_TYPE_SIM_LOCK Тип секции SIM-lock.
SECTION_TYPE_ZERO_TOUCH Тип раздела автоматической регистрации.

Дополнительный сервис

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

Перечисления
DEVICE_PROTECTION Служба защиты устройств, также известная как Android Enterprise Essentials. Чтобы заявить права на устройство с помощью службы защиты устройств, вам необходимо зарегистрироваться в партнерской команде.

Методы

applyConfiguration

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

get

Получает сведения об устройстве.

list

Перечисляет устройства клиента.

removeConfiguration

Удаляет конфигурацию с устройства.

unclaim

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