Method: properties.audienceLists.list

किसी प्रॉपर्टी के लिए, ऑडियंस की सभी सूचियों की सूची बनाता है. इस तरीके का इस्तेमाल करके, नई ऑडियंस सूचियां बनाने के बजाय, मौजूदा ऑडियंस सूचियों को ढूंढा और फिर से इस्तेमाल किया जा सकता है. एक ही ऑडियंस में कई ऑडियंस की सूचियां हो सकती हैं. ये सूचियां, अलग-अलग दिनों में ऑडियंस में शामिल उपयोगकर्ताओं की सूची दिखाती हैं.

ऑडियंस की सूचियों के बारे में उदाहरणों के साथ जानने के लिए, ऑडियंस की सूची बनाना लेख पढ़ें.

यह तरीका, audienceExports.list में बीटा वर्शन के स्टेबल होने पर उपलब्ध है. इस एपीआई के बारे में अपने सुझाव देने के लिए, Google Analytics Audience Export API से जुड़ा सुझाव वाला फ़ॉर्म भरें.

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

GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. इस प्रॉपर्टी की सभी ऑडियंस सूचियां, जवाब में दी जाएंगी. फ़ॉर्मैट: properties/{property}

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

पैरामीटर
pageSize

integer

ज़रूरी नहीं. ऑडियंस की सूचियों की ज़्यादा से ज़्यादा संख्या. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए. अगर कोई वैल्यू नहीं दी जाती है, तो ज़्यादा से ज़्यादा 200 ऑडियंस सूचियां दिखाई जाएंगी. ज़्यादा से ज़्यादा वैल्यू 1,000 है. ज़्यादा वैल्यू को ज़्यादा से ज़्यादा वैल्यू पर सेट कर दिया जाएगा.
pageToken

string

ज़रूरी नहीं. पेज टोकन, जो पिछले audienceLists.list कॉल से मिला था. अगला पेज देखने के लिए, यह डालें.

पेज बनाते समय, audienceLists.list के लिए दिए गए सभी अन्य पैरामीटर, उस कॉल से मेल खाने चाहिए जिसने पेज टोकन दिया है.

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

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

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

किसी प्रॉपर्टी के लिए, ऑडियंस की सभी सूचियों की सूची.

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

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

object (AudienceList)

किसी प्रॉपर्टी के लिए ऑडियंस की हर सूची.
nextPageToken

string

एक टोकन, जिसे अगले पेज को वापस पाने के लिए pageToken के तौर पर भेजा जा सकता है. अगर इस फ़ील्ड को छोड़ा जाता है, तो इसके बाद कोई पेज नहीं दिखेगा.

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

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

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics