API Directory: dispositivos móveis

A API Directory do Google Workspace permite gerenciar dispositivos móveis na sua organização. Esta página inclui exemplos de como listar seus dispositivos móveis, obter detalhes de um dispositivo específico, além de adicionar ou remover um dispositivo.

Neste documento, consideramos que você concluiu os pré-requisitos. Os dispositivos Android precisam ter o app Device Policy instalado. Os dispositivos iOS precisam estar registrados no serviço de gerenciamento móvel do Google.

Nesses exemplos, os marcadores de posição customerId e resourceId são usados para indicar onde você forneceria esses IDs. O customerId pode ser obtido com o método Users.get. O resourceId é um identificador exclusivo do Google para um dispositivo e pode ser encontrado na resposta do método Recuperar todos os dispositivos móveis.

Recuperar todos os dispositivos móveis

Para recuperar todos os dispositivos móveis de uma conta, use a seguinte solicitação GET e inclua a autorização descrita em Autorizar solicitações. Para facilitar a leitura, este exemplo usa retornos de linha: 

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 as propriedades de solicitação e resposta, consulte a referência da API.

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

Recuperar um dispositivo móvel

Para recuperar as propriedades de um dispositivo móvel, use a seguinte solicitação GET e inclua a autorização descrita em Autorizar solicitações. Para facilitar a leitura, este exemplo usa retornos de linha: 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId?projection={FULL|BASIC}

Para as propriedades de solicitação e resposta, consulte a referência da API.

Solicitação JSON

Exemplo de solicitação para o resourceId: 

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
  mobile/resourceId?projection=FULL

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

Aprovar um dispositivo móvel

Para aprovar um dispositivo móvel, use a seguinte solicitação POST e inclua a autorização descrita em Autorizar solicitações. Para facilitar a leitura, este exemplo usa retornos de linha: 

POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId/action

Para as propriedades de solicitação e resposta, consulte a referência da API.

Solicitação JSON

A solicitação JSON a seguir mostra um exemplo de solicitação para aprovar um dispositivo: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices
  /mobile/resourceId/action

O corpo da solicitação é:

{
    "action": "approve"
}

Uma solicitação bem-sucedida retorna um código de status HTTP 200.

Remover um dispositivo móvel

Para remover um dispositivo móvel, use a seguinte solicitação DELETE e inclua a autorização descrita em Autorizar solicitações. Para facilitar a leitura, este exemplo usa retornos de linha: 

DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId

Para as propriedades de solicitação e resposta, consulte a referência da API.

Uma solicitação bem-sucedida retorna um código de status HTTP 200.