Method: chromeosdevices.action

Zamiast tego użyj funkcji BatchChangeChromeOsDeviceStatus. Wykonywanie czynności dotyczących urządzenia z ChromeOS. Obejmuje to odprovisionowanie, wyłączenie i ponowne włączenie 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żyć aliasu my_customer, aby reprezentować customerId na Twoim koncie. Wartość customerId jest też zwracana w ramach zasobu Users.
resourceId

string

Unikalny identyfikator urządzenia. Parametry resourceId są zwracane w odpowiedzi przez metodę chromeosdevices.list.

Treść żądania

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

Treść odpowiedzi

W przypadku powodzenia odpowiedź jest ogólną odpowiedzią HTTP, której format jest zdefiniowany przez metodę.

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.

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 ChromeOS.

Akceptowane wartości:

  • deprovision: usuń z zarządzania urządzenie, które nie jest już aktywne, zostało sprzedane lub zostało wysłane do zwrotu lub naprawy. Użyj działania wyrejestrowania, aby odłączyć je od zarządzania.
  • disable: jeśli uważasz, że urządzenie w Twojej organizacji zostało zgubione lub skradzione, możesz je wyłączyć, aby nikt nie mógł z niego korzystać. Gdy urządzenie z Chrome jest wyłączone, użytkownik widzi tylko ekran z informacją o wyłączeniu i danymi kontaktowymi, pod którymi może zwrócić urządzenie.
  • reenable: ponowne włączenie wyłączonego urządzenia po znalezieniu lub zwróceniu zgubionego urządzenia. Możesz też użyć tej funkcji, jeśli przypadkowo wyłączysz urządzenie z Chrome.
  • pre_provisioned_disable: urządzenie przygotowane do obsługi administracyjnej, które nie może się zarejestrować. Administrator może ponownie włączyć urządzenie, aby umożliwić rejestrację typu zero-touch, zmieniając stan na „pre_provisioned_reenable”. Uwaga: w tym stanie urządzenie można wyrejestrować.
  • pre_provisioned_reenable: urządzenie jest wstępnie skonfigurowane przez producenta. Urządzenia w tym stanie kwalifikują się do rejestracji typu zero-touch.
deprovisionReason

string

Używany tylko wtedy, gdy działaniem jest cofnięcie uprawnień. W przypadku działania anulowania udostępnienia to pole jest wymagane.

Akceptowane wartości:

  • different_model_replacement: wybierz tę opcję, jeśli wymieniasz urządzenie na nowszy model tego samego typu.
  • retiring_device: Użyj tej opcji, jeśli sprzedajesz urządzenie, przekazujesz je w ramach darowizny lub wycofujesz z użycia.
  • same_model_replacement: użyj tego parametru, jeśli wystąpił problem ze sprzętem i urządzenie jest wymieniane na urządzenie tego samego modelu lub na urządzenie podobne do urządzenia od dostawcy lub producenta.
  • upgrade_transfer: wybierz tę opcję, jeśli w ciągu roku zamierzasz zastąpić urządzenia CloudReady Chromebookami.