Directory API: Mobil Cihazlar

Google Workspace Directory API, kuruluşunuzdaki mobil cihazları yönetmenize olanak tanır. Bu sayfada, mobil cihazlarınızı nasıl listeleyeceğiniz, belirli bir cihazın ayrıntılarını nasıl alacağınız ve cihaz ekleme veya kaldırma işlemleriyle ilgili örnekler yer almaktadır.

Bu belgede, Ön Koşullar'ı başarıyla tamamladığınız varsayılır. Android cihazlarda cihaz politikası uygulaması yüklü olmalıdır. iOS cihazlar Google Mobil Yönetim hizmetine kaydedilmelidir.

Bu örneklerde, söz konusu kimlikleri nerede sağlayacağınızı belirtmek için customerId ve resourceId yer tutucuları kullanılmaktadır. customerId, Users.get yönteminden alınabilir. 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 açısından 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

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 ekleyin. Okunabilirliği artırmak açısından 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 ekleyin. Okunabilirliği artırmak açısından 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ğinde, bir cihazı onaylama isteği örneği gösterilmektedir: 

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

İstek metni:

{
    "action": "approve"
}

Başarılı bir istekte HTTP 200 durum kodu döndürülü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. Okunabilirliği artırmak açısından 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 istekte HTTP 200 durum kodu döndürülür.