Mengambil semua perangkat Chrome untuk sebuah akun
Untuk menampilkan daftar semua perangkat Chrome yang ditetapkan ke sebuah akun, gunakan permintaan
GET
berikut dan sertakan otorisasi yang dijelaskan dalam
Permintaan otorisasi. Agar mudah dibaca,
contoh kode ini memiliki hasil baris:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos?projection={BASIC|FULL}&query=query &orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING} &pageToken=token for next results page, if applicable &maxResults=max number of results per page
customerId
adalah ID unik akun Google pelanggan.- Sebagai administrator akun, Anda juga dapat menggunakan string
my_customer
yang mewakilicustomerId
akun. Cara lain untuk mendapatkan nilaicustomerId
adalah dengan menggunakan operasi Mengambil pengguna. Gunakan alamat email administrator atau nilaiid
pengguna unik administrator Anda di parameter jaluruserKey
operasi.
Untuk string kueri, permintaan, dan properti respons, lihat Referensi API.
Contoh: Memfilter perangkat menurut pengguna
Contoh ini menelusuri pengguna tertentu menggunakanquery=user:help desk
. Respons
berisi satu resource chromeosdevice
, dengan
annotatedUser
adalah help desk
:
Permintaan JSON
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos?projection=FULL&query=user:help desk&orderBy=status &sortOrder=ASCENDING&maxResults=100
Respons JSON
{ "kind": "directory#chromeosdevices", "chromeosdevices": [ { "kind": "directory#chromeosdevice", "etag": "1234567890" "deviceId": "def456", "serialNumber": "234567", "status": "ACTIVE", "lastSync": "2013-03-05T17:30:04.325Z", "supportEndDate": "2014-04-05T17:30:04.325Z", "annotatedUser": "help desk", "annotatedLocation": "Mountain View help desk Chromebook", "annotatedAssetId": "1234567890", "notes": "Loaned from support", "orderNumber": "1234", "willAutoRenew": true, "osVersion": "Browser Version 18.0", "platformVersion": "Platform Version 1415.2.0", "firmwareVersion": "Firmware Version 1.2.3.4", "bootMode": "validated", "lastEnrollmentTime": "2012-04-05T17:30:04.325Z", "orgUnitPath": "corp/engineering", "recentUsers": [ { "type": "USER_TYPE_MANAGED", "email": "user@customer.com" } ], "activeTimeRanges": [ { "date": "2012-04-05", "activeTime": "3600000" } ], } ], "nextPageToken": "abcdefghijkl123" }
Contoh: Memfilter perangkat menurut nomor seri
Contoh ini menelusuri nomor seri tertentu menggunakan
query=id:123456
, dengan 123456
sebagai
nomor seri perangkat. Respons yang ditunjukkan di bawah berisi satu balasan yang cocok, dengan properti serialNumber
cocok dengan nilai penelusuran.
Permintaan JSON
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos?projection=FULL&query=id:123456&orderBy=status &sortOrder=ASCENDING&maxResults=100
Respons JSON
{ "kind": "directory#chromeosdevices", "chromeosdevices": [ { "kind": "directory#chromeosdevice", "deviceId": "abc123", "serialNumber": "123456", "status": "SHIPPED", "supportEndDate": "1404457200000", "model": "model_value", "meid": "meid_value", "macAddress": "mac_address_value", "orderNumber": "1234", "willAutoRenew": true } ], "nextPageToken": "abcdefghijkl123" }
Contoh respons ini mencakup properti model
, meid
, dan
macAddress
. Jika perangkat tidak memiliki properti ini, properti tersebut tidak akan
disertakan dalam respons. Untuk mengetahui detail selengkapnya, lihat
representasi resource ChromeOSdevices.
Mengekspor daftar MEID
meid
adalah Mobile Equipment Identifier (MEID) untuk kartu seluler 3G di
perangkat Chrome. MEID biasanya digunakan saat menambahkan perangkat ke paket layanan pascabayar
operator nirkabel. Untuk mengekspor daftar MEID, gunakan permintaan GET
dan
nilai nextPageToken
berikut untuk mengambil daftar lengkap MEID. Agar mudah dibaca, contoh kode ini memiliki hasil baris:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos?fields=nextPageToken,chromeosdevices(meid)
Mengambil perangkat Chrome
Untuk mengambil properti perangkat Chrome, gunakan permintaan GET
berikut dan
sertakan otorisasi yang dijelaskan dalam
Permintaan otorisasi. Agar mudah dibaca,
contoh kode ini memiliki hasil baris:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos/deviceId?projection={FULL|BASIC}
customerId
adalah ID unik akun Google pelanggan.- Sebagai administrator akun, Anda juga dapat menggunakan string
my_customer
yang mewakilicustomerId
akun. Cara lain untuk mendapatkan nilaicustomerId
adalah dengan menggunakan operasi Mengambil pengguna. Gunakan alamat email administrator atau nilaiid
pengguna unik administrator Anda di parameter jaluruserKey
operasi. deviceId
adalah ID unik untuk perangkat dan ditemukan sebagai respons atas operasi Ambil semua perangkat Chrome.
Untuk string kueri, permintaan, dan properti respons, lihat Referensi API.
Permintaan JSON
Contoh permintaan. Agar mudah dibaca, contoh kode ini memiliki hasil baris:GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos/deviceId?projection=full
Respons JSON
Permintaan yang berhasil akan menampilkan kode status HTTP 200. Bersama dengan kode status, respons akan menampilkan properti perangkat Chrome:
{ "kind": "directory#chromeosdevice", "deviceId": "device_id_value", "serialNumber": "device_serial_number", "status": "ACTIVE", "lastSync": "2012-04-05T17:30:04.325Z", "supportEndDate": "2014-04-05T17:30:04.325Z", "annotatedUser": "help desk", "annotatedLocation": "Mountain View help desk Chromebook", "annotatedAssetId": "12345667890", "notes": "Loaned from support", "orderNumber": "123456", "willAutoRenew": true, "osVersion": "Browser Version 18.0", "platformVersion": "Platform Version 1415.2.0", "firmwareVersion": "Firmware Version 1.2.3.4", "bootMode": "validated" "lastEnrollmentTime": "2012-04-05T17:30:04.325Z", "orgUnitPath": "corp/engineering" }
Mengupdate perangkat Chrome
Untuk mengupdate perangkat Chrome, gunakan permintaan PUT
berikut dan sertakan
otorisasi yang dijelaskan dalam
Permintaan otorisasi. Agar mudah dibaca,
contoh kode ini memiliki hasil baris:
PUT https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos/deviceId?projection={FULL|BASIC}
customerId
adalah ID unik akun Google pelanggan.- Sebagai administrator akun, Anda juga dapat menggunakan string
my_customer
yang mewakilicustomerId
akun. Cara lain untuk mendapatkan nilaicustomerId
adalah dengan menggunakan operasi Mengambil pengguna. Gunakan alamat email administrator atau nilaiid
pengguna unik administrator Anda di parameter jaluruserKey
operasi. deviceId
adalah ID unik untuk perangkat dan ditemukan sebagai respons atas operasi Ambil semua perangkat Chrome.
Untuk string kueri, permintaan, dan properti respons, lihat Referensi API.
Permintaan JSON
Contoh permintaan JSON berikut mengupdate properti annotatedUser
,
annotatedLocation
, annotatedAssetId
, notes
, dan
orgUnitPath
perangkat Chrome. Agar mudah dibaca, contoh kode ini memiliki pengembalian baris:
PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/deviceId?projection=fullContoh isi permintaan:
{
"deviceId": "device_id_value",
"annotatedUser": "help desk",
"annotatedLocation": "Mountain View help desk Chromebook",
"annotatedAssetId": "1234567890",
"notes": "Loaned from support",
"orgUnitPath": "/corp/sales"
}
Untuk permintaan pembaruan, hanya sertakan properti dengan nilai yang diperbarui dalam permintaan Anda.
Permintaan yang berhasil akan menampilkan kode status HTTP 200. Bersama dengan kode status, respons akan menampilkan properti untuk perangkat Chrome yang diupdate.
Mencabut akses atau menonaktifkan perangkat Chrome
Untuk mencabut akses atau menonaktifkan perangkat Chrome, gunakan permintaan POST
berikut
dan sertakan otorisasi yang dijelaskan dalam
Permintaan otorisasi. Agar mudah dibaca,
contoh kode ini memiliki hasil baris:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/ devices/chromeos:batchChangeStatus
customerId
adalah ID unik akun Google pelanggan.- Sebagai administrator akun, Anda juga dapat menggunakan string
my_customer
yang mewakilicustomerId
akun. Cara lain untuk mendapatkan nilaicustomerId
adalah dengan menggunakan operasi Mengambil pengguna. Gunakan alamat email administrator atau nilaiid
pengguna unik administrator Anda di parameter jaluruserKey
operasi.
Untuk properti permintaan dan respons, lihat Referensi API.
Permintaan JSON
Permintaan JSON berikut menunjukkan contoh permintaan untuk mencabut akses dan menonaktifkan perangkat Chrome:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos:batchChangeStatusIsi permintaan untuk contoh pencabutan akses adalah:
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"], "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION", "deprovisionReason": "DEPROVISION_REASON_RETIRING_DEVICE" }Isi permintaan untuk penonaktifan adalah:
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"], "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE", }
Permintaan yang berhasil akan menampilkan kode status HTTP 200.
Memindahkan perangkat Chrome ke Unit Organisasi
Untuk memindahkan hingga 50 perangkat Chrome ke Unit Organisasi, gunakan permintaan
POST
berikut dan sertakan otorisasi yang dijelaskan dalam
Izin permintaan. Agar mudah dibaca,
contoh kode ini memiliki hasil baris:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
customerId
adalah ID unik akun Google pelanggan.- Sebagai administrator akun, Anda juga dapat menggunakan string
my_customer
yang mewakilicustomerId
akun. Cara lain untuk mendapatkan nilaicustomerId
adalah dengan menggunakan operasi Mengambil pengguna. Gunakan alamat email administrator atau nilaiid
pengguna unik administrator Anda di parameter jaluruserKey
operasi.
Untuk properti permintaan dan respons, lihat Referensi API.
Permintaan JSON
Permintaan JSON berikut menunjukkan contoh permintaan untuk memindahkan 3 perangkat Chrome ke
Unit Organisasi bernama /Marketing
:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/chromeos/moveDevicesToOu?orgUnitPath=/Marketing
Isi permintaan untuk pemindahan perangkat adalah:
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"] }
Permintaan yang berhasil akan menampilkan kode status HTTP 200.