Method: partners.devices.findByOwner

Encuentra los dispositivos reclamados a los clientes. Los resultados solo contienen dispositivos registrados para el distribuidor identificados por el argumento partnerId. Los dispositivos que el cliente compró a otros distribuidores no aparecen en los resultados.

Solicitud HTTP

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

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 
{
  "pageToken": string,
  "limit": string,
  "sectionType": enum (DeviceProvisioningSectionType),
  "customerId": [
    string
  ],
  "googleWorkspaceCustomerId": [
    string
  ]
}
Campos
pageToken

string

Un token que especifica qué página de resultados se debe mostrar.
limit

string (int64 format)

Obligatorio. La cantidad máxima de dispositivos que se muestran en una página de resultados. Debe estar comprendido entre 1 y 100 inclusive.
sectionType

enum (DeviceProvisioningSectionType)

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

string (int64 format)

Es la lista de los ID de cliente que se deben buscar.
googleWorkspaceCustomerId[]

string

La lista de ID de las cuentas de Google Workspace que se deben buscar.

Cuerpo de la respuesta

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

Respuesta que contiene los dispositivos encontrados.

Representación JSON 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Campos
devices[]

object (Device)

Los dispositivos del cliente.
nextPageToken

string

Un token que se usa para acceder a la página de resultados siguiente. Se omite si no hay más resultados disponibles.
totalSize

integer

El conteo total de elementos de la lista, sin importar la paginación.

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.