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.

  // 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,
  "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

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