Method: chromeosdevices.action

Użyj zamiast niej BatchChangeChromeOsDeviceStatus. Wykonuje czynność, która wpływa na urządzenie z Chrome OS. Obejmuje to wyrejestrowywanie, wyłączanie i ponowne włączanie urządzeń.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Unikalny identyfikator konta Google Workspace klienta. Jako administrator konta możesz też używać aliasu my_customer do reprezentowania grupy customerId swojego konta. Wartość customerId jest też zwracana w ramach zasobu Użytkownicy.
resourceId

string

Unikalny identyfikator urządzenia. Wartości resourceId są zwracane w odpowiedzi z metody chromeosdevices.list.

Treść żądania

Treść żądania zawiera wystąpienie elementu ChromeOsDeviceAction.

Treść odpowiedzi

Jeśli operacja się uda, odpowiedź będzie ogólną odpowiedzią HTTP, której format jest zdefiniowany przez tę metodę.

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.

ChromeOsDeviceAction

Dane o aktualizacji stanu urządzenia z Chrome OS.

Zapis JSON 
{
  "action": string,
  "deprovisionReason": string
}
Pola
action

string

chromeosdevices.action na urządzeniu z Chrome OS.

Dopuszczalne wartości:

  • deprovision: usuń z funkcji zarządzania urządzenie, które nie jest już aktywne, ma zostać odsprzedane albo przesłane do zwrotu / naprawy, użyj czynności wyrejestrowania, aby odłączyć je od zarządzania.
  • disable: jeśli uważasz, że urządzenie należące do Twojej organizacji zostało zgubione lub skradzione, możesz je wyłączyć, aby nikt nie mógł go używać. Gdy urządzenie jest wyłączone, po jego włączeniu użytkownik widzi tylko ekran z informacją o tym, że dane urządzenie jest wyłączone, oraz o tym, dokąd chcesz zwrócić urządzenie.
  • reenable: w przypadku gdy zgubione urządzenie się znajdzie lub zostanie zwrócone, możesz ponownie włączyć wyłączone urządzenie. Możesz też użyć tej funkcji, jeśli przypadkowo oznaczysz urządzenie z Chrome jako wyłączone.
  • pre_provisioned_disable: urządzenie gotowe do obsługi administracyjnej, którego nie można zarejestrować. Administrator może ponownie włączyć na urządzeniu możliwość rejestracji typu zero-touch, zmieniając stan na „pre_provisioned_reenable”. Uwaga: w tym stanie urządzenie można wyrejestrować.
  • pre_provisioned_reenable: urządzenie zostało wstępnie przygotowane do obsługi administracyjnej przez producentów OEM. Urządzenia w tym stanie kwalifikują się do rejestracji typu zero-touch.
deprovisionReason

string

Używany tylko wtedy, gdy działanie zostanie wyrejestrowane. To pole jest wymagane podczas wyrejestrowania.

Dopuszczalne wartości:

  • different_model_replacement: użyj w przypadku wymiany lub wymiany urządzenia na nowszy model tego samego urządzenia.
  • retiring_device: użyj, jeśli odsprzedajesz urządzenie, przekazujesz je w ramach darowizny lub wycofujesz z użycia.
  • same_model_replacement: użyj tej opcji, jeśli w urządzeniu wystąpił problem sprzętowy i jest ono wymieniane na ten sam model lub na podobny model u sprzedawcy lub producenta.
  • upgrade_transfer: użyj tej opcji, jeśli w ciągu roku zastąpisz urządzenia działające w chmurze Chromebookami.