शुरुआती जानकारी
Linking API से उपयोगकर्ताओं को सीधे यूआरएल के ज़रिए, Looker Studio की रिपोर्ट को कॉन्फ़िगर और फ़ॉरवर्ड करने के लिए एक भरोसेमंद इंटरफ़ेस मिलता है. जब उपयोगकर्ता किसी Linking API URL को फ़ॉलो करते हैं, तो वे अपने डेटा को तुरंत देख सकते हैं और उससे इंटरैक्ट कर सकते हैं.
इस दस्तावेज़ में, Linking API यूआरएल को जोड़ने के लिए ज़रूरी फ़ॉर्मैट और उपलब्ध पैरामीटर की जानकारी दी गई है.
इस्तेमाल का उदाहरण और फ़ायदे
Linking API का इस्तेमाल करके, ग्राहकों को पहले से कॉन्फ़िगर की गई रिपोर्ट दी जा सकती हैं, ताकि वे अपने ग्राहकों का डेटा देख सकें और उससे इंटरैक्ट कर सकें. Linking API के मुख्य फ़ायदे यहां दिए गए हैं:
- आपके ग्राहकों के लिए एक-क्लिक में रिपोर्ट बनाने का अनुभव.
- डेटा कॉन्फ़िगरेशन यूआरएल में दिया गया है, ताकि उपयोगकर्ताओं को अपने डेटा के लिए, रिपोर्ट कॉन्फ़िगर करने की ज़रूरत न पड़े.
- उपयोगकर्ता एक क्लिक से रिपोर्ट को सेव कर सकते हैं और किसी भी समय उस रिपोर्ट को फिर से देख सकते हैं.
- बड़े पैमाने पर रिपोर्ट बनाएं. Linking API से नई रिपोर्ट बनाने या डुप्लीकेट रिपोर्ट बनाने में लगने वाला समय कम होता है.
- प्रॉडक्ट इंटिग्रेशन चालू करना. स्थायी इंटरफ़ेस की मदद से, Looker Studio को प्रॉडक्ट वर्कफ़्लो में इंटिग्रेट किया जा सकता है.
यह कैसे काम करता है
नीचे यह बताया गया है कि डेवलपर और उपयोगकर्ता, Linking API के साथ इंटरैक्ट करने का तरीका इस्तेमाल करते हैं.
Linking API डेवलपर वर्कफ़्लो
डेवलपर टेंप्लेट रिपोर्ट, डेटा सोर्स, और लिंकिंग एपीआई यूआरएल को फ़ॉर्मैट करता है. डेवलपर के लिए सामान्य वर्कफ़्लो इस तरह से होता है:
- तय करें कि आपको खाली रिपोर्ट, Looker Studio से मिले डिफ़ॉल्ट रिपोर्ट टेंप्लेट का इस्तेमाल करना है या एक ऐसी Looker Studio रिपोर्ट बनानी है जो टेंप्लेट के तौर पर काम करेगी. इसमें टेंप्लेट के डेटा सोर्स को कॉन्फ़िगर करना भी शामिल है.
- Linking API के यूआरएल को फ़ॉर्मैट करना, ताकि आपको खास तरह की मदद मिल सके. अगर लागू हो, तो रिपोर्ट टेंप्लेट और दूसरे पैरामीटर के बारे में बताएं. इनमें रिपोर्ट का नाम, डेटा सोर्स का नाम, और डेटा सोर्स के कॉन्फ़िगरेशन शामिल हैं.
- उपयोगकर्ताओं को रिपोर्ट पर भेजने के लिए, Linking API के यूआरएल का इस्तेमाल करें.
Linking API का उपयोगकर्ता अनुभव
उपयोगकर्ता, Linking API यूआरएल को फ़ॉलो करता है. अगर डेवलपर उसे सही तरीके से कॉन्फ़िगर करता है, तो वह उसे Looker Studio की रिपोर्ट पर ले जाएगा. इस रिपोर्ट से, उपयोगकर्ता उस डेटा को देख सकता है और उससे इंटरैक्ट कर सकता है जिसका ऐक्सेस उसके पास है. किसी सामान्य उपयोगकर्ता अनुभव पर ऐसा हो सकता है:
- ब्राउज़र में, उपयोगकर्ता उस सेवा पर जाता है जिसे Linking API से इंटिग्रेट किया गया है.
- कॉल-टू-ऐक्शन की मदद से, उपयोगकर्ता को Looker Studio में अपना डेटा देखने के लिए, किसी लिंक पर क्लिक करने का न्योता मिलता है.
- उपयोगकर्ता, उस लिंक पर जाकर Looker Studio की रिपोर्ट पर पहुंच जाता है. रिपोर्ट लोड होती है और उपयोगकर्ता अपना डेटा देख सकता है और उसके साथ इंटरैक्ट कर सकता है.
- उपयोगकर्ता “बदलाव करें और शेयर करें” पर क्लिक करता है. रिपोर्ट, उनके Looker Studio खाते में सेव हो जाती है.
- उपयोगकर्ता के पास अब रिपोर्ट की अपनी कॉपी का पूरा ऐक्सेस और कंट्रोल है. वे किसी भी समय देख सकते हैं, बदलाव कर सकते हैं और शेयर कर सकते हैं.
ज़रूरी शर्तें
Linking API का यूआरएल ठीक से काम कर रहा है या नहीं, यह पक्का करने के लिए नीचे दी गई चीज़ें ज़रूरी हैं:
- टेंप्लेट के तौर पर काम करने के लिए, रिपोर्ट. अगर वैल्यू नहीं दी जाती है, तो Looker Studio से मिली खाली रिपोर्ट या डिफ़ॉल्ट रिपोर्ट का इस्तेमाल किया जा सकता है.
- Linking API यूआरएल के उपयोगकर्ताओं के पास कम से कम टेंप्लेट रिपोर्ट को देखने का ऐक्सेस होना चाहिए. रिपोर्ट में इस्तेमाल किए गए डेटा सोर्स के टाइप और Linking API से मिले कॉन्फ़िगरेशन के आधार पर, उपयोगकर्ताओं को डेटा सोर्स को देखने के ऐक्सेस की ज़रूरत भी पड़ सकती है. ज़्यादा जानकारी के लिए टेंप्लेट की अनुमतियां देखें.
- हर डेटा सोर्स के कनेक्टर टाइप में, लिंकिंग एपीआई की मदद से कॉन्फ़िगरेशन के साथ काम करना चाहिए. इस्तेमाल किए जा सकने वाले कनेक्टर की सूची के लिए, कनेक्टर का रेफ़रंस देखें.
- Linking API के यूआरएल का इस्तेमाल करने वालों के पास, उस डेटा का ऐक्सेस होना चाहिए जिसे लिंकिंग एपीआई यूआरएल में कॉन्फ़िगर किया गया है. अगर उपयोगकर्ता के पास दिए गए डेटा का ऐक्सेस नहीं है, तो कोई भी डिपेंडेंट रिपोर्ट कॉम्पोनेंट गड़बड़ी दिखाएंगे.
यूआरएल के पैरामीटर
Linking API का यूआरएल इस तरह का होना चाहिए:
https://lookerstudio.google.com/reporting/create?parameters
यूआरएल का इस्तेमाल वेब ब्राउज़र के हिसाब से किया जाना चाहिए. आम तौर पर, उपयोगकर्ता किसी लिंक पर क्लिक करता है या उसे यूआरएल पर रीडायरेक्ट करता है. इसका इस्तेमाल रिपोर्ट एम्बेड करने के लिए भी किया जा सकता है.
उदाहरण के तौर पर दिया गया यूआरएल
Linking API यूआरएल का उदाहरण नीचे दिया गया है. रिपोर्ट का नाम सेट किया गया है और एक BigQuery डेटा सोर्स कॉन्फ़िगर किया गया है:
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&r.reportName=MyNewReport
&ds.ds0.connector=bigQuery
&ds.ds0.datasourceName=MyNewDataSource
&ds.ds0.projectId=project-1234
&ds.ds0.type=TABLE
&ds.ds0.datasetId=456
&ds.ds0.tableId=789
कुछ यूआरएल पैरामीटर ज़रूरी होते हैं, जबकि कुछ वैकल्पिक होते हैं. Linking API यूआरएल को तय करने के लिए इस्तेमाल किए गए पैरामीटर की सूची यहां दी गई है:
कंट्रोल पैरामीटर
कंट्रोल पैरामीटर से यह तय होता है कि लिंकिंग एपीआई यूआरएल की मदद से रिपोर्ट देखने पर, रिपोर्ट की स्थिति क्या है.
पैरामीटर का नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. टेंप्लेट रिपोर्ट का आईडी. Looker Studio, बताई गई रिपोर्ट को खोलकर उसे कॉन्फ़िगर करेगा. आईडी ढूंढने का तरीका जानने के लिए, रिपोर्ट आईडी देखें. अगर जानकारी नहीं दी गई है, तो खाली रिपोर्ट या डिफ़ॉल्ट रिपोर्ट टेंप्लेट का इस्तेमाल किया जाता है. ज़्यादा जानकारी के लिए, खाली या डिफ़ॉल्ट रिपोर्ट इस्तेमाल करें देखें. | |
ज़रूरी नहीं. रिपोर्ट में लोड होने वाले शुरुआती पेज का आईडी. अगर कोई जानकारी नहीं दी गई है, तो रिपोर्ट के पहले पेज पर डिफ़ॉल्ट रूप से . | |
ज़रूरी नहीं. शुरुआती रिपोर्ट मोड.
view या
edit में से कोई एक. जानकारी न होने पर, डिफ़ॉल्ट वैल्यू view होती है.
|
|
ज़रूरी नहीं. जानकारी/डीबग डायलॉग दिखने की जानकारी. डायलॉग बटन दिखाने के लिए, इसे
true पर सेट करें. कोई जानकारी न होने पर,
false को डिफ़ॉल्ट के तौर पर सेट किया जाता है. ज़्यादा जानने के लिए,
कॉन्फ़िगरेशन से जुड़ी समस्याओं को हल करना देखें.
|
उदाहरण
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&c.pageId=g7u8s9
&c.mode=edit
&r.reportName=MyNewReport
&ds.ds0.datasourceName=MyNewDataSource
&ds.ds0.connector=bigQuery
&ds.ds0.projectId=project-1234
&ds.ds0.type=TABLE
&ds.ds0.datasetId=456
&ds.ds0.tableId=789
रिपोर्ट के पैरामीटर
रिपोर्ट पैरामीटर, रिपोर्ट प्रॉपर्टी को बदल देते हैं.
पैरामीटर का नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. रिपोर्ट का नाम सेट करता है. अगर इसकी जानकारी नहीं दी गई है, तो टेंप्लेट रिपोर्ट का नाम डिफ़ॉल्ट तौर पर सेट रहता है. | |
ज़रूरी नहीं. यह Google Analytics मेज़रमेंट आईडी को, रिपोर्ट के इस्तेमाल को मेज़र करने के लिए सेट करता है. एक से ज़्यादा आईडी को अलग करने के लिए, कॉमा का इस्तेमाल करें. अगर |
|
ज़रूरी नहीं. टेंप्लेट रिपोर्ट का इस्तेमाल करने के लिए,
Google Analytics मेज़रमेंट आईडी को अगर |
उदाहरण
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&r.reportName=MyNewReport
&r.measurementId=G-XXXXXXXXXX
&ds.ds0.datasourceName=MyNewDataSource
&ds.ds0.connector=bigQuery
&ds.ds0.projectId=project-1234
&ds.ds0.type=TABLE
&ds.ds0.datasetId=456
&ds.ds0.tableId=789
डेटा स्रोत पैरामीटर
डेटा सोर्स पैरामीटर की मदद से, टेंप्लेट रिपोर्ट में डेटा सोर्स का कॉन्फ़िगरेशन और डेटा सोर्स तय करने के लिए डेटा तय किया जा सकता है.
alias
का इस्तेमाल किसी मौजूदा रिपोर्ट में डेटा सोर्स का रेफ़रंस देने के लिए किया जाता है. अगर टेंप्लेट रिपोर्ट में किसी डेटा सोर्स को जोड़ा या हटाया जाता है, तो
उपनाम का इस्तेमाल करके, पुराने सिस्टम के साथ काम किया जा सकता है.
डेटा सोर्स alias
को ढूंढने का तरीका जानने के लिए, डेटा सोर्स का उपनाम देखें.
डेटा स्रोत पैरामीटर
नीचे दिए गए पैरामीटर, सभी तरह के कनेक्टर में सामान्य हैं:
नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. डेटा सोर्स का नाम सेट करता है. अगर |
|
ज़रूरी नहीं. टेंप्लेट के डेटा सोर्स का नाम इस्तेमाल करने के लिए,
अगर |
|
ज़रूरी नहीं.
डेटा सोर्स का कनेक्टर टाइप. काम करने वाले कनेक्टर टाइप के बारे में ज़्यादा जानने के लिए, कनेक्टर रेफ़रंस देखें. अगर यह नीति सेट की जाती है, तो कनेक्टर टाइप के लिए सभी ज़रूरी कनेक्टर पैरामीटर, Linking API के यूआरएल में शामिल होने चाहिए. साथ ही, टेंप्लेट के डेटा सोर्स का कॉन्फ़िगरेशन पूरी तरह से बदल दिया जाएगा. अगर जानकारी नहीं दी गई है, तो कनेक्टर टाइप के लिए शून्य या इससे ज़्यादा कनेक्टर पैरामीटर, Linking API के यूआरएल में दिए जा सकते हैं. टेंप्लेट के डेटा सोर्स के कॉन्फ़िगरेशन का इस्तेमाल, ऐसे सभी पैरामीटर तय करने के लिए किया जाएगा जो Linking API के यूआरएल में नहीं दिए गए हैं. टेंप्लेट डेटा सोर्स के कनेक्टर टाइप की पहचान करने का तरीका जानने के लिए, कनेक्टर का टाइप लेख पढ़ें. इस बारे में ज़्यादा जानने के लिए कि |
|
ज़रूरी नहीं.
Linking API के ज़रिए
तय किए गए डेटा सोर्स कॉन्फ़िगरेशन का इस्तेमाल करने के लिए,
डेटा सोर्स फ़ील्ड को
टेंप्लेट रिपोर्ट में बिना कोई बदलाव किए छोड़ने के लिए,
अगर कोई वैल्यू तय नहीं की गई है, तो कनेक्टर टाइप के हिसाब से डिफ़ॉल्ट सेटिंग अलग-अलग होती हैं. कनेक्टर के हिसाब से डिफ़ॉल्ट सेटिंग को इस्तेमाल करने के लिए, कनेक्टर रेफ़रंस देखें. इससे, आपको डिफ़ॉल्ट तौर पर तय की गई डिफ़ॉल्ट सेटिंग में बदलाव करने में मदद मिलेगी. refreshFields का इस्तेमाल करते समय इन बातों का ध्यान रखें:
|
|
ज़रूरी है. कनेक्टर टाइप के लिए, डेटा सोर्स का कॉन्फ़िगरेशन. डेटा सोर्स बनाने के लिए इस्तेमाल किए गए कनेक्टर की पहचान करने के तरीके की जानकारी के लिए, कनेक्टर का टाइप लेख पढ़ें. हर कनेक्टर टाइप के लिए उपलब्ध डेटा सोर्स पैरामीटर की जानकारी पाने के लिए, कनेक्टर का रेफ़रंस देखें. |
बदलें बनाम अपडेट - डेटा सोर्स कॉन्फ़िगरेशन
डेटा सोर्स के पैरामीटर सेट करते समय, Linking API यूआरएल में
ds.connector
पैरामीटर की मौजूदगी या विलोपन से, टेंप्लेट के डेटा सोर्स के कॉन्फ़िगरेशन को बदलने या अपडेट करने का पता चलता है.
इस टेबल में बताया गया है कि ds.connector
पैरामीटर इस बात पर कैसे असर डालता है कि
टेंप्लेट डेटा सोर्स के कॉन्फ़िगरेशन को पूरी तरह से बदला गया है या उन पैरामीटर को अपडेट
करने के लिए इस्तेमाल किया गया है जिनके बारे में नहीं बताया गया है:
क्या ds.connector सेट है? |
अपेक्षित कॉन्फ़िगरेशन और व्यवहार | आम इस्तेमाल |
---|---|---|
हां |
बदलें. टेंप्लेट के डेटा सोर्स के कॉन्फ़िगरेशन को पूरी तरह से बदल दिया जाता है. इसके लिए, Linking API यूआरएल में बताए गए डेटा सोर्स पैरामीटर का इस्तेमाल किया जाता है. कनेक्टर टाइप के लिए, आपको सभी ज़रूरी पैरामीटर तय करने होंगे. ds.connector सेट होने पर
ज़रूरी पैरामीटर देखें.
|
|
नहीं | अपडेट करें. टेंप्लेट के डेटा सोर्स के कॉन्फ़िगरेशन का इस्तेमाल,
ऐसे सभी पैरामीटर तय करने के लिए किया जाएगा जो Linking API के यूआरएल में नहीं दिए गए हैं. जब तक अलग से निर्देश न दिए जाएं, तब तक कनेक्टर टाइप के लिए सभी कनेक्टर पैरामीटर ज़रूरी नहीं होते.
यह Linking API के यूआरएल को इस्तेमाल करने का तरीका आसान बनाता है. आम तौर पर, इसका सुझाव तब दिया जाता है, जब आपको टेंप्लेट के डेटा सोर्स के कॉन्फ़िगरेशन के बारे में पता होता है और आपको सिर्फ़ पैरामीटर के सबसेट को बदलना होता है. |
|
ds.connector
सेट होने पर ज़रूरी पैरामीटर
अगर डेटा सोर्स के ds.connector
पैरामीटर की जानकारी दी गई है, तो डेटा सोर्स के लिए ज़रूरी के तौर पर तय किए गए सभी कनेक्टर पैरामीटर
तय होने चाहिए. अगर डेटा सोर्स के ds.connector
पैरामीटर की जानकारी नहीं दी गई है, तो सभी कनेक्टर पैरामीटर को वैकल्पिक माना जा सकता है. इनमें ज़रूरत के मुताबिक पैरामीटर भी हो सकते हैं.
उदाहरण
यह रिपोर्ट, एक BigQuery डेटा सोर्स (ds0
) वाली रिपोर्ट को कॉन्फ़िगर करती है और डेटा सोर्स के कॉन्फ़िगरेशन को पूरी तरह से बदल देती है:
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&r.reportName=MyNewReport
&ds.ds0.datasourceName=MyNewDataSource
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=bigquery-public-data
&ds.ds0.datasetId=samples
&ds.ds0.tableId=shakespeare
रिपोर्ट में एक डेटा सोर्स होने पर, डेटा सोर्स का उपनाम हटाया जा सकता है. ऊपर दिए गए यूआरएल से, ये काम किए जा सकते हैं:
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&r.reportName=MyNewReport
&ds.datasourceName=MyNewDataSource
&ds.connector=bigQuery
&ds.type=TABLE
&ds.projectId=bigquery-public-data
&ds.datasetId=samples
&ds.tableId=shakespeare
एक BigQuery डेटा सोर्स (ds0
) वाली रिपोर्ट को कॉन्फ़िगर करती है और
डेटा सोर्स के सिर्फ़ बिलिंग प्रोजेक्ट आईडी
अपडेट करती है:
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&r.reportName=MyNewReport
&ds.ds0.billingProjectId=my-billing-project
यह रिपोर्ट को दो डेटा सोर्स, BigQuery डेटा सोर्स (ds0
) और
Google Analytics डेटा सोर्स (ds1
) के साथ कॉन्फ़िगर करती है. BigQuery डेटा सोर्स का कॉन्फ़िगरेशन
पूरी तरह से बदला जाता है, जबकि Google Analytics का कॉन्फ़िगरेशन किसी
एक पैरामीटर को अपडेट करता है और
किसी भी कनेक्टर पैरामीटर के लिए जानकारी नहीं दिए गए ds1
टेंप्लेट डेटा सोर्स पर निर्भर करता है:
https://lookerstudio.google.com/reporting/create?
c.reportId=7890
&r.reportName=MyNewReportWithMultipleDataSources
&ds.ds0.datasourceName=MyNewDataSource
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=bigquery-public-data
&ds.ds0.datasetId=samples
&ds.ds0.tableId=shakespeare
&ds.ds1.viewId=92320289
बनाना बनाम जोड़ना
कई रिपोर्ट में एक ही डेटा सोर्स का होना कभी-कभी मददगार हो सकता है, इसलिए डेटा सोर्स में किए गए अपडेट सभी रिपोर्ट पर एक साथ असर डालते हैं. Linking API की मदद से रिपोर्ट बनाते समय, आपको अपनी टेंप्लेट रिपोर्ट से डेटा सोर्स को फिर से जोड़ने का विकल्प मिलता है. ऐसा करने के लिए, पक्का करें कि ये शर्तें पूरी हुई हों:
- डेटा सोर्स फिर से इस्तेमाल किया जा सकता है (एम्बेड किए गए डेटा सोर्स बनाम फिर से इस्तेमाल किए जा सकने वाले डेटा सोर्स देखें)
- यूआरएल, डेटा सोर्स को उपनाम से रेफ़र नहीं करता है
- यह यूआरएल, वाइल्डकार्ड उपनाम का इस्तेमाल नहीं करता है (डेटा सोर्स उपनाम वाइल्डकार्ड देखें)
जब Linking API की मदद से एक नया डेटा सोर्स बनाया जाता है, तो वह उस यूआरएल पर क्लिक करने वाले उपयोगकर्ता के क्रेडेंशियल का इस्तेमाल करता है. इसका मतलब है कि उपयोगकर्ता के पास असल डेटा का ऐक्सेस होना चाहिए, नहीं तो कनेक्शन काम नहीं करेगा. जनरेट की गई नई रिपोर्ट में डेटा सोर्स को फिर से जोड़कर, उसके क्रेडेंशियल सुरक्षित रखे जा सकते हैं, ताकि उपयोगकर्ता अपनी नई रिपोर्ट में डेटा को ऐक्सेस करना जारी रख सकें.
डेटा सोर्स का उपनाम वाइल्डकार्ड
कई डेटा सोर्स पर Linking API पैरामीटर को लागू करने के लिए, डेटा सोर्स के उपनाम की जगह वाइल्डकार्ड उपनाम
ds.*
का इस्तेमाल किया जा सकता है.
यह आपके यूआरएल से बार-बार इस्तेमाल होने वाले पैरामीटर हटाने में मदद कर सकता है. उदाहरण
के लिए, अगर आपके पास तीन BigQuery डेटा सोर्स से जुड़ा एक टेंप्लेट है और आपको हर एक में projectId
और datasetId
को बदलना है, लेकिन tableId
को सुरक्षित रखना है, तो उसे इस तरह लिखें:
https://lookerstudio.google.com/reporting/create?
c.reportId=7890
&ds.ds1.projectId=client-project
&ds.ds1.datasetId=client-dataset
&ds.ds2.projectId=client-project
&ds.ds2.datasetId=client-dataset
&ds.ds3.projectId=client-project
&ds.ds3.datasetId=client-dataset
इसके अलावा, ds.*
वाइल्डकार्ड के साथ, इस मिलते-जुलते यूआरएल का इस्तेमाल किया जा सकता है:
https://lookerstudio.google.com/reporting/create?
c.reportId=7890
&ds.*.projectId=client-project
&ds.*.datasetId=client-dataset
Linking API में दिए गए उन पैरामीटर को प्राथमिकता दी जाती है जो ds.*
वाइल्डकार्ड का इस्तेमाल नहीं करते हैं. ऊपर दिए गए उदाहरण में, वाइल्डकार्ड से वैल्यू बदलने के लिए, एक खास डेटा सोर्स उपनाम जोड़ा जा सकता है.
https://lookerstudio.google.com/reporting/create?
c.reportId=7890
&ds.*.projectId=client-project
&ds.*.datasetId=client-dataset
&ds.ds1.datasetId=client-dataset
आम तौर पर, पैरामीटर की प्राथमिकता का क्रम इस तरह होता है:
- खास उपनाम (
ds.ds1.datasetId
) के साथ दिया गया पैरामीटर - वाइल्डकार्ड (
ds.*.datasetId
) का इस्तेमाल करके दिया गया पैरामीटर - अगर ds.connector दिया गया नहीं है, तो टेंप्लेट डेटा सोर्स से मिला वैल्यू (बदलें बनाम अपडेट देखें)
- पैरामीटर की डिफ़ॉल्ट वैल्यू, अगर यह ज़रूरी नहीं है.
कनेक्टर का रेफ़रंस
Linking API में नीचे दिए गए कनेक्टर और कॉन्फ़िगरेशन काम करते हैं. हर कनेक्टर के लिए, उपलब्ध डेटा सोर्स पैरामीटर की सूची दी गई है.
BigQuery
BigQuery कनेक्टर दो तरह की क्वेरी के साथ काम करता है, TABLE
क्वेरी, जिसमें क्वेरी करने के लिए टेबल का टेबल आईडी और CUSTOM_QUERY
दिया जाता है. इसमें टेबल से क्वेरी करने के लिए SQL स्टेटमेंट दिया जाता है.
TABLE क्वेरी
ये पैरामीटर तब लागू होते हैं, जब type
को TABLE
पर सेट किया जाता है और आप
क्वेरी करने के लिए टेबल का आईडी देते हैं.
पैरामीटर का नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. BigQuery
कनेक्टर के लिए,
bigQuery पर सेट करें.अगर सेट किया जाता है, तो डेटा सोर्स को उपलब्ध कराए गए BigQuery कॉन्फ़िगरेशन से बदल देता है. बदलें बनाम अपडेट देखें. |
|
ज़रूरी है** क्वेरी किस तरह की है. TABLE
पर सेट करें. |
|
ज़रूरी है** क्वेरी के लिए टेबल का प्रोजेक्ट आईडी. | |
ज़रूरी है** क्वेरी के लिए टेबल का डेटासेट आईडी. | |
ज़रूरी** क्वेरी के लिए टेबल का
टेबल आईडी. तारीख के लिए शार्ड टेबल: * (वाइल्डकार्ड कैरेक्टर) या YYYYMMDD सफ़िक्स, तारीख के हिसाब से शार्ड टेबल की क्वेरी करते समय काम करता है.अगर किसी टेबल की पहचान Google Analytics, Firebase Analytics या Firebase Crashlytics के तौर पर की जाती है, तो डिफ़ॉल्ट फ़ील्ड टेंप्लेट चुना जाएगा. फ़ील्ड टेंप्लेट टेबल से जुड़े पैरामीटर देखें. |
|
ज़रूरी नहीं. बिलिंग के लिए इस्तेमाल किए जाने वाले प्रोजेक्ट का आईडी. अगर यह नीति सेट नहीं है, तो
projectId का इस्तेमाल किया जाएगा. |
|
ज़रूरी नहीं. अगर टेबल को सेगमेंट में बांटा गया है और आपको
तारीख की सीमा वाले डाइमेंशन के तौर पर सेगमेंटेशन कॉलम का इस्तेमाल करना है, तो true पर सेट करें. यह सिर्फ़ समय के हिसाब से सेगमेंट में बांटने (उदाहरण के लिए, समय के हिसाब से पार्टीशन कॉलम या _PARTITIONTIME स्यूडोकॉलम का इस्तेमाल करना) पर लागू होता है. साथ ही, यह
पूर्णांक के आधार पर सेगमेंट में बांटी गई टेबल के लिए काम नहीं करता. कोई जानकारी न होने पर,
false को डिफ़ॉल्ट के तौर पर सेट किया जाता है. ज़्यादा जानने के लिए,
सेगमेंट में बांटी गई टेबल के बारे में जानकारी देखें. |
|
ज़रूरी नहीं. जानकारी न होने पर, डिफ़ॉल्ट वैल्यू true होती है. ज़्यादा जानकारी के लिए, refreshFields को देखें. |
Google Analytics, Firebase Analytics, और Crashlytics के लिए फ़ील्ड टेंप्लेट
Google Analytics, Firebase Analytics या Firebase Crashlytics के रूप में पहचानी गई टेबल के लिए, फ़ील्ड टेंप्लेट सेट करने के लिए दूसरे पैरामीटर उपलब्ध हैं. अगर जानकारी नहीं दी गई है, तो डिफ़ॉल्ट टेंप्लेट चुना जाएगा.
नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. इस्तेमाल करने के लिए Google Analytics फ़ील्ड टेंप्लेट. सिर्फ़ तब लागू होता है, जब Google Analytics की टेबल के लिए BigQuery Export के बारे में क्वेरी की गई हो. ALL , SESSION , HITS में से एक. Google
Analytics की टेबल के लिए, जानकारी न देने पर डिफ़ॉल्ट रूप से ALL सेट होता है. |
|
ज़रूरी नहीं. इस्तेमाल करने के लिए Firebase Analytics फ़ील्ड टेंप्लेट. लागू
सिर्फ़ तब होता है, जब Firebase Analytics टेबल के लिए BigQuery एक्सपोर्ट के बारे में क्वेरी की गई हो.
सिर्फ़ EVENTS पर सेट किया जा सकता है. Firebase Analytics टेबल के लिए,
तय न होने पर EVENTS डिफ़ॉल्ट रूप से सेट हो जाता है. |
|
Firebase Crashlytics फ़ील्ड का इस्तेमाल करने के लिए टेंप्लेट. सिर्फ़ DEFAULT पर सेट किया जा सकता है. यह तब ही लागू होता है, जब Firebase के लिए BigQuery एक्सपोर्ट की
Crashlytics टेबल के बारे में क्वेरी की गई हो. Firebase Crashlytics टेबल के लिए, अगर इसकी जानकारी नहीं दी गई है, तो डिफ़ॉल्ट रूप से DEFAULT पर सेट होती है. |
CUSTOM क्वेरी
ये पैरामीटर तब लागू होते हैं, जब type
को CUSTOM_QUERY
पर सेट किया जाता है और
टेबल से क्वेरी करने के लिए SQL स्टेटमेंट दिया जाता है.
पैरामीटर का नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. BigQuery
कनेक्टर के लिए,
bigQuery पर सेट करें.अगर सेट किया जाता है, तो डेटा सोर्स को उपलब्ध कराए गए BigQuery कॉन्फ़िगरेशन से बदल देता है. बदलें बनाम अपडेट देखें. |
|
ज़रूरी है** क्वेरी किस तरह की है. CUSTOM_QUERY
पर सेट करें. |
|
ज़रूरी है** चलाने के लिए एसक्यूएल क्वेरी. | |
ज़रूरी नहीं. बिलिंग के लिए इस्तेमाल किए जाने वाले प्रोजेक्ट का आईडी. अगर यह नीति सेट नहीं है, तो
projectId का इस्तेमाल किया जाएगा. अगर projectId सेट नहीं है,
तो क्वेरी की गई टेबल के प्रोजेक्ट का इस्तेमाल किया जाएगा. |
|
ज़रूरी नहीं. एसक्यूएल क्वेरी पर लागू करने के लिए, पैटर्न और रीप्लेसमेंट स्ट्रिंग की कॉमा-डीलिमिटेड सूची. स्ट्रिंग बदलने की सुविधा सिर्फ़ तब लागू की जाती है, जब कोई
पैटर्न मिलता-जुलता हो. पैटर्न और स्ट्रिंग के जोड़े को अलग-अलग करने के लिए, कॉमा का इस्तेमाल करें. उदाहरण के लिए, |
|
ज़रूरी नहीं. जानकारी न होने पर, डिफ़ॉल्ट वैल्यू true होती है. ज़्यादा जानकारी के लिए, refreshFields को देखें. |
उदाहरण
TABLE
टाइप का कॉन्फ़िगरेशन, जिसमें क्वेरी को टेबल आईडी की मदद से तय किया जाता है:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=bigquery-public-data
&ds.ds0.datasetId=samples
&ds.ds0.tableId=shakespeare
&ds.ds0.billingProjectId=myProject
वाइल्डकार्ड कैरेक्टर सफ़िक्स का इस्तेमाल करके, तारीख वाले शार्ड टेबल के बारे में क्वेरी करने के लिए TABLE
टाइप का कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=price-data
&ds.ds0.datasetId=samples
&ds.ds0.tableId=stock_*
YYYYMMDD
सफ़िक्स का इस्तेमाल करके, तारीख वाली शार्ड टेबल के बारे में क्वेरी करने के लिए TABLE
टाइप का कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=price-data
&ds.ds0.datasetId=samples
&ds.ds0.tableId=stock_YYYYMMDD
SESSION
फ़ील्ड टेंप्लेट का इस्तेमाल करके, Google Analytics टेबल से BigQuery Export की क्वेरी करने के लिए TABLE
टाइप का कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=my-gabq-project
&ds.ds0.datasetId=1234567
&ds.ds0.tableId=ga_sessions_YYYYMMDD
&ds.ds0.gaTemplateLevel=SESSION
डेटा जोड़ने के समय के हिसाब से सेगमेंट में बांटी गई टेबल के बारे में क्वेरी करने और तारीख की सीमा वाले डाइमेंशन के तौर पर बंटवारे वाले कॉलम का इस्तेमाल करने के लिए, TABLE
टाइप का कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=acme-co-logs
&ds.ds0.datasetId=logs
&ds.ds0.tableId=logs_table
&ds.ds0.isPartitioned=true
CUSTOM_QUERY
टाइप का एक कॉन्फ़िगरेशन, जहां उनकी क्वेरी को एसक्यूएल स्टेटमेंट की मदद से बताया जाता है:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=CUSTOM_QUERY
&ds.ds0.projectId=bigquery-public-data
&ds.ds0.sql=SELECT%20word%2C%20word_count%20FROM%20%60bigquery-public-data.samples.shakespeare%60
&ds.ds0.billingProjectId=myProject
CUSTOM_QUERY
टाइप का कॉन्फ़िगरेशन, जिसमें सिर्फ़ SQL स्टेटमेंट को अपडेट किया जाता है और
टेंप्लेट डेटा सोर्स का इस्तेमाल बाकी कॉन्फ़िगरेशन के लिए किया जाता है:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.sql=SELECT%20corpus%20FROM%20%60bigquery-public-data.samples.shakespeare%60
CUSTOM_QUERY
टाइप का एक कॉन्फ़िगरेशन, जिसमें sqlReplace
का इस्तेमाल करके टेंप्लेट डेटा सोर्स का SQL स्टेटमेंट अपडेट किया जाता है:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.sqlReplace=bigquery-public-data,new-project,samples,new-dataset
# The following shows a template query before and after sqlReplace is applied.
#
# Template data source custom query:
# SELECT word, word_count FROM big-query-public-data.samples.shakespeare
# INNER JOIN
# SELECT word, word_count FROM big-query-public-data.samples.raleigh
#
# New data source custom query with sqlReplace applied:
# SELECT word, word_count FROM new-project.new-dataset.shakespeare
# INNER JOIN
# SELECT word, word_count FROM new-project.new-dataset.raleigh
Cloud Spanner
पैरामीटर का नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. Cloud
Spanner कनेक्टर के लिए,
cloudSpanner पर सेट करें.अगर इस नीति को सेट किया जाता है, तो यह डेटा सोर्स को दिए गए Cloud Spanner कॉन्फ़िगरेशन से बदल देता है. बदलें बनाम अपडेट देखें. |
|
ज़रूरी है** प्रोजेक्ट आईडी. | |
ज़रूरी है** इंस्टेंस आईडी. | |
ज़रूरी है** डेटाबेस आईडी. | |
ज़रूरी है** चलाने के लिए एसक्यूएल क्वेरी. | |
ज़रूरी नहीं. जानकारी न होने पर, डिफ़ॉल्ट वैल्यू true होती है.
ज़्यादा जानकारी के लिए रीफ़्रेश फ़ील्ड देखें. |
उदाहरण
SQL स्टेटमेंट के साथ Cloud Spanner कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=456def
&ds.ds1.connector=cloudSpanner
&ds.ds1.projectId=myProject
&ds.ds1.instanceId=production
&ds.ds1.datasetId=transactions
&ds.ds1.sql=SELECT%20accountId%2C%20date%2C%20revenue%20FROM%20sales%3B
समुदाय कनेक्टर
पैरामीटर का नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. कम्यूनिटी कनेक्टर के लिए,
community पर सेट करें.अगर इस नीति को सेट किया जाता है, तो यह डेटा सोर्स को दिए गए कम्यूनिटी कनेक्टर कॉन्फ़िगरेशन से बदल देता है. बदलें बनाम अपडेट देखें. |
|
ज़रूरी है** कम्यूनिटी कनेक्टर
connectorId (इसे deploymentId के नाम से भी जाना जाता है).
| |
ज़रूरी नहीं. कम्यूनिटी कनेक्टर के कनेक्टर कॉन्फ़िगरेशन में बताए गए, कनेक्टर के हिसाब से बने दूसरे पैरामीटर. | |
ज़रूरी नहीं. जानकारी न होने पर, डिफ़ॉल्ट वैल्यू true होती है. ज़्यादा जानकारी के लिए, refreshFields को देखें. |
उदाहरण
state
और city
कॉन्फ़िगरेशन पैरामीटर की मदद से किसी कम्यूनिटी कनेक्टर से कनेक्ट करें:
https://lookerstudio.google.com/reporting/create?
c.reportId=161718pqr
&ds.ds5.connector=community
&ds.ds5.connectorId=AqwqXxQshl94nJa0E0-1MsZXQL0DfCsJIMWk7dnx
&ds.ds5.state=CA
&ds.ds5.city=Sacramento
Google Analytics
पैरामीटर का नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. Google
Analytics कनेक्टर के लिए
googleAnalytics पर सेट करें.अगर सेट हो, तो डेटा सोर्स को दिए गए Google Analytics कॉन्फ़िगरेशन से बदल देता है. बदलें बनाम अपडेट देखें. |
|
ज़रूरी है** खाता आईडी. | |
ज़रूरी है** प्रॉपर्टी आईडी. | |
व्यू आईडी. यह Universal Analytics प्रॉपर्टी के लिए ज़रूरी है**. Google Analytics 4 प्रॉपर्टी के लिए सेट न करें. |
|
ज़रूरी नहीं. जानकारी न होने पर, डिफ़ॉल्ट वैल्यू false होती है. ज़्यादा जानकारी के लिए, refreshFields को देखें. |
उदाहरण
Universal Analytics प्रॉपर्टी के लिए Google Analytics का कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=789ghi
&ds.ds2.connector=googleAnalytics
&ds.ds2.accountId=54516992
&ds.ds2.propertyId=UA-54516992-1
&ds.ds2.viewId=92320289
Google Analytics 4 प्रॉपर्टी के लिए Google Analytics का कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=789ghi
&ds.ds2.connector=googleAnalytics
&ds.ds2.accountId=54516992
&ds.ds2.propertyId=213025502
Google Cloud Storage
पैरामीटर का नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. googleCloudStorage
Google
Cloud Storage कनेक्टर पर सेट करें.अगर इस नीति को सेट किया जाता है, तो यह डेटा सोर्स को Google Cloud Storage के उपलब्ध कराए गए कॉन्फ़िगरेशन से बदल देता है. बदलें बनाम अपडेट देखें. |
|
ज़रूरी है** पाथ टाइप. एक फ़ाइल चुनने के लिए
FILE या दिए गए पाथ की सभी फ़ाइलें चुनने के लिए, FOLDER का इस्तेमाल करें. |
|
ज़रूरी है** अगर pathType , FILE है या फ़ोल्डर पाथ (जैसे कि *MyBucket/MyData) FOLDER है, तो फ़ाइल का पाथ (उदाहरण के लिए, MyBucket/MyData/MyFile.csv).pathType |
|
ज़रूरी नहीं. जानकारी न होने पर, डिफ़ॉल्ट वैल्यू true होती है.
ज़्यादा जानकारी के लिए रीफ़्रेश फ़ील्ड देखें. |
उदाहरण
किसी एक फ़ाइल के लिए Google Cloud Storage कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=231908kpf
&ds.ds50.connector=googleCloudStorage
&ds.ds50.pathType=FILE
&ds.ds50.path=MyBucket%2FMyData%2FMyFile.csv
पाथ की सभी फ़ाइलों के लिए Google Cloud Storage कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=231908kpf
&ds.ds50.connector=googleCloudStorage
&ds.ds50.pathType=FOLDER
&ds.ds50.path=MyBucket%2FMyData
Google Sheets
पैरामीटर का नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. Google
Sheets कनेक्टर के लिए
googleSheets पर सेट करें.अगर सेट हो, तो डेटा सोर्स को Google Sheets के दिए गए कॉन्फ़िगरेशन से बदल देता है. बदलें बनाम अपडेट देखें. |
|
ज़रूरी है** स्प्रेडशीट आईडी. | |
ज़रूरी है** वर्कशीट आईडी. | |
ज़रूरी नहीं. पहली लाइन को हेडर के तौर पर इस्तेमाल करने के लिए, true पर सेट करें.
जानकारी न होने पर, डिफ़ॉल्ट वैल्यू true होती है. कॉलम के हेडर, यूनीक होने चाहिए. डेटा स्रोत में खाली हेडर वाले स्तंभ नहीं जोड़े जाएंगे.
|
|
ज़रूरी नहीं. छिपे हुए सेल शामिल करने के लिए, true पर सेट करें.
जानकारी न होने पर, डिफ़ॉल्ट वैल्यू true होती है. |
|
ज़रूरी नहीं. फ़िल्टर किए गए सेल शामिल करने के लिए, true पर सेट करें.
जानकारी न होने पर, डिफ़ॉल्ट वैल्यू true होती है. |
|
ज़रूरी नहीं. रेंज, जैसे कि A1:B52. | |
ज़रूरी नहीं. जानकारी न होने पर, डिफ़ॉल्ट वैल्यू true होती है. ज़्यादा जानकारी के लिए, refreshFields को देखें. |
उदाहरण
Google Sheets कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=101112jkl
&ds.ds3.connector=googleSheets
&ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
&ds.ds3.worksheetId=903806437
एक Google शीट कॉन्फ़िगरेशन, जिसमें हेडर के रूप में इस्तेमाल की गई पहली पंक्ति और छिपे हुए और फ़िल्टर किए गए सेल शामिल हैं:
https://lookerstudio.google.com/reporting/create?
c.reportId=101112jkl
&ds.ds3.connector=googleSheets
&ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
&ds.ds3.worksheetId=903806437
&ds.ds3.hasHeader=true
&ds.ds3.includeHiddenCells=true
&ds.ds3.includeFilteredCells=true
Google Sheets कॉन्फ़िगरेशन का रेंज (A1:D20):
https://lookerstudio.google.com/reporting/create?
c.reportId=101112jkl
&ds.ds3.connector=googleSheets
&ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
&ds.ds3.worksheetId=903806437
&ds.ds3.range=A1%3AD20
Looker
पैरामीटर का नाम | ब्यौरा |
---|---|
ज़रूरी नहीं.
Looker कनेक्टर के लिए,
looker पर सेट करें.अगर यह नीति सेट है, तो यह डेटा सोर्स को उपलब्ध कराए गए Looker कॉन्फ़िगरेशन से बदल देता है. बदलें बनाम अपडेट देखें. |
|
ज़रूरी है** Looker इंस्टेंस का यूआरएल. | |
ज़रूरी है** Looker मॉडल. | |
ज़रूरी है** Looker Explore. | |
ज़रूरी नहीं. जानकारी न होने पर, डिफ़ॉल्ट वैल्यू false होती है. ज़्यादा जानकारी के लिए, refreshFields को देखें. |
उदाहरण
Looker Explore से कनेक्ट करना:
https://lookerstudio.google.com/reporting/create?
c.reportId=161718pqr
&ds.ds5.connector=looker
&ds.ds5.instanceUrl=my.looker.com
&ds.ds5.model=thelook
&ds.ds5.explore=orders
Search Console
पैरामीटर का नाम | ब्यौरा |
---|---|
ज़रूरी नहीं. Search Console कनेक्टर के लिए,
searchConsole पर सेट करें.अगर सेट हो, तो डेटा सोर्स को दिए गए Search Console के कॉन्फ़िगरेशन से बदल देता है. बदलें बनाम अपडेट देखें. |
|
ज़रूरी है** साइट का यूआरएल. डोमेन प्रॉपर्टी के लिए, प्रीफ़िक्स में sc-domain\: लगाएं. |
|
ज़रूरी है** टेबल का टाइप सेट करता है. SITE_IMPRESSION या URL_IMPRESSION में से एक हो सकता है. |
|
ज़रूरी** खोज का टाइप सेट करता है. WEB , IMAGE , VIDEO या NEWS में से कोई एक हो सकता है. |
|
ज़रूरी नहीं. जानकारी न होने पर, डिफ़ॉल्ट वैल्यू false होती है. ज़्यादा जानकारी के लिए, refreshFields को देखें. |
उदाहरण
यूआरएल-प्रीफ़िक्स प्रॉपर्टी के लिए Search Console का कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=161718pqr
&ds.ds5.connector=searchConsole
&ds.ds5.siteUrl=https%3A%2F%2Fwww.example.com%2Fwelcome
&ds.ds5.tableType=SITE_IMPRESSION
&ds.ds5.searchType=WEB
डोमेन प्रॉपर्टी के लिए Search Console का कॉन्फ़िगरेशन:
https://lookerstudio.google.com/reporting/create?
c.reportId=161718pqr
ds.ds5.connector=searchConsole
&ds.ds5.siteUrl=sc-domain%3Aexample.com
&ds.ds5.tableType=SITE_IMPRESSION
&ds.ds5.searchType=WEB
टेंप्लेट से जुड़ी अनुमतियां
उपयोगकर्ताओं को बेहतरीन उपयोगकर्ता अनुभव देने के लिए, अपनी टेंप्लेट रिपोर्ट और उससे जुड़े डेटा सोर्स के लिए, रिपोर्ट ऐक्सेस करने की अनुमतियों को सही तरीके से सेट करना ज़रूरी है. ज़रूरी अनुमतियां इस बात पर निर्भर करती हैं कि रिपोर्ट टेंप्लेट, एम्बेड किए गए बनाम फिर से इस्तेमाल किए जा सकने वाले डेटा सोर्स का इस्तेमाल करता है या नहीं. साथ ही, यह इस बात पर भी निर्भर करता है कि Linking API कॉन्फ़िगरेशन को किसी डेटा सोर्स के कॉन्फ़िगरेशन को बदलने या अपडेट करने के लिए सेट किया गया है या नहीं.
इस टेबल में, टेंप्लेट डेटा सोर्स और Linking API कॉन्फ़िगरेशन के आधार पर, बेहतरीन उपयोगकर्ता अनुभव के लिए सुझाया गया डेटा सोर्स ऐक्सेस दिया गया है:
डेटा सोर्स का टाइप | डेटा सोर्स के लिए एपीआई कॉन्फ़िगरेशन लिंक करना | डेटा सोर्स की अनुमतियों के लिए सुझाव | नोट |
---|---|---|---|
एम्बेड किया गया | बदलें | लागू नहीं - व्यू का ऐक्सेस, रिपोर्ट से लिया जाएगा. | अगर उपयोगकर्ता के पास टेंप्लेट की रिपोर्ट को देखने का ऐक्सेस है, तो उसे किसी भी एम्बेड किए गए डेटा सोर्स को देखने का ऐक्सेस अपने-आप मिल जाएगा. |
एम्बेड किया गया | अपडेट करें | लागू नहीं - व्यू का ऐक्सेस, रिपोर्ट से लिया जाएगा. | अगर उपयोगकर्ता के पास टेंप्लेट की रिपोर्ट को देखने का ऐक्सेस है, तो उसे किसी भी एम्बेड किए गए डेटा सोर्स को देखने का ऐक्सेस अपने-आप मिल जाएगा. |
फिर से इस्तेमाल किया जा सकता है | बदलें | उपयोगकर्ता को देखने के ऐक्सेस की ज़रूरत नहीं है. | डेटा सोर्स कॉन्फ़िगरेशन को Linking API से पूरी तरह से बदला जा रहा है. इसलिए, व्यू के ऐक्सेस की ज़रूरत नहीं है. |
फिर से इस्तेमाल किया जा सकता है | अपडेट करें | उपयोगकर्ता को देखने का ऐक्सेस चाहिए. | Linking API के लिए डेटा सोर्स को देखने का ऐक्सेस होना ज़रूरी है, ताकि वह टेंप्लेट के डेटा सोर्स के कॉन्फ़िगरेशन को पढ़ और इस्तेमाल कर सके. अगर उपयोगकर्ताओं के पास देखने का ऐक्सेस नहीं है, तो रिपोर्ट लोड करते समय उन्हें गड़बड़ी का मैसेज मिलेगा. |
खाली या डिफ़ॉल्ट रिपोर्ट का इस्तेमाल करें
खाली रिपोर्ट या डिफ़ॉल्ट रिपोर्ट का इस्तेमाल करने के लिए, Linking API को इस तरह कॉन्फ़िगर करें:
रिपोर्ट का टाइप | reportId कंट्रोल पैरामीटर सेट करें |
डेटा सोर्स ( ) के पैरामीटर सेट करें. |
नोट |
---|---|---|---|
रिक्त रिपोर्ट | नहीं | नहीं | |
डिफ़ॉल्ट रिपोर्ट | नहीं | हां | डिफ़ॉल्ट रिपोर्ट, Looker Studio उपलब्ध कराता है. डिफ़ॉल्ट रिपोर्ट के लिए डेटा सोर्स पैरामीटर तय करते समय, डेटा सोर्स के उपनाम का इस्तेमाल करना ज़रूरी नहीं है, क्योंकि डिफ़ॉल्ट रिपोर्ट में एक ही डेटा सोर्स एम्बेड किया गया है. |
नीचे दिए गए उदाहरणों में ऐसे अलग-अलग Linking API यूआरएल दिखाए गए हैं जो खाली या डिफ़ॉल्ट रिपोर्ट का इस्तेमाल करते हैं.
खाली रिपोर्ट के साथ रिपोर्ट बनाने का वर्कफ़्लो शुरू करें:
https://lookerstudio.google.com/reporting/create
एक खाली रिपोर्ट के साथ रिपोर्ट बनाने का वर्कफ़्लो शुरू करें और रिपोर्ट का नाम सेट करें:
https://lookerstudio.google.com/reporting/create?r.reportName=MyNewReport
Google Sheets कनेक्टर कॉन्फ़िगरेशन के साथ, डिफ़ॉल्ट रिपोर्ट टेंप्लेट का इस्तेमाल करें:
https://lookerstudio.google.com/reporting/create?
ds.connector=googleSheets
&ds.spreadsheetId=1Q-w7KeeJj1jk3wFcFm4NsPlppNscs0CtHf_EP9fsYOo
&ds.worksheetId=0
कोई रिपोर्ट एम्बेड करना
Linking API की मदद से बनाई गई रिपोर्ट को एम्बेड करने के लिए, यूआरएल पैरामीटर सेट करें और /embed/
पाथ शामिल करें. Linking API का एम्बेड यूआरएल इस तरह का होना चाहिए:
https://lookerstudio.google.com/embed/reporting/create?parameters
आईडी और उपनाम ढूंढना
रिपोर्ट आईडी
रिपोर्ट आईडी ढूंढने के लिए:
- वह रिपोर्ट खोलें जिसे आपको टेंप्लेट के तौर पर इस्तेमाल करना है. रिपोर्ट के यूआरएल की
जांच करें.
reporting/
और/page
के बीच का हिस्सा, रिपोर्ट आईडी होता है. उदाहरण के लिए, इस यूआरएल में,0B_U5RNpwhcE6SF85TENURnc4UjA
रिपोर्ट आईडी है:
https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M
डेटा सोर्स का उपनाम
एक रिपोर्ट में कई डेटा सोर्स हो सकते हैं. डेटा सोर्स का रेफ़रंस उसके उपनाम से लिया जाना चाहिए.
डेटा सोर्स का उपनाम ढूंढने के लिए:
- रिपोर्ट में बदलाव करें.
- टूलबार से, संसाधन > जोड़े गए डेटा सोर्स मैनेज करें चुनें.
- हर डेटा सोर्स के लिए उपनाम की जानकारी पाने के लिए, Alias कॉलम की जांच करें.
किसी डेटा सोर्स को जोड़ने या हटाने पर, पुराने सिस्टम के साथ काम करने की सुविधा को पक्का करने के लिए, उपनामों में बदलाव किया जा सकता है.
कनेक्टर किस तरह का है
किसी रिपोर्ट में कई डेटा सोर्स हो सकते हैं. हर डेटा सोर्स, एक कनेक्टर को कॉन्फ़िगर करके बनाया जाता है. डेटा सोर्स बनाने के लिए इस्तेमाल किए गए कनेक्टर का टाइप ढूंढने के लिए:
- रिपोर्ट में बदलाव करें.
- टूलबार से, संसाधन > जोड़े गए डेटा सोर्स मैनेज करें चुनें.
- डेटा सोर्स बनाने के लिए इस्तेमाल किए गए कनेक्टर की पहचान करने के लिए, कनेक्टर टाइप कॉलम की जांच करें.
सलाह और समस्या हल करना
अगर आपको समस्या आ रही है, तो संभावित समस्याओं और आम तौर पर होने वाली गड़बड़ियों के बारे में जानने के लिए, नीचे दी गई जानकारी देखें.
डीबग डायलॉग
Looker Studio में बताए गए, Linking API के कॉन्फ़िगरेशन की समीक्षा करने के लिए, डीबग डायलॉग का इस्तेमाल करें. इससे, एपीआई से जुड़ी समस्याओं को डीबग करने में मदद मिल सकती है.
- Linking API के यूआरएल को पार्स करने के दौरान कोई गड़बड़ी होने पर, गड़बड़ी के बारे में जानकारी देने वाला एक डायलॉग अपने-आप दिखेगा.
- जब कोई गड़बड़ी होती है और कोई डायलॉग अपने-आप नहीं दिखता, तो रिपोर्ट के सबसे ऊपर दाईं ओर मौजूद, जानकारी वाला बटन खोजें. डीबग के बारे में ज़्यादा जानकारी पाने के लिए क्लिक करें.
- अगर कोई जानकारी बटन मौजूद नहीं है, तो किसी भी Linking API यूआरएल के आखिर में
&c.explain=true
पैरामीटर को जोड़कर, इस बटन को चालू किया जा सकता है.
अनुमतियां
पक्का करें कि आपके पास डेटा सोर्स के टाइप और Linking API कॉन्फ़िगरेशन के लिए टेंप्लेट की अनुमतियां सही हैं. ज़्यादा जानकारी के लिए टेंप्लेट की अनुमतियां देखें.
अपडेट करना बनाम बदलना
अगर किसी डेटा सोर्स टेंप्लेट से डेटा सोर्स कॉन्फ़िगरेशन अपडेट किया जा रहा है, तो टेंप्लेट के डेटा सोर्स कॉन्फ़िगरेशन और Linking API कॉन्फ़िगरेशन की समीक्षा करें. इससे पक्का किया जा सकेगा कि वे साथ काम करते हैं या नहीं. पुष्टि करें कि नए कॉन्फ़िगरेशन से मिलने वाले फ़ील्ड, रिपोर्ट कॉम्पोनेंट और कॉन्फ़िगरेशन के साथ काम करते हैं.
अपडेट बनाम बदलाव करते समय, ऐसा अमान्य कॉन्फ़िगरेशन सेट किया जा सकता है जिसकी जानकारी नहीं दी गई हो. ज़्यादा जानकारी के लिए बदलें बनाम अपडेट देखें.
फ़ील्ड रीफ़्रेश करना
अगर आपने टेंप्लेट के डेटा सोर्स के लिए, फ़ील्ड के नाम, टाइप या एग्रीगेशन को कॉन्फ़िगर किया है, तो ये बदलाव Linking API से कॉन्फ़िगर किए गए डेटा सोर्स में सिर्फ़ तब ही लागू होंगे, जब ds.refreshFields
पैरामीटर को
false
पर सेट किया गया हो.
अपने Linking API यूआरएल का ds.refreshFields
डेटा सोर्स पैरामीटर देखें. अगर इसे छोड़ दिया जाता है, तो पुष्टि करें कि हर कनेक्टर टाइप के लिए पैरामीटर की डिफ़ॉल्ट वैल्यू
आपके इस्तेमाल के उदाहरण के लिए सही है.
आम तौर पर, अगर आपने टेंप्लेट के डेटा सोर्स में फ़ील्ड कॉन्फ़िगर किए हैं और आपको पक्के तौर पर पता है कि Linking API के ज़रिए नए डेटा सोर्स कॉन्फ़िगरेशन में हमेशा एक जैसे फ़ील्ड आएंगे, तो हमारा सुझाव है कि आप refreshFields
को false
पर सेट करें.
उदाहरण के लिए, अगर रिपोर्ट टेंप्लेट बनाते समय, Looker Studio एक खास डेटा सोर्स फ़ील्ड की पहचान टाइप Number के तौर पर करता है और इसे साल टाइप में बदल दिया जाता है, तो फ़ील्ड कॉन्फ़िगरेशन में किया गया यह बदलाव अब टेंप्लेट डेटा सोर्स का हिस्सा है. सही किए गए फ़ील्ड का इस्तेमाल करने वाले रिपोर्ट टेंप्लेट के किसी भी चार्ट में,
साल दिखाया जाएगा. अगर चार्ट समय पर आधारित है, तो हो सकता है कि यह तब न दिखे. अगर
Linking API का इस्तेमाल एक ऐसा नया डेटा सोर्स कॉन्फ़िगरेशन देने के लिए किया जाता है जो बिलकुल
एक जैसे फ़ील्ड देता है, तो
refreshFields
पैरामीटर की वैल्यू के आधार पर दो नतीजे मिलते हैं:
अगर इसे
true
पर सेट किया जाता है, तो टेंप्लेट के डेटा सोर्स का फ़ील्ड कॉन्फ़िगरेशन नया नहीं होगा.साथ ही, अगर चार्ट एक ही फ़ील्ड कॉन्फ़िगरेशन पर निर्भर हैं, तो हो सकता है कि वे लोड न हों. जैसे, साल वाला फ़ील्ड होना चाहिए.अगर इसे
false
पर सेट किया जाता है, तो टेंप्लेट डेटा सोर्स का फ़ील्ड कॉन्फ़िगरेशन नए डेटा सोर्स में लागू हो जाएगा. साथ ही, रिपोर्ट चार्ट को एक जैसे कॉन्फ़िगरेशन वाले फ़ील्ड मिलेंगे और सही तरीके से लोड होंगे.
सुझाव और सहायता
Linking API से जुड़ी समस्याओं की शिकायत करने या सुझाव या राय देने के लिए, समस्या के ट्रैकर का इस्तेमाल करें. मदद पाने और सवाल पूछने के सामान्य संसाधनों के लिए सहायता देखें.
बदलावों का लॉग
2023-06-06
- Google Analytics मेज़रमेंट आईडी रिपोर्ट सेटिंग को कॉन्फ़िगर करने के लिए,
r.measurementId
औरr.keepMeasurementId
रिपोर्ट पैरामीटर जोड़े गए. - टेंप्लेट के डेटा सोर्स के नाम के फिर से इस्तेमाल को कंट्रोल करने के लिए,
ds.keepDatasourceName
को जोड़ा गया. - रिपोर्ट एम्बेड करें सेक्शन जोड़ा गया.
- BigQuery कनेक्टर
sqlReplace
को जोड़ा गया. इससे आपको टेंप्लेट डेटा सोर्स की SQL क्वेरी अपडेट करने के लिए, पैटर्न और रिप्लेसमेंट स्ट्रिंग तय करने की सुविधा मिलती है.
2023-05-22
- Looker कनेक्टर के लिए सहायता जोड़ी गई.
- कम्यूनिटी कनेक्टर के लिए सहायता जोड़ी गई.
2022-11-21
- खाली रिपोर्ट इस्तेमाल करने की सुविधा जोड़ी गई. खाली या डिफ़ॉल्ट रिपोर्ट का इस्तेमाल करने का तरीका देखें
refreshFields
सेक्शन को सलाह और समस्या हल करने में जोड़ा गया.
2022-11-14
- Google Surveys की सेवा बंद होने की वजह से, Surveys के कनेक्टर का रेफ़रंस हटा दिया गया है.
2022-06-15
- बीटा वर्शन से बाहर है
- इंटिग्रेशन एपीआई का नाम बदलकर, Linking API कर दिया गया है.
- Linking API को बीटा वर्शन से बाहर कर दिया गया है.
- किसी रिपोर्ट पेज से लिंक करने की अनुमति देने के लिए,
pageId
कंट्रोल पैरामीटर जोड़ा गया. mode
कंट्रोल पैरामीटर जोड़ा गया, ताकि रिपोर्ट की स्थिति को लोड होने पर व्यू या बदलाव करें मोड पर सेट किया जा सके.- डेटा स्रोत कॉन्फ़िगरेशन को अब पूरी तरह से या कुछ हद तक अपडेट किया जा सकता है. यह व्यवहार इस बात से तय होता है कि
ds.connector
पैरामीटर सेट है या नहीं. ज़्यादा जानकारी के लिए बदलें बनाम अपडेट देखें. - अगर
c.reportId
पैरामीटर का इस्तेमाल करके कोई रिपोर्ट टेंप्लेट उपलब्ध नहीं कराया जाता, तो अब डिफ़ॉल्ट टेंप्लेट का इस्तेमाल किया जाता है. ds.refreshFields
डेटा सोर्स पैरामीटर जोड़ा गया. इससे यह कंट्रोल किया जा सकता है कि डेटा सोर्स कॉन्फ़िगरेशन लोड करते समय, डेटा सोर्स फ़ील्ड रीफ़्रेश किए जाएं या नहीं.- BigQuery कनेक्टर
- जब
type
कोCUSTOM_QUERY
पर सेट किया जाता है, तोprojectId
की ज़रूरत नहीं होती. - अगर
billingProjectId
को सेट नहीं किया जाता है, तो बिलिंग प्रोजेक्टprojectId
या क्वेरी की गई टेबल के प्रोजेक्ट पर वापस चला जाएगा. - तारीख के हिसाब से सेगमेंट में बांटी गई टेबल के लिए सहायता जोड़ी गई. पार्टीशन फ़ील्ड को तारीख की सीमा वाले डाइमेंशन के तौर पर इस्तेमाल करने के लिए,
isPartitioned
पैरामीटर कोtrue
पर सेट करें. - वाइल्डकार्ड वर्ण या
YYYYMMDD
टेबल सफ़िक्स का इस्तेमाल करके, तारीख के हिसाब से सेगमेंट में बांटी गई टेबल की क्वेरी करने की सुविधा जोड़ी गई. - Google Analytics, Firebase Analytics या Crashlytics टेबल से क्वेरी करने और फ़ील्ड टेंप्लेट चुनने की सुविधा जोड़ी गई.
- जब
- Google Sheets
hasHeader
की डिफ़ॉल्ट वैल्यूtrue
होती है. यह वेब यूज़र इंटरफ़ेस (यूआई) के लिए डिफ़ॉल्ट तौर पर लागू होती है.includeHiddenAndFilteredCell
कोincludeHiddenCells
में बांटा गयाincludeFilteredCells
. वेब यूज़र इंटरफ़ेस (यूआई) के डिफ़ॉल्ट नियम के मुताबिक, अब दोनों डिफ़ॉल्ट रूप सेtrue
पर सेट हैं.
- Search Console कनेक्टर
propertyType
पैरामीटर का नाम बदलकरsearchType
किया गया.
- Google Surveys का कनेक्टर
surveyId
अब एक सर्वे आईडी या एक कॉमा-सेपरेटेड लिस्ट स्वीकार करता है.
2021-12-16
- इंटिग्रेशन एपीआई की शुरुआती रिलीज़.
- किसी मौजूदा रिपोर्ट से लिंक करने और रिपोर्ट का नाम सेट करने की सुविधा भी मिलती है.
- कई डेटा सोर्स कॉन्फ़िगर किए जा सकते हैं और हर डेटा सोर्स का नाम सेट किया जा सकता है.
- इन कनेक्टर टाइप के लिए सहायता: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Google Sheets, Google Surveys, Search Console.