एपीआई कॉल की पुष्टि करना

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

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

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

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

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

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

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

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

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

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

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

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 प्लैटफ़ॉर्म एपीआई का दायरा इस तरह है: 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 Platform API के लिए क्लाइंट लाइब्रेरी काम नहीं करती हैं. इसलिए, सीधे एचटीटीपी रिक्वेस्ट भेजने होंगे. ऐक्सेस टोकन को एचटीटीपी अनुरोध में हेडर के तौर पर शामिल किया जाना चाहिए. हेडर इस तरह दिखना चाहिए:

Authorization: OAuth <credentials>

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