Method: customer.devices.chromeos.issueCommand

डिवाइस को निर्देश देता है कि उसे क्या करना है.

एचटीटीपी अनुरोध

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
customerId

string

इम्यूटेबल. Google Workspace खाते का आईडी.
deviceId

string

इम्यूटेबल. Chrome OS डिवाइस का आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "commandType": enum (CommandType),
  "payload": string
}
फ़ील्ड
commandType

enum (CommandType)

निर्देश का टाइप.
payload

string

निर्देश के लिए पेलोड, सिर्फ़ तब दें, जब निर्देश के साथ इसका इस्तेमाल किया जा सकता हो. ये निर्देश, पेलोड जोड़ने के साथ काम करते हैं:

  • SET_VOLUME: पेलोड, स्ट्रिंग में बदला गया JSON ऑब्जेक्ट होता है. यह इस फ़ॉर्मैट में होता है: { "volume": 50 }. वॉल्यूम, [0,100] की रेंज में होना चाहिए.
  • DEVICE_START_CRD_SESSION: पेलोड, वैकल्पिक रूप से स्ट्रिंग में बदला गया JSON ऑब्जेक्ट होता है. यह इस फ़ॉर्मैट में होता है: { "ackedUserPresence": true, "crdSessionType": string }. ackedUserPresence एक बूलियन है. डिफ़ॉल्ट रूप से, ackedUserPresence को false पर सेट किया जाता है. किसी चालू डिवाइस के लिए Chrome रिमोट डेस्कटॉप सेशन शुरू करने के लिए, ackedUserPresence को true पर सेट करें. crdSessionType सिर्फ़ private या shared वैल्यू में से कोई एक वैल्यू चुन सकता है. private वैल्यू चुनने पर, रिमोट एडमिन को ChromeOS डिवाइस का खास कंट्रोल मिलता है. वहीं, shared वैल्यू चुनने पर, एडमिन और स्थानीय उपयोगकर्ता, ChromeOS डिवाइस का कंट्रोल शेयर कर सकते हैं. अगर यह सेट नहीं है, तो crdSessionType डिफ़ॉल्ट रूप से shared पर सेट हो जाता है.
  • REBOOT: पेलोड, स्ट्रिंग में बदला गया JSON ऑब्जेक्ट होता है. इसका फ़ॉर्मैट यह होता है: { "user_session_delay_seconds": 300 }. अगर कोई उपयोगकर्ता लॉग इन है, तो डिवाइस को रीबूट करने से पहले user_session_delay_seconds सेकंड तक इंतज़ार करना होता है. यह [0,300] की रेंज में पूर्णांक होना चाहिए. अगर रीबूट के लिए पेलोड मौजूद नहीं है, तो डिफ़ॉल्ट रूप से देरी 0 सेट होती है. ध्यान दें: यह सेटिंग सिर्फ़ तब लागू होती है, जब कोई असली उपयोगकर्ता लॉग इन हो. इसमें मेहमान भी शामिल है. अगर डिवाइस लॉगिन स्क्रीन या कीऑस्क मोड में है, तो इस वैल्यू का इस्तेमाल नहीं किया जाता और डिवाइस तुरंत रीस्टार्ट हो जाता है.
  • FETCH_SUPPORT_PACKET: पेलोड, वैकल्पिक रूप से स्ट्रिंग में बदला गया JSON ऑब्जेक्ट होता है. यह इस फ़ॉर्म में होता है: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
    उपलब्ध data_collector_enums की सूची इस प्रकार है: Chrome सिस्टम की जानकारी (1), क्रैश आईडी (2), मेमोरी की जानकारी (3), यूज़र इंटरफ़ेस (यूआई) की हैरारकी (4), ChromeOS प्लैटफ़ॉर्म के अन्य लॉग (5), डिवाइस इवेंट (6), Intel WiFi NICs डीबग डंप (7), टच इवेंट (8), Lacros (9), Lacros सिस्टम की जानकारी (10), ChromeOS Flex लॉग (11), DBus की जानकारी (12), ChromeOS नेटवर्क रूट (13), ChromeOS Shill (कनेक्शन मैनेजर) लॉग (14), नीतियां (15), ChromeOS सिस्टम की स्थिति और लॉग (16), ChromeOS सिस्टम लॉग (17), ChromeOS Chrome उपयोगकर्ता लॉग (18), ChromeOS ब्लूटूथ (19), ChromeOS से कनेक्ट किए गए इनपुट डिवाइस (20), ChromeOS ट्रैफ़िक काउंटर (21), ChromeOS वर्चुअल कीबोर्ड (22), ChromeOS नेटवर्क की स्थिति (23).
    ज़्यादा जानकारी के लिए, सहायता लेख पढ़ें.

जवाब का मुख्य भाग

कोई कमांड देने पर मिलने वाला जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "commandId": string
}
फ़ील्ड
commandId

string (int64 format)

दिए गए निर्देश का यूनीक आईडी. इसका इस्तेमाल, निर्देश का स्टेटस पाने के लिए किया जाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.