Method: partners.devices.claim

Reivindica um dispositivo para um cliente e o adiciona ao registro sem toque. Se o dispositivo já tiver sido reivindicado por outro cliente, a chamada retornará um erro.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
partnerId

string (int64 format)

Obrigatório. O ID do parceiro revendedor.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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.
}
Campos
deviceIdentifier

object (DeviceIdentifier)

Obrigatório. Obrigatório. O identificador do dispositivo a ser reivindicado.

sectionType

enum (DeviceProvisioningSectionType)

Obrigatório. O tipo de seção do registro de provisionamento do dispositivo.

deviceMetadata

object (DeviceMetadata)

Opcional. Os metadados a serem anexados ao dispositivo.

preProvisioningToken

string

Opcional. Precisa e só pode ser definido para dispositivos Chrome OS.

Campo de união customer. Obrigatório. O cliente para quem o dispositivo está sendo reivindicado. customer pode ser apenas de um dos tipos a seguir:
customerId

string (int64 format)

O ID do cliente para quem o dispositivo está sendo reivindicado.

googleWorkspaceCustomerId

string

O ID de cliente do Google Workspace.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Mensagem de resposta com o ID do dispositivo da reivindicação.

Representação JSON
{
  "deviceId": string,
  "deviceName": string
}
Campos
deviceId

string (int64 format)

O ID do dispositivo reivindicado.

deviceName

string

O nome de recurso do dispositivo no formato partners/[PARTNER_ID]/devices/[DEVICE_ID].

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.