REST Resource: customer.devices.chromeos.commands

संसाधन: DirectoryChromeosdevicesCommand

किसी डिवाइस को दिए गए निर्देश के बारे में जानकारी.

JSON के काेड में दिखाना 
{
  "commandId": string,
  "type": enum (CommandType),
  "issueTime": string,
  "state": enum (State),
  "commandExpireTime": string,
  "commandResult": {
    object (DirectoryChromeosdevicesCommandResult)
  },
  "payload": string
}
फ़ील्ड
commandId

string (int64 format)

डिवाइस कमांड का यूनीक आईडी.
type

enum (CommandType)

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

string (Timestamp format)

एडमिन ने जब निर्देश दिया था, तब का टाइमस्टैंप.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
state

enum (State)

निर्देश की स्थिति दिखाता है.
commandExpireTime

string (Timestamp format)

वह समय जब निर्देश की समयसीमा खत्म हो जाएगी. अगर डिवाइस इस समयसीमा के अंदर कमांड को पूरा नहीं करता है, तो कमांड की समयसीमा खत्म हो जाएगी.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
commandResult

object (DirectoryChromeosdevicesCommandResult)

कमांड लागू करने का नतीजा.
payload

string

अगर कमांड में कोई पेलोड दिया गया है, तो वह.

CommandType

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

Enums
COMMAND_TYPE_UNSPECIFIED निर्देश का टाइप नहीं बताया गया था.
REBOOT डिवाइस को रीबूट करें. कीऑस्क और मैनेज किए जा रहे गेस्ट सेशन वाले डिवाइसों के साथ-साथ, ChromeOS 113 या उसके बाद के वर्शन वाले सामान्य डिवाइसों पर जारी किया जा सकता है.
TAKE_A_SCREENSHOT डिवाइस का स्क्रीनशॉट लें. यह सुविधा सिर्फ़ तब उपलब्ध होती है, जब डिवाइस कीऑस्क मोड में हो.
SET_VOLUME डिवाइस की आवाज़ सेट करें. सिर्फ़ कीऑस्क और मैनेज किए जा रहे गेस्ट सेशन मोड वाले डिवाइसों पर जारी किया जा सकता है.
WIPE_USERS डिवाइस से सभी उपयोगकर्ताओं की जानकारी मिटाएं. डिवाइस में यह निर्देश लागू करने पर, उपयोगकर्ता प्रोफ़ाइल का सारा डेटा हट जाएगा. हालांकि, डिवाइस से जुड़ी नीति और रजिस्टर किया गया डेटा नहीं हटेगा.
REMOTE_POWERWASH डिवाइस को पॉवर वॉश करके मिटाता है. डिवाइस में यह निर्देश लागू करने पर, उपयोगकर्ता की नीतियां, डिवाइस की नीतियां, और रजिस्टर करने की नीतियां समेत सभी डेटा मिट जाएगा. चेतावनी: ऐसा करने पर, यह डिवाइस अपनी फ़ैक्ट्री सेटिंग की डिफ़ॉल्ट स्थिति में पहुंच जाएगा और इसमें दर्ज सभी नाम हट जाएंगे. हालांकि, अगर डिवाइस में ज़बरदस्ती या अपने-आप नाम दर्ज होने की सेटिंग चालू है, तो ऐसा नहीं होगा. सावधानी से इस्तेमाल करें, क्योंकि इस कार्रवाई को पहले जैसा नहीं किया जा सकेगा!
DEVICE_START_CRD_SESSION Chrome रिमोट डेस्कटॉप सेशन शुरू करता है.
CAPTURE_LOGS कीऑस्क डिवाइस के सिस्टम लॉग कैप्चर करें. लॉग को chromeosdevices के deviceFiles फ़ील्ड में मौजूद downloadUrl लिंक से डाउनलोड किया जा सकता है
FETCH_CRD_AVAILABILITY_INFO इस सुविधा से ऐसी जानकारी मिलती है जिससे यह पता चलता है कि डिवाइस पर CRD (Chrome रिमोट डेस्कटॉप) की सुविधा उपलब्ध है या नहीं.
FETCH_SUPPORT_PACKET किसी डिवाइस से, सहायता पैकेट को रिमोट तौर पर फ़ेच करना. सहायता पैकेट एक ज़िप संग्रह होता है, जिसमें ChromeOS डिवाइस के अलग-अलग सिस्टम लॉग और डीबग डेटा शामिल होता है. सहायता पैकेज को chromeosdevices के deviceFiles फ़ील्ड में मौजूद downloadURL लिंक से डाउनलोड किया जा सकता है

स्थिति

यह दिए गए निर्देश की स्थिति दिखाता है.

Enums
STATE_UNSPECIFIED निर्देश की स्थिति की जानकारी नहीं दी गई थी.
PENDING ऐसा निर्देश जिसकी समयसीमा खत्म नहीं हुई है और जिसे अब तक क्लाइंट को नहीं भेजा गया है.
EXPIRED क्लाइंट ने तय समय के अंदर कमांड को पूरा नहीं किया.
CANCELLED एडमिन ने 'मंज़ूरी बाकी है' स्टेटस के दौरान, निर्देश रद्द कर दिया है.
SENT_TO_CLIENT क्लाइंट को निर्देश भेज दिया गया है.
ACKED_BY_CLIENT क्लाइंट ने जवाब दिया है कि उसे निर्देश मिल गया है.
EXECUTED_BY_CLIENT क्लाइंट ने निर्देश को पूरा किया या नहीं.

DirectoryChromeosdevicesCommandResult

किसी निर्देश को लागू करने का नतीजा.

JSON के काेड में दिखाना 
{
  "result": enum (CommandResultType),
  "executeTime": string,
  "errorMessage": string,
  "commandResultPayload": string
}
फ़ील्ड
result

enum (CommandResultType)

कमांड का नतीजा.
executeTime

string (Timestamp format)

वह समय जब निर्देश लागू किया गया या लागू नहीं किया जा सका.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
errorMessage

string

गड़बड़ी का मैसेज, जिसमें यह जानकारी होती है कि निर्देश पूरा क्यों नहीं हुआ. यह सिर्फ़ तब मौजूद होता है, जब निर्देश पूरा न हो पाया हो.
commandResultPayload

string

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

  • DEVICE_START_CRD_SESSION: पेलोड, स्ट्रिंग में बदला गया JSON ऑब्जेक्ट होता है. यह इस फ़ॉर्मैट में होता है: { "url": url }. यूआरएल, Chrome Remote Desktop सेशन का लिंक देता है.

CommandResultType

निर्देश के नतीजे का टाइप.

Enums
COMMAND_RESULT_TYPE_UNSPECIFIED निर्देश का नतीजा नहीं मिला.
IGNORED इस निर्देश को 'पुराना है' के तौर पर मार्क कर दिया गया है.
FAILURE निर्देश को पूरा नहीं किया जा सका.
SUCCESS निर्देश पूरा हो गया.

तरीके

get

 डिवाइस को दिए गए किसी खास निर्देश का डेटा पाता है.