Method: chromeosdevices.action

Verwenden Sie stattdessen BatchChangeChromeOsDeviceStatus. eine Aktion tätigt, die ein Chrome OS-Gerät betrifft. Dazu gehören die Deaktivierung und Reaktivierung 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 für das Google Workspace-Konto des Kunden. Als Kontoadministrator können Sie auch den Alias my_customer verwenden, um die customerId Ihres Kontos zu repräsentieren. Die customerId wird auch als Teil der Ressource „Nutzer“ 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 einer Aktualisierung des Status eines ChromeOS-Geräts.

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

string

chromeosdevices.action, die auf dem ChromeOS-Gerät ausgeführt werden soll.

Akzeptable Werte sind:

  • deprovision: Wenn Sie ein Gerät aus der Verwaltung entfernen möchten, das nicht mehr aktiv ist, weiterverkauft wird oder zur Rückgabe oder Reparatur eingesendet wird, verwenden Sie die Aktion „Bereitstellung aufheben“, um die Verknüpfung mit der Verwaltung aufzuheben.
  • disable: Wenn Sie der Meinung sind, 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, auf dem ihm mitgeteilt wird, dass es deaktiviert wurde, und Ihre gewünschten Kontaktdaten, unter denen das Gerät zurückgegeben werden kann.
  • 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 wieder aktivieren, um die Zero-Touch-Registrierung zuzulassen, indem er den Status in „pre_provisioned_reenable“ ändert. Hinweis: In diesem Status kann die Bereitstellung des Geräts aufgehoben werden.
  • pre_provisioned_reenable: Das Gerät wird vom OEM vorab bereitgestellt. Geräte in diesem Status sind für die Zero-Touch-Registrierung geeignet.
deprovisionReason

string

Wird nur verwendet, wenn die Aktion die Deaktivierung ist. Bei der Deaktivierung ist dieses Feld erforderlich.

Akzeptable Werte sind:

  • different_model_replacement: Verwenden Sie diese Option, wenn Sie Ihr Gerät durch ein neueres Modell desselben Geräts ersetzen.
  • 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 bei einem Gerät ein Hardwareproblem aufgetreten ist und es durch dasselbe Modell oder ein ähnliches Modell von einem Reparaturanbieter / Hersteller ersetzt wird.
  • upgrade_transfer: Verwenden Sie diese Option, wenn Sie Ihre Cloud Ready-Geräte innerhalb eines Jahres durch Chromebooks ersetzen.