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

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

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

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

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

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

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

    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) असाइन करें.

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

अगले चरण

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