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

chromeosdevices.action को Chrome OS डिवाइस पर किया जाना चाहिए.

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

  • 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: अगर आपको एक साल के अंदर अपने CloudReady डिवाइसों को Chromebook से बदलना है, तो इसका इस्तेमाल करें.