Linking API

परिचय

Linking API से उपयोगकर्ताओं को सीधे URL के ज़रिए, Data Studio की रिपोर्ट को कॉन्फ़िगर और फ़ॉरवर्ड करने के लिए एक भरोसेमंद इंटरफ़ेस मिलता है. जब उपयोगकर्ता किसी Linking API URL को फ़ॉलो करते हैं, तो वे अपने डेटा को तुरंत देख सकते हैं और उससे इंटरैक्ट कर सकते हैं.

इस दस्तावेज़ में, Linking API के यूआरएल के ज़रूरी फ़ॉर्मैट और उपलब्ध पैरामीटर के बारे में बताया गया है.

इस्तेमाल का उदाहरण और फ़ायदे

Linking API का इस्तेमाल, आपके ग्राहकों को पहले से कॉन्फ़िगर की गई रिपोर्ट देने के लिए किया जा सकता है. इससे वे अपने डेटा को देख सकते हैं और उससे इंटरैक्ट कर सकते हैं. Linking API के मुख्य फ़ायदे यहां दिए गए हैं:

खरीदारों के लिए, एक क्लिक में रिपोर्ट बनाने की सुविधा.
- डेटा कॉन्फ़िगरेशन, यूआरएल में दिया जाता है, ताकि उपयोगकर्ताओं को अपने डेटा के लिए रिपोर्ट कॉन्फ़िगर न करनी पड़े.
- उपयोगकर्ता, रिपोर्ट को एक क्लिक में सेव कर सकते हैं. साथ ही, वे इसे कभी भी देख सकते हैं.
बड़े पैमाने पर रिपोर्ट बनाना. Linking API की मदद से, डुप्लीकेट रिपोर्ट बनाने या नई रिपोर्ट बनाने में लगने वाला समय कम हो जाता है.
प्रॉडक्ट इंटिग्रेशन की सुविधा चालू करें. स्टेबल इंटरफ़ेस की मदद से, Data Studio को किसी प्रॉडक्ट वर्कफ़्लो में इंटिग्रेट किया जा सकता है.

यह कैसे काम करता है

यहां बताया गया है कि डेवलपर और उपयोगकर्ता, Linking API के साथ कैसे इंटरैक्ट करते हैं.

Linking API डेवलपर वर्कफ़्लो

डेवलपर, टेंप्लेट रिपोर्ट और डेटा सोर्स तैयार करता है. साथ ही, Linking API यूआरएल को फ़ॉर्मैट करता है. डेवलपर के लिए सामान्य वर्कफ़्लो इस तरह होता है:

तय करें कि आपको खाली रिपोर्ट का इस्तेमाल करना है या Data Studio की ओर से उपलब्ध कराए गए डिफ़ॉल्ट रिपोर्ट टेंप्लेट का इस्तेमाल करना है. इसके अलावा, आपके पास ऐसी Data Studio रिपोर्ट बनाने का विकल्प भी है जिसका इस्तेमाल टेंप्लेट के तौर पर किया जा सकेगा. इसमें टेंप्लेट के डेटा सोर्स कॉन्फ़िगर करना भी शामिल है.
अपने इस्तेमाल के उदाहरण के हिसाब से, Linking API यूआरएल को फ़ॉर्मैट करें. अगर लागू हो, तो रिपोर्ट टेंप्लेट और अन्य पैरामीटर तय करें. इनमें रिपोर्ट का नाम, डेटा सोर्स का नाम, और डेटा सोर्स के कॉन्फ़िगरेशन शामिल हैं.
उपयोगकर्ताओं को रिपोर्ट पर भेजने के लिए, Linking API के यूआरएल का इस्तेमाल करें.

Linking API का इस्तेमाल करने वाले लोगों का अनुभव

उपयोगकर्ता, Linking API यूआरएल को फ़ॉलो करता है. अगर डेवलपर ने इसे सही तरीके से कॉन्फ़िगर किया है, तो उपयोगकर्ता को Data Studio की उस रिपोर्ट पर रीडायरेक्ट किया जाएगा जिसमें वे उस डेटा को देख सकते हैं और उससे इंटरैक्ट कर सकते हैं जिसे ऐक्सेस करने की अनुमति उनके पास है. उपयोगकर्ता का सामान्य अनुभव इस तरह हो सकता है:

ब्राउज़र में, उपयोगकर्ता ऐसी सेवा पर जाता है जो Linking API के साथ इंटिग्रेट की गई है.
कॉल-टू-ऐक्शन में, उपयोगकर्ता को Data Studio में अपना डेटा देखने के लिए, किसी लिंक पर क्लिक करने का न्योता दिया जाता है.
उपयोगकर्ता लिंक पर क्लिक करता है और उसे Data Studio रिपोर्ट पर भेज दिया जाता है. रिपोर्ट लोड हो जाती है और उपयोगकर्ता अपना डेटा देख पाता है और उससे इंटरैक्ट कर पाता है.
उपयोगकर्ता “बदलाव करें और शेयर करें” पर क्लिक करता है. रिपोर्ट को उसके Data Studio खाते में सेव कर दिया जाता है.
अब उपयोगकर्ता के पास, रिपोर्ट की अपनी कॉपी का पूरा ऐक्सेस और कंट्रोल है. वे इसे किसी भी समय देख सकते हैं, इसमें बदलाव कर सकते हैं, और इसे शेयर कर सकते हैं.

ज़रूरी शर्तें

यह पक्का करने के लिए कि Linking API का यूआरएल उम्मीद के मुताबिक काम कर रहा है, यह ज़रूरी है:

एक रिपोर्ट, जिसे टेंप्लेट के तौर पर इस्तेमाल किया जा सकता है. अगर यह जानकारी नहीं दी जाती है, तो Data Studio की ओर से उपलब्ध कराई गई डिफ़ॉल्ट रिपोर्ट या खाली रिपोर्ट का इस्तेमाल किया जा सकता है.
Linking API URL का इस्तेमाल करने वाले लोगों के पास, कम से कम टेंप्लेट रिपोर्ट देखने का ऐक्सेस होना चाहिए. रिपोर्ट में इस्तेमाल किए गए डेटा सोर्स के टाइप और Linking API के ज़रिए दिए गए कॉन्फ़िगरेशन के आधार पर, उपयोगकर्ताओं को डेटा सोर्स को देखने का ऐक्सेस भी देना पड़ सकता है. ज़्यादा जानकारी के लिए, टेंप्लेट की अनुमतियां देखें.
हर डेटा सोर्स का कनेक्टर टाइप, Linking API के ज़रिए कॉन्फ़िगरेशन की सुविधा के साथ काम करना चाहिए. इस्तेमाल किए जा सकने वाले कनेक्टर की सूची देखने के लिए, कनेक्टर रेफ़रंस देखें.
Linking API URL का इस्तेमाल करने वाले लोगों के पास, Linking API URL में कॉन्फ़िगर किए गए डेटा का ऐक्सेस होना चाहिए. अगर उपयोगकर्ता के पास डेटा का ऐक्सेस नहीं है, तो डेटा पर निर्भर रिपोर्ट कॉम्पोनेंट में गड़बड़ी दिखेगी.

