Method: chromeosdevices.action

Sebagai gantinya, gunakan BatchChangeChromeOsDeviceStatus. Melakukan tindakan yang memengaruhi Perangkat Chrome OS. Hal ini mencakup penghapusan penyediaan, penonaktifan, dan pengaktifan ulang 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 generik 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 diambil di perangkat Chrome OS.

Nilai yang dapat diterima adalah:

  • deprovision: Menghapus perangkat dari pengelolaan yang tidak lagi aktif, dijual kembali, atau dikirim untuk dikembalikan / diperbaiki, gunakan tindakan pencabutan akses untuk memisahkannya dari pengelolaan.
  • 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. Saat perangkat dinonaktifkan, semua yang dapat dilihat pengguna saat mengaktifkan perangkat Chrome adalah layar yang memberi tahu mereka bahwa perangkat telah dinonaktifkan, dan informasi kontak yang Anda inginkan untuk mengembalikan perangkat.
  • reenable: Mengaktifkan ulang 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 sebelumnya dan tidak dapat didaftarkan. Admin dapat mengaktifkan kembali perangkat untuk mengizinkan Pendaftaran Zero-Touch dengan mengubah statusnya menjadi "pre_provisioned_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 jika tindakannya adalah penghapusan penyediaan. Dengan tindakan penghapusan penyediaan, kolom ini wajib diisi.

Nilai yang dapat diterima adalah:

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