Google Workspace Directory API, kuruluşunuzdaki mobil cihazları yönetmenize olanak tanır. Bu sayfada, mobil cihazlarınızı listeleme, belirli bir cihazla ilgili ayrıntıları edinme ve cihaz ekleme veya kaldırma işlemlerinin nasıl yapılacağına dair örnekler yer almaktadır.
Bu belgede Önkoşullar'ı başarıyla tamamladığınız varsayılmaktadır. Android cihazlarda cihaz politikası uygulaması yüklü olmalıdır. iOS cihazlar ise Google Mobil Yönetimi hizmetine kayıtlı olmalıdır.
Bu örneklerde customerId ve resourceId yer tutucuları, bu kimlikleri nereye sağlayacağınızı belirtmek için kullanılmaktadır. customerId, Users.get yönteminden edinilebilir. resourceId, bir cihaz için benzersiz Google tanımlayıcısıdır ve Tüm mobil cihazları al yönteminin yanıtında bulunur.
Tüm mobil cihazları al
Bir hesabın tüm mobil cihazlarını almak için aşağıdaki GET
isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirmeyi dahil edin. Okunabilirlik için bu örnekte satır döndürmeleri kullanılmaktadır:
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
İstek ve yanıt özellikleri için API Referansı'na bakın.
JSON yanıtı
{ "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" }
Bir mobil cihazı alma
Bir mobil cihazın özelliklerini almak için aşağıdaki GET
isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirmeyi dahil edin. Okunabilirlik için bu örnekte satır döndürmeleri kullanılmaktadır:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId?projection={FULL|BASIC}
İstek ve yanıt özellikleri için API Referansı'na bakın.
JSON isteği
resourceId için örnek istek:
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ mobile/resourceId?projection=FULL
JSON yanıtı
{ "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", }
Mobil cihazı onaylama
Bir mobil cihazı onaylamak için aşağıdaki POST
isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirmeyi dahil edin.
Okunabilirlik için bu örnekte satır sonuçları kullanılmaktadır:
POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId/action
İstek ve yanıt özellikleri için API Referansı'na bakın.
JSON isteği
Aşağıdaki JSON isteğinde, bir cihazı onaylamaya yönelik örnek istek gösterilmektedir:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices /mobile/resourceId/action
İsteğin gövdesi:
{ "action": "approve" }
Başarılı bir istek, HTTP 200 durum kodu döndürür.
Mobil cihazı kaldırma
Bir mobil cihazı kaldırmak için aşağıdaki DELETE
isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirmeyi dahil edin.
Okunabilirlik için bu örnekte satır sonuçları kullanılmaktadır:
DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId
İstek ve yanıt özellikleri için API Referansı'na bakın.
Başarılı bir istek, HTTP 200 durum kodu döndürür.