यूआरएल पैरामीटर

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 यूआरएल के ज़रिए रिपोर्ट देखने पर, रिपोर्ट की स्थिति कैसी होगी.

पैरामीटर का नाम	ब्यौरा
`c.reportId`	ज़रूरी नहीं. रिपोर्ट के टेंप्लेट का आईडी. Data Studio खुल जाएगा और उसमें बताई गई रिपोर्ट कॉन्फ़िगर हो जाएगी. आईडी ढूंढने के तरीके के बारे में ज़्यादा जानकारी के लिए, रिपोर्ट आईडी लेख पढ़ें. अगर कोई टेंप्लेट नहीं चुना जाता है, तो खाली रिपोर्ट या डिफ़ॉल्ट रिपोर्ट टेंप्लेट का इस्तेमाल किया जाता है. ज़्यादा जानकारी के लिए, खाली या डिफ़ॉल्ट रिपोर्ट का इस्तेमाल करना लेख पढ़ें.
`c.pageId`	ज़रूरी नहीं. रिपोर्ट में लोड होने वाले शुरुआती पेज का आईडी. अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से रिपोर्ट का पहला पेज दिखता है.
`c.mode`	ज़रूरी नहीं. रिपोर्ट का शुरुआती मोड. `view` या `edit` में से कोई एक. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `view` वैल्यू सेट होती है.
`c.explain`	ज़रूरी नहीं. जानकारी/डीबग करने से जुड़ा डायलॉग बॉक्स दिखता है या नहीं. डायलॉग बटन दिखाने के लिए, इसे `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

रिपोर्ट पैरामीटर

रिपोर्ट पैरामीटर, रिपोर्ट प्रॉपर्टी को ओवरराइड करते हैं.

पैरामीटर का नाम ब्यौरा

पैरामीटर का नाम	ब्यौरा
`r.reportName`	ज़रूरी नहीं. रिपोर्ट का नाम सेट करता है. अगर इसकी जानकारी नहीं दी जाती है, तो यह डिफ़ॉल्ट रूप से टेंप्लेट रिपोर्ट के नाम पर सेट हो जाता है.
`r.measurementId`	ज़रूरी नहीं. यह कुकी, Google Analytics मेज़रमेंट आईडी को रिपोर्ट के इस्तेमाल के आंकड़े मेज़र करने के लिए सेट करती है. एक से ज़्यादा आईडी को अलग करने के लिए कॉमा का इस्तेमाल करें. अगर `r.measurementId` और `r.keepMeasurementId` की वैल्यू नहीं दी गई है, तो Google Analytics मेज़रमेंट आईडी रिपोर्ट की सेटिंग डिफ़ॉल्ट रूप से 'सेट नहीं है' पर सेट होती है. अगर `r.measurementId` और `r.keepMeasurementId`, दोनों सेट हैं, तो आईडी सेट करने के लिए `r.keepMeasurementId` को प्राथमिकता दी जाती है.
`r.keepMeasurementId`	ज़रूरी नहीं. `true` पर सेट करें, ताकि Google Analytics मेज़रमेंट आईडी का इस्तेमाल करके टेंप्लेट रिपोर्ट बनाई जा सके. अगर इसकी वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू `false` होती है. अगर `r.measurementId` और `r.keepMeasurementId` की वैल्यू नहीं दी गई है, तो Google Analytics मेज़रमेंट आईडी रिपोर्ट की सेटिंग डिफ़ॉल्ट रूप से 'सेट नहीं है' पर सेट होती है. अगर `r.measurementId` और `r.keepMeasurementId`, दोनों सेट हैं, तो आईडी सेट करने के लिए `r.keepMeasurementId` को प्राथमिकता दी जाती है.

r.reportName

ज़रूरी नहीं. रिपोर्ट का नाम सेट करता है. अगर इसकी जानकारी नहीं दी जाती है, तो यह डिफ़ॉल्ट रूप से टेंप्लेट रिपोर्ट के नाम पर सेट हो जाता है.

r.measurementId

ज़रूरी नहीं. यह कुकी, Google Analytics मेज़रमेंट आईडी को रिपोर्ट के इस्तेमाल के आंकड़े मेज़र करने के लिए सेट करती है. एक से ज़्यादा आईडी को अलग करने के लिए कॉमा का इस्तेमाल करें.

अगर r.measurementId और r.keepMeasurementId की वैल्यू नहीं दी गई है, तो Google Analytics मेज़रमेंट आईडी रिपोर्ट की सेटिंग डिफ़ॉल्ट रूप से 'सेट नहीं है' पर सेट होती है. अगर r.measurementId और r.keepMeasurementId, दोनों सेट हैं, तो आईडी सेट करने के लिए r.keepMeasurementId को प्राथमिकता दी जाती है.

r.keepMeasurementId

ज़रूरी नहीं. true पर सेट करें, ताकि Google Analytics मेज़रमेंट आईडी का इस्तेमाल करके टेंप्लेट रिपोर्ट बनाई जा सके. अगर इसकी वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू false होती है.

उदाहरण

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 ढूंढने के तरीके के बारे में जानने के लिए, डेटा सोर्स का उपनाम लेख पढ़ें.

डेटा स्रोत पैरामीटर

ये पैरामीटर, सभी कनेक्टर टाइप में एक जैसे होते हैं:

नाम	ब्यौरा
`ds.alias.datasourceName`	ज़रूरी नहीं. यह विकल्प, डेटा सोर्स का नाम सेट करता है. अगर `ds.datasourceName` और `ds.keepDatasourceName` की वैल्यू नहीं दी गई है, तो डेटा सोर्स का नाम, डिफ़ॉल्ट रूप से नाम रखने के उस तरीके के हिसाब से सेट हो जाता है जिसमें कनेक्टर का टाइप और बनाने का समय शामिल होता है. उदाहरण के लिए, samples - 12/12/21, 10:53 PM. अगर `ds.datasourceName` और `ds.keepDatasourceName`, दोनों सेट हैं, तो डेटा सोर्स का नाम सेट करने के लिए `ds.datasourceName` को प्राथमिकता दी जाती है.
`ds.alias.keepDatasourceName`	ज़रूरी नहीं. टेंप्लेट डेटा सोर्स के नाम का इस्तेमाल करने के लिए, इसे `true` पर सेट करें. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `false` वैल्यू सेट होती है. अगर `ds.datasourceName` और `ds.keepDatasourceName` की वैल्यू नहीं दी गई है, तो डेटा सोर्स का नाम, डिफ़ॉल्ट रूप से नाम रखने के उस तरीके के हिसाब से सेट हो जाता है जिसमें कनेक्टर का टाइप और बनाने का समय शामिल होता है. उदाहरण के लिए, samples - 12/12/21, 10:53 PM. अगर `ds.datasourceName` और `ds.keepDatasourceName`, दोनों सेट हैं, तो डेटा सोर्स का नाम सेट करने के लिए `ds.datasourceName` को प्राथमिकता दी जाती है.
`ds.alias.connector`	ज़रूरी नहीं. डेटा सोर्स का कनेक्टर टाइप. कनेक्टर के उन टाइप के बारे में ज़्यादा जानने के लिए जिन्हें इस्तेमाल किया जा सकता है, कनेक्टर रेफ़रंस देखें. अगर इसे सेट किया जाता है, तो कनेक्टर टाइप के लिए ज़रूरी सभी कनेक्टर पैरामीटर, लिंकिंग एपीआई यूआरएल में दिए जाने चाहिए. साथ ही, टेंप्लेट के डेटा सोर्स कॉन्फ़िगरेशन को पूरी तरह से बदल दिया जाएगा. अगर इसे तय नहीं किया गया है, तो कनेक्टर टाइप के लिए शून्य या उससे ज़्यादा कनेक्टर पैरामीटर, Linking API यूआरएल में तय किए जा सकते हैं. टेंप्लेट के डेटा सोर्स कॉन्फ़िगरेशन का इस्तेमाल, Linking API यूआरएल में नहीं दिए गए पैरामीटर तय करने के लिए किया जाएगा. टेंप्लेट के डेटा सोर्स के कनेक्टर टाइप की पहचान करने के तरीके के बारे में जानने के लिए, कनेक्टर टाइप लेख पढ़ें. `ds.connector` पैरामीटर से, टेंप्लेट डेटा सोर्स कॉन्फ़िगरेशन पर क्या असर पड़ता है, इस बारे में ज़्यादा जानें. इससे यह तय होता है कि टेंप्लेट डेटा सोर्स कॉन्फ़िगरेशन को पूरी तरह से बदला जाएगा या इसका इस्तेमाल, ऐसे पैरामीटर को अपडेट करने के लिए किया जाएगा जिनके बारे में जानकारी नहीं दी गई है. इसके लिए, बदलना बनाम अपडेट करना लेख पढ़ें.
`ds.alias.refreshFields`	ज़रूरी नहीं. Linking API के ज़रिए तय किए गए डेटा सोर्स कॉन्फ़िगरेशन का इस्तेमाल करने के लिए, इसे `true` पर सेट करें. इससे डेटा सोर्स फ़ील्ड रीफ़्रेश किए जा सकते हैं. साथ ही, रिपोर्ट कॉम्पोनेंट को नए फ़ील्ड के विकल्पों के साथ अपडेट किया जा सकता है. `true` आम तौर पर तब तय किया जाता है, जब कनेक्टर टाइप बदला जा रहा हो या कनेक्टर टाइप के लिए, कॉन्फ़िगरेशन में बदलाव करने पर अलग-अलग फ़ील्ड मिलते हों. उदाहरण के लिए, BigQuery डेटा सोर्स के फ़ील्ड अक्सर अलग-अलग टेबल कॉन्फ़िगरेशन के साथ बदलते हैं. डेटा सोर्स फ़ील्ड को टेंप्लेट रिपोर्ट में बदलाव किए बिना इस्तेमाल करने के लिए, `false` पर सेट करें. `false` आम तौर पर तब चुना जाता है, जब नए डेटा कॉन्फ़िगरेशन से ठीक वही फ़ील्ड मिलते हैं और आपको टेंप्लेट के डेटा सोर्स में किए गए फ़ील्ड में बदलावों को बनाए रखना होता है. अगर कोई वैल्यू तय नहीं की जाती है, तो कनेक्टर के टाइप के हिसाब से डिफ़ॉल्ट वैल्यू अलग-अलग होती हैं. अगर आपको डिफ़ॉल्ट सेटिंग बदलनी है, तो कनेक्टर के हिसाब से डिफ़ॉल्ट सेटिंग के लिए, कनेक्टर रेफ़रंस देखें. `refreshFields` का इस्तेमाल करते समय इन बातों का ध्यान रखें: अगर `refreshFields` को `false` पर सेट किया गया है और Linking API के ज़रिए तय किए गए डेटा सोर्स कॉन्फ़िगरेशन से, टेंप्लेट रिपोर्ट में इस्तेमाल किए गए फ़ील्ड से अलग फ़ील्ड मिलते हैं, तो उपयोगकर्ता को उन कॉम्पोनेंट के लिए कॉन्फ़िगरेशन से जुड़ी गड़बड़ी दिख सकती है. अगर `refreshFields` को `true` पर सेट किया जाता है, तो टेंप्लेट के डेटा सोर्स में फ़ील्ड (जैसे कि नाम, टाइप, एग्रीगेशन वगैरह) में किए गए बदलाव, नए डेटा सोर्स में नहीं दिखते. टेम्पलेट के डेटा सोर्स से फ़ील्ड कॉन्फ़िगरेशन बनाए रखने के लिए, `refreshFields` को `false` पर सेट करें. कैलकुलेटेड फ़ील्ड और पैरामीटर, टेंप्लेट डेटा सोर्स में तय किए जाते हैं. इन्हें हमेशा नए डेटा सोर्स में कॉपी किया जाता है. इन पर `refreshFields` की वैल्यू का कोई असर नहीं पड़ता.
`ds.alias.connectorParameters`	ज़रूरी है. कनेक्टर टाइप के लिए डेटा सोर्स का कॉन्फ़िगरेशन. डेटा सोर्स बनाने के लिए इस्तेमाल किए गए कनेक्टर की पहचान करने के तरीके के बारे में जानने के लिए, कनेक्टर का टाइप लेख पढ़ें. हर कनेक्टर टाइप के लिए उपलब्ध डेटा सोर्स पैरामीटर के बारे में जानने के लिए, कनेक्टर रेफ़रंस देखें.

डेटा सोर्स कॉन्फ़िगरेशन को बदलना बनाम अपडेट करना

डेटा सोर्स के पैरामीटर सेट करते समय, Linking API के यूआरएल में ds.connector पैरामीटर मौजूद होने या न होने से, टेंप्लेट के डेटा सोर्स कॉन्फ़िगरेशन को बदलने या अपडेट करने का इरादा पता चलता है.

इस टेबल में बताया गया है कि ds.connector पैरामीटर से, टेंप्लेट डेटा सोर्स कॉन्फ़िगरेशन पर क्या असर पड़ता है. इससे यह तय होता है कि टेंप्लेट डेटा सोर्स कॉन्फ़िगरेशन को पूरी तरह से बदला जाएगा या इसका इस्तेमाल, बिना जानकारी वाले पैरामीटर को अपडेट करने के लिए किया जाएगा:

क्या `ds.connector` सेट है?	उम्मीद के मुताबिक कॉन्फ़िगरेशन और व्यवहार	आम तौर पर इस्तेमाल
हां	बदलें पर टैप करें. लिंकिंग एपीआई यूआरएल में दिए गए डेटा सोर्स पैरामीटर का इस्तेमाल करके, टेंप्लेट के डेटा सोर्स कॉन्फ़िगरेशन को पूरी तरह से बदल दिया जाता है. आपको कनेक्टर टाइप के लिए, सभी ज़रूरी पैरामीटर तय करने होंगे. `ds.connector` सेट होने पर ज़रूरी पैरामीटर देखें.	डेटा सोर्स के कनेक्टर का टाइप बदलते समय. उदाहरण के लिए, अगर आपने टेंप्लेट रिपोर्ट में BigQuery डेटा सोर्स कॉन्फ़िगर किया है, लेकिन आपको Linking API के ज़रिए Sheets डेटा सोर्स कॉन्फ़िगर करना है. इसके लिए, कनेक्टर का नया कॉन्फ़िगरेशन तय करना होगा. जब आपको किसी डेटा सोर्स के कॉन्फ़िगरेशन की गारंटी देनी हो. कॉन्फ़िगरेशन बदलने से, टेंप्लेट डेटा सोर्स से इस्तेमाल की जा रही किसी भी अनजान वैल्यू को हटाया जा सकता है.
नहीं	अपडेट करें. टेंप्लेट के डेटा सोर्स कॉन्फ़िगरेशन का इस्तेमाल, Linking API यूआरएल में नहीं दिए गए पैरामीटर तय करने के लिए किया जाएगा. कनेक्टर टाइप के लिए, सभी कनेक्टर पैरामीटर इस्तेमाल करना या न करना आपकी ज़रूरत पर तय करता है. हालांकि, अगर किसी पैरामीटर के बारे में यह बताया गया है कि उसे इस्तेमाल करना ज़रूरी है, तो आपको उसे इस्तेमाल करना होगा. इससे Linking API का यूआरएल आसान हो जाता है. आम तौर पर, इसका इस्तेमाल तब किया जाता है, जब आपको टेंप्लेट के डेटा सोर्स कॉन्फ़िगरेशन के बारे में पता हो और आपको सिर्फ़ पैरामीटर के सबसेट को बदलना हो.	जब आपको सिर्फ़ उन पैरामीटर की वैल्यू देनी हों जो टेंप्लेट डेटा सोर्स से अलग हैं. साथ ही, आपको उन कनेक्टर पैरामीटर के लिए टेंप्लेट डेटा सोर्स पर भरोसा करना हो जिनके बारे में आपने नहीं बताया है. उदाहरण के लिए, सिर्फ़ BigQuery डेटा सोर्स कॉन्फ़िगरेशन का बिलिंग प्रोजेक्ट आईडी बदलें और अन्य सभी पैरामीटर के लिए, टेंप्लेट कॉन्फ़िगरेशन का इस्तेमाल करें.

`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 की मदद से नया डेटा सोर्स बनाने पर, यह उस उपयोगकर्ता के क्रेडेंशियल का इस्तेमाल करता है जिसने यूआरएल पर क्लिक किया था. इसका मतलब है कि उपयोगकर्ता के पास, डेटा को ऐक्सेस करने की अनुमति होनी चाहिए. ऐसा न होने पर, कनेक्शन काम नहीं करेगा. नई रिपोर्ट में डेटा सोर्स को फिर से जोड़कर, उसके क्रेडेंशियल सुरक्षित रखे जा सकते हैं. इससे उपयोगकर्ता अपनी नई रिपोर्ट में डेटा को ऐक्सेस कर पाएंगे.

