REST Resource: partners.devices

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

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

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

string ( int64 format)

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

deviceIdentifier

object ( DeviceIdentifier )

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

name

string

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

deviceMetadata

object ( DeviceMetadata )

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

claims[]

object ( DeviceClaim )

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

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

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

Представление 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.
}
Поля
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 устройства.

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

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

перечисления
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,
  "resellerId": string,
  "additionalService": enum (AdditionalService)
}
Поля
sectionType

enum ( DeviceProvisioningSectionType )

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

ownerCompanyId

string ( int64 format)

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

googleWorkspaceCustomerId

string

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

resellerId

string ( int64 format)

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

additionalService

enum ( AdditionalService )

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

DeviceProvisioningSectionType

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

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

Дополнительная услуга

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

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

Методы

claim

 Запрашивает устройство для клиента и добавляет его в автоматическую регистрацию.

claimAsync

 Запрашивает партию устройств для клиента асинхронно.

findByIdentifier

 Находит устройства по аппаратным идентификаторам, таким как IMEI.

findByOwner

 Находит устройства, заявленные для клиентов.

get

 Получает устройство.

metadata

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

unclaim

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

unclaimAsync

 Асинхронно аннулирует заявку на партию устройств для клиента.

updateMetadataAsync

 Обновляет метаданные торгового посредника, прикрепленные к группе устройств.