Directory API: Mobil Cihazlar

Google Workspace Directory API, kuruluşunuzdaki mobil cihazları yönetmenize olanak tanır. Bu sayfada, mobil cihazlarınızın nasıl listeleneceği, belirli bir cihazın ayrıntılarının nasıl alınacağı ve cihaz ekleme ya da kaldırmayla ilgili örnekler yer almaktadır.

Bu dokümanda, ön koşulları başarıyla tamamladığınız varsayılmaktadır. Android cihazlarda cihaz politikası uygulaması yüklü olmalıdır. iOS cihazlar Google Mobil Yönetimi hizmetine kayıtlı olmalıdır.

Bu örneklerde, bu kimlikleri nerede sağlayacağınızı belirtmek için customerId ve resourceId yer tutucuları kullanılır. customerId, Users.get yönteminden elde edilebilir. resourceId, bir cihazın benzersiz Google tanımlayıcısıdır ve Tüm mobil cihazları alma yönteminin yanıtında bulunur.

Tüm mobil cihazları alma

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 ekleyin. Okunabilirliği artırmak için bu örnekte satır sonları kullanılmıştı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"
  }

Mobil cihazı alma

Mobil cihazları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. Okunabilirliği artırmak için bu örnekte satır sonları kullanılmıştı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 bir 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. Okunabilirliği artırmak için bu örnekte satır sonları kullanılmıştı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ği, bir cihazı onaylamak için örnek bir istek göstermektedir: 

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

İstek metni:

{
    "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 ekleyin. Okunabilirliği artırmak için bu örnekte satır sonları kullanılmıştı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.