Method: chromeosdevices.action

Zamiast tego użyj polecenia BatchChangeChromeOsDeviceStatus. Podejmuje działanie wpływające 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 domeny 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 systemu zarządzania urządzenie, które nie jest już aktywne, jest odsprzedane lub jest przesyłane do zwrotu albo naprawy. Użyj działania wyrejestrowania, aby usunąć powiązanie urządzenia z zarządzaniem.
  • disable: jeśli uważasz, że urządzenie z Twojej organizacji zostało zgubione lub skradzione, możesz je wyłączyć, by nikt inny nie mógł z niego korzystać. Gdy urządzenie z Chrome jest wyłączone, po jego włączeniu użytkownik widzi tylko ekran z informacją o tym, że zostało wyłączone, oraz wybrane informacje kontaktowe dotyczące miejsca zwrotu urządzenia.
  • reenable: ponowne włączenie wyłączonego urządzenia po znalezieniu zgubionego urządzenia lub zwróceniu utraconego 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że zostać wyrejestrowane.
  • 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 podczas wyrejestrowania działania. W przypadku działania odzyskiwania 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, jeśli w urządzeniu wystąpił problem ze sprzętem i jest ono wymieniane na ten sam model lub na zamiennik zgodny z modelem dostarczonym przez dostawcę naprawy.
  • upgrade_transfer: wybierz tę opcję, jeśli zamierzasz zastąpić urządzenia CloudReady Chromebookami w ciągu roku.