Method: partners.devices.claim

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

HTTP-запрос

POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
partnerId

string ( int64 format)

Необходимый. Идентификатор партнера-посредника.

Тело запроса

Тело запроса содержит данные со следующей структурой:

Представление JSON
{
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "sectionType": enum (DeviceProvisioningSectionType),
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "preProvisioningToken": string,
  // Union field customer can be only one of the following:
  "customerId": string,
  "googleWorkspaceCustomerId": string
  // End of list of possible types for union field customer.
}
Поля
deviceIdentifier

object ( DeviceIdentifier )

Необходимый. Необходимый. Идентификатор устройства для утверждения.

sectionType

enum ( DeviceProvisioningSectionType )

Необходимый. Тип раздела записи инициализации устройства.

deviceMetadata

object ( DeviceMetadata )

Необязательный. Метаданные для прикрепления к устройству.

preProvisioningToken

string

Необязательный. Должен и может быть установлен только для устройств Chrome OS.

Союз поле customer . Необходимый. Клиент, для которого заявлено устройство. customer может быть только одним из следующих:
customerId

string ( int64 format)

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

googleWorkspaceCustomerId

string

Идентификатор клиента Google Workspace.

Тело ответа

В случае успеха тело ответа содержит данные со следующей структурой:

Ответное сообщение, содержащее идентификатор устройства претензии.

Представление JSON
{
  "deviceId": string,
  "deviceName": string
}
Поля
deviceId

string ( int64 format)

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

deviceName

string

Имя ресурса устройства в формате partners/[PARTNER_ID]/devices/[DEVICE_ID] .

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/androidworkprovisioning

Дополнительные сведения см. в обзоре OAuth 2.0 .