Method: chromeosdevices.action

Sebagai gantinya, gunakan BatchChangeChromeOsDeviceStatus. Mengambil tindakan yang memengaruhi Perangkat Chrome OS. Tindakan ini termasuk mencabut akses, menonaktifkan, dan mengaktifkan kembali perangkat.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

ID unik untuk akun Google Workspace pelanggan. Sebagai administrator akun, Anda juga dapat menggunakan alias my_customer untuk mewakili customerId akun Anda. customerId juga ditampilkan sebagai bagian dari Resource pengguna.
resourceId

string

ID unik perangkat. resourceId ditampilkan sebagai respons dari metode chromeosdevices.list.

Isi permintaan

Isi permintaan memuat instance ChromeOsDeviceAction.

Isi respons

Jika berhasil, responsnya adalah respons HTTP umum yang formatnya ditentukan oleh metode.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ChromeOsDeviceAction

Data tentang update status perangkat ChromeOS.

Representasi JSON 
{
  "action": string,
  "deprovisionReason": string
}
Kolom
action

string

chromeosdevices.action yang akan dilakukan di perangkat ChromeOS.

Nilai yang dapat diterima:

  • deprovision: Menghapus perangkat dari pengelolaan yang tidak lagi aktif, dijual kembali, atau sedang dikirim untuk dikembalikan / direparasi, gunakan tindakan pencabutan akses untuk memisahkannya dari manajemen.
  • disable: Jika Anda yakin bahwa perangkat di organisasi Anda telah hilang atau dicuri, Anda dapat menonaktifkan perangkat tersebut agar tidak ada orang lain yang dapat menggunakannya. Jika perangkat dinonaktifkan, semua pengguna akan dapat melihat layar yang memberi tahu mereka bahwa perangkat Chrome telah dinonaktifkan dan informasi kontak yang Anda inginkan terkait tempat untuk mengembalikan perangkat.
  • reenable: Mengaktifkan kembali perangkat yang dinonaktifkan saat perangkat yang salah tempat ditemukan atau perangkat yang hilang dikembalikan. Anda juga dapat menggunakan fitur ini jika Anda tidak sengaja menandai perangkat Chrome sebagai dinonaktifkan.
  • pre_provisioned_disable: Perangkat yang telah disediakan dan tidak dapat didaftarkan. Admin dapat mengaktifkan kembali perangkat untuk mengizinkan Pendaftaran Zero-Touch dengan mengubah status menjadi "pre_Provideed_reenable". Catatan: Dari status ini, perangkat dapat dicabut aksesnya.
  • pre_provisioned_reenable: Perangkat telah disediakan sebelumnya oleh OEM. Perangkat dalam status ini memenuhi syarat untuk Pendaftaran Zero-Touch.
deprovisionReason

string

Hanya digunakan saat tindakan dicabut aksesnya. Dengan tindakan cabut akses, kolom ini wajib diisi.

Nilai yang dapat diterima:

  • different_model_replacement: Gunakan jika Anda mengupgrade atau mengganti perangkat dengan model perangkat yang sama yang lebih baru.
  • retiring_device: Gunakan jika Anda menjual kembali, mendonasikan, atau menghapus perangkat secara permanen agar tidak digunakan.
  • same_model_replacement: Gunakan jika perangkat mengalami masalah hardware dan perangkat diganti dengan model yang sama atau model pengganti dari vendor / produsen reparasi.
  • upgrade_transfer: Gunakan jika Anda mengganti perangkat Cloud Ready dengan Chromebook dalam waktu satu tahun.