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

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

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

  1. कोई Google Cloud प्रोजेक्ट या Google खाता, जिसका इस्तेमाल करके आपको प्रोजेक्ट का मालिकाना हक पाना है.

    • अगर आपके पास कोई प्रोजेक्ट नहीं है, तो अगले सेक्शन में सेटअप की प्रोसेस के दौरान आपके लिए एक प्रोजेक्ट बनाया जाएगा.

    • अगर आपके पास पहले से कोई प्रोजेक्ट है, तो पक्का करें कि आपके Google खाते के पास कोई ऐसी भूमिका हो जिससे प्रोजेक्ट पर एपीआई चालू किए जा सकें. जैसे, मालिक, एडिटर, या सेवा के इस्तेमाल का एडमिन. अपनी भूमिका देखने के लिए, Google Cloud Console में IAM पेज खोलें, अपना प्रोजेक्ट चुनें, और सूची में अपना Google खाता ढूंढें.

      ज़्यादा जानकारी के लिए, मौजूदा ऐक्सेस देखना लेख पढ़ें.

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

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

अगर आपने पहले से ऐसा नहीं किया है, तो अपने Google Cloud प्रोजेक्ट में Data Manager API को चालू करें. इसके लिए, Data Manager API चालू करें पर क्लिक करें या इस चरण को मैन्युअल तरीके से पूरा करने के लिए, निर्देशों का पालन करें.

Data Manager API चालू करें

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    3. दायरे की सूची में, Data Manager API ढूंढें और हर उस दायरे के लिए बॉक्स पर सही का निशान लगाएं जिसकी ज़रूरत आपके ऐप्लिकेशन को है:

      • .../auth/datamanager: एपीआई के सामान्य ऑपरेशन के लिए, यह दायरा चुनें. जैसे, ग्राहक से जुड़ा डेटा, ऑडियंस, और इवेंट मैनेज करना. इस गाइड में, मुख्य तौर पर इसी दायरे का इस्तेमाल किया गया है.

      • .../auth/datamanager.partnerlink: यह दायरा सिर्फ़ तब चुनें जब आप डेटा पार्टनर हों और विज्ञापन देने वाले के खातों में पार्टनर लिंक बना रहे हों या उन्हें मिटा रहे हों.

    4. अपडेट करें पर क्लिक करें.

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

    6. Google Cloud Console में, ऑडियंस पर जाएं और शुरुआती डेवलपमेंट के लिए सेटिंग कॉन्फ़िगर करें:

      • पब्लिश होने की स्थिति को टेस्टिंग पर सेट करें.
      • उपयोगकर्ता का टाइप को इंटरनल पर सेट करें. यह तब करें, जब आपका प्रोजेक्ट किसी Google Workspace संगठन में हो. अगर ऐसा नहीं है, तो एक्सटर्नल पर सेट करें.
      • अगर एक्सटर्नल का इस्तेमाल किया जा रहा है, तो क्रेडेंशियल जनरेट करने के लिए इस्तेमाल किए जाने वाले Google खातों को टेस्ट करने वाले उपयोगकर्ता के तौर पर जोड़ें.

      ऐप्लिकेशन की ऑडियंस मैनेज करना लेख में, इन सेटिंग के बारे में ज़्यादा जानें.

  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. सेवा खाते को सेवा के इस्तेमाल के लिए ग्राहक की आईएएम भूमिका (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) दें.

    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"

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

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

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

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

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

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

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

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

Display &Video 360

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

Google Analytics

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

डेटा पार्टनर

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

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

सेवा खाता

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

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

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

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

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

Display &Video 360

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

Google Analytics

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

डेटा पार्टनर

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

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

अगले चरण

आगे बढ़ें
क्लाइंट लाइब्रेरी इंस्टॉल करना