REST Resource: properties.recurringAudienceLists

संसाधन: Shopping AudienceList

बार-बार आने वाली दर्शक सूची हर दिन नई दर्शक सूचियां बनाती है. ऑडियंस की सूचियां, बनाते समय ऑडियंस में मौजूद उपयोगकर्ता होती हैं. बार-बार आने वाली दर्शक सूची से यह पक्का होता है कि आपके पास हर दिन इस्तेमाल करने के लिए उपलब्ध सबसे हाल के डेटा के आधार पर दर्शक सूची है.

जेएसओएन के काेड में दिखाना
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. आइडेंटिफ़ायर. ऑडियंस की सूची को बनाते समय, बार-बार इस्तेमाल होने वाले संसाधन का नाम असाइन किया गया. संसाधन का यह नाम इस RecurringAudienceList की पहचान करता है.

फ़ॉर्मैट: properties/{property}/recurringAudienceLists/{recurringAudienceList}

audience

string

ज़रूरी है. ऑडियंस के संसाधन का नाम. संसाधन का यह नाम, सूची में शामिल ऑडियंस की पहचान करता है. साथ ही, इसे Analytics डेटा और एडमिन एपीआई के बीच शेयर किया जाता है.

फ़ॉर्मैट: properties/{property}/audiences/{audience}

audienceDisplayName

string

सिर्फ़ आउटपुट के लिए. इस ऑडियंस के लिए जानकारी वाला डिसप्ले नेम. उदाहरण के लिए, "खरीदार".

dimensions[]

object (AudienceDimension)

ज़रूरी है. अनुरोध किए गए डाइमेंशन, ऑडियंस की सूची के रिस्पॉन्स में दिखाए गए हैं.

audienceLists[]

string

सिर्फ़ आउटपुट के लिए. बार-बार इस्तेमाल होने वाली इस दर्शक सूची के लिए बनाए गए दर्शक सूची के इंस्टेंस के लिए दर्शक सूची के संसाधन नाम. हर दिन के लिए एक ऑडियंस की सूची बनाई जाती है और ऑडियंस की सूची यहां दिखेगी.

इस सूची को, सबसे हाल में बनाई गई ऑडियंस सूची को पहले क्रम में लगाया जाता है.

activeDaysRemaining

integer

ज़रूरी नहीं. बचे हुए दिनों की वह संख्या जब ऑडियंस को बार-बार एक्सपोर्ट करने पर, ऑडियंस की सूची का इंस्टेंस बनेगा. यह काउंटर हर दिन एक तक घटता है और जब यह शून्य तक पहुंच जाएगा, तब ऑडियंस की कोई नई सूची नहीं बनाई जाएगी.

Analytics 360 प्रॉपर्टी के लिए, ऑडियंस की सूची के बार-बार होने वाले अनुरोध की अवधि, डिफ़ॉल्ट तौर पर 180 दिनों की होती है. इस सूची में ज़्यादा से ज़्यादा 365 दिन हो सकते हैं. स्टैंडर्ड Analytics प्रॉपर्टी के लिए अनुरोध की अवधि, डिफ़ॉल्ट रूप से 14 दिनों की होती है. इसमें ज़्यादा से ज़्यादा 30 दिन लग सकते हैं.

निर्माण के दौरान स्वीकृत मान कम से कम 1 है. सीमा से ज़्यादा के अनुरोधों को उनकी तय सीमा से ज़्यादा कर दिया जाएगा.

webhookNotification

object (WebhookNotification)

ज़रूरी नहीं. यह नीति, Google Analytics Data API से आपके वेबहुक सर्वर पर भेजी जाने वाली वेबहुक सूचनाओं को कॉन्फ़िगर करती है. वेबहुक का इस्तेमाल करना ज़रूरी नहीं है. अगर इस्तेमाल नहीं किया गया है, तो आपको इस एपीआई का इस्तेमाल करके यह पता लगाना होगा कि बार-बार आने वाली ऑडियंस की सूची, ऑडियंस की नई सूचियां कब बनाती है. वेबहुक की मदद से, आपके सर्वर पर सूचना भेजी जा सकती है और पोल कराने की ज़रूरत नहीं पड़ती.

जब भी ऑडियंस की सूची बार-बार बनाई जाएगी, तब दो पोस्ट अनुरोध भेजे जाएंगे. ऐसा हर दिन एक बार तब तक होता है, जब तक बार-बार आने वाली दर्शक सूची 0 सक्रिय दिनों तक नहीं पहुंचती. पहला अनुरोध भेजा जाएगा, जिसमें बनाई गई नई ऑडियंस की सूची को बनाने की स्थिति में दिखाया जाएगा. ऑडियंस की सूची बन जाने के बाद दूसरा अनुरोध भेजा जाएगा (चालू या असफल स्थिति में से).

तरीके

create

बार-बार आने वाली ऑडियंस की सूची बनाता है.

get

बार-बार आने वाली किसी ऑडियंस की सूची के बारे में कॉन्फ़िगरेशन मेटाडेटा की जानकारी देता है.

list

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