डेटा सोर्स के उपनाम के लिए वाइल्डकार्ड

लिंकिंग एपीआई पैरामीटर को एक से ज़्यादा डेटा सोर्स पर लागू करने के लिए, डेटा सोर्स के एलियास की जगह वाइल्डकार्ड एलियास 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 क्वेरी. इसमें आपको टेबल पर क्वेरी करने के लिए एसक्यूएल स्टेटमेंट देना होता है.

टेबल क्वेरी

type को TABLE पर सेट करने और क्वेरी करने के लिए टेबल का आईडी देने पर, ये पैरामीटर लागू होते हैं.

पैरामीटर का नाम	ब्यौरा
`ds.alias.connector`	ज़रूरी नहीं. BigQuery कनेक्टर के लिए, `bigQuery` पर सेट करें. अगर सेट है, तो डेटा सोर्स को दिए गए BigQuery कॉन्फ़िगरेशन से बदल देता है. देखें बदलें बनाम अपडेट करें.
`ds.alias.type`	ज़रूरी है** क्वेरी का टाइप. `TABLE` पर सेट करें.
`ds.alias.projectId`	ज़रूरी है** क्वेरी करने के लिए टेबल का प्रोजेक्ट आईडी.
`ds.alias.datasetId`	ज़रूरी है** यह क्वेरी की जाने वाली टेबल का डेटासेट आईडी है.
`ds.alias.tableId`	ज़रूरी है** क्वेरी करने के लिए टेबल का आईडी. तारीख के हिसाब से बांटी गई टेबल: तारीख के हिसाब से बांटी गई टेबल की क्वेरी करते समय, * (वाइल्डकार्ड वर्ण) या `YYYYMMDD` सफ़िक्स का इस्तेमाल किया जा सकता है. अगर किसी टेबल की पहचान Google Analytics, Firebase Analytics या Firebase Crashlytics के तौर पर की जाती है, तो डिफ़ॉल्ट फ़ील्ड टेंप्लेट चुना जाएगा. हालांकि, ऐसा तब होगा, जब कोई टेंप्लेट तय न किया गया हो. फ़ील्ड टेंप्लेट टेबल से जुड़े पैरामीटर देखें.
`ds.alias.billingProjectId`	ज़रूरी नहीं. बिलिंग के लिए इस्तेमाल किए जाने वाले प्रोजेक्ट का आईडी. अगर यह सेट नहीं है, तो `projectId` का इस्तेमाल किया जाएगा.
`ds.alias.isPartitioned`	ज़रूरी नहीं. अगर टेबल को तारीख के हिसाब से सेगमेंट में बांटा गया है और आपको सेगमेंट में बांटने वाले कॉलम का इस्तेमाल, तारीख की सीमा वाले डाइमेंशन के तौर पर करना है, तो इसे `true` पर सेट करें. यह सिर्फ़ समय के हिसाब से पार्टिशन करने की सुविधा पर लागू होता है.उदाहरण के लिए, समय के हिसाब से पार्टिशन करने वाले कॉलम या `_PARTITIONTIME` स्यूडो कॉलम का इस्तेमाल करना. साथ ही, यह पूर्णांक रेंज के हिसाब से पार्टिशन की गई टेबल के लिए काम नहीं करता. अगर इसकी वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू `false` होती है. ज़्यादा जानने के लिए, पार्टिशन की गई टेबल के बारे में जानकारी लेख पढ़ें.
`ds.alias.refreshFields`	ज़रूरी नहीं. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `true` वैल्यू सेट होती है. ज़्यादा जानकारी के लिए, refreshFields देखें.

