Directory API: Mobil Cihazlar

Google Workspace Directory API, kuruluşunuzdaki mobil cihazları yönetmenize olanak tanır. Bu sayfa ve mobil cihazlarınızı listeleme, belirli bir cihazın ayrıntılarını öğrenme ve ekleme veya kaldırma gibi işlemleri yapabilirsiniz.

Bu belgede, ilk olarak Ön koşullar. Android cihazlarda device Policy uygulaması yüklendi. iOS cihazlar Google Mobil Yönetimi hizmeti.

Bu örneklerde customerId ve resourceId yer tutucuları şu amaçlarla kullanılır: bu kimlikleri nerede sağlayacağınızı belirtin. customerId, şuradan elde edilebilir: Users.get yöntemi kullanılır. İlgili içeriği oluşturmak için kullanılan resourceId, bir cihazın benzersiz Google tanımlayıcısıdır ve Tüm mobil cihazları al yöntemini seçin.

Tüm mobil cihazları al

Bir hesabın tüm mobil cihazlarını almak için şu GET işlevini kullanın: içinde açıklanan yetkilendirmeyi içeren bir e-posta alırsınız İstekleri yetkilendirin. Okunabilirlik açısından aşağıdaki örnekte şu satır sonuçları 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ı.

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

Bir mobil cihazın özelliklerini almak için aşağıdaki GET isteğini kullanın ve İstekleri yetkilendirin. Okunabilirlik açısından aşağıdaki örnekte şu satır sonuçları 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ı.

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",
  }

Bir mobil cihazı onaylama

Bir mobil cihazı onaylamak için aşağıdaki POST isteğini kullanın ve şunu ekleyin: yetki belgesinin bu bölümünde İstekleri yetkilendirin. Bu örnekte okunabilirlik için satır sonları 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ı.

JSON isteği

Aşağıdaki JSON isteğinde, bir cihazı onaylamak için örnek bir istek gösterilmektedir: 

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

İsteğin ana metni:

{
    "action": "approve"
}

Başarılı bir istek, HTTP 200 durum kodu.

Mobil cihazı kaldırma

Bir mobil cihazı kaldırmak için aşağıdaki DELETE isteğini kullanın ve aşağıdakileri ekleyin: yukarıda açıklanan yetkilendirme İstekleri yetkilendirin. Bu örnekte okunabilirlik için satır sonları 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ı.

Başarılı bir istek, HTTP 200 durum kodu.