Authentication

इस दस्तावेज़ में Ad Manager API की पुष्टि करने का तरीका बताया गया है. आपने कैसे किया पुष्टि करना, आपके इस्तेमाल किए जाने वाले इंटरफ़ेस और उस एनवायरमेंट पर निर्भर करता है जहां आपके कोड चल रहा है, लेकिन सभी एपीआई अनुरोधों में Ad Manager API का स्कोप.

Ad Manager क्लाइंट लाइब्रेरी, Ad Manager API के दायरे में ऐक्सेस टोकन जनरेट करने के लिए, ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल का इस्तेमाल करती हैं. इस गाइड में, ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल कॉन्फ़िगर करने का तरीका.

अगर क्लाइंट लाइब्रेरी का इस्तेमाल नहीं किया जा रहा है, तब भी आपको क्रेडेंशियल बनाने होंगे और अपने अनुरोधों को अनुमति देने के लिए उनका इस्तेमाल करें.

पुष्टि और अनुमति देने के बारे में ज़्यादा जानने के लिए, OAuth 2.0 का इस्तेमाल करना गाइड देखें.

पुष्टि करने का तरीका तय करना

प्रमाणीकरण का प्रकार ब्यौरा
सेवा खाता अगर आपको 'खास तौर पर आपके लिए काम करने वाले' के तौर पर पुष्टि करनी है, तो इसे चुनें खाता बनाने के लिए प्रोत्साहित भी करते हैं.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है ज़्यादा जानें.
वेब एेप्लिकेशन अगर आपको किसी उपयोगकर्ता के तौर पर अपनी पुष्टि करनी है, तो इसे चुनें जो आपके ऐप्लिकेशन को ऐक्सेस करने की अनुमति देता है अपने Ad Manager डेटा में बदलाव कर सकते हैं.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है ज़्यादा जानें
लोकल डेवलपमेंट अगर आपको अपने स्थानीय डेवलपमेंट एनवायरमेंट से, अपने Google खाते या किसी सेवा खाते के तौर पर पुष्टि करनी है, तो यह विकल्प चुनें.

Ad Manager API को चालू करना

  1. अपने Google API Console Cloud प्रोजेक्ट में, Ad Manager API को चालू करें.

  2. अगर कहा जाए, तो कोई प्रोजेक्ट चुनें या एक नया प्रोजेक्ट बनाएं.

क्रेडेंशियल बनाएं

पुष्टि करने के तरीके के टैब पर क्लिक करें और अपने क्रेडेंशियल बनाने के लिए, दिए गए निर्देशों का पालन करें:

सेवा खाता

Google Cloud पर

Google Cloud पर चल रहे वर्कलोड की पुष्टि करने के लिए, आप जिनके क्रेडेंशियल का इस्तेमाल करते हैं उस कंप्यूट रिसॉर्स से जुड़ा सेवा खाता जिसमें आपका कोड दौड़ने.

उदाहरण के लिए, किसी Compute Engine वर्चुअल मशीन (VM) इंस्टेंस, Cloud Run सेवा या Dataflow जॉब से सेवा खाता अटैच किया जा सकता है. Google Cloud के कंप्यूट संसाधन पर चलने वाले कोड के लिए, पुष्टि करने का यह तरीका सबसे सही है.

सेवा खाते को किन संसाधनों में अटैच किया जा सकता है, यह जानने के लिए, और संसाधन में सेवा खाते को अटैच करने में सहायता मिलेगी, तो सेवा खाता अटैच करने से जुड़ा दस्तावेज़.

ऑन-प्राइमिस या किसी दूसरे क्लाउड सेवा देने वाली कंपनी के पास

Google Cloud के बाहर से, पुष्टि करने की सुविधा सेट अप करने का पसंदीदा तरीका यह है वर्कलोड आइडेंटिटी फ़ेडरेशन का इस्तेमाल करने के लिए; तो आप कोई क्रेडेंशियल कॉन्फ़िगरेशन फ़ाइल और GOOGLE_APPLICATION_CREDENTIALS सेट करें एनवायरमेंट वैरिएबल का इस्तेमाल करके डेटा को पॉइंट करता है. यह तरीका, सेवा खाता कुंजी बनाने से ज़्यादा सुरक्षित है.

अगर वर्कलोड आइडेंटिटी फ़ेडरेशन को कॉन्फ़िगर नहीं कर पा रहे हैं, तो आपको सेवा खाता बनाने और सेवा खाते के लिए एक कुंजी बनाने के लिए:

  1. Google API Console का क्रेडेंशियल पेज खोलें.

  2. क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं चुनें. इसके बाद सेवा खाता चुनें.

  3. उस सेवा खाते के ईमेल पते पर क्लिक करें जिसके लिए आपको पासकोड बनाना है.

  4. कुंजियां टैब पर क्लिक करें.

  5. कुंजी जोड़ें ड्रॉप-डाउन मेन्यू पर क्लिक करें. इसके बाद, नई कुंजी बनाएं चुनें.

  6. कुंजी टाइप के तौर पर JSON चुनें और बनाएं पर क्लिक करें.

  7. एनवायरमेंट वैरिएबल GOOGLE_APPLICATION_CREDENTIALS को पाथ पर सेट करें .

Linux या macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

