एपीआई ऐक्सेस सेट अप करना

एसडीके या REST का इस्तेमाल करके, Data Manager API का ऐक्सेस सेट अप करने का तरीका यहां दिया गया है.

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

Data API का इस्तेमाल करने से पहले, पक्का करें कि आपके पास ये चीज़ें हों:

1. एक Google Cloud प्रोजेक्ट. आपके पास किसी मौजूदा प्रोजेक्ट का इस्तेमाल करने या Data Manager API के लिए नया प्रोजेक्ट बनाने का विकल्प होता है.

2. एक Google खाता, जिसके पास आपके Google Cloud प्रोजेक्ट पर serviceusage.services.enable की अनुमति हो या जिसके पास ऐसी भूमिका हो जिसमें यह अनुमति शामिल हो. उदाहरण के लिए, roles/owner और roles/serviceusage.serviceUsageAdmin दोनों में serviceusage.services.enable की अनुमति शामिल होती है. अपनी अनुमतियां देखने के लिए, मौजूदा ऐक्सेस देखें.

3. Google Cloud सीएलआई इंस्टॉल होना चाहिए.

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

अगर आपने अब तक Data Manager API को चालू नहीं किया है, तो Enable the Data Manager API पर क्लिक करें. इसके अलावा, इस चरण को मैन्युअल तरीके से पूरा करने के लिए, निर्देशों का पालन करें.

Data Manager API को चालू करें

अगर आपको Data Manager API नहीं मिल रहा है या Data Manager API को चालू करें काम नहीं कर रहा है, तो पुष्टि करें कि आपका Google खाता, ज़रूरी शर्तें पूरी करता हो.

पुष्टि करने की सुविधा सेट अप करना

एपीआई पासकोड के अलावा, Google पर पुष्टि करने के किसी भी तरीके का इस्तेमाल किया जा सकता है. हमारा सुझाव है कि अपने इस्तेमाल के उदाहरण के लिए, पुष्टि करने का सही तरीका चुनने का तरीका देखें. इससे आपको यह तय करने में मदद मिलेगी कि आपके इस्तेमाल के उदाहरण के लिए कौनसी अप्रोच सही है.

पुष्टि करने के दो सामान्य तरीके हैं: उपयोगकर्ता खाते और सेवा खाते:

• उपयोगकर्ता खाते: ये उन लोगों के लिए होते हैं जो सीधे Google API और सेवाओं के साथ इंटरैक्ट करते हैं.
• सेवा खाते: ये ऐप्लिकेशन के लिए होते हैं, न कि लोगों के लिए. इन्हें उपयोगकर्ता के तौर पर इस्तेमाल किया जाता है. इनकी मदद से, आपके ऐप्लिकेशन पुष्टि और अनुमति को मैनेज कर सकते हैं. उदाहरण के लिए, अगर किसी ऐप्लिकेशन को Google Cloud के संसाधनों को ऐक्सेस करना है.

आपका इंटिग्रेशन, एनवायरमेंट से क्रेडेंशियल अपने-आप ढूंढने के लिए, ऐप्लिकेशन डिफ़ॉल्ट क्रेडेंशियल (एडीसी) का इस्तेमाल कर सकता है. इससे आपको पुष्टि करने के लिए, क्लाइंट कोड में बदलाव करने की ज़रूरत नहीं पड़ती.

एडीसी सेट अप करने के लिए, उपयोगकर्ता खाता या सेवा खाता चुनें:

उपयोगकर्ता खाता

उपयोगकर्ता खाते के क्रेडेंशियल से पुष्टि करने का तरीका यहां दिया गया है:

1. अपने प्रोजेक्ट के लिए, Google Auth Platform की सेटिंग कॉन्फ़िगर करें.

   अहम जानकारी: Data Manager API के दायरे के लिए, उपयोगकर्ता के क्रेडेंशियल पाने के लिए इस्तेमाल किए जाने वाले किसी भी Google Cloud ऐप्लिकेशन की Google OAuth से पुष्टि होनी चाहिए. ऐसा न करने पर, उपयोगकर्ताओं को पुष्टि नहीं की गई यूज़र इंटरफ़ेस (यूआई) स्क्रीन दिखेगी. सेवा खातों के लिए, Google OAuth से पुष्टि करने की ज़रूरत नहीं होती.

   1. Google Cloud Console में, ब्रैंडिंग पेज खोलें.

   2. अपना प्रोजेक्ट चुनें.

   3. फ़ॉर्म भरें और बनाएं पर क्लिक करें.

