Method: chromeosdevices.action

Verwenden Sie stattdessen BatchChangeChromeOsDeviceStatus. Eine Aktion, die ein Chrome OS-Gerät betrifft Dazu gehört auch die Aufhebung der Bereitstellung und die Deaktivierung und erneute Aktivierung von Geräten.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Die eindeutige ID des Google Workspace-Kontos des Kunden. Als Kontoadministrator können Sie auch den my_customer-Alias verwenden, um die customerId Ihres Kontos darzustellen. Das customerId wird auch als Teil der Nutzerressource zurückgegeben.
resourceId

string

Die eindeutige ID des Geräts. Die resourceIds werden in der Antwort der Methode chromeosdevices.list zurückgegeben.

Anfragetext

Der Anfragetext enthält eine Instanz von ChromeOsDeviceAction.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, ist die Antwort eine allgemeine HTTP-Antwort, deren Format von der Methode vorgegeben wird.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

ChromeOsDeviceAction

Daten zu einem Update des Status eines Chrome OS-Geräts.

JSON-Darstellung 
{
  "action": string,
  "deprovisionReason": string
}
Felder
action

string

chromeosdevices.action auf dem Chrome OS-Gerät.

Akzeptable Werte sind:

  • deprovision: Entfernen Sie ein Gerät aus der Verwaltung, das nicht mehr aktiv ist, wiederverkauft oder für die Rückgabe oder Reparatur eingereicht wird, können Sie die Bereitstellung aufheben, um es von der Verwaltung zu trennen.
  • disable: Wenn Sie vermuten, dass ein Gerät in Ihrer Organisation verloren gegangen ist oder gestohlen wurde, können Sie es deaktivieren, damit es von niemand anderem verwendet werden kann. Wenn ein Gerät deaktiviert ist, sieht der Nutzer beim Einschalten des Chrome-Geräts nur einen Bildschirm mit der Meldung, dass das Gerät deaktiviert wurde, und der gewünschten Kontaktinformationen für die Rückgabe des Geräts.
  • reenable: Deaktiviertes Gerät wieder aktivieren, wenn ein verlegtes Gerät gefunden oder ein verlorenes Gerät zurückgegeben wird. Sie können diese Funktion auch verwenden, wenn Sie ein Chrome-Gerät versehentlich als deaktiviert markiert haben.
  • pre_provisioned_disable: Ein vorab bereitgestelltes Gerät, das nicht registriert werden kann. Ein Administrator kann das Gerät wieder aktivieren, um die Zero-Touch-Registrierung zu ermöglichen, indem er den Status in „pre_provisioned_reenable“ ändert. Hinweis: Ab diesem Status kann die Bereitstellung des Geräts aufgehoben werden.
  • pre_provisioned_reenable: Das Gerät wird von OEMs vorab bereitgestellt. Geräte mit diesem Status können für die Zero-Touch-Registrierung verwendet werden.
deprovisionReason

string

Wird nur verwendet, wenn die Aktion das Aufheben der Bereitstellung ist. Bei der Aktion zum Aufheben der Bereitstellung ist dieses Feld ein Pflichtfeld.

Akzeptable Werte sind:

  • different_model_replacement: Verwenden Sie diese Option, wenn Sie ein Upgrade Ihres Geräts durch ein neueres Modell desselben Geräts durchführen oder es durch ein neueres Modell ersetzen möchten.
  • retiring_device: Verwenden Sie diese Option, wenn Sie das Gerät weiterverkaufen, spenden oder das Gerät dauerhaft nicht mehr verwenden möchten.
  • same_model_replacement: Verwenden Sie diese Option, wenn bei einem Gerät ein Hardwareproblem aufgetreten ist und es durch dasselbe Modell oder durch ein ähnliches Modell von einem Reparaturanbieter / Hersteller ersetzt wird.
  • upgrade_transfer: Verwenden Sie diese Option, wenn Sie Ihre cloudfähigen Geräte innerhalb eines Jahres durch Chromebooks ersetzen möchten.