Method: customer.devices.chromeos.batchChangeStatus

Zmienia stan grupy urządzeń z ChromeOS. Więcej informacji o zmianie stanu urządzenia z ChromeOS znajdziesz w artykule Naprawa, zmiana zastosowania lub wycofywanie urządzeń z ChromeOS.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagane. Niezmienny identyfikator konta Google Workspace.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

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

string

Wymagane. Lista identyfikatorów urządzeń z ChromeOS, które mają zostać zmienione. Maksymalnie 50.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

Wymagane. Działanie, które należy wykonać na urządzeniu z ChromeOS, aby zmienić jego stan.
deprovisionReason

enum (DeprovisionReason)

Opcjonalnie: Powód wyrejestrowania urządzenia. Należy podać tę wartość, jeśli parametr „changeChromeOsDeviceStatusAction” ma wartość „CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION”. W przeciwnym razie pomiń to pole.

Treść odpowiedzi

Odpowiedź na zmianę stanu grupy urządzeń z ChromeOS.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
Pola
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

Wyniki dotyczące każdego urządzenia z ChromeOS podanego w żądaniu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.

ChangeChromeOsDeviceStatusAction

Działanie, które należy wykonać, aby zmienić stan urządzenia z ChromeOS.

Wartości w polu enum
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED Wartość domyślna. Wartość jest nieużywana.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION Wyrejestrowuje urządzenie z ChromeOS. Jeśli masz urządzenia z ChromeOS, które nie są już używane w organizacji, wyrejestruj je, aby przestać nimi zarządzać. Wyrejestrowanie urządzenia powoduje wycofanie wszystkich zasad, jakim ono podlegało, usunięcie drukarek ustawionych na poziomie urządzenia, a także uniemożliwia wykorzystanie go jako kiosku. W zależności od licencji powiązanej z urządzeniem to działanie może spowodować zwolnienie licencji z puli licencji, co pozwoli Ci użyć jej na innym urządzeniu.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE Wyłącza urządzenie z ChromeOS. Użyj tej opcji, jeśli użytkownik zgubi urządzenie lub ktoś je ukradnie. Urządzenie będzie nadal zarządzane, więc będzie nadal otrzymywać zasady, ale nikt nie będzie mógł z niego korzystać. W zależności od licencji powiązanej z urządzeniem to działanie może spowodować zwolnienie licencji z puli licencji, co pozwoli użyć jej na innym urządzeniu.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Włącza urządzenie z ChromeOS, które zostało wyłączone. Włącza urządzenie, gdy nie jest już zgubione lub zostało odzyskane. Dzięki temu można z niego ponownie korzystać. W zależności od uaktualnienia powiązanego z urządzeniem może to spowodować wykorzystanie jednej licencji z puli licencji. Oznacza to, że jeśli nie ma wystarczającej liczby dostępnych licencji, operacja się nie powiedzie.

ChangeChromeOsDeviceStatusResult

Wynik operacji zmiany stanu pojedynczego urządzenia z ChromeOS.

Zapis 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.
}
Pola
deviceId

string

Unikalny identyfikator urządzenia z ChromeOS.

Pole unii result.

result może być tylko jednym z tych elementów:
error

object (Status)

Wynik błędu operacji w przypadku niepowodzenia.
response

object (ChangeChromeOsDeviceStatusSucceeded)

Urządzenie mogło zmienić swój stan.

Stan

Typ Status definiuje model błędu logicznego, który jest odpowiedni dla różnych środowisk programowania, w tym interfejsów API REST i RPC. Jest używany przez gRPC. Każda wiadomość Status zawiera 3 elementy danych: kod błędu, komunikat o błędzie i szczegóły błędu.

Więcej informacji o tym modelu błędów i o tym, jak z niego korzystać, znajdziesz w przewodniku API Design Guide (w języku angielskim).

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

integer

Kod stanu, który powinien być wartością z enumeracji google.rpc.Code.
message

string

Komunikat o błędzie dla programisty, który powinien być w języku angielskim. Wszelkie komunikaty o błędach wyświetlane użytkownikowi powinny być zlokalizowane i wysyłane w polu google.rpc.Status.details lub zlokalizowane przez klienta.
details[]

object

Lista wiadomości zawierających szczegóły błędu. Interfejsy API mogą korzystać z wspólnego zestawu typów wiadomości.

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

ChangeChromeOsDeviceStatusSucceeded

Ten typ nie ma pól.

Odpowiedź na pomyślną zmianę stanu urządzenia z ChromeOS.