Authentication

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

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

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

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

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

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

Ad Manager API चालू करना

  1. अपने Google 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 REST API का सिर्फ़ एक स्कोप होता है. उपयोगकर्ता को अनुमति दी जानी चाहिए के स्तर को हाइलाइट करें.

दायरा अनुमतियां
https://www.googleapis.com/auth/admanager अपने कैंपेन देखें और मैनेज करें के बारे में हमारा दूसरा वीडियो देखें.