Method: enterprises.devices.executeCommand
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Exécute une commande sur l'appareil géré par l'entreprise.
Requête HTTP
POST https://smartdevicemanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:executeCommand
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
name |
string
Nom de l'appareil demandé. Par exemple : "enterprises/XYZ/devices/123".
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Représentation JSON |
{
"command": string,
"params": {
object
}
} |
| Champs |
command |
string
Nom de la commande à exécuter, représenté par le nom complet du message protobuf.
|
params |
object (Struct format)
Message de commande à exécuter, représenté par un objet Struct.
|
Corps de la réponse
Message de réponse pour SmartDeviceManagementService.ExecuteDeviceCommand
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"results": {
object
}
} |
| Champs |
results |
object (Struct format)
Résultats de l'exécution de la commande
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/sdm.service
Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
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)."],[[["\u003cp\u003eExecutes a specified command on a device managed by the enterprise using an HTTP POST request.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires the command name and parameters, formatted as a JSON object.\u003c/p\u003e\n"],["\u003cp\u003eThe response body provides the command execution results, also formatted as a JSON object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/sdm.service\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: enterprises.devices.executeCommand\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ExecuteDeviceCommandResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n\nExecutes a command to device managed by the enterprise.\n\n### HTTP request\n\n`POST https://smartdevicemanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:executeCommand`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|---------------------------------------------------------------------------------------|\n| `name` | `string` The name of the device requested. For example: \"enterprises/XYZ/devices/123\" |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------|\n| ``` { \"command\": string, \"params\": { object } } ``` |\n\n| Fields ||\n|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `command` | `string` The command name to execute, represented by the fully qualified protobuf message name. |\n| `params` | `object (`[Struct](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Struct)` format)` The command message to execute, represented as a Struct. |\n\n### Response body\n\nResponse message for SmartDeviceManagementService.ExecuteDeviceCommand\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------|\n| ``` { \"results\": { object } } ``` |\n\n| Fields ||\n|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `results` | `object (`[Struct](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Struct)` format)` The results of executing the command. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/sdm.service`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
