Method: enterprises.devices.executeCommand
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kuruluş tarafından yönetilen cihazda bir komut yürütür.
HTTP isteği
POST https://smartdevicemanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:executeCommand
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
name |
string
İstenen cihazın adı. Örneğin: "enterprises/XYZ/devices/123"
|
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
| JSON gösterimi |
{
"command": string,
"params": {
object
}
} |
| Alanlar |
command |
string
Yürütülecek komut adı. Tam nitelikli protobuf mesaj adıyla gösterilir.
|
params |
object (Struct format)
Yürütülecek komut mesajı ve yapısal olarak temsil edilir.
|
Yanıt gövdesi
SmartDeviceManagementService.ExecuteDeviceCommand için yanıt mesajı
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"results": {
object
}
} |
| Alanlar |
results |
object (Struct format)
Komutun çalıştırılmasının sonuçları.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/sdm.service
Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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)."]]
