La API de Directory de Google Workspace te permite administrar los dispositivos móviles de tu organización. En esta página, se incluyen ejemplos de cómo enumerar tus dispositivos móviles, obtener detalles de un dispositivo específico y agregar o quitar un dispositivo.
En este documento, se supone que completaste correctamente los requisitos previos. Los dispositivos Android deben tener instalada la aplicación de política de dispositivos y los dispositivos iOS deben estar registrados en el servicio de Administración de dispositivos móviles de Google.
En estos ejemplos, los marcadores de posición customerId y resourceId se usan para indicar dónde proporcionarías esos ID. El customerId se puede obtener del método Users.get. El resourceId es un identificador único de Google para un dispositivo que se encuentra en la respuesta del método Recupera todos los dispositivos móviles.
Recuperar todos los dispositivos móviles
Para recuperar todos los dispositivos móviles de una cuenta, usa la siguiente solicitud GET e incluye la autorización que se describe en Solicitudes de autorización. Para facilitar la lectura, en este ejemplo, se usa una línea que muestra lo siguiente:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
/devices/mobile?projection={BASIC|FULL}&query=query
&orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING}
&pageToken=token for next results page
&maxResults=max number of results per page
Para conocer las propiedades de solicitud y respuesta, consulta la Referencia de la API.
Respuesta JSON
{
"kind": "directory#mobiledevices",
"mobiledevices": [
{
"kind": "directory#mobiledevice",
"resourceId": "resourceId",
"deviceId": "deviceId",
"name": [
"Sales"
],
"email": [
"sales@example.com"
],
"model": "Nexus 4",
"os": "Android 4.2.2",
"type": "ANDROID",
"status": "APPROVED",
"hardwareId": "1234567890",
"firstSync": "2013-05-15T17:30:04.325Z",
"lastSync": "2013-06-05T17:30:04.325Z",
"userAgent": "Google Apps Device Policy 4.14",
},
{
"kind": "directory#mobiledevice",
"resourceId": "resourceId",
"deviceId": "deviceId",
"name": [
"Liz"
],
"email": [
"liz@example.com"
],
"model": "Galaxy Nexus",
"os": "Android 4.2.2",
"type": "ANDROID",
"status": "APPROVED",
"hardwareId": "9123456780",
"firstSync": "2013-06-05T17:30:04.325Z",
"lastSync": "2013-08-12T17:30:04.325Z",
"userAgent": "Google Apps Device Policy 4.14",
}
],
"nextPageToken": "next_page_token_value"
}
Recupera un dispositivo móvil
Para recuperar las propiedades de un dispositivo móvil, usa la siguiente solicitud GET e incluye la autorización que se describe en Autoriza solicitudes. Para facilitar la lectura, en este ejemplo, se usa una línea que muestra lo siguiente:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
/devices/mobile/resourceId?projection={FULL|BASIC}
Para conocer las propiedades de solicitud y respuesta, consulta la Referencia de la API.
Solicitud JSON
Esta es una solicitud de ejemplo para resourceId:
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ mobile/resourceId?projection=FULL
Respuesta JSON
{
"kind": "directory#mobiledevice",
"resourceId": "resourceId",
"deviceId": "deviceId",
"name": [
"Sales3"
],
"email": [
"sales@example.com"
],
"model": "Nexus 4",
"os": "Android 4.2.2",
"type": "ANDROID",
"status": "APPROVED",
"hardwareId": "1234567890",
"firstSync": "2010-05-15T17:30:04.325Z",
"lastSync": "2013-06-05T17:30:04.325Z",
"userAgent": "Google Apps Device Policy 4.14",
}
Cómo aprobar un dispositivo móvil
Para aprobar un dispositivo móvil, usa la siguiente solicitud de POST e incluye la autorización que se describe en Autoriza solicitudes.
Para facilitar la lectura, en este ejemplo, se usa una línea que muestra lo siguiente:
POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
/devices/mobile/resourceId/action
Para conocer las propiedades de solicitud y respuesta, consulta la Referencia de la API.
Solicitud JSON
En la siguiente solicitud JSON, se muestra un ejemplo de solicitud para aprobar un dispositivo:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices /mobile/resourceId/action
El cuerpo de la solicitud es el siguiente:
{
"action": "approve"
}
Una solicitud correcta muestra un código de estado HTTP 200.
Cómo quitar un dispositivo móvil
Para quitar un dispositivo móvil, usa la siguiente solicitud DELETE e incluye la autorización que se describe en Autoriza solicitudes.
Para facilitar la lectura, en este ejemplo, se usa una línea que muestra lo siguiente:
DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
/devices/mobile/resourceId
Para conocer las propiedades de solicitud y respuesta, consulta la Referencia de la API.
Una solicitud correcta muestra un código de estado HTTP 200.