Method: mobiledevices.action
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Effectue une action qui affecte un appareil mobile. Par exemple, effacer les données d'un appareil à distance.
Requête HTTP
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile/{resourceId}/action
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
customerId |
string
Identifiant unique du compte Google Workspace du client. En tant qu'administrateur de compte, vous pouvez également utiliser l'alias my_customer pour représenter le customerId de votre compte. customerId est également renvoyé dans la ressource "Users".
|
resourceId |
string
Identifiant unique utilisé par le service d'API pour identifier l'appareil mobile.
|
Corps de la requête
Le corps de la requête contient une instance de MobileDeviceAction.
Corps de la réponse
Si la requête aboutit, la réponse est une réponse HTTP générique dont le format est défini par la méthode.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/admin.directory.device.mobile
https://www.googleapis.com/auth/admin.directory.device.mobile.action
Pour en savoir plus, consultez le guide d'autorisation.
MobileDeviceAction
| Représentation JSON |
{
"action": string
} |
| Champs |
action |
string
Action à effectuer sur l'appareil. Les valeurs acceptées sont les suivantes :
admin_remote_wipeadmin_account_wipeapproveblockcancel_remote_wipe_then_activatecancel_remote_wipe_then_block
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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` |"]]
