Method: partners.devices.findByOwner

Encuentra dispositivos reclamados para clientes. Los resultados solo contienen dispositivos registrados para el revendedor que se identifica con el argumento partnerId. Los dispositivos del cliente que se compraron a otros revendedores 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. El ID del socio revendedor.

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

Es 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 mostrarán en una página de resultados. El valor debe estar comprendido entre 1 y 100, inclusive.

sectionType

enum (DeviceProvisioningSectionType)

Obligatorio. Es el tipo de sección del registro de aprovisionamiento del dispositivo.

customerId[]

string (int64 format)

La lista de los ID de cliente que se buscarán.

googleWorkspaceCustomerId[]

string

La lista de IDs de cuentas de Google Workspace que se buscarán.

Cuerpo de la respuesta

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

Respuesta que contiene 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 siguiente de resultados. 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.