API каталога Google Workspace позволяет вам управлять мобильными устройствами в вашей организации. На этой странице приведены примеры того, как составить список ваших мобильных устройств, получить подробную информацию о конкретном устройстве, а также добавить или удалить устройство.
В этом документе предполагается, что вы успешно выполнили предварительные условия . На устройствах Android должно быть установлено приложение политики устройств . Устройства iOS должны быть зарегистрированы в службе управления мобильными устройствами Google .
В этих примерах заполнители customerId и resourceId используются для указания того, где вы будете предоставлять эти идентификаторы. customerId можно получить из метода Users.get . resourceId — это уникальный идентификатор устройства Google, который можно найти в ответе метода Получить все мобильные устройства .
Получить все мобильные устройства
Чтобы получить все мобильные устройства учетной записи, используйте следующий запрос 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 .