Method: customer.devices.chromeos.batchChangeStatus

Mengubah status batch perangkat ChromeOS. Untuk mengetahui informasi selengkapnya tentang cara mengubah status perangkat ChromeOS, Memperbaiki, memodifikasi, atau menghentikan penggunaan perangkat ChromeOS.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID yang tidak dapat diubah dari akun Google Workspace.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
Kolom
deviceIds[]

string

Wajib. Daftar ID perangkat ChromeOS yang akan diubah. Maksimum 50.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

Wajib. Tindakan yang harus dilakukan pada perangkat ChromeOS untuk mengubah statusnya.
deprovisionReason

enum (DeprovisionReason)

Opsional. Alasan di balik pencabutan akses perangkat. Harus diberikan jika 'changeChromeOsDeviceStatusAction' disetel ke 'CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION'. Jika tidak, hapus kolom ini.

Isi respons

Respons atas perubahan status batch perangkat ChromeOS.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
Kolom
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

Hasil untuk setiap perangkat ChromeOS yang diberikan dalam permintaan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ChangeChromeOsDeviceStatusAction

Tindakan yang harus dilakukan untuk mengubah status perangkat ChromeOS.

Enum
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED Nilai default. Nilai tidak digunakan.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION Mencabut akses perangkat ChromeOS. Jika memiliki perangkat ChromeOS yang tidak lagi digunakan di organisasi, Anda harus mencabut akses perangkat tersebut sehingga Anda tidak lagi mengelolanya. Mencabut akses perangkat akan menghapus semua kebijakan yang ada di perangkat serta printer tingkat perangkat dan kemampuan untuk menggunakan perangkat sebagai kios. Bergantung pada upgrade yang dikaitkan dengan perangkat, tindakan ini mungkin melepaskan lisensi kembali ke kumpulan lisensi; yang memungkinkan Anda menggunakan lisensi di perangkat lain.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE Menonaktifkan perangkat ChromeOS. Gunakan tindakan ini jika pengguna kehilangan perangkat atau perangkatnya dicuri, sehingga perangkat tetap dikelola, sehingga tetap akan menerima kebijakan, tetapi tidak ada yang dapat menggunakannya. Bergantung pada upgrade yang dikaitkan dengan perangkat, tindakan ini mungkin melepaskan lisensi kembali ke kumpulan lisensi; yang memungkinkan Anda menggunakan lisensi di perangkat lain.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Mengaktifkan kembali perangkat ChromeOS untuk digunakan setelah dinonaktifkan. Mengaktifkan kembali perangkat setelah tidak hilang atau telah dipulihkan. Tindakan ini memungkinkan perangkat digunakan lagi. Bergantung pada upgrade yang terkait dengan perangkat, tindakan ini mungkin menggunakan satu lisensi dari kumpulan lisensi. Artinya, jika lisensi yang tersedia tidak mencukupi, operasi akan gagal.

ChangeChromeOsDeviceStatusResult

Hasil dari satu perangkat ChromeOS untuk operasi Ubah status.

Representasi JSON 
{
  "deviceId": string,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    object (ChangeChromeOsDeviceStatusSucceeded)
  }
  // End of list of possible types for union field result.
}
Kolom
deviceId

string

ID unik perangkat ChromeOS.

Kolom union result.

result hanya dapat berupa salah satu dari berikut:
error

object (Status)

Hasil error operasi jika terjadi kegagalan.
response

object (ChangeChromeOsDeviceStatusSucceeded)

Perangkat mungkin berhasil mengubah statusnya.

Status

Jenis Status menentukan model error logis yang cocok untuk berbagai lingkungan pemrograman, meliputi REST API dan RPC API. Jenis error ini digunakan oleh gRPC. Setiap pesan Status berisi tiga bagian data: kode error, pesan error, dan detail error.

Anda dapat mencari tahu lebih lanjut tentang model error ini dan cara penanganannya di Panduan Desain API.

Representasi JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Kolom
code

integer

Kode status, harus berupa nilai enum dari google.rpc.Code.
message

string

Pesan error yang ditampilkan ke developer dan seharusnya dalam bahasa Inggris. Setiap pesan error yang ditampilkan kepada pengguna harus dilokalkan dan dikirim di kolom google.rpc.Status.details, atau dilokalkan oleh klien.
details[]

object

Daftar pesan yang membawa detail error. Ada seperangkat jenis pesan umum untuk digunakan API.

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

ChangeChromeOsDeviceStatusSucceeded

Jenis ini tidak memiliki kolom.

Respons untuk perubahan status perangkat ChromeOS yang berhasil.