Method: customer.devices.chromeos.batchChangeStatus

Mengubah status batch perangkat ChromeOS. Untuk mengetahui informasi selengkapnya tentang cara mengubah status perangkat ChromeOS Memperbaiki, memodifikasi, atau menghentikan 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 akun Google Workspace yang tidak dapat diubah.

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 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 untuk mengubah status sekumpulan 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:

  • 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 Anda memiliki perangkat ChromeOS yang tidak lagi digunakan di organisasi, Anda harus mencabut akses perangkat tersebut sehingga Anda tidak lagi mengelolanya. Pencabutan 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 akan melepaskan lisensi kembali ke kumpulan lisensi; sehingga Anda dapat menggunakan lisensi di perangkat yang berbeda.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE Menonaktifkan perangkat ChromeOS. Gunakan tindakan ini jika pengguna kehilangan perangkat atau perangkatnya dicuri, dengan begitu perangkat masih dikelola, sehingga tetap akan menerima kebijakan, tetapi tidak ada yang dapat menggunakannya. Bergantung pada upgrade yang dikaitkan dengan perangkat, tindakan ini mungkin akan melepaskan lisensi kembali ke kumpulan lisensi; sehingga Anda dapat menggunakan lisensi di perangkat yang berbeda.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Mengaktifkan kembali perangkat ChromeOS untuk digunakan setelah dinonaktifkan. Mengaktifkan kembali perangkat setelah tidak lagi hilang atau telah dipulihkan. Tindakan ini memungkinkan perangkat digunakan kembali. Bergantung pada upgrade yang dikaitkan dengan perangkat, hal ini mungkin menggunakan satu lisensi dari kumpulan lisensi, yang berarti jika tidak tersedia cukup lisensi, 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 yang berikut:
error

object (Status)

Hasil error operasi jika terjadi kegagalan.
response

object (ChangeChromeOsDeviceStatusSucceeded)

Perangkat 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.