REST Resource: properties.audienceExports

संसाधन: AudienceExport

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

JSON के काेड में दिखाना 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string,
  "percentageCompleted": number
}
फ़ील्ड
name

string

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

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

string

ज़रूरी है. ऑडियंस के संसाधन का नाम. इस संसाधन के नाम से, सूची में शामिल की जा रही ऑडियंस की पहचान होती है. इसे Analytics Data API और Admin API के बीच शेयर किया जाता है.

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

string

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

object (AudienceDimension)

ज़रूरी है. क्वेरी के जवाब में दिखाए गए और अनुरोध किए गए डाइमेंशन.
creationQuotaTokensCharged

integer

सिर्फ़ आउटपुट के लिए. AudienceExport बनाते समय, इस्तेमाल किए गए कुल कोटा टोकन. टोकन की यह संख्या, CREATING स्थिति में की गई गतिविधि पर आधारित होती है. इसलिए, ऑडियंस एक्सपोर्ट के ACTIVE या FAILED स्थितियों में पहुंचने के बाद, चार्ज किए गए टोकन की संख्या तय हो जाएगी.
state

enum (State)

सिर्फ़ आउटपुट के लिए. इस AudienceExport की मौजूदा स्थिति.
beginCreatingTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. यह वह समय होता है, जब audienceExports.create को कॉल किया गया था और AudienceExport ने CREATING स्थिति में काम करना शुरू किया था.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
rowCount

integer

सिर्फ़ आउटपुट के लिए. AudienceExport के नतीजे में मौजूद लाइनों की कुल संख्या.
errorMessage

string

सिर्फ़ आउटपुट के लिए. ऑडियंस एक्सपोर्ट करने के दौरान, ऑडियंस बनाने में गड़बड़ी होने पर यह मैसेज दिखता है. ऐसा कोटा खत्म होने की वजह से होता है.
percentageCompleted

number

सिर्फ़ आउटपुट के लिए. इस ऑडियंस को एक्सपोर्ट करने की प्रोसेस का पूरा हुआ प्रतिशत. यह 0 से 100 के बीच होता है.

AudienceDimension

ऑडियंस डाइमेंशन, उपयोगकर्ता एट्रिब्यूट होता है. QueryAudienceExportResponse में, एट्रिब्यूट किए गए किसी खास उपयोगकर्ता के लिए अनुरोध किया जाता है. इसके बाद, उसे वापस कर दिया जाता है.

JSON के काेड में दिखाना 
{
  "dimensionName": string
}
फ़ील्ड
dimensionName

string

ज़रूरी नहीं. डाइमेंशन का एपीआई नाम. डाइमेंशन के नामों की सूची के लिए, एपीआई डाइमेंशन देखें.

राज्य

AudienceExport फ़िलहाल इस स्थिति में है.

Enums
STATE_UNSPECIFIED 'अनस्पेसिफ़ाइड' स्थिति का इस्तेमाल कभी नहीं किया जाएगा.
CREATING AudienceExport फ़िलहाल बनाया जा रहा है. यह आने वाले समय में उपलब्ध होगा. ऑडियंस एक्सपोर्ट करने की प्रोसेस, audienceExports.create कॉल के तुरंत बाद शुरू हो जाती है.
ACTIVE AudienceExport पूरी तरह से बन गया है और क्वेरी करने के लिए तैयार है. अनुरोध के बाद, AudienceExport को एसिंक्रोनस तरीके से अपडेट करके चालू किया जाता है. ऐसा, क्रिएट कॉल के कुछ समय बाद (उदाहरण के लिए, 15 मिनट) होता है.
FAILED AudienceExport नहीं बनाया जा सका. ऐसा हो सकता है कि ऑडियंस एक्सपोर्ट करने का अनुरोध फिर से करने पर, यह पूरा हो जाए.

तरीके

create

 यह कुकी, ऑडियंस एक्सपोर्ट करती है, ताकि बाद में उसे वापस पाया जा सके.

get

 इस तरीके से, किसी ऑडियंस एक्सपोर्ट के कॉन्फ़िगरेशन के बारे में मेटाडेटा मिलता है.

list

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

query

 उपयोगकर्ताओं के ऑडियंस एक्सपोर्ट को वापस लाता है.