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.