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

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