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 लागू की गई.

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

  • deprovision: ऐसे डिवाइस को मैनेजमेंट से हटाएं जो अब चालू नहीं है, जिसे दोबारा बेचा जा रहा है या वापस / रिपेयर कराने के लिए सबमिट किया जा रहा है. ऐसे डिवाइस को मैनेजमेंट से अलग करने के लिए, इस्तेमाल से बाहर करने की कार्रवाई का इस्तेमाल करें.
  • disable: अगर आपको लगता है कि आपके संगठन का कोई डिवाइस खो गया है या चोरी हो गया है, तो उसे बंद किया जा सकता है, ताकि कोई दूसरा डिवाइस उसका इस्तेमाल न कर सके. किसी डिवाइस के बंद होने पर, Chrome डिवाइस को चालू करने पर सभी उपयोगकर्ताओं को एक स्क्रीन दिख सकती है. इस स्क्रीन पर उन्हें बताया जाएगा कि डिवाइस को बंद कर दिया गया है. साथ ही, डिवाइस को वापस करने की आपकी संपर्क जानकारी भी दिखेगी.
  • 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 से बदलना है, तो इसका इस्तेमाल करें.