Method: chromeosdevices.action

इसके बजाय, BatchChangeChromeOsDeviceStatus का इस्तेमाल करें. ऐसी कार्रवाई करता है जिसका असर Chrome OS डिवाइस पर पड़ता है. इसमें डिवाइसों को डिप्रावाइज़ करना, बंद करना, और फिर से चालू करना शामिल है.

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

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

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

पाथ पैरामीटर

पैरामीटर
customerId

string

ग्राहक के Google Workspace खाते का यूनीक आईडी. खाते के एडमिन के तौर पर, अपने खाते के customerId को दिखाने के लिए, आपके पास my_customer उपनाम का इस्तेमाल करने का विकल्प भी है. customerId को उपयोगकर्ता संसाधन के हिस्से के तौर पर भी दिखाया जाता है.
resourceId

string

डिवाइस का यूनीक आईडी. resourceId को chromeosdevices.list तरीके से रिस्पॉन्स के तौर पर दिखाया जाता है.

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

अनुरोध के मुख्य भाग में ChromeOsDeviceAction का उदाहरण है.

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

अगर अनुरोध पूरा हो जाता है, तो रिस्पॉन्स एक सामान्य एचटीटीपी रिस्पॉन्स होता है. इसका फ़ॉर्मैट, तरीके के हिसाब से तय होता है.

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

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

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

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

ChromeOsDeviceAction

Chrome OS डिवाइस की स्थिति के अपडेट के बारे में डेटा.

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

string

Chrome OS डिवाइस पर किया जाने वाला chromeosdevices.action.

ये वैल्यू स्वीकार की जाती हैं:

  • deprovision: किसी ऐसे डिवाइस को मैनेजमेंट से हटाएं जो अब चालू नहीं है, जिसे फिर से बेचा जा रहा है या जिसे लौटाने / ठीक कराने के लिए सबमिट किया जा रहा है. इसे मैनेजमेंट से अलग करने के लिए, डिवाइस को डिप्रावाइज़ करने की कार्रवाई का इस्तेमाल करें.
  • disable: अगर आपको लगता है कि आपके संगठन का कोई डिवाइस खो गया है या चोरी हो गया है, तो आपके पास उस डिवाइस को बंद करने का विकल्प है. इससे कोई दूसरा व्यक्ति उस डिवाइस का इस्तेमाल नहीं कर पाएगा. जब किसी डिवाइस को बंद किया जाता है, तो उसे चालू करने पर उपयोगकर्ता को एक स्क्रीन दिखती है. इस स्क्रीन पर, उसे यह जानकारी मिलती है कि डिवाइस बंद कर दिया गया है. साथ ही, डिवाइस को कहां लौटाना है, इसकी संपर्क जानकारी भी दिखती है.
  • reenable: जब कोई डिवाइस मिल जाए या खोया हुआ डिवाइस वापस मिल जाए, तो बंद किए गए डिवाइस को फिर से चालू करें. अगर आपने गलती से किसी Chrome डिवाइस को 'बंद है' के तौर पर मार्क कर दिया है, तो इस सुविधा का इस्तेमाल करके उसे फिर से चालू किया जा सकता है.
  • pre_provisioned_disable: पहले से प्रोवाइड किया गया ऐसा डिवाइस जिसे रजिस्टर नहीं किया जा सकता. एडमिन, डिवाइस को फिर से चालू करके, बिना किसी टच के रजिस्टर करने की सुविधा दे सकता है. इसके लिए, उसे डिवाइस का स्टेटस "pre_provisioned_reenable" पर बदलना होगा. ध्यान दें: इस स्थिति में, डिवाइस को इस्तेमाल से हटाया जा सकता है.
  • pre_provisioned_reenable: डिवाइस को OEM ने पहले से तैयार किया हो. इस स्थिति में मौजूद डिवाइसों को ज़ीरो-टच रजिस्ट्रेशन की सुविधा मिल सकती है.
deprovisionReason

string

इसका इस्तेमाल सिर्फ़ तब किया जाता है, जब ऐक्शन को हटाया जाता है. डिप्रोवाइज़ करने की कार्रवाई के लिए, यह फ़ील्ड भरना ज़रूरी है.

स्वीकार की जा सकने वाली वैल्यू ये हैं:

  • different_model_replacement: अगर आपको अपने डिवाइस को अपग्रेड करना है या उसी डिवाइस के नए मॉडल से बदलना है, तो इसका इस्तेमाल करें.
  • retiring_device: अगर डिवाइस को दोबारा बेचा जा रहा है, उसे दान किया जा रहा है या हमेशा के लिए हटाया जा रहा है, तो इसका इस्तेमाल करें.
  • same_model_replacement: अगर किसी डिवाइस में हार्डवेयर से जुड़ी कोई समस्या आती है और उसे रिपेयर करने वाले वेंडर / मैन्युफ़ैक्चरर से उसी मॉडल या मिलते-जुलते मॉडल से बदला जा रहा है, तो इसका इस्तेमाल करें.
  • upgrade_transfer: अगर आपको एक साल के अंदर अपने क्लाउड रेडी डिवाइसों को Chromebook से बदलना है, तो इसका इस्तेमाल करें.