Method: customer.devices.chromeos.batchChangeStatus

ChromeOS डिवाइसों के बैच की स्थिति बदलता है. ChromeOS डिवाइस की स्थिति बदलने के बारे में ज़्यादा जानकारी के लिए, ChromeOS डिवाइसों को रिपेयर करें, फिर से इस्तेमाल करें या बंद करें.

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

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

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

पाथ के पैरामीटर

पैरामीटर
customerId

string

ज़रूरी है. Google Workspace खाते का ऐसा आईडी जिसे बदला नहीं जा सकता.

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

अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
फ़ील्ड
deviceIds[]

string

ज़रूरी है. जिन ChromeOS डिवाइसों में बदलाव करना है उनके आईडी की सूची. ज़्यादा से ज़्यादा 50.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

ज़रूरी है. ChromeOS डिवाइस की स्थिति बदलने के लिए उस पर की जाने वाली कार्रवाई.
deprovisionReason

enum (DeprovisionReason)

ज़रूरी नहीं. डिवाइस को इस्तेमाल से बाहर किए जाने की वजह. अगर 'changeChromeOsDeviceStatusAction'' 'CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION' पर सेट है, तो दिया जाना ज़रूरी है. अगर ऐसा नहीं है, तो इस फ़ील्ड को छोड़ दें.

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

ChromeOS डिवाइसों के बैच की स्थिति बदलने से जुड़ा रिस्पॉन्स.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
फ़ील्ड
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

अनुरोध में दिए गए हर 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 result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    object (ChangeChromeOsDeviceStatusSucceeded)
  }
  // End of list of possible types for union field result.
}
फ़ील्ड
deviceId

string

ChromeOS डिवाइस का यूनीक आईडी.

यूनियन फ़ील्ड result.

result इनमें से सिर्फ़ एक हो सकता है:
error

object (Status)

विफल होने पर कार्रवाई के गड़बड़ी परिणाम.
response

object (ChangeChromeOsDeviceStatusSucceeded)

डिवाइस अपनी स्थिति बदल सका.

स्थिति

Status टाइप, एक लॉजिकल गड़बड़ी मॉडल के बारे में बताता है. यह मॉडल अलग-अलग प्रोग्रामिंग एनवायरमेंट के लिए सही होता है. इनमें REST API और RPC एपीआई शामिल हैं. इसका इस्तेमाल gRPC करता है. हर Status मैसेज में डेटा के तीन हिस्से होते हैं: गड़बड़ी कोड, गड़बड़ी का मैसेज, और गड़बड़ी की जानकारी.

एपीआई डिज़ाइन गाइड में गड़बड़ी के इस मॉडल और इसके साथ काम करने के तरीके के बारे में ज़्यादा जानकारी पाई जा सकती है.

जेएसओएन के काेड में दिखाना 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
फ़ील्ड
code

integer

स्टेटस कोड, जो google.rpc.Code की Enum वैल्यू होनी चाहिए.
message

string

डेवलपर को दिखने वाला गड़बड़ी का मैसेज, जो अंग्रेज़ी में होना चाहिए. उपयोगकर्ताओं को दिखने वाली गड़बड़ी के मैसेज का स्थानीय भाषा में अनुवाद किया जाना चाहिए और google.rpc.Status.details फ़ील्ड में भेजा जाना चाहिए. इसके अलावा, क्लाइंट इस मैसेज को स्थानीय भाषा में भी भेज सकता है.
details[]

object

उन मैसेज की सूची जिनमें गड़बड़ी की जानकारी होती है. एपीआई के इस्तेमाल के लिए, मैसेज टाइप का एक सामान्य सेट है.

एक ऑब्जेक्ट, जिसमें आर्बिट्रेरी टाइप के फ़ील्ड शामिल हैं. एक और फ़ील्ड "@type" में, टाइप की पहचान करने वाला एक यूआरआई शामिल है. उदाहरण: { "id": 1234, "@type": "types.example.com/standard/id" }.

ChangeChromeOsDeviceStatusSucceeded

इस टाइप के लिए कोई फ़ील्ड नहीं है.

ChromeOS डिवाइस के स्टेटस में बदलाव हुआ है.