Google Analytics, Firebase Analytics, और Crashlytics के लिए फ़ील्ड टेंप्लेट

Google Analytics, Firebase Analytics या Firebase Crashlytics के तौर पर पहचाने गए टेबल के लिए, फ़ील्ड टेंप्लेट सेट करने के लिए अतिरिक्त पैरामीटर उपलब्ध होते हैं. अगर कोई टेंप्लेट नहीं चुना जाता है, तो डिफ़ॉल्ट टेंप्लेट चुना जाएगा.

नाम	ब्यौरा
`ds.alias.gaTemplateLevel`	ज़रूरी नहीं. Google Analytics फ़ील्ड का इस्तेमाल करने के लिए टेंप्लेट. यह सिर्फ़ तब लागू होता है, जब Google Analytics की टेबल के लिए BigQuery Export से क्वेरी की जा रही हो. `ALL`, `SESSION`, `HITS` में से कोई एक. Google Analytics टेबल के लिए, अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से `ALL` को चुना जाता है.
`ds.alias.firebaseTemplateLevel`	ज़रूरी नहीं. इस्तेमाल किया जाने वाला Firebase Analytics फ़ील्ड टेंप्लेट. लागू होता है सिर्फ़ तब, जब Firebase Analytics टेबल के लिए BigQuery Export की क्वेरी की जा रही हो. इसे सिर्फ़ `EVENTS` पर सेट किया जा सकता है. Firebase Analytics टेबल के लिए, अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से `EVENTS` वैल्यू सेट होती है.
`ds.alias.crashlyticsTemplateLevel`	इस्तेमाल किया जाने वाला Firebase Crashlytics फ़ील्ड टेंप्लेट. इसे सिर्फ़ `DEFAULT` पर सेट किया जा सकता है. यह सिर्फ़ तब लागू होता है, जब Firebase Crashlytics की टेबल के लिए BigQuery Export की क्वेरी की जा रही हो. Firebase Crashlytics टेबल के लिए, अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से `DEFAULT` सेट होता है.

