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 डिवाइस की स्थिति से जुड़े अपडेट के बारे में डेटा.

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

string

chromeosdevices.action, Chrome OS डिवाइस से ही इस्तेमाल किया जा सकता है.

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

  • 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 से बदलने वाले हैं, तो इसका इस्तेमाल करें.