API de Directory: Dispositivos móviles

La API de Directory de Google Workspace te permite administrar dispositivos móviles en 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 app de la política de dispositivos. Los dispositivos iOS deben estar registrados en el servicio de Administración de dispositivos móviles de Google.

En estos ejemplos, se usan los marcadores de posición customerId y resourceId para indicar dónde proporcionarías esos IDs. El customerId se puede obtener del método Users.get. resourceId es un identificador único de Google para un dispositivo y se encuentra en la respuesta del método Retrieve all mobile devices.

Cómo recuperar todos los dispositivos móviles

Para recuperar todos los dispositivos móviles de una cuenta, usa la siguiente solicitud GET y, luego, incluye la autorización que se describe en Autorizar solicitudes. Para facilitar la lectura, en este ejemplo, se usan saltos de línea: 

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"
  }

Cómo recuperar 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 Autorizar solicitudes. Para facilitar la lectura, en este ejemplo, se usan saltos de línea: 

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

Un ejemplo de solicitud para resourceId es el siguiente: 

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 POST y, luego, incluye la autorización que se describe en Autorizar solicitudes. Para facilitar la lectura, este ejemplo usa saltos de línea: 

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 una solicitud de ejemplo 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 devuelve 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 y, luego, incluye la autorización que se describe en Autorizar solicitudes. Para facilitar la lectura, este ejemplo usa saltos de línea: 

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 devuelve un código de estado HTTP 200.