Interfejs Google Workspace Directory API umożliwia zarządzanie urządzeniami mobilnymi w organizacji. Na tej stronie znajdziesz przykłady wyświetlania listy urządzeń mobilnych, uzyskiwania szczegółowych informacji o konkretnym urządzeniu, a także dodawania i usuwania urządzeń.
W tym dokumencie zakładamy, że spełniasz wymagania wstępne. Na urządzeniach z Androidem musi być zainstalowana aplikacja Device Policy. Urządzenia z iOS muszą być zarejestrowane w usłudze zarządzania urządzeniami mobilnymi w Google.
W tych przykładach do wskazania, gdzie należy wstawić te identyfikatory, służą obiekty zastępcze customerId i resourceId. Element customerId można uzyskać za pomocą metody Users.get. resourceId to unikalny identyfikator Google urządzenia, który można znaleźć w odpowiedzi metody Pobierz wszystkie urządzenia mobilne.
Pobierz wszystkie urządzenia mobilne
Aby pobrać wszystkie urządzenia mobilne na koncie, użyj poniższego żądania GET
i dołącz autoryzację opisaną w sekcji Autoryzacja żądań. Aby zwiększyć czytelność, w tym przykładzie zastosowano zwracanie wierszy:
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
Właściwości żądania i odpowiedzi znajdziesz w dokumentacji interfejsu API.
Odpowiedź 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" }
Pobierz urządzenie mobilne
Aby pobrać właściwości urządzenia mobilnego, użyj poniższego żądania GET
i dołącz autoryzację opisaną w sekcji Autoryzowanie żądań. Aby zwiększyć czytelność, w tym przykładzie zastosowano zwracanie wierszy:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId?projection={FULL|BASIC}
Właściwości żądania i odpowiedzi znajdziesz w dokumentacji interfejsu API.
Żądanie JSON
Przykładowe żądanie dla pola resourceId:
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ mobile/resourceId?projection=FULL
Odpowiedź 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", }
Zatwierdzanie urządzenia mobilnego
Aby zatwierdzić urządzenie mobilne, użyj poniższego żądania POST
i dołącz autoryzację opisaną w sekcji Autoryzacja żądań.
Aby zwiększyć czytelność, w tym przykładzie użyto funkcji zwracania wiersza:
POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId/action
Właściwości żądania i odpowiedzi znajdziesz w dokumentacji interfejsu API.
Żądanie JSON
To żądanie JSON przedstawia przykładowe żądanie zatwierdzenia urządzenia:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices /mobile/resourceId/action
Treść żądania:
{ "action": "approve" }
Pomyślne żądanie zwraca kod stanu HTTP 200.
Usuwanie urządzenia mobilnego
Aby usunąć urządzenie mobilne, użyj poniższego żądania DELETE
i dołącz autoryzację opisaną w sekcji Autoryzowanie żądań.
Aby zwiększyć czytelność, w tym przykładzie użyto funkcji zwracania wiersza:
DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId
Właściwości żądania i odpowiedzi znajdziesz w dokumentacji interfejsu API.
Pomyślne żądanie zwraca kod stanu HTTP 200.