Method: customer.devices.chromeos.batchChangeStatus

Bir grup ChromeOS cihazın durumunu değiştirir. ChromeOS cihazlarının durumunu değiştirme hakkında daha fazla bilgi için ChromeOS cihazları onarma, yeniden kullanma 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 değişmeyen kimliği.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

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

string

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

enum (ChangeChromeOsDeviceStatusAction)

Zorunlu. ChromeOS cihazın durumunu değiştirmek için yapılması gereken işlem.
deprovisionReason

enum (DeprovisionReason)

İsteğe bağlı. Cihazın temel hazırlığının kaldırılma nedeni. "changeChromeOsDeviceStatusAction", "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION" olarak ayarlanmışsa sağlanmalıdır. Aksi takdirde bu alanı çıkarın.

Yanıt gövdesi

Bir grup ChromeOS cihazın durumunu değiştirmeyle ilgili 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 belirtilen her ChromeOS cihazın 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 bakın.

ChangeChromeOsDeviceStatusAction

Bir ChromeOS cihazın durumunu değiştirmek için yapılacak işlem.

Sıralamalar
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED Varsayılan değer. Değer kullanılmaz.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION ChromeOS cihazın temel hazırlığını kaldırır. Kuruluşunuzda kullanım dışı kalmış 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 ve cihaz düzeyindeki yazıcılar kaldırılır. Ayrıca cihaz bundan böyle kiosk olarak kullanılamaz. Cihazla ilişkili yükseltmeye bağlı olarak bu işlem, lisansı lisans havuzuna geri bırakabilir. Bu sayede lisansı farklı bir cihazda kullanabilirsiniz.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE ChromeOS cihazı devre dışı bırakır. Kullanıcı cihazını kaybederse veya cihaz çalınırsa bu işlemi kullanın. Bu işlem, cihazın yönetilmeye devam etmesini sağlar. Böylece cihaz politika almaya devam eder ancak kimse cihazı kullanamaz. Cihazla ilişkili yükseltmeye bağlı olarak bu işlem, lisansı lisans havuzuna geri bırakabilir. Bu sayede lisansı farklı bir cihazda kullanabilirsiniz.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Devre dışı bırakılan bir ChromeOS cihazını yeniden etkinleştirerek kullanılmasını sağlar. Cihaz kaybolduğunda veya bulunduğunda yeniden etkinleştirilir. Bu sayede cihaz tekrar kullanılabilir. Cihazla ilişkili yükseltmeye bağlı olarak bu işlem, lisans havuzundan bir lisans tüketebilir. Yani yeterli 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.

Birlik alanı result.

result yalnızca aşağıdakilerden biri olabilir:
error

object (Status)

Başarısızlık durumunda işlemin hata sonucu.
response

object (ChangeChromeOsDeviceStatusSucceeded)

Cihazın durumu başarıyla değiştirildi.

Durum

Status türü, REST API'leri ve RPC API'leri dahil olmak üzere farklı programlama ortamlarına uygun mantıksal bir 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 bu modelle nasıl çalışacağınız 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

Durum kodu (google.rpc.Code değerine sahip bir enum değeri olmalıdır).
message

string

Geliştiricilere yönelik, İngilizce bir hata mesajı. Kullanıcılara yönelik tüm hata mesajları yerelleştirilmeli ve 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 ortak bir mesaj türü grubu vardır.

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

ChangeChromeOsDeviceStatusSucceeded

Bu türde alan yoktur.

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