एसडीके या REST की मदद से, Data Manager API का ऐक्सेस सेट अप करने का तरीका यहां बताया गया है.
सेटअप करने के लिए, आपको जिस तरह की प्रोसेस का इस्तेमाल करना है उसे चुनें:
ज़रूरी शर्तें
डेटा एपीआई का इस्तेमाल करने से पहले, पक्का करें कि आपके पास ये चीज़ें हों:
- एक Google Cloud प्रोजेक्ट.
- ऐसा Google खाता जिसके पास आपके Google Cloud प्रोजेक्ट पर
serviceusage.services.enableकी अनुमति हो या जिसके पास ऐसी भूमिका हो जिसमें यह अनुमति शामिल हो. उदाहरण के लिए,roles/ownerऔरroles/serviceusage.serviceUsageAdmin, दोनों मेंserviceusage.services.enableअनुमति शामिल है. अनुमतियां देखने के लिए, मौजूदा ऐक्सेस देखें पर जाएं. - Google Cloud कमांड-लाइन इंटरफ़ेस इंस्टॉल हो गया हो.
एपीआई चालू करना
अगर आपने अब तक ऐसा नहीं किया है, तो Data Manager API चालू करें पर क्लिक करके, Data Manager API चालू करें. इसके अलावा, इस चरण को मैन्युअल तरीके से पूरा करने के लिए, निर्देशों का पालन करें.
Data Manager API चालू करनाअगर आपको Data Manager API नहीं मिल रहा है या Data Manager API चालू नहीं हो रहा है, तो पुष्टि करें कि आपका Google खाता ज़रूरी शर्तों को पूरा करता हो.
पुष्टि करने की सुविधा सेट अप करना
एपीआई कुंजियों के अलावा, Google पर पुष्टि करने के किसी भी तरीके का इस्तेमाल किया जा सकता है. हमारा सुझाव है कि आप अपने इस्तेमाल के उदाहरण के लिए पुष्टि करने का सही तरीका चुनने के बारे में पढ़ें. इससे आपको यह तय करने में मदद मिलेगी कि आपके इस्तेमाल के उदाहरण के लिए कौनसा तरीका सही है.
पुष्टि करने के दो सामान्य तरीके हैं: उपयोगकर्ता खाते और सेवा खाते:
- उपयोगकर्ता खाते: ये उन लोगों के खाते होते हैं जो Google के एपीआई और सेवाओं से सीधे तौर पर इंटरैक्ट करते हैं.
- सेवा खाते: ये उपयोगकर्ताओं के तौर पर लोगों के बजाय ऐप्लिकेशन को दिखाते हैं. इनकी मदद से, आपके ऐप्लिकेशन पुष्टि करने और अनुमति देने की प्रोसेस को मैनेज कर पाते हैं. उदाहरण के लिए, अगर किसी ऐप्लिकेशन को Google Cloud के संसाधनों को ऐक्सेस करना है.
आपका इंटिग्रेशन, ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (एडीसी) का इस्तेमाल करके, एनवायरमेंट से क्रेडेंशियल अपने-आप ढूंढ सकता है. इससे आपको पुष्टि करने के लिए, क्लाइंट कोड बदलने की ज़रूरत नहीं पड़ती.
एडीसी सेट अप करने के लिए, उपयोगकर्ता खाता या सेवा खाते के तौर पर काम करना चुनें:
उपयोगकर्ता खाते के क्रेडेंशियल की मदद से पुष्टि करने का तरीका यहां दिया गया है:
अपने प्रोजेक्ट के लिए, Google Auth Platform की सेटिंग कॉन्फ़िगर करें.
Google Cloud Console में, ब्रैंडिंग पेज खोलें.
अपना प्रोजेक्ट चुनें.
फ़ॉर्म भरें और बनाएं पर क्लिक करें.
Data Manager API का स्कोप संवेदनशील स्कोप है. इसलिए, यह तरीका अपनाना ज़रूरी है:
अपने प्रोजेक्ट के लिए, डेटा ऐक्सेस की सेटिंग पर जाएं.
स्कोप जोड़ें या हटाएं पर क्लिक करें.
स्कोप की सूची में, Data Manager API के बगल में मौजूद बॉक्स पर सही का निशान लगाएं. इसके बाद, अपडेट करें पर क्लिक करें.
सेव करें पर क्लिक करें.
Google Cloud Console में Audience पर जाएं. इसके बाद, पब्लिश करने की स्थिति और उपयोगकर्ता का टाइप अपडेट करें. ऐप्लिकेशन ऑडियंस मैनेज करें में इन सेटिंग के बारे में ज़्यादा जानें.
प्रोजेक्ट में OAuth2 क्लाइंट बनाने के लिए, OAuth2 क्लाइंट बनाएं पर क्लिक करें. इसके अलावा, डेस्कटॉप OAuth2 क्लाइंट बनाने के लिए, निर्देशों का पालन करें. अगर आपके पास पहले से कोई डेस्कटॉप OAuth2 क्लाइंट है और आपको उसका इस्तेमाल Data Manager API के लिए करना है, तो यह चरण छोड़ा जा सकता है.
OAuth2 क्लाइंट बनाएं पर क्लिक करने के बाद, OAuth क्लाइंट कॉन्फ़िगर करें का प्रॉम्प्ट मिलने पर, डेस्कटॉप ऐप्लिकेशन चुनें. इससे, बाकी चरणों में क्लाइंट का इस्तेमाल किया जा सकेगा.
OAuth2 क्लाइंट बनानाआखिरी चरण में, क्लाइंट कॉन्फ़िगरेशन डाउनलोड करें पर क्लिक करें. साथ ही, डाउनलोड करने के लिए चुनी गई जगह को नोट करें.
नीचे दिए गए निर्देश का इस्तेमाल करके, लोकल एडीसी फ़ाइल जनरेट करें. इस कमांड से एक वेब फ़्लो लॉन्च होता है. इसमें आपको उस Google खाते में लॉग इन करने के लिए कहा जाता है जिसका इस्तेमाल एपीआई के साथ किया जा रहा है.
PATH_TO_CLIENT_JSON की जगह, डाउनलोड की गई JSON फ़ाइल का नाम डालें.
gcloud auth application-default login \ --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \ --client-id-file="PATH_TO_CLIENT_JSON"अगर आपको Data Manager API और Google Ads API के लिए एक ही क्रेडेंशियल का इस्तेमाल करना है, तो
--scopesसूची में Google Ads API स्कोप शामिल करें:gcloud auth application-default login \ --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \ --client-id-file="PATH_TO_CLIENT_JSON"अगर आपको Data Manager API और Display & Video 360 API के लिए एक ही क्रेडेंशियल का इस्तेमाल करना है, तो
--scopesसूची में Display & Video 360 API का स्कोप शामिल करें:gcloud auth application-default login \ --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \ --client-id-file="PATH_TO_CLIENT_JSON"पुष्टि करें कि क्रेडेंशियल को इस कमांड का इस्तेमाल करके सही तरीके से सेट अप किया गया है. अगर यह कमांड काम करती है, तो यह कंसोल पर ऐक्सेस टोकन प्रिंट करती है.
gcloud auth application-default print-access-token
अपने ऐप्लिकेशन के लिए पुष्टि करने और क्रेडेंशियल के बारे में ज़्यादा जानने के लिए, Google पर पुष्टि करने के तरीके और ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल कैसे काम करते हैं लेख पढ़ें.
खाते का ऐक्सेस सेट अप करना
अपने उपयोगकर्ता खाते से जुड़े ईमेल पते को Destination का ऐक्सेस दें.
- अगर Google Ads खाते का इस्तेमाल किया जा रहा है, तो Google Ads खाते या पैरंट Google Ads मैनेजर खाते में उपयोगकर्ता का ईमेल पता जोड़ने के लिए, दिए गए निर्देशों का पालन करें.
- अगर Display & Video 360 खाते का इस्तेमाल किया जा रहा है, तो खाते में उपयोगकर्ता का ईमेल पता जोड़ने के लिए, दिए गए निर्देशों का पालन करें.
- अगर Google Analytics प्रॉपर्टी का इस्तेमाल किया जा रहा है, तो खाते में उपयोगकर्ता का ईमेल पता जोड़ने के लिए, दिए गए निर्देशों का पालन करें.
अगले चरण
क्लाइंट लाइब्रेरी इंस्टॉल करें और कोड के सैंपल चलाकर, Data Manager API का पहला अनुरोध करें.