Method: properties.audienceExports.query

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

ऑडियंस एक्सपोर्ट करने की सुविधा के बारे में जानने के लिए, ऑडियंस एक्सपोर्ट करना लेख पढ़ें.

Google Analytics 4 में ऑडियंस की मदद से, अपने कारोबार के लिए उपयोगकर्ताओं को उनकी अहमियत के मुताबिक अलग-अलग सेगमेंट में बांटा जा सकता है. ज़्यादा जानकारी के लिए, https://support.google.com/analytics/answer/9267572 पर जाएं.

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

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

POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query

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

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. उस ऑडियंस का नाम जिसे एक्सपोर्ट करना है, ताकि उपयोगकर्ताओं को वापस लाया जा सके. फ़ॉर्मैट: properties/{property}/audienceExports/{audienceExport}

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

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

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

string (int64 format)

ज़रूरी नहीं. शुरुआती पंक्ति की पंक्तियों की संख्या. पहली लाइन को शून्य के तौर पर गिना जाता है.

पेजिंग करते समय, पहला अनुरोध ऑफ़सेट की जानकारी नहीं देता है; या इसके बराबर, ऑफ़सेट को 0 पर सेट करता है; पहला अनुरोध, पहली limit पंक्तियों को नतीजे के तौर पर दिखाता है. दूसरा अनुरोध ऑफ़सेट को पहले अनुरोध के limit पर सेट करता है; दूसरा अनुरोध, पंक्तियों की दूसरी limit दिखाता है.

पेज पर नंबर डालने के इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना लेख पढ़ें.
limit

string (int64 format)

ज़रूरी नहीं. दिखाई जाने वाली पंक्तियों की संख्या. अगर जानकारी नहीं दी गई है, तो 10,000 पंक्तियां दिखती हैं. एपीआई हर अनुरोध के लिए ज़्यादा से ज़्यादा 2,50, 000 लाइनें दिखाता है. इससे कोई फ़र्क़ नहीं पड़ता कि आपको कितनी लाइनें चाहिए. limit, पॉज़िटिव होना चाहिए.

अगर डाइमेंशन वैल्यू limit की संख्या से कम हैं, तो एपीआई अनुरोध किए गए limit से कम लाइनें भी दिखा सकता है.

पेज पर नंबर डालने के इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना लेख पढ़ें.

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

ऑडियंस एक्सपोर्ट में शामिल उपयोगकर्ताओं की सूची.

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

JSON के काेड में दिखाना 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceExport": {
    object (AudienceExport)
  },
  "rowCount": integer
}
फ़ील्ड
audienceRows[]

object (AudienceRow)

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

object (AudienceExport)

AudienceExport के बारे में क्वेरी किए जाने से जुड़ा कॉन्फ़िगरेशन डेटा. इस जवाब में, ऑडियंस लाइन को समझने में मदद करने के लिए दिखाया गया. उदाहरण के लिए, इस AudienceExport में मौजूद डाइमेंशन, Audience पंक्तियों के कॉलम से मिलते-जुलते हैं.
rowCount

integer

Audience Export के नतीजे में पंक्तियों की कुल संख्या. rowCount, रिस्पॉन्स में दिखाई गई पंक्तियों की संख्या, limit अनुरोध पैरामीटर, और offset अनुरोध पैरामीटर से अलग होता है. उदाहरण के लिए, अगर कोई क्वेरी 175 पंक्तियां दिखाती है और एपीआई अनुरोध में 50 में से limit पंक्तियां शामिल होती हैं, तो जवाब में 175 में से rowCount, लेकिन सिर्फ़ 50 पंक्तियां होंगी.

पेज पर नंबर डालने के इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना लेख पढ़ें.

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

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

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

AudienceRow

ऑडियंस की उपयोगकर्ता पंक्ति के लिए डाइमेंशन वैल्यू एट्रिब्यूट.

JSON के काेड में दिखाना 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
फ़ील्ड
dimensionValues[]

object (AudienceDimensionValue)

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

AudienceDimensionValue

किसी डाइमेंशन की वैल्यू.

JSON के काेड में दिखाना 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
फ़ील्ड
यूनियन फ़ील्ड one_value. एक तरह की डाइमेंशन वैल्यू. one_value इनमें से सिर्फ़ एक हो सकता है:
value

string

अगर डाइमेंशन टाइप कोई स्ट्रिंग है, तो स्ट्रिंग के तौर पर वैल्यू.