कस्टम क्वेरी

जब type को CUSTOM_QUERY पर सेट किया जाता है और टेबल को क्वेरी करने के लिए एसक्यूएल स्टेटमेंट दिया जाता है, तब ये पैरामीटर लागू होते हैं.

पैरामीटर का नाम	ब्यौरा
`ds.alias.connector`	ज़रूरी नहीं. BigQuery कनेक्टर के लिए, `bigQuery` पर सेट करें. अगर सेट है, तो डेटा सोर्स को दिए गए BigQuery कॉन्फ़िगरेशन से बदल देता है. देखें बदलें बनाम अपडेट करें.
`ds.alias.type`	ज़रूरी है** क्वेरी का टाइप. `CUSTOM_QUERY` पर सेट करें.
`ds.alias.sql`	ज़रूरी है** यह एसक्यूएल क्वेरी है, जिसे चलाना है.
`ds.alias.billingProjectId`	ज़रूरी नहीं. बिलिंग के लिए इस्तेमाल किए जाने वाले प्रोजेक्ट का आईडी. अगर यह सेट नहीं है, तो `projectId` का इस्तेमाल किया जाएगा. अगर `projectId` सेट नहीं है, तो क्वेरी की गई टेबल के प्रोजेक्ट का इस्तेमाल किया जाएगा.
`ds.alias.sqlReplace`	ज़रूरी नहीं. कॉमा से अलग की गई पैटर्न और बदलने के लिए स्ट्रिंग की सूची. इसका इस्तेमाल SQL क्वेरी पर किया जाता है. स्ट्रिंग बदलने की सुविधा सिर्फ़ तब लागू होती है, जब पैटर्न मैच होता है. पैटर्न और बदलने के लिए स्ट्रिंग के जोड़े को अलग करने के लिए, कॉमा का इस्तेमाल करें. उदाहरण के लिए, `stringPattern1,replacementString1, stringPattern2,replacementString2`.
`ds.alias.refreshFields`	ज़रूरी नहीं. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `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

TABLE टाइप का कॉन्फ़िगरेशन, SESSION फ़ील्ड टेंप्लेट का इस्तेमाल करके, Google Analytics के लिए BigQuery Export टेबल की क्वेरी करने के लिए:

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 का इस्तेमाल करके, टेंप्लेट डेटा सोर्स के एसक्यूएल स्टेटमेंट को अपडेट किया जाता है:

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

पैरामीटर का नाम	ब्यौरा
`ds.alias.connector`	ज़रूरी नहीं. `cloudSpanner` पर सेट किया गया है. यह Cloud Spanner कनेक्टर के लिए है. अगर सेट किया गया है, तो डेटा सोर्स को दिए गए Cloud Spanner कॉन्फ़िगरेशन से बदल देता है. देखें बदलें बनाम अपडेट करें.
`ds.alias.projectId`	ज़रूरी है** प्रोजेक्ट आईडी.
`ds.alias.instanceId`	ज़रूरी है** इंस्टेंस आईडी.
`ds.alias.databaseId`	ज़रूरी है** डेटाबेस आईडी.
`ds.alias.sql`	ज़रूरी है** यह एसक्यूएल क्वेरी है, जिसे चलाना है.
`ds.alias.refreshFields`	ज़रूरी नहीं. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `true` वैल्यू सेट होती है. ज़्यादा जानकारी के लिए, refreshFields देखें.

उदाहरण

एसक्यूएल स्टेटमेंट के साथ 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

कम्यूनिटी कनेक्टर

पैरामीटर का नाम	ब्यौरा
`ds.alias.connector`	ज़रूरी नहीं. कम्यूनिटी कनेक्टर के लिए, इसे `community` पर सेट करें. अगर यह विकल्प सेट किया जाता है, तो डेटा सोर्स को दिए गए कम्यूनिटी कनेक्टर कॉन्फ़िगरेशन से बदल दिया जाता है. देखें बदलें बनाम अपडेट करें.
`ds.alias.connectorId`	ज़रूरी है** कम्यूनिटी कनेक्टर `connectorId` (इसे `deploymentId` भी कहा जाता है).
`ds.alias.parameters`	ज़रूरी नहीं. कनेक्टर के हिसाब से तय किए गए अतिरिक्त पैरामीटर. इन्हें कम्यूनिटी कनेक्टर के कनेक्टर कॉन्फ़िगरेशन में तय किया जाता है.
`ds.alias.refreshFields`	ज़रूरी नहीं. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `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

