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

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

पहला चरण: नया 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 प्लैटफ़ॉर्म एपीआई खोजा नहीं जा सकता. इसका मतलब है कि आपको अपने प्रोजेक्ट में इसे चालू करने के लिए नीचे दिए गए लिंक पर जाना होगा:

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

Authorization: OAuth <credentials>

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