Method: mobiledevices.action
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Eine Aktion wird ausgeführt, die sich auf ein Mobilgerät auswirkt. Beispielsweise können Sie die Daten auf einem Gerät aus der Ferne löschen.
HTTP-Anfrage
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile/{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, mit der der API-Dienst das Mobilgerät identifiziert.
|
Anfragetext
Der Anfragetext enthält eine Instanz von MobileDeviceAction.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, ist die Antwort eine allgemeine HTTP-Antwort, deren Format von der Methode vorgegeben wird.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/admin.directory.device.mobile
https://www.googleapis.com/auth/admin.directory.device.mobile.action
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
MobileDeviceAction
| JSON-Darstellung |
{
"action": string
} |
| Felder |
action |
string
Die Aktion, die auf dem Gerät ausgeführt werden soll. Akzeptable Werte sind:
admin_remote_wipeadmin_account_wipeapproveblockcancel_remote_wipe_then_activatecancel_remote_wipe_then_block
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# Method: mobiledevices.action\n\nTakes an action that affects a mobile device. For example, remotely wiping a device.\n\n### HTTP request\n\n`POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}/action`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](https://developers.google.com/workspace/admin/directory/v1/reference/users). |\n| `resourceId` | `string` The unique ID the API service uses to identify the mobile device. |\n\n### Request body\n\nThe request body contains an instance of [MobileDeviceAction](/workspace/admin/directory/reference/rest/v1/mobiledevices/action#MobileDeviceAction).\n\n### Response body\n\nIf successful, the response is a generic HTTP response whose format is defined by the method.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admin.directory.device.mobile`\n- `\n https://www.googleapis.com/auth/admin.directory.device.mobile.action`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nMobileDeviceAction\n------------------\n\n| JSON representation |\n|------------------------------|\n| ``` { \"action\": string } ``` |\n\n| Fields ||\n|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `action` | `string` \u003cbr /\u003e The action to be performed on the device. Acceptable values are: - `admin_remote_wipe` - `admin_account_wipe` - `approve` - `block` - `cancel_remote_wipe_then_activate` - `cancel_remote_wipe_then_block` |"]]
