Method: chromeosdevices.action

Sebagai gantinya, gunakan BatchChangeChromeOsDeviceStatus. Mengambil tindakan yang memengaruhi Perangkat Chrome OS. Hal 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 generik yang formatnya ditentukan oleh metode.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ChromeOsDeviceAction

Data tentang pembaruan status perangkat Chrome OS.

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

string

chromeosdevices.action di perangkat Chrome OS.

Nilai yang dapat diterima:

  • deprovision: Menghapus perangkat dari pengelolaan yang sudah tidak aktif, dijual kembali, atau sedang 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. Jika perangkat dinonaktifkan, semua pengguna dapat melihat layar yang memberitahukan bahwa perangkat Chrome telah dinonaktifkan, serta informasi kontak yang diinginkan terkait tempat pengembalian perangkat.
  • reenable: Mengaktifkan kembali perangkat yang dinonaktifkan saat perangkat yang salah taruh ditemukan atau perangkat yang hilang ditampilkan. Anda juga dapat menggunakan fitur ini jika tidak sengaja menandai perangkat Chrome sebagai dinonaktifkan.
  • pre_provisioned_disable: Perangkat yang telah disediakan dan tidak dapat mendaftar. Admin dapat mengaktifkan kembali perangkat untuk mengizinkan Pendaftaran Zero-Touch dengan mengubah status menjadi "pre_appealed_reenable". Catatan: Dari status ini, perangkat dapat dicabut aksesnya.
  • pre_provisioned_reenable: Perangkat telah disediakan oleh OEM. Perangkat dalam status ini memenuhi syarat untuk Pendaftaran Zero-Touch.
deprovisionReason

string

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

Nilai yang dapat diterima:

  • different_model_replacement: Gunakan jika Anda mengupgrade atau mengganti perangkat dengan model yang lebih baru dari perangkat yang sama.
  • retiring_device: Gunakan jika Anda menjual kembali, menyumbang, atau menghapus perangkat secara permanen agar tidak dapat digunakan.
  • same_model_replacement: Gunakan jika perangkat mengalami masalah hardware 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.