API Directory: dispositivos móveis

Com a API Google Workspace Directory, você gerencia 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, bem como adicionar ou remover um dispositivo.

Este documento pressupõe que você concluiu Pré-requisitos. Os dispositivos Android precisam ter app Device Policy instalado. Os dispositivos iOS devem ser registrados com o Serviço do Gerenciamento Google de dispositivos móveis.

Nestes exemplos, os marcadores de posição customerId e resourceId são usados para indique onde você forneceria esses IDs. O customerId pode ser encontrado no Users.get. A resourceId é um identificador exclusivo do Google para um dispositivo, encontrado na resposta de o 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 o seguinte GET solicitação e incluir 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 obter 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": [
      "[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"
  }

Recuperar um dispositivo móvel

Para recuperar as propriedades de um dispositivo móvel, use a seguinte solicitação GET e incluir 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 obter as propriedades de solicitação e resposta, consulte a Referência da API.

Solicitação JSON

Este é um exemplo de solicitação para 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": [
    "[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",
  }

Aprovar um dispositivo móvel

Para aprovar um dispositivo móvel, use a seguinte solicitação POST e inclua o 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 obter as propriedades de solicitação e resposta, consulte a Referência da API.

Solicitação JSON

A seguinte solicitação JSON 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 da autorização descrita no 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 obter 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.