API каталога: мобильные устройства

API Google Workspace Directory позволяет управлять мобильными устройствами в вашей организации. На этой странице приведены примеры того, как составить список мобильных устройств, получить подробную информацию о конкретном устройстве, а также добавить или удалить устройство.

В этом документе предполагается, что вы успешно выполнили все предварительные условия . На устройствах Android должно быть установлено приложение «Политика устройства» . Устройства iOS должны быть зарегистрированы в службе Google Mobile Management .

В этих примерах заполнители customerId и resourceId используются для указания мест, где следует указывать эти идентификаторы. Идентификатор customerId можно получить из метода Users.get . Идентификатор resourceId — это уникальный идентификатор устройства от Google, который находится в ответе метода Retrieve all mobile devices .

Получить все мобильные устройства

Чтобы получить список всех мобильных устройств учетной записи, используйте следующий GET запрос и включите авторизацию, описанную в разделе «Авторизация запросов» . Для удобства чтения в этом примере используются переводы строк:

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

Свойства запроса и ответа см. в справочнике API .

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

Извлечь мобильное устройство

Для получения свойств мобильного устройства используйте следующий GET запрос и включите авторизацию, описанную в разделе «Авторизация запросов» . Для удобства чтения в этом примере используются переводы строк:

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

Свойства запроса и ответа см. в справочнике API .

JSON-запрос

Пример запроса для resourceId :

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

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

Одобрить мобильное устройство

Для подтверждения авторизации мобильного устройства используйте следующий POST запрос, включив в него авторизацию, описанную в разделе «Авторизованные запросы» . Для удобства чтения в этом примере используются переводы строк:

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

Свойства запроса и ответа см. в справочнике API .

JSON-запрос

Следующий JSON-запрос демонстрирует пример запроса на подтверждение устройства:

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

В теле запроса содержится:

{
    "action": "approve"
}

В случае успешного выполнения запроса возвращается код состояния HTTP 200 .

Удалите мобильное устройство

Для удаления мобильного устройства используйте следующий DELETE запрос и укажите авторизацию, описанную в разделе «Авторизованные запросы» . Для удобства чтения в этом примере используются переводы строк:

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

Свойства запроса и ответа см. в справочнике API .

В случае успешного выполнения запроса возвращается код состояния HTTP 200 .