Method: customers.profiles.list

खोज और क्रम से लगाने की दी गई शर्तों के आधार पर, किसी ग्राहक की Chrome ब्राउज़र प्रोफ़ाइलों की सूची दिखाता है.

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

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/profiles

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. फ़ॉर्मैट: customers/{customer_id}

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

पैरामीटर
pageSize

integer

ज़रूरी नहीं. कितनी प्रोफ़ाइलें दिखानी हैं. अगर pageSize की वैल्यू नहीं दी गई है, तो पेज का डिफ़ॉल्ट साइज़ 100 होता है. साथ ही, पेज का ज़्यादा से ज़्यादा साइज़ 200 हो सकता है.
pageToken

string

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

string

ज़रूरी नहीं. प्रोफ़ाइलों को फ़िल्टर करने के लिए इस्तेमाल किया जाने वाला फ़िल्टर. फ़िल्टर में इन फ़ील्ड का इस्तेमाल किया जा सकता है:

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • ouId

ऊपर दिए गए किसी भी फ़ील्ड का इस्तेमाल, फ़िल्टर तय करने के लिए किया जा सकता है. साथ ही, कई फ़ील्ड के हिसाब से फ़िल्टर करने की सुविधा AND ऑपरेटर के साथ काम करती है. स्ट्रिंग टाइप फ़ील्ड और एनम टाइप फ़ील्ड में, '=' और '!=' ऑपरेटर का इस्तेमाल किया जा सकता है. पूर्णांक टाइप और टाइमस्टैंप टाइप वाले फ़ील्ड में, '=', '!=', '<', '>', '<=', और '>=' ऑपरेटर का इस्तेमाल किया जा सकता है. टाइमस्टैंप के लिए, RFC-3339 फ़ॉर्मैट वाली स्ट्रिंग का इस्तेमाल किया जाना चाहिए. जैसे, 2012-04-21T11:30:00-04:00. वाइल्डकार्ड '*' का इस्तेमाल, स्ट्रिंग टाइप फ़ील्ड फ़िल्टर के साथ किया जा सकता है. इसके अलावा, स्ट्रिंग की लिटरल फ़िल्टर भी किया जा सकता है. उदाहरण के लिए, 'ABC' एक फ़िल्टर पर मैप होता है. यह फ़िल्टर यह देखता है कि फ़िल्टर किए जा सकने वाले स्ट्रिंग टाइप फ़ील्ड में 'ABC' है या नहीं.

संगठन की इकाई के नंबर का इस्तेमाल, फ़िल्टर करने की शर्त के तौर पर किया जा सकता है. इसके लिए, 'ouId = ${your_org_unit_id}' डालें. कृपया ध्यान दें कि सिर्फ़ एक ओयू आईडी से मैच करने की सुविधा काम करती है.
orderBy

string

ज़रूरी नहीं. नतीजों के क्रम को तय करने के लिए इस्तेमाल किए जाने वाले फ़ील्ड. ये फ़ील्ड इस्तेमाल किए जा सकते हैं:

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState

डिफ़ॉल्ट रूप से, डेटा को बढ़ते क्रम में क्रम से लगाया जाता है. किसी फ़ील्ड के लिए घटते क्रम में लगाने के लिए, फ़ील्ड के नाम में "desc" सफ़िक्स जोड़ा जाना चाहिए. डिफ़ॉल्ट रूप से, आइटम lastStatusReportTime के घटते क्रम में दिखते हैं.

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

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

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

Profiles.list तरीके का जवाब देने के लिए.

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

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

object (ChromeBrowserProfile)

वापस लाई गई प्रोफ़ाइलों की सूची दिखाई गई.
nextPageToken

string

पेजेशन टोकन, जिसका इस्तेमाल अगले पेज की सूची बनाने के लिए किया जा सकता है.
totalSize

string (int64 format)

कुल साइज़ से, दिखाए गए संसाधनों की अनुमानित संख्या का पता चलता है. 10 हज़ार से ज़्यादा प्रोफ़ाइलों के लिए, इस बात की कोई गारंटी नहीं है कि यह सटीक होगा.

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

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

  • https://www.googleapis.com/auth/chrome.management.profiles.readonly
  • https://www.googleapis.com/auth/chrome.management.profiles