2. Data Manager API का दायरा संवेदनशील होता है. इसलिए, यह तरीका अपनाना ज़रूरी है:

   1. अपने प्रोजेक्ट के लिए, डेटा ऐक्सेस की सेटिंग पर जाएं.

   2. दायरे जोड़ें या हटाएं पर क्लिक करें.

   3. दायरे की सूची में, Data Manager API के बगल में मौजूद बॉक्स को चुनें. इसके बाद, अपडेट करें पर क्लिक करें.

   4. सेव करें पर क्लिक करें.

   5. Google Cloud Console में, ऑडियंस पर जाएं और पब्लिश करने की स्थिति और उपयोगकर्ता का टाइप अपडेट करें. ऐप्लिकेशन की ऑडियंस मैनेज करना लेख में, इन सेटिंग के बारे में ज़्यादा जानें.

3. प्रोजेक्ट में OAuth2 क्लाइंट बनाने के लिए, OAuth2 क्लाइंट बनाएं पर क्लिक करें. इसके अलावा, डेस्कटॉप OAuth2 क्लाइंट बनाने के लिए, निर्देशों का पालन करें. अगर आपके पास पहले से कोई डेस्कटॉप OAuth2 क्लाइंट है और आपको Data Manager API के लिए उसका इस्तेमाल करना है, तो इस चरण को छोड़ा जा सकता है.

   अगर आपने OAuth2 क्लाइंट बनाएं पर क्लिक किया है, तो अपना OAuth क्लाइंट कॉन्फ़िगर करें के लिए पूछे जाने पर, डेस्कटॉप ऐप्लिकेशन चुनें. इससे बाकी चरणों में क्लाइंट का इस्तेमाल किया जा सकेगा.

   OAuth2 क्लाइंट बनाएं

   आखिरी चरण में, क्लाइंट कॉन्फ़िगरेशन डाउनलोड करें पर क्लिक करें और डाउनलोड करने की वह जगह नोट करें जिसे आपने चुना है.

4. नीचे दी गई कमांड चलाकर, लोकल एडीसी फ़ाइल जनरेट करें. इस कमांड से एक वेब फ़्लो लॉन्च होता है. इसमें आपको उस 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 के लिए एक ही क्रेडेंशियल का इस्तेमाल करना है, तो Google Ads API का दायरा --scopes सूची में शामिल करें:

   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 के लिए एक ही क्रेडेंशियल का इस्तेमाल करना है, तो Display & Video 360 API का दायरा --scopes सूची में शामिल करें:

   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"
   

5. पुष्टि करें कि क्रेडेंशियल सही तरीके से सेट अप किए गए हैं. इसके लिए, यह कमांड इस्तेमाल करें. अगर यह कमांड सही तरीके से काम करती है, तो कंसोल पर एक ऐक्सेस टोकन दिखता है.

   gcloud auth application-default print-access-token
   

सेवा खाता

पुष्टि करने के लिए, सेवा खाते के तौर पर काम करने की सुविधा का इस्तेमाल करने का तरीका यहां दिया गया है. इस तरीके में, सेवा खाते की कुंजियों के बजाय, सेवा खाते के तौर पर काम करने की सुविधा का इस्तेमाल किया जाता है. ऐसा इसलिए, क्योंकि सेवा खाते की कुंजियों को सही तरीके से मैनेज न करने पर, सुरक्षा से जुड़ा जोखिम हो सकता है.

1. **सेवा खाता बनाएं** बटन पर क्लिक करें. इसके अलावा, सेवा खाता चुनने या बनाने के लिए, निर्देशों का पालन करें.

   सेवा खाता बनाएं

2. सेवा खाते को सर्विस यूसेज कंज्यूमर IAM की भूमिका (roles/serviceusage.serviceUsageConsumer) दें. इसमें serviceusage.services.use की अनुमति शामिल होती है. इस अनुमति की मदद से, सेवा खाता प्रोजेक्ट के लिए एपीआई अनुरोध भेज सकता है.

   gcloud projects add-iam-policy-binding PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/serviceusage.serviceUsageConsumer"
   

3. अपने Google खाते को, सेवा खाता टोकन क्रिएटर IAM की भूमिका (roles/iam.serviceAccountTokenCreator) सेवा खाते पर दें.

   ध्यान दें: यह चरण तब भी ज़रूरी है, जब आपका Google खाता प्रोजेक्ट का मालिक हो.

   gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
     --member="user:USER_EMAIL" \
     --role="roles/iam.serviceAccountTokenCreator"
   

4. एडीसी को कॉन्फ़िगर करने के लिए, यह कमांड चलाएं:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"
   

   अगर आपको Data Manager API और Google Ads API के लिए एक ही क्रेडेंशियल का इस्तेमाल करना है, तो Google Ads API का दायरा --scopes सूची में शामिल करें:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"
   

   अगर आपको Data Manager API और Display & Video 360 API के लिए एक ही क्रेडेंशियल का इस्तेमाल करना है, तो Display & Video 360 API का दायरा --scopes सूची में शामिल करें:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"
   

   साइन इन करने के लिए कहे जाने पर, अपने उस Google खाते से लॉग इन करें जिसके पास सेवा खाता टोकन क्रिएटर की भूमिका है.

