Method: properties.recurringAudienceLists.list

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
parent

string

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

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

पैरामीटर
pageSize

integer

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

string

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

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

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

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

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

किसी प्रॉपर्टी के लिए, बार-बार जनरेट होने वाली ऑडियंस की सभी सूचियों की सूची.

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

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

object (RecurringAudienceList)

किसी प्रॉपर्टी के लिए, बार-बार जनरेट होने वाली हर ऑडियंस सूची.
nextPageToken

string

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

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

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

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