API de Directory: Dispositivos móviles

La API de Directory de Google Workspace te permite administrar los dispositivos móviles de tu organización. Esta página incluye ejemplos de cómo mostrar la lista de dispositivos móviles, obtener detalles de un dispositivo específico, así como como agregar o quitar un dispositivo.

En este documento, se asume que completaste correctamente el Requisitos previos. Los dispositivos Android deben contar con app de política de dispositivo esté instalado. Los dispositivos iOS deben registrarse con 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 que indican dónde debes proporcionar esos IDs. El customerId se puede obtener de Users.get. El resourceId es un identificador único de Google para un dispositivo y se encuentra en la respuesta de el método Recuperar todos los dispositivos móviles

Recuperar todos los dispositivos móviles

Para recuperar todos los dispositivos móviles de una cuenta, usa el siguiente GET: solicitud e incluir la autorización descrita en Autoriza solicitudes. Para mayor legibilidad, en este ejemplo, se usan retornos 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": [
      "[email protected]"
     ],
     "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": [
      "[email protected]"
     ],
     "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 incluya la autorización descrita en Autoriza solicitudes. Para mayor legibilidad, en este ejemplo, se usan retornos 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

A continuación, se muestra un ejemplo de solicitud 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": [
    "[email protected]"
   ],
   "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",
  }

Aprobar un dispositivo móvil

Para aprobar un dispositivo móvil, usa la siguiente solicitud de POST e incluye el autorización descrita en Autoriza solicitudes. Para facilitar la lectura, en este ejemplo se usan resultados de líneas: 

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

La siguiente solicitud JSON 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 descrita en Autoriza solicitudes. Para facilitar la lectura, en este ejemplo se usan resultados de líneas: 

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.