पैरामीटर का नाम	ब्यौरा
`ds.alias.connector`	ज़रूरी नहीं. Google Analytics कनेक्टर के लिए, `googleAnalytics` पर सेट किया गया है. अगर यह विकल्प सेट है, तो डेटा सोर्स को दिए गए Google Analytics कॉन्फ़िगरेशन से बदल देता है. देखें बदलें बनाम अपडेट करें.
`ds.alias.accountId`	ज़रूरी है** खाता आईडी.
`ds.alias.propertyId`	ज़रूरी है** प्रॉपर्टी आईडी.
`ds.alias.viewId`	व्यू आईडी. Universal Analytics प्रॉपर्टी के लिए ज़रूरी है**. Google Analytics 4 प्रॉपर्टी के लिए इसे सेट न करें.
`ds.alias.refreshFields`	ज़रूरी नहीं. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `false` वैल्यू सेट होती है. ज़्यादा जानकारी के लिए, refreshFields देखें.

ध्यान दें: Universal Analytics (UA) और Google Analytics 4 (GA4) के कॉन्फ़िगरेशन एक-दूसरे के साथ काम नहीं करते, क्योंकि इनमें डाइमेंशन और मेट्रिक के अलग-अलग सेट होते हैं. GA4 प्रॉपर्टी के लिए बनाए गए डेटा सोर्स के लिए UA कॉन्फ़िगरेशन सेट करने पर, वह काम नहीं करेगा. इसी तरह, UA प्रॉपर्टी के लिए बनाए गए डेटा सोर्स के लिए GA4 कॉन्फ़िगरेशन सेट करने पर, वह काम नहीं करेगा. अगर आपको रिपोर्ट टेंप्लेट को दोनों प्रॉपर्टी के साथ काम करने देना है, तो ds.refreshFields पैरामीटर को true पर सेट करें.

उदाहरण

यूनिवर्सल 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

पैरामीटर का नाम	ब्यौरा
`ds.alias.connector`	ज़रूरी नहीं. इसे `googleCloudStorage` Google Cloud Storage connector पर सेट करें. अगर यह विकल्प सेट है, तो डेटा सोर्स को Google Cloud Storage के दिए गए कॉन्फ़िगरेशन से बदल देता है. देखें बदलें बनाम अपडेट करें.
`ds.alias.pathType`	ज़रूरी है** पाथ का टाइप. किसी एक फ़ाइल को चुनने के लिए `FILE` का इस्तेमाल करें या दिए गए पाथ की सभी फ़ाइलों को चुनने के लिए `FOLDER` का इस्तेमाल करें.
`ds.alias.path`	ज़रूरी है** अगर `pathType` `FILE` है, तो फ़ाइल पाथ (जैसे, MyBucket/MyData/MyFile.csv) या अगर `pathType` `FOLDER` है, तो फ़ोल्डर पाथ (जैसे, *MyBucket/MyData).
`ds.alias.refreshFields`	ज़रूरी नहीं. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `true` वैल्यू सेट होती है. ज़्यादा जानकारी के लिए, refreshFields देखें.

उदाहरण

किसी एक फ़ाइल के लिए 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

पैरामीटर का नाम	ब्यौरा
`ds.alias.connector`	ज़रूरी नहीं. Google Sheets कनेक्टर के लिए, इसे `googleSheets` पर सेट करें. अगर सेट किया गया है, तो डेटा सोर्स को Google Sheets के दिए गए कॉन्फ़िगरेशन से बदलता है. देखें बदलें बनाम अपडेट करें.
`ds.alias.spreadsheetId`	ज़रूरी है** स्प्रेडशीट का आईडी.
`ds.alias.worksheetId`	ज़रूरी है** यह वर्कशीट का आईडी है.
`ds.alias.hasHeader`	ज़रूरी नहीं. पहली लाइन को हेडर के तौर पर इस्तेमाल करने के लिए, इसे `true` पर सेट करें. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `true` वैल्यू सेट होती है. कॉलम के हेडर यूनीक होने चाहिए. डेटा सोर्स में खाली हेडर वाले कॉलम नहीं जोड़े जाएंगे.
`ds.alias.includeHiddenCells`	ज़रूरी नहीं. छिपे हुए सेल शामिल करने के लिए, इसे `true` पर सेट करें. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `true` वैल्यू सेट होती है.
`ds.alias.includeFilteredCell`	ज़रूरी नहीं. फ़िल्टर किए गए सेल शामिल करने के लिए, इसे `true` पर सेट करें. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `true` वैल्यू सेट होती है.
`ds.alias.range`	ज़रूरी नहीं. रेंज, जैसे कि A1:B52.
`ds.alias.refreshFields`	ज़रूरी नहीं. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `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 Sheets का कॉन्फ़िगरेशन, जिसमें पहली लाइन को हेडर के तौर पर इस्तेमाल किया गया है. साथ ही, इसमें छिपी हुई और फ़िल्टर की गई सेल शामिल हैं:

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

पैरामीटर का नाम	ब्यौरा
`ds.alias.connector`	ज़रूरी नहीं. Looker कनेक्टर के लिए, इसे `looker` पर सेट करें. अगर सेट किया गया है, तो यह Looker कॉन्फ़िगरेशन का इस्तेमाल करके डेटा सोर्स को बदल देता है. देखें बदलें बनाम अपडेट करें.
`ds.alias.instanceUrl`	ज़रूरी है** Looker इंस्टेंस का यूआरएल.
`ds.alias.model`	ज़रूरी है** Looker मॉडल.
`ds.alias.explore`	ज़रूरी है** Looker Explore.
`ds.alias.refreshFields`	ज़रूरी नहीं. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `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

