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

एसडीके या REST की मदद से, Data Manager 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 चालू करें पर क्लिक करके, Data Manager API चालू करें. इसके अलावा, इस चरण को मैन्युअल तरीके से पूरा करने के लिए, निर्देशों का पालन करें.

Data Manager API चालू करना

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

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

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

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

• उपयोगकर्ता खाते: ये उन लोगों के खाते होते हैं जो Google के एपीआई और सेवाओं से सीधे तौर पर इंटरैक्ट करते हैं.
• सेवा खाते: ये उपयोगकर्ताओं के तौर पर लोगों के बजाय ऐप्लिकेशन को दिखाते हैं. इन कुकी की मदद से, आपके ऐप्लिकेशन पुष्टि करने और अनुमति देने की प्रोसेस को मैनेज कर पाते हैं. उदाहरण के लिए, अगर किसी ऐप्लिकेशन को 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 में Audience पर जाएं. इसके बाद, पब्लिश करने की स्थिति और उपयोगकर्ता का टाइप अपडेट करें. ऐप्लिकेशन की ऑडियंस मैनेज करें में जाकर, इन सेटिंग के बारे में ज़्यादा जानें.

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 के लिए एक ही क्रेडेंशियल का इस्तेमाल करना है, तो --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"
   

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

   gcloud auth application-default print-access-token
   

सेवा खाता

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

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

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

2. सेवा खाते को Service Usage Consumer 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 खाते को, सेवा खाते पर सेवा खाता टोकन क्रिएटर की आईएएम भूमिका (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 के लिए एक ही क्रेडेंशियल का इस्तेमाल करना है, तो --scopes सूची में Google Ads API स्कोप शामिल करें:

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

   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"
   

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

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

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

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

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

• अगर Google Ads खाते का इस्तेमाल किया जा रहा है, तो Google Ads खाते या पैरंट Google Ads मैनेजर खाते में उपयोगकर्ता का ईमेल पता जोड़ने के लिए, दिए गए निर्देशों का पालन करें.
• अगर Display & Video 360 खाते का इस्तेमाल किया जा रहा है, तो खाते में उपयोगकर्ता का ईमेल पता जोड़ने के लिए, दिए गए निर्देशों का पालन करें.
• अगर Google Analytics प्रॉपर्टी का इस्तेमाल किया जा रहा है, तो खाते में उपयोगकर्ता का ईमेल पता जोड़ने के लिए, इन निर्देशों का पालन करें.
• अगर आपको विज्ञापन देने वाले व्यक्ति या कंपनी के खाते से लिंक किए गए डेटा पार्टनर खाते का इस्तेमाल करके Destination को ऐक्सेस करना है, तो डेटा पार्टनर खाते में उपयोगकर्ता का ईमेल पता जोड़ने के लिए, दिए गए निर्देशों का पालन करें.

सेवा खाता

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

• अगर Google Ads खाते का इस्तेमाल किया जा रहा है, तो Google Ads खाते या पैरंट Google Ads मैनेजर खाते में सेवा खाता जोड़ने के लिए, खाता ऐक्सेस करने की सुविधा का सेटअप पूरा करें.
• अगर Display & Video 360 खाते का इस्तेमाल किया जा रहा है, तो सेवा खाते से जुड़े Display & Video 360 उपयोगकर्ता को बनाने के लिए, दिए गए निर्देशों का पालन करें.
• अगर Google Analytics प्रॉपर्टी का इस्तेमाल किया जा रहा है, तो खाते में उपयोगकर्ता का ईमेल पता जोड़ने के लिए, इन निर्देशों का पालन करें.
• अगर आपको विज्ञापन देने वाले व्यक्ति या कंपनी के खाते से मिले पार्टनर लिंक का इस्तेमाल करके, डेटा पार्टनर खाते से Destination को ऐक्सेस करना है, तो डेटा पार्टनर खाते में खाता ऐक्सेस करने का सेटअप पूरा करें. इससे सेवा खाता जोड़ा जा सकेगा और उसके ऐक्सेस का लेवल सेट किया जा सकेगा.

अगले चरण

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