Directory API: Perangkat Seluler

Google Workspace Directory API memungkinkan Anda mengelola perangkat seluler dalam organisasi. Halaman ini mencakup contoh cara menampilkan daftar perangkat seluler Anda, mendapatkan detail dari perangkat tertentu, serta seperti menambah atau menghapus perangkat.

Dokumen ini mengasumsikan bahwa Anda telah berhasil menyelesaikan Prasyarat. Perangkat Android harus memiliki aplikasi device policy terinstal. Perangkat iOS harus terdaftar di Layanan Google Pengelolaan Seluler.

Dalam contoh ini, placeholder customerId dan resourceId digunakan untuk menunjukkan di mana Anda akan memberikan ID tersebut. customerId dapat diperoleh dari Metode Users.get. Tujuan resourceId adalah ID unik Google untuk perangkat dan ditemukan sebagai respons dari metode Ambil semua perangkat seluler.

Ambil semua perangkat seluler

Untuk mengambil semua perangkat seluler suatu akun, gunakan GET berikut dan sertakan otorisasi yang dijelaskan dalam Mengizinkan permintaan. Agar mudah dibaca, contoh ini menggunakan pengembalian baris: 

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

Untuk properti permintaan dan respons, lihat Referensi API.

Respons JSON

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

Mengambil perangkat seluler

Untuk mengambil properti perangkat seluler, gunakan permintaan GET berikut dan termasuk otorisasi yang dijelaskan dalam Mengizinkan permintaan. Agar mudah dibaca, contoh ini menggunakan pengembalian baris: 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId?projection={FULL|BASIC}

Untuk properti permintaan dan respons, lihat Referensi API.

Permintaan JSON

Contoh permintaan untuk resourceId adalah: 

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
  mobile/resourceId?projection=FULL

Respons JSON

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

Setujui perangkat seluler

Untuk menyetujui perangkat seluler, gunakan permintaan POST berikut dan sertakan otorisasi yang dijelaskan dalam Mengizinkan permintaan. Agar mudah dibaca, contoh ini menggunakan pengembalian baris: 

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

Untuk properti permintaan dan respons, lihat Referensi API.

Permintaan JSON

Permintaan JSON berikut menunjukkan contoh permintaan untuk menyetujui perangkat: 

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

Isi permintaan adalah:

{
    "action": "approve"
}

Permintaan yang berhasil akan menampilkan Kode status HTTP 200.

Menghapus perangkat seluler

Untuk menghapus perangkat seluler, gunakan permintaan DELETE berikut dan sertakan otorisasi yang dijelaskan dalam Mengizinkan permintaan. Agar mudah dibaca, contoh ini menggunakan pengembalian baris: 

DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId

Untuk properti permintaan dan respons, lihat Referensi API.

Permintaan yang berhasil akan menampilkan Kode status HTTP 200.