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 खाते का नहीं बदला जा सकने वाला आईडी.

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

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

JSON के काेड में दिखाना 
{
  "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 डिवाइसों के बैच का स्टेटस बदलने से जुड़ा रिस्पॉन्स.

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

JSON के काेड में दिखाना 
{
  "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 डिवाइस का नतीजा.

JSON के काेड में दिखाना 
{
  "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 मैसेज में डेटा के तीन हिस्से होते हैं: गड़बड़ी का कोड, गड़बड़ी का मैसेज, और गड़बड़ी की जानकारी.

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

JSON के काेड में दिखाना 
{
  "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 डिवाइस के स्टेटस में किए गए बदलाव का रिस्पॉन्स दिया गया.