पैरामीटर का नाम	ब्यौरा
`ds.alias.connector`	ज़रूरी नहीं. Search Console कनेक्टर के लिए, `searchConsole` पर सेट किया गया हो. अगर यह विकल्प सेट है, तो डेटा सोर्स को दिए गए Search Console कॉन्फ़िगरेशन से बदल देता है. देखें बदलें बनाम अपडेट करें.
`ds.alias.siteUrl`	ज़रूरी है** साइट का यूआरएल. डोमेन प्रॉपर्टी के लिए, `sc-domain\:` प्रीफ़िक्स का इस्तेमाल करें.
`ds.alias.tableType`	ज़रूरी है** इससे टेबल का टाइप सेट किया जाता है. यह `SITE_IMPRESSION` या `URL_IMPRESSION` में से कोई एक हो सकता है.
`ds.alias.searchType`	ज़रूरी है** इससे खोज का टाइप सेट होता है. इसकी वैल्यू `WEB`, `IMAGE`, `VIDEO` या `NEWS` में से कोई एक हो सकती है.
`ds.alias.refreshFields`	ज़रूरी नहीं. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से `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 कंट्रोल पैरामीटर सेट करना डेटा सोर्स (ds) के पैरामीटर सेट करें. नोट

रिक्त रिपोर्ट नहीं नहीं

डिफ़ॉल्ट रिपोर्ट

नहीं

हां

रिपोर्ट का टाइप	`reportId` कंट्रोल पैरामीटर सेट करना	डेटा सोर्स (`ds`) के पैरामीटर सेट करें.	नोट
रिक्त रिपोर्ट	नहीं	नहीं
डिफ़ॉल्ट रिपोर्ट	नहीं	हां	डिफ़ॉल्ट रिपोर्ट, Data Studio से मिलती है. डिफ़ॉल्ट रिपोर्ट के लिए डेटा सोर्स पैरामीटर तय करते समय, डेटा सोर्स के उपनाम का इस्तेमाल करना ज़रूरी नहीं है. ऐसा इसलिए, क्योंकि डिफ़ॉल्ट रिपोर्ट में सिर्फ़ एक एम्बेड किया गया डेटा सोर्स होता है.

डिफ़ॉल्ट रिपोर्ट, Data 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

ब्राउज़र के पता बार में, Data Studio की रिपोर्ट का यूआरएल दिखाया गया है.
रिपोर्ट आईडी को हाइलाइट किया गया है. — रिपोर्ट के यूआरएल में रिपोर्ट आईडी ढूंढें.

डेटा सोर्स का उपनाम

एक रिपोर्ट में कई डेटा सोर्स हो सकते हैं. डेटा सोर्स को उसके उपनाम से रेफ़रंस किया जाना चाहिए.

डेटा सोर्स का उपनाम ढूंढने के लिए:

रिपोर्ट में बदलाव करें.
टूलबार में जाकर, संसाधन > जोड़े गए डेटा सोर्स मैनेज करें को चुनें.
हर डेटा सोर्स के लिए, उपनाम की जानकारी देखने के लिए उपनाम कॉलम देखें.

डेटा सोर्स जोड़ने या हटाने पर, पीछे की ओर काम करने की सुविधा को चालू रखने के लिए, उपनामों में बदलाव किया जा सकता है.

डेटा सोर्स रिसॉर्स मैनेजमेंट पेज में, डेटा सोर्स की सूची.
उपनाम कॉलम को हाइलाइट किया गया है. — *डेटा सोर्स* मैनेज करने वाले पेज पर जाकर, डेटा सोर्स का उपनाम ढूंढें.

कनेक्टर किस तरह का है

किसी रिपोर्ट में कई डेटा सोर्स हो सकते हैं. हर डेटा सोर्स को कनेक्टर कॉन्फ़िगर करके बनाया जाता है. डेटा सोर्स बनाने के लिए इस्तेमाल किए गए कनेक्टर का टाइप ढूंढने के लिए:

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

डेटा सोर्स रिसॉर्स मैनेजमेंट पेज में, डेटा सोर्स की सूची.
कनेक्टर टाइप कॉलम को हाइलाइट किया गया है. — *डेटा सोर्स* मैनेजमेंट पेज पर जाकर, डेटा सोर्स कनेक्टर टाइप ढूंढें.

सलाह और समस्या हल करना

अगर आपको समस्या आ रही है, तो संभावित समस्याओं और सामान्य गलत कॉन्फ़िगरेशन का पता लगाने के लिए, यहां दी गई जानकारी देखें.

डीबग वाला डायलॉग बॉक्स

Linking API के कॉन्फ़िगरेशन की समीक्षा करने के लिए, डीबग डायलॉग का इस्तेमाल करें. यह कॉन्फ़िगरेशन, Data Studio के हिसाब से होता है. इससे एपीआई से जुड़ी समस्याओं को डीबग करने में मदद मिल सकती है.

Linking API यूआरएल को पार्स करते समय कोई गड़बड़ी होने पर, गड़बड़ी की जानकारी वाला एक डायलॉग अपने-आप दिखेगा.
जब कोई गड़बड़ी होती है और कोई डायलॉग अपने-आप नहीं दिखता है, तो रिपोर्ट के सबसे ऊपर दाईं ओर मौजूद जानकारी वाले बटन को देखें. डीबग करने से जुड़ी अतिरिक्त जानकारी के लिए क्लिक करें.
अगर कोई जानकारी वाला बटन उपलब्ध नहीं है, तो बटन को चालू किया जा सकता है. इसके लिए, किसी भी Linking API यूआरएल के आखिर में &c.explain=true पैरामीटर जोड़ें.

अनुमतियां

पक्का करें कि आपने डेटा सोर्स टाइप और Linking API कॉन्फ़िगरेशन के लिए, टेंप्लेट की सही अनुमतियां सेट की हों. ज़्यादा जानकारी के लिए, टेंप्लेट की अनुमतियां देखें.

अपडेट करना बनाम बदलना

अगर डेटा सोर्स टेंप्लेट से डेटा सोर्स के कॉन्फ़िगरेशन को अपडेट किया जा रहा है, तो टेंप्लेट के डेटा सोर्स के कॉन्फ़िगरेशन और Linking API के कॉन्फ़िगरेशन की समीक्षा करें. इससे यह पक्का किया जा सकेगा कि दोनों एक-दूसरे के साथ काम करते हैं. पुष्टि करें कि नए कॉन्फ़िगरेशन से मिले फ़ील्ड, रिपोर्ट के कॉम्पोनेंट और कॉन्फ़िगरेशन के साथ काम करते हों.

अपडेट करने के बजाय बदलने पर, ऐसा कॉन्फ़िगरेशन सेट किया जा सकता है जो अमान्य हो और जिसका व्यवहार तय न हो. ज़्यादा जानकारी के लिए, बदलाव करना बनाम अपडेट करना लेख पढ़ें.

फ़ील्ड रीफ़्रेश करें

अगर आपने किसी टेंप्लेट डेटा सोर्स के लिए फ़ील्ड के नाम, टाइप या एग्रीगेशन कॉन्फ़िगर किए हैं, तो ये बदलाव सिर्फ़ Linking API से कॉन्फ़िगर किए गए डेटा सोर्स में तब दिखेंगे, जब ds.refreshFields पैरामीटर को false पर सेट किया गया हो.

Linking API के यूआरएल में मौजूद ds.refreshFields डेटा सोर्स पैरामीटर की समीक्षा करें. अगर इसे शामिल नहीं किया जाता है, तो पुष्टि करें कि कनेक्टर के हर टाइप के लिए पैरामीटर की डिफ़ॉल्ट वैल्यू, इस्तेमाल के आपके उदाहरण के लिए सही है.

आम तौर पर, अगर आपने टेंप्लेट डेटा सोर्स में फ़ील्ड कॉन्फ़िगर किए हैं और आपको यकीन है कि Linking API के ज़रिए नए डेटा सोर्स कॉन्फ़िगरेशन से हमेशा एक जैसे फ़ील्ड मिलेंगे, तो refreshFields को false पर सेट करने का सुझाव दिया जाता है.

उदाहरण के लिए, अगर रिपोर्ट टेंप्लेट बनाते समय Data Studio किसी डेटा सोर्स फ़ील्ड को नंबर टाइप के तौर पर पहचानता है और आपने उसे साल टाइप में बदल दिया है, तो फ़ील्ड कॉन्फ़िगरेशन में हुआ यह बदलाव अब टेंप्लेट डेटा सोर्स का हिस्सा है. रिपोर्ट टेंप्लेट में मौजूद जिस चार्ट में सही किए गए फ़ील्ड का इस्तेमाल किया गया है उसमें साल की जानकारी होनी चाहिए. अगर चार्ट समय के हिसाब से बनाया गया है, तो हो सकता है कि वह जानकारी के बिना रेंडर न हो. अगर Linking API का इस्तेमाल करके, एक नया डेटा सोर्स कॉन्फ़िगरेशन दिया जाता है और उससे ठीक वही फ़ील्ड मिलते हैं, तो refreshFields पैरामीटर की वैल्यू के आधार पर दो नतीजे मिलते हैं:

अगर इसे true पर सेट किया जाता है, तो टेंप्लेट के डेटा सोर्स से फ़ील्ड कॉन्फ़िगरेशन ट्रांसफ़र नहीं होगा.साथ ही, अगर चार्ट उसी फ़ील्ड कॉन्फ़िगरेशन पर निर्भर करते हैं, तो हो सकता है कि वे लोड न हों. जैसे, साल टाइप का फ़ील्ड.
false पर सेट होने पर, टेंप्लेट डेटा सोर्स का फ़ील्ड कॉन्फ़िगरेशन, नए डेटा सोर्स में ट्रांसफ़र हो जाएगा. साथ ही, रिपोर्ट चार्ट को एक ही कॉन्फ़िगरेशन वाले फ़ील्ड मिलेंगे और वे सही तरीके से लोड हो जाएंगे.

सुझाव/राय/शिकायत और सहायता

Linking API से जुड़ी समस्याओं की शिकायत करने या सुझाव/राय देने के लिए, Issue Tracker का इस्तेमाल करें. मदद पाने और सवाल पूछने से जुड़े सामान्य संसाधनों के लिए, सहायता देखें.

बदलावों का लॉग

2023-06-06

Google Analytics मेज़रमेंट आईडी की रिपोर्ट सेटिंग को कॉन्फ़िगर करने के लिए, r.measurementId और r.keepMeasurementId रिपोर्ट पैरामीटर जोड़े गए.
टेंप्लेट के डेटा सोर्स के नाम का दोबारा इस्तेमाल करने की सुविधा को कंट्रोल करने के लिए, ds.keepDatasourceName जोड़ा गया.
रिपोर्ट एम्बेड करें सेक्शन जोड़ा गया.
BigQuery कनेक्टर
- sqlReplace को जोड़ा गया. इस विकल्प की मदद से, टेंप्लेट डेटा सोर्स की एसक्यूएल क्वेरी को अपडेट करने के लिए, पैटर्न और बदलने के लिए स्ट्रिंग तय की जा सकती हैं.

2023-05-22

Looker कनेक्टर के लिए सहायता जोड़ी गई.
कम्यूनिटी कनेक्टर के लिए सहायता जोड़ी गई.

2022-11-21

खाली रिपोर्ट का इस्तेमाल करने की सुविधा जोड़ी गई. देखें ब्लैंक या डिफ़ॉल्ट रिपोर्ट का इस्तेमाल करना
सलाह और समस्या हल करना पेज पर, refreshFields सेक्शन जोड़ा गया.

2022-11-14

Google Surveys के बंद होने की वजह से, Surveys कनेक्टर के रेफ़रंस को हटा दिया गया है.

2022-06-15

बीटा वर्शन से नए वर्शन तक का सफ़र
- Integration API का नाम बदलकर Linking API कर दिया गया है.
- Linking API का बीटा वर्शन अब उपलब्ध नहीं है.
pageId कंट्रोल पैरामीटर जोड़ा गया, ताकि किसी रिपोर्ट पेज से लिंक किया जा सके.
लोड होने पर रिपोर्ट की स्थिति को View या Edit मोड पर सेट करने के लिए, 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 कर दिया गया है.
Surveys कनेक्टर
- surveyId अब एक सर्वे आईडी या सर्वे आईडी की कॉमा लगाकर अलग की गई सूची स्वीकार करता है.

2021-12-16

Integration API की शुरुआती रिलीज़.
- इससे किसी मौजूदा रिपोर्ट को लिंक किया जा सकता है और रिपोर्ट का नाम सेट किया जा सकता है.
- एक साथ कई डेटा सोर्स कॉन्फ़िगर किए जा सकते हैं. साथ ही, हर डेटा सोर्स का नाम सेट किया जा सकता है.
- इन कनेक्टर टाइप के साथ काम करता है: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Google Sheets, Google Surveys, Search Console.

Linking API संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

परिचय

इस्तेमाल का उदाहरण और फ़ायदे

यह कैसे काम करता है

Linking API डेवलपर वर्कफ़्लो

Linking API का इस्तेमाल करने वाले लोगों का अनुभव

ज़रूरी शर्तें

यूआरएल पैरामीटर

कंट्रोल पैरामीटर

रिपोर्ट पैरामीटर

डेटा स्रोत पैरामीटर

डेटा स्रोत पैरामीटर

डेटा सोर्स कॉन्फ़िगरेशन को बदलना बनाम अपडेट करना

ds.connector सेट होने पर ज़रूरी पैरामीटर

उदाहरण

बनाना बनाम जोड़ना

डेटा सोर्स के उपनाम के लिए वाइल्डकार्ड

कनेक्टर का रेफ़रंस

BigQuery

टेबल क्वेरी

Google Analytics, Firebase Analytics, और Crashlytics के लिए फ़ील्ड टेंप्लेट

कस्टम क्वेरी

Cloud Spanner

कम्यूनिटी कनेक्टर

Google Analytics

Google Cloud Storage

Google Sheets

Looker

Search Console

टेंप्लेट की अनुमतियां

नई या डिफ़ॉल्ट रिपोर्ट का इस्तेमाल करना

कोई रिपोर्ट एम्बेड करना

आईडी और उपनाम ढूंढना

रिपोर्ट आईडी

डेटा सोर्स का उपनाम

कनेक्टर किस तरह का है

सलाह और समस्या हल करना

डीबग वाला डायलॉग बॉक्स

अनुमतियां

अपडेट करना बनाम बदलना

फ़ील्ड रीफ़्रेश करें

सुझाव/राय/शिकायत और सहायता

बदलावों का लॉग

2023-06-06

2023-05-22

2022-11-21

2022-11-14

2022-06-15

2021-12-16

Linking API

`ds.connector` सेट होने पर ज़रूरी पैरामीटर