Looker Studio एपीआई

Looker Studio API का इस्तेमाल करके, Looker Studio की एसेट को खोजा और मैनेज किया जा सकता है.

इस एपीआई का मुख्य इस्तेमाल यह है कि Google Workspace या Cloud Identity के संगठन, Looker Studio की एसेट को अपने-आप मैनेज करें और माइग्रेट करें.

अहम जानकारी: यह एपीआई सिर्फ़ उन उपयोगकर्ताओं के लिए उपलब्ध है जो Google Workspace या Cloud Identity वाले संगठन से जुड़े हैं.

ज़रूरी शर्तों के बारे में खास जानकारी

Looker Studio API का इस्तेमाल करने के लिए, इन चरणों को पूरा करना ज़रूरी है:

1. एपीआई का इस्तेमाल करने के लिए, किसी ऐप्लिकेशन को कॉन्फ़िगर करें.
2. ऐप्लिकेशन को अनुमति देने के लिए, Google Admin console का इस्तेमाल करें.
3. OAuth 2.0 ऐक्सेस टोकन पाना और एपीआई को कॉल करना.

इन सामान्य तरीकों से, ऊपर दिए गए तरीके को अलग-अलग संगठन अपना सकते हैं:

• किसी संगठन के लिए बनाए गए इंटरनल ऐप्लिकेशन. संगठन अपने संगठन के सभी उपयोगकर्ताओं के लिए ऐप्लिकेशन को कॉन्फ़िगर और अनुमति देता है.
• बाहरी उपयोगकर्ताओं/ग्राहकों (उदाहरण के लिए, डेवलपर और अलग-अलग संगठनों के उपयोगकर्ता) के लिए बनाए गए तीसरे पक्ष के ऐप्लिकेशन. डेवलपर ऐप्लिकेशन को कॉन्फ़िगर करता है, लेकिन उपयोगकर्ता का संगठन तीसरे पक्ष के ऐप्लिकेशन को अनुमति देता है.

1. एपीआई का इस्तेमाल करने के लिए, कोई ऐप्लिकेशन कॉन्फ़िगर करें

अपना ऐप्लिकेशन कॉन्फ़िगर करने के लिए, नीचे दिया गया तरीका अपनाएं:

• एपीआई को चालू करें
• OAuth क्लाइंट बनाना

इस एपीआई को चालू करें

अपने प्रोजेक्ट के लिए कोई एपीआई चालू करने के लिए:

1. Google API (एपीआई) कंसोल में Looker Studio API खोलें.
2. पूछे जाने पर, कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं.
3. चालू करें पर क्लिक करें.
4. अनुरोध किए जाने पर, एपीआई की सेवा की शर्तें पढ़ें और स्वीकार करें.

OAuth क्लाइंट बनाना

OAuth क्लाइंट बनाने के ये तरीके सामान्य दिशा-निर्देश हैं. साथ ही, इन्हें आपके ऐप्लिकेशन की ज़रूरतों के हिसाब से सेट किया जाना चाहिए.

अहम जानकारी: अपने OAuth क्लाइंट में Looker Studio के दायरे न जोड़ें. ये दायरे, Workspace एडमिन तब जोड़ेंगे, जब वे ऐप्लिकेशन को अनुमति देंगे.

1. OAuth के लिए सहमति वाली स्क्रीन को कॉन्फ़िगर करें पर जाएं.
   1. अंदरूनी चुनें, बनाएं पर क्लिक करें.
   2. ज़रूरी फ़ील्ड भरें, सेव करें पर क्लिक करें.
2. क्रेडेंशियल पर जाएं.
   1. क्रेडेंशियल बनाएं पर क्लिक करें.
   2. OAuth क्लाइंट आईडी चुनें.
   3. सही Application Type चुनें. (वेब ऐप्लिकेशन सबसे सामान्य है).
   4. ज़रूरी फ़ील्ड भरें, बनाएं पर क्लिक करें.
3. Client-ID पर ध्यान दें, क्योंकि इसका इस्तेमाल ऐप्लिकेशन को अनुमति देने के लिए किया जाता है.

2. संगठन के लिए ऐप्लिकेशन को अनुमति दें

