ChromeOS डिवाइसों के बैच की स्थिति बदलता है. ChromeOS डिवाइस की स्थिति बदलने के बारे में ज़्यादा जानकारी के लिए, ChromeOS डिवाइसों को रिपेयर करें, फिर से इस्तेमाल करें या बंद करें.
एचटीटीपी अनुरोध
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
customerId |
ज़रूरी है. Google Workspace खाते का ऐसा आईडी जिसे बदला नहीं जा सकता. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "deviceIds": [ string ], "changeChromeOsDeviceStatusAction": enum ( |
फ़ील्ड | |
---|---|
deviceIds[] |
ज़रूरी है. जिन ChromeOS डिवाइसों में बदलाव करना है उनके आईडी की सूची. ज़्यादा से ज़्यादा 50. |
changeChromeOsDeviceStatusAction |
ज़रूरी है. ChromeOS डिवाइस की स्थिति बदलने के लिए उस पर की जाने वाली कार्रवाई. |
deprovisionReason |
ज़रूरी नहीं. डिवाइस को इस्तेमाल से बाहर किए जाने की वजह. अगर 'changeChromeOsDeviceStatusAction'' 'CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION' पर सेट है, तो दिया जाना ज़रूरी है. अगर ऐसा नहीं है, तो इस फ़ील्ड को छोड़ दें. |
जवाब का मुख्य भाग
ChromeOS डिवाइसों के बैच की स्थिति बदलने से जुड़ा रिस्पॉन्स.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"changeChromeOsDeviceStatusResults": [
{
object ( |
फ़ील्ड | |
---|---|
changeChromeOsDeviceStatusResults[] |
अनुरोध में दिए गए हर ChromeOS डिवाइस के लिए नतीजे. |
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/admin.directory.device.chromeos
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.
ChangeChromeOsDeviceStatusAction
किसी ChromeOS डिवाइस की स्थिति बदलने के लिए की जाने वाली कार्रवाई.
Enums | |
---|---|
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED |
डिफ़ॉल्ट मान. वैल्यू इस्तेमाल नहीं की गई है. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION |
ChromeOS डिवाइस को इस्तेमाल से बाहर कर देता है. अगर आपके पास ऐसे ChromeOS डिवाइस हैं जिनका इस्तेमाल अब आपके संगठन में नहीं किया जा रहा है, तो उन्हें इस्तेमाल से बाहर कर दें. ऐसा करने पर, आपको उन्हें मैनेज नहीं करना होगा. डिवाइस को इस्तेमाल से बाहर करने पर, डिवाइस पर मौजूद सभी नीतियां हट जाती हैं. साथ ही, डिवाइस-लेवल के प्रिंटर और डिवाइस को कीऑस्क के तौर पर इस्तेमाल करने की सुविधा भी हट जाती है. डिवाइस पर अपग्रेड किए जाने के हिसाब से, इस कार्रवाई से लाइसेंस को वापस लाइसेंस पूल में रिलीज़ किया जा सकता है. इससे किसी दूसरे डिवाइस पर लाइसेंस का इस्तेमाल किया जा सकता है. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE |
इससे ChromeOS डिवाइस को बंद किया जाता है. अगर उपयोगकर्ता का डिवाइस खो जाता है या चोरी हो जाता है, तो इस कार्रवाई का इस्तेमाल करें. इससे डिवाइस को अब भी मैनेज किया जा सकेगा. ऐसे में, उस डिवाइस पर नीतियां लागू होंगी, लेकिन कोई भी व्यक्ति इसका इस्तेमाल नहीं कर पाएगा. डिवाइस पर अपग्रेड किए जाने के हिसाब से, इस कार्रवाई से लाइसेंस को वापस लाइसेंस पूल में रिलीज़ किया जा सकता है. इससे किसी दूसरे डिवाइस पर लाइसेंस का इस्तेमाल किया जा सकता है. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE |
बंद किए जाने के बाद, किसी ChromeOS डिवाइस को इस्तेमाल के लिए फिर से चालू करता है. डिवाइस खोने या वापस मिल जाने पर, यह फिर से चालू हो जाता है. इससे डिवाइस को फिर से इस्तेमाल किया जा सकता है. डिवाइस के अपग्रेड के आधार पर, इसे लाइसेंस पूल से एक लाइसेंस का इस्तेमाल किया जा सकता है. इसका मतलब है कि अगर ज़रूरी लाइसेंस उपलब्ध नहीं होंगे, तो कार्रवाई नहीं की जा सकेगी. |
ChangeChromeOsDeviceStatusResult
एक ChromeOS डिवाइस का, 'स्थिति में बदलाव करें' कार्रवाई के लिए नतीजा.
जेएसओएन के काेड में दिखाना |
---|
{ "deviceId": string, // Union field |
फ़ील्ड | |
---|---|
deviceId |
ChromeOS डिवाइस का यूनीक आईडी. |
यूनियन फ़ील्ड
|
|
error |
विफल होने पर कार्रवाई के गड़बड़ी परिणाम. |
response |
डिवाइस अपनी स्थिति बदल सका. |
स्थिति
Status
टाइप, एक लॉजिकल गड़बड़ी मॉडल के बारे में बताता है. यह मॉडल अलग-अलग प्रोग्रामिंग एनवायरमेंट के लिए सही होता है. इनमें REST API और RPC एपीआई शामिल हैं. इसका इस्तेमाल gRPC करता है. हर Status
मैसेज में डेटा के तीन हिस्से होते हैं: गड़बड़ी कोड, गड़बड़ी का मैसेज, और गड़बड़ी की जानकारी.
एपीआई डिज़ाइन गाइड में गड़बड़ी के इस मॉडल और इसके साथ काम करने के तरीके के बारे में ज़्यादा जानकारी पाई जा सकती है.
जेएसओएन के काेड में दिखाना |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
फ़ील्ड | |
---|---|
code |
स्टेटस कोड, जो |
message |
डेवलपर को दिखने वाला गड़बड़ी का मैसेज, जो अंग्रेज़ी में होना चाहिए. उपयोगकर्ताओं को दिखने वाली गड़बड़ी के मैसेज का स्थानीय भाषा में अनुवाद किया जाना चाहिए और |
details[] |
उन मैसेज की सूची जिनमें गड़बड़ी की जानकारी होती है. एपीआई के इस्तेमाल के लिए, मैसेज टाइप का एक सामान्य सेट है. एक ऑब्जेक्ट, जिसमें आर्बिट्रेरी टाइप के फ़ील्ड शामिल हैं. एक और फ़ील्ड |
ChangeChromeOsDeviceStatusSucceeded
इस टाइप के लिए कोई फ़ील्ड नहीं है.
ChromeOS डिवाइस के स्टेटस में बदलाव हुआ है.