Google Ads API के लिए OAuth 2.0 की इंटरनल जानकारी

ध्यान दें: Google Ads API की क्लाइंट लाइब्रेरी, इस गाइड में दी गई जानकारी को अपने-आप मैनेज करती हैं. अगर आपको यह समझना है कि पर्दे के पीछे क्या होता है या क्लाइंट लाइब्रेरी का इस्तेमाल नहीं किया जा रहा है, तो यह गाइड पढ़ें.

यह सेक्शन उन ऐडवांस उपयोगकर्ताओं के लिए है जो पहले से ही OAuth 2.0 की खास जानकारी से वाकिफ़ हैं और जिन्हें Google API के साथ OAuth 2.0 का इस्तेमाल करने का तरीका पता है.

दायरा

एक ऐक्सेस टोकन से, कई एपीआई को अलग-अलग लेवल का ऐक्सेस दिया जा सकता है. scope नाम का एक वैरिएबल पैरामीटर, संसाधनों और कार्रवाइयों के सेट को कंट्रोल करता है. ऐक्सेस टोकन, इन संसाधनों और कार्रवाइयों को अनुमति देता है. ऐक्सेस टोकन के अनुरोध के दौरान, आपका ऐप्लिकेशन scope पैरामीटर में एक या उससे ज़्यादा वैल्यू भेजता है.

Google Ads API के दायरे में ये शामिल हैं:

https://www.googleapis.com/auth/adwords

बिना इंटरनेट के इस्तेमाल और टोकन की समयसीमा

Google Ads API क्लाइंट ऐप्लिकेशन के लिए, ऑफ़लाइन ऐक्सेस का अनुरोध करना आम बात है. उदाहरण के लिए, हो सकता है कि आपका ऐप्लिकेशन उस समय बैच जॉब चलाना चाहे जब उपयोगकर्ता आपकी वेबसाइट को ब्राउज़ करने के लिए ऑनलाइन न हो. ऐक्सेस टोकन 3,600 सेकंड (1 घंटा) तक मान्य होते हैं. इसके बाद, आपके ऐप्लिकेशन को नए ऐक्सेस टोकन के लिए, रीफ़्रेश टोकन का इस्तेमाल करना होगा.

किसी वेब ऐप्लिकेशन टाइप के लिए, बिना इंटरनेट के इस्तेमाल करने का अनुरोध करने के लिए, पक्का करें कि आपने access_type पैरामीटर को offline पर सेट किया हो. आपको Google की OAuth 2.0 गाइड में ज़्यादा जानकारी मिल सकती है.

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

अनुरोध के हेडर

Google Ads API को भेजे जाने वाले सभी अनुरोधों के हेडर में, OAuth 2.0 ऐक्सेस टोकन शामिल होना चाहिए. यहां दिए गए सेक्शन में, gRPC और REST का इस्तेमाल करके इन क्रेडेंशियल को पास करने का तरीका बताया गया है.

gRPC हेडर

gRPC API का इस्तेमाल करते समय, हर अनुरोध में ऐक्सेस टोकन शामिल करें. किसी Credential को Channel से जोड़ा जा सकता है, ताकि उस चैनल पर सभी अनुरोधों के लिए इसका इस्तेमाल किया जा सके. हर कॉल के लिए, अपनी पसंद के मुताबिक क्रेडेंशियल भी भेजा जा सकता है. gRPC Authorization guide में, अनुमति को मैनेज करने के बारे में ज़्यादा जानकारी दी गई है.

REST हेडर

REST API का इस्तेमाल करते समय, एचटीटीपी हेडर Authorization: Bearer <ACCESS_TOKEN> की मदद से ऐक्सेस टोकन पास करें. यहां एचटीटीपी अनुरोध का एक उदाहरण दिया गया है:

# Returns the resource names of customers directly accessible by the user
# authenticating the call.
#
# Variables:
#   API_VERSION,
#   OAUTH2_ACCESS_TOKEN:
#     See https://developers.google.com/google-ads/api/rest/auth#request_headers
#     for details.
#
curl -f --request GET \
"https://googleads.googleapis.com/v${API_VERSION}/customers:listAccessibleCustomers" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \