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

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

    अगर आपको डेटा मैनेजर एपीआई और 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) दें.

    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"

अपने ऐप्लिकेशन के लिए पुष्टि करने के तरीके और क्रेडेंशियल के बारे में ज़्यादा जानने के लिए, 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 के यूज़र इंटरफ़ेस (यूआई) से मैनेज किया जाता है. सेवा खाते को जोड़ने और उसका ऐक्सेस लेवल सेट करने के लिए, खाते का ऐक्सेस सेटअप करना में दिया गया तरीका अपनाएं.

अगले चरण

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