Directory API: Perangkat Seluler

Google Workspace Directory API memungkinkan Anda mengelola perangkat seluler di dalam organisasi. Halaman ini menyertakan contoh cara menampilkan daftar perangkat seluler, mendapatkan detail perangkat tertentu, serta menambahkan atau menghapus perangkat.

Dokumen ini mengasumsikan bahwa Anda telah berhasil menyelesaikan Prasyarat. Perangkat Android harus menginstal aplikasi Device Policy. Perangkat iOS harus terdaftar di layanan Google Mobile Management.

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

Ambil semua perangkat seluler

Untuk mengambil semua perangkat seluler akun, gunakan permintaan GET berikut dan sertakan otorisasi yang dijelaskan di Permintaan otorisasi. Agar mudah dibaca, contoh ini menggunakan hasil 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 sertakan otorisasi yang dijelaskan di Permintaan otorisasi. Agar mudah dibaca, contoh ini menggunakan hasil 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",
  }

Menyetujui perangkat seluler

Untuk menyetujui perangkat seluler, gunakan permintaan POST berikut dan sertakan otorisasi yang dijelaskan di Permintaan otorisasi. Agar mudah dibaca, contoh ini menggunakan baris yang ditampilkan:

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 menampilkan 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 di Permintaan otorisasi. Agar mudah dibaca, contoh ini menggunakan baris yang ditampilkan:

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.