5. पुष्टि करें कि क्रेडेंशियल सही तरीके से सेट अप किए गए हैं. इसके लिए, यह कमांड इस्तेमाल करें. अगर यह कमांड सही तरीके से काम करती है, तो कंसोल पर एक ऐक्सेस टोकन दिखता है.

   gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"
   

ध्यान दें: https://www.googleapis.com/auth/datamanager का दायरा, Data Manager API की सभी सेवाओं के लिए ज़रूरी है.

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

खाते का ऐक्सेस सेट अप करना

उपयोगकर्ता खाता

अपने इस्तेमाल के उदाहरण के हिसाब से टैब चुनें.

• अगर आपको उन विज्ञापन देने वालों के खातों के लिए क्रेडेंशियल का इस्तेमाल करना है जिन्हें आपको मैनेज करना है और अगर आपका Google खाता उन खातों में उपयोगकर्ता के तौर पर शामिल है, तो विज्ञापन देने वाला चुनें.
• अगर आपको किसी डेटा पार्टनर के खाते के लिए क्रेडेंशियल का इस्तेमाल करना है और आपका Google खाता उस खाते में उपयोगकर्ता के तौर पर शामिल है, तो डेटा पार्टनर चुनें. साथ ही, अगर आपको उन विज्ञापन देने वालों के खातों को मैनेज करना है जो डेटा पार्टनर के खाते से पार्टनर लिंक हैं, तो डेटा पार्टनर चुनें.

विज्ञापन देने वाला

उपयोगकर्ता से जुड़े ईमेल को Destination का ऐक्सेस दें.

Google Ads

उपयोगकर्ता के ईमेल को Google Ads खाते या पैरंट Google Ads मैनेजर खाते में जोड़ने के लिए, निर्देशों का पालन करें.

Display &Video 360

उपयोगकर्ता के ईमेल को खाते में जोड़ने के लिए, निर्देशों का पालन करें.

Google Analytics

उपयोगकर्ता के ईमेल को खाते में जोड़ने के लिए, निर्देशों का पालन करें.

डेटा पार्टनर

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

Google Ads के यूज़र इंटरफ़ेस (यूआई) के ज़रिए, डेटा पार्टनर खाते में उपयोगकर्ता का ईमेल जोड़ने के लिए, इन निर्देशों का पालन करें.

सेवा खाता

अपने इस्तेमाल के उदाहरण के हिसाब से टैब चुनें.

• अगर आपको उन विज्ञापन देने वालों के खातों के लिए क्रेडेंशियल का इस्तेमाल करना है जिन्हें आपको मैनेज करना है और अगर आपका Google खाता उन खातों में उपयोगकर्ता के तौर पर शामिल है, तो विज्ञापन देने वाला चुनें.
• अगर आपको किसी डेटा पार्टनर के खाते के लिए क्रेडेंशियल का इस्तेमाल करना है और आपका Google खाता उस खाते में उपयोगकर्ता के तौर पर शामिल है, तो डेटा पार्टनर चुनें. साथ ही, अगर आपको उन विज्ञापन देने वालों के खातों को मैनेज करना है जो डेटा पार्टनर के खाते से पार्टनर लिंक हैं, तो डेटा पार्टनर चुनें.

विज्ञापन देने वाला

अपने सेवा खाते से जुड़े ईमेल को Destination का ऐक्सेस दें.

Google Ads

सेवा खाते को Google Ads खाते या पैरंट Google Ads मैनेजर खाते में जोड़ने के लिए, खाते के ऐक्सेस का सेटअप पूरा करें.

Display &Video 360

सेवा खाते से जुड़े Display & Video 360 उपयोगकर्ता को बनाने के लिए, निर्देशों का पालन करें.

Google Analytics

सेवा खाते के ईमेल को खाते में जोड़ने के लिए, निर्देशों का पालन करें.

डेटा पार्टनर

अपने सेवा खाते से जुड़े ईमेल को अपने डेटा पार्टनर खाते का ऐक्सेस दें.

डेटा पार्टनर खाते के ऐक्सेस को Google Ads के यूज़र इंटरफ़ेस (यूआई) से मैनेज किया जाता है. सेवा खाते को जोड़ने और उसका ऐक्सेस लेवल सेट करने के लिए, खाते के ऐक्सेस का सेटअप में दिए गए चरणों का पालन करें.

अगले चरण

क्लाइंट लाइब्रेरी इंस्टॉल करें और कोड के सैंपल चलाएं, ताकि Data Manager API के लिए पहला अनुरोध भेजा जा सके.