Method: chromeosdevices.action

Verwenden Sie stattdessen BatchChangeChromeOsDeviceStatus. eine Aktion tätigt, die ein Chrome OS-Gerät betrifft. Dazu gehört auch, dass Sie die Bereitstellung von Geräten aufheben oder sie deaktivieren und wieder aktivieren.

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 für das Google Workspace-Konto des Kunden. Als Kontoadministrator können Sie auch den Alias my_customer verwenden, um die customerId Ihres Kontos darzustellen. customerId wird auch als Teil der Nutzerressource zurückgegeben.
resourceId

string

Die eindeutige ID des Geräts. Die resourceIds werden in der Antwort der chromeosdevices.list-Methode 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 für das Chrome OS-Gerät.

Akzeptable Werte sind:

  • deprovision: Entfernen Sie ein Gerät aus der Verwaltung, das nicht mehr aktiv ist, weiterverkauft oder zur Rückgabe oder Reparatur eingereicht wird. Mit der Aktion „Bereitstellung aufheben“ heben Sie die Verwaltung auf.
  • 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, sowie die gewünschten Kontaktdaten, an die das Gerät zurückgegeben werden soll.
  • reenable: Ein deaktiviertes Gerät wird wieder aktiviert, wenn ein verlegtes Gerät gefunden oder 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 für die Zero-Touch-Registrierung wieder aktivieren, 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 Bereitstellung der Aktion aufgehoben wird. Beim Aufheben der Bereitstellung ist dieses Feld erforderlich.

Akzeptable Werte sind:

  • different_model_replacement: Wählen Sie diese Option, wenn Sie Ihr Gerät upgraden oder durch ein neueres Modell desselben Geräts ersetzen möchten.
  • retiring_device: Verwenden Sie diese Option, wenn Sie das Gerät weiterverkaufen, spenden oder dauerhaft entfernen möchten.
  • same_model_replacement: Verwenden Sie diese Option, wenn ein Hardwareproblem bei einem Gerät aufgetreten ist und es durch dasselbe Modell oder ein Ersatzgerät eines ähnlichen Modells von einem Reparaturanbieter oder ‐hersteller ersetzt wird.
  • upgrade_transfer: Wählen Sie diese Option, wenn Sie Ihre cloudfähigen Geräte innerhalb eines Jahres durch Chromebooks ersetzen möchten.