Method: enterprises.devices.executeCommand
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Führt einen Befehl auf dem Gerät aus, das vom Unternehmen verwaltet wird.
HTTP-Anfrage
POST https://smartdevicemanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:executeCommand
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
name |
string
Der Name des angeforderten Geräts. Beispiel: „enterprises/XYZ/devices/123“.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
{
"command": string,
"params": {
object
}
} |
| Felder |
command |
string
Der auszuführende Befehlsname, dargestellt durch den voll qualifizierten protobuf-Nachrichtennamen.
|
params |
object (Struct format)
Die auszuführende Befehlsnachricht, dargestellt als Struktur.
|
Antworttext
Antwortnachricht für SmartDeviceManagementService.ExecuteDeviceCommand
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"results": {
object
}
} |
| Felder |
results |
object (Struct format)
Die Ergebnisse der Ausführung des Befehls.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/sdm.service
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
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)."],[[["\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)."]]
