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/admin-sdk/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 घटते क्रम में.