वेब एेप्लिकेशन

  1. Google API Console का क्रेडेंशियल पेज खोलें.

  2. अगर कहा जाए, तो वह प्रोजेक्ट चुनें जिसमें आपने Ad Manager API चालू किया है.

  3. क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं चुनें. इसके बाद, OAuth क्लाइंट आईडी चुनें.

  4. वेब ऐप्लिकेशन ऐप्लिकेशन टाइप चुनें.

  5. फ़ॉर्म भरें और बनाएं पर क्लिक करें. PHP, Java, Python, Ruby, और .NET जैसी भाषाओं और फ़्रेमवर्क का इस्तेमाल करने वाले ऐप्लिकेशन को, अनुमति वाले रीडायरेक्ट यूआरआई की जानकारी देनी होगी. रीडायरेक्ट यूआरआई ऐसे एंडपॉइंट होते हैं जिन पर OAuth 2.0 सर्वर जवाब भेज सकता है. इन एंडपॉइंट को Google की पुष्टि के नियम.

  6. अपने क्रेडेंशियल बनाने के बाद, client_secret.json फ़ाइल डाउनलोड करें. फ़ाइल को ऐसी जगह पर सुरक्षित रूप से सेव करें जहां सिर्फ़ आपका ऐप्लिकेशन ऐक्सेस कर सके.

यहां से, OAuth 2.0 ऐक्सेस टोकन पाने के लिए दिया गया तरीका अपनाएं

लोकल डेवलपमेंट

अपने डिवाइस में ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (एडीसी) सेट अप करें.

Google Cloud सीएलआई इंस्टॉल करें. इसके बाद, यह कमांड चलाकर इसे शुरू करें:

gcloud init

अपने Google खाते के लिए स्थानीय पुष्टि करने के क्रेडेंशियल बनाएं और प्रोजेक्ट आईडी को ऐसे प्रोजेक्ट पर सेट करें जहां Ad Manager API चालू हो:

gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
gcloud auth application-default set-quota-project PROJECT_ID

इसके अलावा, एनवायरमेंट की सेटिंग में सेवा खाते की पुष्टि करें वैरिएबल GOOGLE_APPLICATION_CREDENTIALS को आपकी मुख्य फ़ाइल के पाथ पर ले जाएगा.

Linux या macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

अपना Ad Manager नेटवर्क कॉन्फ़िगर करना

सेवा खाता

  1. अपने Ad Manager नेटवर्क पर जाएं.
  2. एडमिन टैब पर क्लिक करें.
  3. पक्का करें कि एपीआई ऐक्सेस चालू हो.
  4. सेवा खाते का उपयोगकर्ता जोड़ें बटन पर क्लिक करें.
  5. सेवा खाते के ईमेल पते का इस्तेमाल करके फ़ॉर्म भरें. कॉन्टेंट बनाने सेवा खाते के उपयोगकर्ता को सही भूमिकाओं और टीमों में जोड़ा जाना चाहिए की भी ज़रूरत नहीं है.
  6. सेव करें बटन पर क्लिक करें. पुष्टि करने के लिए, आपको एक मैसेज दिखेगा उसे जोड़ने के बारे में ज़्यादा जानें.
  7. उपयोगकर्ता टैब पर जाकर, सेवा खाते के मौजूदा उपयोगकर्ताओं की जानकारी देखें सेवा खाता फ़िल्टर पर क्लिक करें.

वेब एेप्लिकेशन

  1. अपने Ad Manager नेटवर्क पर जाएं.
  2. एडमिन टैब पर क्लिक करें.
  3. पक्का करें कि एपीआई ऐक्सेस चालू हो.

लोकल डेवलपमेंट

  1. अपने Ad Manager नेटवर्क पर जाएं.
  2. एडमिन टैब पर क्लिक करें.
  3. पक्का करें कि एपीआई ऐक्सेस चालू हो.

क्लाइंट लाइब्रेरी के बिना

अगर क्लाइंट लाइब्रेरी का इस्तेमाल नहीं किया जा रहा है, तो हमारा सुझाव है कि पुष्टि करने के लिए, OAuth2 लाइब्रेरी का इस्तेमाल करें.

ऐक्सेस टोकन पाने के बारे में ज़्यादा जानकारी के लिए, Google API के साथ OAuth2 का इस्तेमाल करना लेख पढ़ें.

ऐक्सेस टोकन

एपीआई को किए गए अनुरोध में अपना ऐक्सेस टोकन शामिल करें. इसके लिए, access_token क्वेरी पैरामीटर या Authorization एचटीटीपी हेडर Bearer की वैल्यू. जब मुमकिन हो, तब एचटीटीपी हेडर को प्राथमिकता दी जाती है, क्योंकि क्वेरी स्ट्रिंग आम तौर पर सर्वर लॉग में दिखाई दे सकती है.

उदाहरण के लिए:

GET /v1/networks/1234
Host: admanager.googleapis.com
Authorization: Bearer ya29.a0Ad52N3_shYLX

GET https://admanager.googleapis.com/v1/networks/1234?access_token=1/fFAGRNJru1FTz70BzhT3Zg

दायरा

हर ऐक्सेस टोकन, एक या उससे ज़्यादा दायरों से जुड़ा होता है. स्कोप से यह कंट्रोल होता है कि संसाधनों और कार्रवाइयों के सेट को ऐक्सेस करने की अनुमति देता है. Ad Manager एपीआई का सिर्फ़ एक स्कोप होता है. अनुमति, प्रॉडक्ट में उपयोगकर्ता के लेवल पर दी जानी चाहिए.

दायरा अनुमतियां
https://www.googleapis.com/auth/admanager Google Ad Manager पर अपने कैंपेन देखें और मैनेज करें.