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 |
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 ( |
Pola | |
---|---|
deviceIds[] |
To pole jest wymagane. Lista identyfikatorów urządzeń z ChromeOS do zmiany. Maksymalnie 50. |
changeChromeOsDeviceStatusAction |
To pole jest wymagane. Działanie, które należy wykonać na urządzeniu z ChromeOS, aby zmienić jego stan. |
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 ( |
Pola | |
---|---|
changeChromeOsDeviceStatusResults[] |
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 |
Pola | |
---|---|
deviceId |
Unikalny identyfikator urządzenia z ChromeOS. |
Pole sumy
|
|
error |
Wynik błędu operacji w przypadku niepowodzenia. |
response |
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 |
Kod stanu, który powinien być wartością wyliczeniową |
message |
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 |
details[] |
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 |
ChangeChromeOsDeviceStatusSucceeded
Ten typ nie ma pól.
Odpowiedź na informację o udanej zmianie stanu urządzenia z ChromeOS.