- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
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 |
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 ( |
Campos | |
---|---|
pageToken |
Un token que especifica qué página de resultados se debe mostrar. |
limit |
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 |
Obligatorio. El tipo de sección del registro de aprovisionamiento del dispositivo. |
customerId[] |
Es la lista de los ID de cliente que se deben buscar. |
googleWorkspaceCustomerId[] |
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 ( |
Campos | |
---|---|
devices[] |
Los dispositivos del cliente. |
nextPageToken |
Un token que se usa para acceder a la página de resultados siguiente. Se omite si no hay más resultados disponibles. |
totalSize |
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.