Looker Studio API का इस्तेमाल करने वाले ऐप्लिकेशन, सिर्फ़ उन Google Workspace उपयोगकर्ताओं को पुष्टि कर सकते हैं और अनुमति दे सकते हैं जिन्हें उपयोगकर्ता के संगठन ने एपीआई का ऐक्सेस कंट्रोल करने के लिए पूरे डोमेन पर काम करने के अधिकार का इस्तेमाल करके ऐप्लिकेशन को अनुमति दी है.

पूरे डोमेन के लिए, ऐप्लिकेशन के OAuth क्लाइंट आईडी और ऐप्लिकेशन के लिए ज़रूरी दायरे को कॉन्फ़िगर करें.

अहम जानकारी: Workspace एडमिन को नीचे दिए गए चरण पूरे करने होंगे. एडमिन को ऐप्लिकेशन के OAuth क्लाइंट आईडी और ऐप्लिकेशन के लिए ज़रूरी OAuth के दायरों की सूची की ज़रूरत होगी.

1. अपने Google Admin console में साइन इन करें और डोमेन के सभी लोगों को ऐक्सेस देना पर जाएं.
2. API clients नया जोड़ें पर क्लिक करें.
3. अनुमति देने के लिए, ऐप्लिकेशन का Client ID डालें (उदाहरण के लिए, वह ऐप्लिकेशन जो Looker Studio API का इस्तेमाल करता है).
4. ऐप्लिकेशन के लिए ज़रूरी सभी OAuth स्कोप डालें. अगर एसेट को मैनेज करने के लिए, Looker Studio API का इस्तेमाल किया जा रहा है, तो आम तौर पर ये स्कोप अनुरोध किए जाते हैं:
   • https://www.googleapis.com/auth/datastudio
   • https://www.googleapis.com/auth/userinfo.profile
5. अनुमति दें पर क्लिक करें.

ध्यान दें: अगर आपके ऐप्लिकेशन को Looker Studio की एसेट को मैनेज करने की ज़रूरत नहीं है, तो https://www.googleapis.com/auth/datastudio के बजाय, ज़्यादा पाबंदी वाले https://www.googleapis.com/auth/datastudio.readonly दायरे का इस्तेमाल करें.

ऐप्लिकेशन की अनुमति मिलने के बाद, संगठन से जुड़ा Workspace का कोई भी उपयोगकर्ता, Looker Studio API के साथ अपने-आप ऐप्लिकेशन का इस्तेमाल कर पाएगा.

3. OAuth 2.0 ऐक्सेस टोकन पाना और एपीआई को कॉल करना

ऐप्लिकेशन को डेवलप करने और उसकी अनुमति देने के बाद, आप Workspace के उपयोगकर्ताओं के लिए एपीआई को कॉल कर पाएंगे. OAuth का इस्तेमाल करके Google API के साथ काम करने के बारे में जानकारी के लिए, OAuth 2.0 का इस्तेमाल करके, Google API ऐक्सेस करना देखें. उपलब्ध कार्रवाइयों के लिए, एपीआई का रेफ़रंस देखें.

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

OAuth डायलॉग मौजूद नहीं है

अगर किसी उपयोगकर्ता के संगठन ने ऐप्लिकेशन को अनुमति दी है, तो उस संगठन के उपयोगकर्ताओं को ऐप्लिकेशन की अनुमति देते समय OAuth डायलॉग नहीं दिखाया जाएगा. हालांकि, यह अपवाद तब होगा, जब ऐप्लिकेशन, Google API के ऐसे अन्य दायरे के लिए अनुमति का अनुरोध करे जिन्हें Workspace एडमिन ने कॉन्फ़िगर न किया हो. इस स्थिति में, OAuth डायलॉग, उपयोगकर्ताओं को दिखेगा.

गड़बड़ी 400: invalid_scope

अगर ऐप्लिकेशन को अनुमति देते समय, किसी उपयोगकर्ता को Error 400: invalid_scope मैसेज मिलता है, तो इसका मतलब है कि उपयोगकर्ता के संगठन ने गलत तरीके से ऐप्लिकेशन को अनुमति नहीं दी है. समस्या को हल करने के लिए, उपयोगकर्ता को अनुरोध करना होगा कि उनके संगठन में ऐप्लिकेशन को अनुमति दी जाए.