Directory API: Mobil Cihazlar

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.