- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
यह उपयोगकर्ताओं की ऑडियंस की सूची को Google शीट में एक्सपोर्ट करता है. ऑडियंस बनाने के बाद, उपयोगकर्ता तुरंत लिस्टिंग के लिए उपलब्ध नहीं होते हैं. सबसे पहले, उपयोगकर्ताओं की ऑडियंस की सूची बनाने के लिए, audienceLists.create
को अनुरोध करना ज़रूरी है. इसके बाद, ऑडियंस की सूची में मौजूद उपयोगकर्ताओं को Google शीट में एक्सपोर्ट करने के लिए इस तरीके का इस्तेमाल किया जाता है.
उदाहरणों के साथ ऑडियंस की सूची के बारे में जानने के लिए, ऑडियंस की सूची बनाना देखें.
Google Analytics 4 में ऑडियंस की मदद से, उपयोगकर्ताओं को कारोबार की अहमियत के मुताबिक अलग-अलग सेगमेंट में बांटा जा सकता है. ज़्यादा जानने के लिए, https://support.google.com/analytics/answer/9267572 देखें.
यह तरीका बीटा वर्शन पर जाने से पहले लॉन्च किया गया है, ताकि ऐल्फ़ा के लेवल पर सिंटैक्स और सुविधाओं के बारे में सुझाव इकट्ठा किया जा सके. इस एपीआई के बारे में सुझाव/राय देने या शिकायत करने के लिए, Google Analytics Audience Export API का फ़ीडबैक फ़ॉर्म भरें.
एचटीटीपी अनुरोध
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/audienceLists/*}:exportSheet
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
name |
ज़रूरी है. उस ऑडियंस की सूची का नाम जिससे उपयोगकर्ताओं को वापस लाना है. फ़ॉर्मैट: |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "offset": string, "limit": string } |
फ़ील्ड | |
---|---|
offset |
ज़रूरी नहीं. शुरुआती पंक्ति के लिए पंक्तियों की संख्या. पहली लाइन की गिनती पंक्ति 0 के तौर पर की जाती है. पेजिंग करते समय, पहला अनुरोध ऑफ़सेट तय नहीं करता है; या इसके बराबर, ऑफ़सेट को 0 पर सेट करता है; पहला अनुरोध पंक्तियों का पहली पेज पर नंबर डालने वाले इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना देखें. |
limit |
ज़रूरी नहीं. दिखाई जाने वाली पंक्तियों की संख्या. इन्हें तय न करने पर, 10,000 लाइनें दिखती हैं. एपीआई हर अनुरोध में ज़्यादा से ज़्यादा 2,50,000 लाइनें दिखाता है, चाहे आपने कितनी भी लाइनें मांगी हों. अगर पेज पर नंबर डालने वाले इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना देखें. |
जवाब का मुख्य भाग
बनाई गई Google शीट, जिसमें ऑडियंस की सूची में उपयोगकर्ताओं की सूची शामिल है.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"spreadsheetUri": string,
"spreadsheetId": string,
"rowCount": integer,
"audienceList": {
object ( |
फ़ील्ड | |
---|---|
spreadsheetUri |
Google शीट देखने के लिए, ब्राउज़र पर आपके लिए एक यूआरआई. |
spreadsheetId |
ऐसा आईडी जो बनाए गए 'Google शीट' संसाधन की पहचान करता है. |
rowCount |
AudienceList नतीजे में पंक्तियों की कुल संख्या होती है. पेज पर नंबर डालने वाले इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना देखें. |
audienceList |
AudienceList को एक्सपोर्ट किए जाने के बारे में कॉन्फ़िगरेशन डेटा. इस जवाब की Google शीट में AudienceList को समझने के लिए, यह फ़ॉर्म लौटाया गया है. उदाहरण के लिए, AudienceList में Google शीट में मौजूद पंक्तियों से ज़्यादा लाइनें हो सकती हैं. ऐसे में, हो सकता है कि आप किसी अतिरिक्त Google शीट में पंक्तियों का अगला पेज फिर से पाने के लिए, किसी अलग |
अनुमति के दायरे
इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets