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 )

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

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

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

Перечисления
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

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