Method: chromeosdevices.list

किसी खाते में मौजूद Chrome OS डिवाइसों की पेज की गई सूची को वापस लाता है.

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

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

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

पाथ पैरामीटर

पैरामीटर
customerId

string

ग्राहक के Google Workspace खाते का यूनीक आईडी. खाते के एडमिन के तौर पर, अपने खाते के customerId को दिखाने के लिए, my_customer के उपनाम का भी इस्तेमाल किया जा सकता है. customerId को उपयोगकर्ता संसाधन के हिस्से के तौर पर भी दिखाया जाता है.

क्वेरी पैरामीटर

पैरामीटर
maxResults

integer

कितने नतीजे दिखाने हैं. वैल्यू 300 से ज़्यादा नहीं होनी चाहिए.
orderBy

enum (OrderBy)

नतीजों को क्रम से लगाने के लिए इस्तेमाल की जाने वाली डिवाइस प्रॉपर्टी.
orgUnitPath

string

संगठन की इकाई का पूरा पाथ (/ को छोड़कर) या उसका यूनीक आईडी.
pageToken

string

pageToken क्वेरी पैरामीटर का इस्तेमाल, क्वेरी के नतीजों के अगले पेज का अनुरोध करने के लिए किया जाता है. फ़ॉलो-अप अनुरोध का pageToken क्वेरी पैरामीटर, आपके पिछले जवाब का nextPageToken होता है.
projection

enum (Projection)

इससे यह तय होता है कि रिस्पॉन्स में प्रॉपर्टी की पूरी सूची है या सिर्फ़ एक सबसेट.
query

string

https://developers.google.com/workspace/admin/directory/v1/list-query-operators पर दिए गए फ़ॉर्मैट में खोज स्ट्रिंग
sortOrder

enum (SortOrder)

नतीजों को बढ़ते या घटते क्रम में दिखाना है या नहीं. इसका इस्तेमाल orderBy पैरामीटर के साथ करना ज़रूरी है.
includeChildOrgunits

boolean

सभी चाइल्ड ऑर्गैनाइज़ेशनल यूनिट के साथ-साथ, चुनी गई ऑर्गैनाइज़ेशनल यूनिट से डिवाइसों को वापस लाएं. अगर इसे 'सही है' पर सेट किया जाता है, तो 'orgUnitPath' की वैल्यू देना ज़रूरी है.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

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

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

JSON के काेड में दिखाना 
{
  "kind": string,
  "etag": string,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
kind

string

यह किस तरह का संसाधन है.
etag

string

संसाधन का ETag.
chromeosdevices[]

object (ChromeOsDevice)

Chrome OS डिवाइस ऑब्जेक्ट की सूची.
nextPageToken

string

इस नतीजे के अगले पेज को ऐक्सेस करने के लिए इस्तेमाल किया जाने वाला टोकन. अगला पेज ऐक्सेस करने के लिए, इस अनुरोध की pageToken क्वेरी स्ट्रिंग में इस टोकन की वैल्यू का इस्तेमाल करें.

अनुमति के दायरे

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos
  • https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.

OrderBy

Enums
ANNOTATED_LOCATION Chrome डिवाइस की जगह की जानकारी, जैसा कि एडमिन ने एनोटेट किया है.
ANNOTATED_USER एडमिन ने Chromebook का इस्तेमाल करने वाले व्यक्ति के नाम के आगे जो एनोटेशन किया है.
LAST_SYNC वह तारीख और समय जब Chrome डिवाइस को Admin console में नीति की सेटिंग के साथ आखिरी बार सिंक किया गया था.
NOTES एडमिन ने Chrome डिवाइस पर जो नोट जोड़े हैं.
SERIAL_NUMBER डिवाइस चालू करते समय डाला गया, Chrome डिवाइस का सीरियल नंबर.
STATUS Chrome डिवाइस का स्टेटस. ज़्यादा जानकारी के लिए, <a chromeosdevices देखें.

अनुमान

डिवाइसों के लिए दिखाने के लिए प्रोजेक्शन का टाइप.

Enums
BASIC इसमें सिर्फ़ बुनियादी मेटाडेटा फ़ील्ड शामिल होते हैं. जैसे, deviceId, serialNumber, status, और user
FULL इसमें सभी मेटाडेटा फ़ील्ड शामिल होते हैं

SortOrder

डिवाइस सूची में क्रम से लगाने का तरीका.

Enums
ASCENDING बढ़ते क्रम में.
DESCENDING घटते क्रम में.