Method: customer.devices.chromeos.batchChangeStatus

Bir grup ChromeOS cihazın durumunu değiştirir. ChromeOS cihaz durumunu değiştirme hakkında daha fazla bilgi için ChromeOS cihazları onarıma gönderme, başka amaçlarla kullanıma hazırlama veya kullanımdan kaldırma başlıklı makaleyi inceleyin.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Google Workspace hesabının sabit kimliği.

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
Alanlar
deviceIds[]

string

Zorunlu. Değiştirilecek ChromeOS cihazların kimliklerinin listesi. Maksimum 50.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

Zorunlu. ChromeOS cihazda, durumunu değiştirmek için yapılacak işlem.
deprovisionReason

enum (DeprovisionReason)

İsteğe bağlı. Bir cihazın temel hazırlığının kaldırılmasının nedeni. "changeChromeOsDeviceStatusAction" "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION" olarak ayarlanmışsa sağlanmalıdır. Aksi takdirde bu alanı atlayın.

Yanıt gövdesi

Bir grup ChromeOS cihazın durumunu değiştirme yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
Alanlar
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

İstekte sağlanan ChromeOS cihazların her biri için sonuçlar.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.

ChangeChromeOsDeviceStatusAction

ChromeOS cihazın durumunu değiştirmek için gerçekleştirilen işlem.

Sıralamalar
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED Varsayılan değer. Değer kullanılmıyor.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION Bir ChromeOS cihazın temel hazırlığını kaldırır. Kuruluşunuzda artık kullanılmayan ChromeOS cihazlarınız varsa, artık yönetmediğiniz bu cihazların temel hazırlığını kaldırmanız gerekir. Cihazın temel hazırlığı kaldırıldığında cihazdaki tüm politikalar, cihaz düzeyindeki yazıcılar ve cihazı kiosk olarak kullanma özelliği kaldırılır. Cihazla ilişkili yükseltmeye bağlı olarak, bu işlem, lisansın farklı bir cihazda kullanılmasına olanak tanıyan lisans havuzuna geri yüklenebilir.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE ChromeOS cihazı devre dışı bırakır. Kullanıcı cihazı kaybederse veya çalınırsa bu işlemi kullanın. Bu durumda, cihaz hâlâ yönetilen cihaz durumunda olacak ve cihaz politikaları almaya devam edecektir ancak cihazı kimse kullanamaz. Cihazla ilişkili yükseltmeye bağlı olarak, bu işlem, lisansın farklı bir cihazda kullanılmasına olanak tanıyan lisans havuzuna geri yüklenebilir.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Devre dışı bırakıldıktan sonra ChromeOS cihazı yeniden etkinleştirir. Cihazınız artık kaybolmadığında veya kurtarıldığında yeniden etkinleştirilir. Bu, cihazın tekrar kullanılmasına olanak tanır. Cihazla ilişkilendirilmiş yükseltme işlemine bağlı olarak, lisans havuzundaki bir lisans kullanılabilir. Bu durumda, yeterli sayıda lisans yoksa işlem başarısız olur.

ChangeChromeOsDeviceStatusResult

Durumu değiştirme işlemi için tek bir ChromeOS cihazın sonucu.

JSON gösterimi 
{
  "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.
}
Alanlar
deviceId

string

ChromeOS cihazın benzersiz kimliği.

result alanı.

result şunlardan yalnızca biri olabilir:
error

object (Status)

Hata olması durumunda işlemin hata sonucu.
response

object (ChangeChromeOsDeviceStatusSucceeded)

Cihaz, durumunu başarılı bir şekilde değiştirebilir.

Durum

Status türü, REST API'ler ve RPC API'leri dahil olmak üzere farklı programlama ortamları için uygun bir mantıksal hata modeli tanımlar. gRPC tarafından kullanılır. Her Status mesajı üç veri parçası içerir: hata kodu, hata mesajı ve hata ayrıntıları.

Bu hata modeli ve modelle nasıl çalışılacağı hakkında daha fazla bilgiyi API Tasarım Kılavuzu'nda bulabilirsiniz.

JSON gösterimi 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Alanlar
code

integer

google.rpc.Code değerinin enum değeri olması gereken durum kodu.
message

string

Geliştiricinin karşılaştığı İngilizce hata mesajı. Kullanıcılara yönelik tüm hata mesajları yerelleştirilip google.rpc.Status.details alanında gönderilmeli veya istemci tarafından yerelleştirilmelidir.
details[]

object

Hata ayrıntılarını içeren mesajların listesi. API'lerin kullanabileceği yaygın bir dizi mesaj türü vardır.

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

ChangeChromeOsDeviceStatusSucceeded

Bu türde alan yok.

Başarılı bir ChromeOS cihaz durumu değişikliğinin yanıtı.