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 używanie 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

To pole jest 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

To pole jest wymagane. Lista identyfikatorów urządzeń z ChromeOS do zmiany. Maksymalnie 50.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

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

enum (DeprovisionReason)

Opcjonalnie. Przyczyna wyrejestrowania urządzenia. Należy go podać, jeśli parametr „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 dla 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 po autoryzacji.

ChangeChromeOsDeviceStatusAction

Działanie, które ma zostać wykonane, 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 zasad, które były na nim ustawione, a także drukarek na poziomie urządzenia i możliwość używania urządzenia jako 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 umożliwi używanie jej na innym urządzeniu.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE Wyłącza urządzenie z ChromeOS. Wykonaj tę czynność, jeśli użytkownik zgubi urządzenie lub zostanie ono skradzione. Dzięki temu urządzenie będzie nadal zarządzane i 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 powrotem do puli licencji, co umożliwi używanie jej na innym urządzeniu.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Ponownie włącza urządzenie z ChromeOS do używania po jego wyłączeniu. Ponownie aktywuje urządzenie, gdy już nie utracisz go lub zostanie przywrócone. Dzięki temu będzie można ponownie z niego korzystać. W zależności od licencji powiązanej z urządzeniem może to spowodować wykorzystanie jednej licencji z puli licencji. Oznacza to, że jeśli nie ma wystarczającej liczby licencji, operacja nie powiedzie się.

ChangeChromeOsDeviceStatusResult

Wynik operacji zmiany stanu dotyczącej 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 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 definiuje model błędu logicznego, który jest odpowiedni dla różnych środowisk programowania, w tym interfejsów API REST i interfejsów API RPC. Jest używany przez gRPC. Każdy komunikat Status zawiera 3 rodzaje danych: kod błędu, komunikat o błędzie i szczegóły błędu.

Więcej informacji o tym modelu błędu i o tym, jak z nim korzystać, znajdziesz w dokumencie 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ą google.rpc.Code.
message

string

Komunikat o błędzie widoczny dla dewelopera w języku angielskim. Każdy komunikat o błędzie widoczny dla użytkownika powinien być zlokalizowany i wysyłany w polu google.rpc.Status.details lub zlokalizowany przez klienta.
details[]

object

Lista komunikatów zawierających szczegółowe informacje o błędzie. Istnieje wspólny zestaw typów wiadomości używanych przez 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 ma pól.

Odpowiedź na informację o udanej zmianie stanu urządzenia z ChromeOS.