Directory API: Perangkat Seluler

Google Workspace Directory API memungkinkan Anda mengelola perangkat seluler dalam organisasi Anda. Halaman ini mencakup contoh cara mencantumkan 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 kebijakan perangkat. Perangkat iOS harus didaftarkan ke layanan Pengelolaan Seluler Google.

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 perangkat dan ditemukan dalam respons metode Ambil semua perangkat seluler.

Mengambil semua perangkat seluler

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