एपीआई कॉल की पुष्टि की जा रही है

इस उदाहरण में, हम यह दिखा रहे हैं कि उप-खाते बनाने और उन्हें मैनेज करने के लिए, सेवा खातों का इस्तेमाल करके AdSense Platforms API को किस तरह कॉल किया जा सकता है.

पहला चरण: नया Google Cloud प्रोजेक्ट बनाना या किसी मौजूदा प्रोजेक्ट का इस्तेमाल करना

अगर आपके पास कोई मौजूदा Google Cloud प्रोजेक्ट है, तो उसका इस्तेमाल करें. अगर ऐसा नहीं है, तो नया प्रोजेक्ट सेट अप करने के लिए नीचे दी गई गाइड की मदद लें:

https://cloud.google.com/resource-manager/docs/creating-managing-projects

दूसरा चरण: सेवा खाता बनाना

सेवा खातों का इस्तेमाल करना, उप-खाते बनाने का सबसे अच्छा तरीका है. अपना सेवा खाता बनाने के लिए इन चरणों को अपनाएं:

• Google Cloud में सेवा खाते पेज पर जाएं
• आप चाहें, तो मौजूदा सेवा खाता इस्तेमाल करें या नया खाता बनाएं:
  • "+ सेवा खाता बनाएं" पर क्लिक करें
  • "सेवा खाते की जानकारी" भरें फ़ॉर्म
  • पेज पर दूसरा और तीसरा चरण (प्रोजेक्ट और उपयोगकर्ताओं का ऐक्सेस देना) ज़रूरी नहीं है

सेवा खाते बनाने और उन्हें मैनेज करने के बारे में ज़्यादा जानें.

सेवा खाता बनाने के बाद, आपको उसे Google को भेजना होगा, ताकि उसे आपके AdSense खाते से जोड़ा जा सके. यह ज़रूरी है, क्योंकि सेवा खाते के पास आपके AdSense खाते को ऐक्सेस करने की अनुमति होनी चाहिए. कृपया अपने खाता मैनेजर के ज़रिए इस बारे में बताएं.

तीसरा चरण: अपने Google Cloud प्रोजेक्ट के लिए AdSense Platform API चालू करना

AdSense प्लैटफ़ॉर्म एपीआई को खोजा नहीं जा सकता. इसका मतलब है कि अपने प्रोजेक्ट के लिए इसे चालू करने के लिए, आपको नीचे दिए गए लिंक पर जाना होगा:

https://console.developers.google.com/apis/api/adsenseplatform.googleapis.com/overview

चौथा चरण: सेवा कुंजी बनाना

एपीआई कॉल में इस्तेमाल करने के लिए ऐक्सेस टोकन जनरेट करने के लिए, आपको सेवा कुंजी बनानी होगी. यह तरीका अपनाएं:

• Google Cloud में सेवा खाते पेज पर जाएं
• कार्रवाई कॉलम में, जिस सेवा खाते का इस्तेमाल आपको उप-खाते बनाने के लिए करना है उसके लिए, पर क्लिक करें. इसके बाद, "कुंजी मैनेज करें" पर क्लिक करें
• "कुंजी जोड़ें" पर क्लिक करें. इसके बाद, "नया बटन बनाएं" को चुनें
• JSON को कुंजी के टाइप के तौर पर चुना हुआ रखें और "बनाएं" पर क्लिक करें
• एक json फ़ाइल बनाई जाएगी और आपके कंप्यूटर पर डाउनलोड की जाएगी. इसे सुरक्षित रखें, क्योंकि एपीआई कॉल की पुष्टि करने के लिए यह ज़रूरी है

सेवा खाते की कुंजियां बनाने और उन्हें मैनेज करने के बारे में ज़्यादा जानें.

पांचवां चरण: ऐक्सेस टोकन जनरेट करने के लिए Google की OAuth लाइब्रेरी का इस्तेमाल करना

Google, लाइब्रेरी की सुविधा देता है, ताकि ऐक्सेस टोकन जनरेट करने में मदद मिल सके. इनका इस्तेमाल एपीआई कॉल करने के लिए किया जा सकता है. सेवा खातों के लिए क्रेडेंशियल जनरेट करने के तरीके के बारे में यहां जानें:

https://developers.google.com/identity/protocols/oauth2/service-account#authorizingrequests

AdSense Platforms API का दायरा यहां बताया गया है: https://www.googleapis.com/auth/adsense अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

Python का उदाहरण

from google.auth.transport import requests
from google.oauth2 import service_account

CREDENTIAL_SCOPES = ["https://www.googleapis.com/auth/adsense"]
CREDENTIALS_KEY_PATH = 'service.json'

def get_service_account_token():
  credentials = service_account.Credentials.from_service_account_file(
          CREDENTIALS_KEY_PATH, scopes=CREDENTIAL_SCOPES)
  credentials.refresh(requests.Request())
  return credentials.token

अब आप एपीआई कॉल करने के लिए तैयार हैं. फ़िलहाल, AdSense प्लैटफ़ॉर्म एपीआई के लिए क्लाइंट लाइब्रेरी काम नहीं करती हैं. इसलिए, सीधे एचटीटीपी अनुरोध करने की ज़रूरत होती है. ऐक्सेस टोकन को एचटीटीपी अनुरोध में हेडर के तौर पर शामिल किया जाना चाहिए. हेडर ऐसा दिखना चाहिए:

Authorization: OAuth <credentials>

एपीआई पेजों में उदाहरण शामिल किए गए हैं.