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 और आरपीसी एपीआई. इसका इस्तेमाल gRPC करता है. हर Status मैसेज में तीन तरह का डेटा होता है: गड़बड़ी का कोड, गड़बड़ी का मैसेज, और गड़बड़ी की जानकारी.

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

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

integer

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

string

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

object

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

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

ChangeChromeOsDeviceStatusSucceeded

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

ChromeOS डिवाइस की स्थिति में बदलाव होने पर मिलने वाला रिस्पॉन्स.