Method: partners.devices.claim

Reclama un dispositivo para un cliente y lo agrega a la inscripción automática. Si otro cliente ya reclamó el dispositivo, la llamada mostrará un error.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
partnerId

string (int64 format)

Obligatorio. Es el ID del socio distribuidor.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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)

Obligatorio. Obligatorio. El identificador del dispositivo que se va a reclamar.

sectionType

enum (DeviceProvisioningSectionType)

Obligatorio. El tipo de sección del registro de aprovisionamiento del dispositivo.

deviceMetadata

object (DeviceMetadata)

Opcional. Los metadatos que se adjuntarán al dispositivo.

preProvisioningToken

string

Opcional. Solo se puede configurar para dispositivos con Chrome OS.

Campo de unión customer. Obligatorio. El cliente por el que se reclama el dispositivo Las direcciones (customer) solo pueden ser una de las siguientes opciones:
customerId

string (int64 format)

El ID del cliente por el que se reclama el dispositivo.

googleWorkspaceCustomerId

string

El ID de cliente de Google Workspace.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Mensaje de respuesta que contiene el ID del dispositivo del reclamo.

Representación JSON
{
  "deviceId": string,
  "deviceName": string
}
Campos
deviceId

string (int64 format)

El ID del dispositivo reclamado.

deviceName

string

El nombre del recurso del dispositivo en el formato partners/[PARTNER_ID]/devices/[DEVICE_ID].

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.