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
  • osPlatformVersion
  • 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
  • osPlatformVersion

डिफ़ॉल्ट रूप से, डेटा को बढ़ते क्रम में क्रम से लगाया जाता है. किसी फ़ील्ड के लिए घटते क्रम में लगाने के लिए, फ़ील्ड के नाम में "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