Method: customer.devices.chromeos.batchChangeStatus

Zmienia stan grupy urządzeń z ChromeOS. Więcej informacji o zmienianiu stanu urządzenia z ChromeOS znajdziesz w artykule Naprawianie, ponowne wykorzystanie i 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. Stały 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. Ta wartość jest wymagana, jeśli „changeChromeOsDeviceStatusAction” ma wartość „CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION”. W przeciwnym razie pomiń to pole.

Treść odpowiedzi

Odpowiedź dotycząca zmiany 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 z urządzeń z ChromeOS podanych 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 na temat 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ść nie jest uż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 nie były zarządzane. Wyrejestrowanie urządzenia powoduje usunięcie wszystkich zawartych na nim zasad i drukarek na poziomie urządzenia, a także możliwość używania urządzenia w trybie kiosku. W zależności od licencji powiązanej z urządzeniem to działanie może spowodować zwolnienie licencji z powrotem do puli licencji. co pozwala korzystać z licencji na innym urządzeniu.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE Wyłącza urządzenie z ChromeOS. Wykonaj tę czynność w przypadku utraty urządzenia lub kradzieży urządzenia – dzięki temu urządzenie nadal będzie zarządzane i będzie 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 powrotem do puli licencji. co pozwala korzystać z licencji na innym urządzeniu.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Ponownie włącza używanie urządzenia z ChromeOS po jego wyłączeniu. Ponowne włączenie urządzenia, gdy będzie już zgubione lub odzyskane. Umożliwi to ponowne korzystanie z urządzenia. W zależności od licencji powiązanej z urządzeniem może to spowodować użycie 1 licencji z puli licencji, co oznacza, że jeśli nie ma wystarczającej liczby licencji, operacja się nie powiedzie.

ChangeChromeOsDeviceStatusResult

Wynik operacji zmiany stanu na jednym urządzeniu 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 sumy result.

result może mieć tylko jedną z tych wartości:
error

object (Status)

Wynik błędu operacji w przypadku niepowodzenia.
response

object (ChangeChromeOsDeviceStatusSucceeded)

Udało się zmienić stan urządzenia.

Stan

Typ Status określa logiczny model błędów odpowiedni dla różnych środowisk programowania, w tym interfejsów API typu REST i RPC. Jest używany przez gRPC. Każdy komunikat Status zawiera 3 elementy danych: kod błędu, komunikat o błędzie i szczegóły błędu.

Więcej informacji na temat tego modelu błędów i sposobu jego działania 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ą wyliczeniową równą google.rpc.Code.
message

string

komunikat o błędzie widoczny dla dewelopera. Powinien być w języku angielskim; Każdy komunikat o błędzie widoczny dla użytkowników powinien zostać zlokalizowany i wysłany w polu google.rpc.Status.details lub zlokalizowany przez klienta.
details[]

object

Lista komunikatów ze szczegółami błędu. Istnieje typowy zestaw typów wiadomości, których mogą używać interfejsy API.

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 zawiera pól.

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