हमारी क्लाइंट लाइब्रेरी, यहां बताई गई जानकारी को अपने-आप मैनेज करती हैं. इसलिए, सिर्फ़ तब पढ़ना जारी रखें, जब आपको यह जानना हो कि पर्दे के पीछे क्या हो रहा है या अगर हमारी किसी क्लाइंट लाइब्रेरी का इस्तेमाल नहीं किया जा रहा है.
यह सेक्शन उन बेहतर उपयोगकर्ताओं के लिए है जो पहले से ही OAuth 2.0 स्पेसिफ़िकेशन के बारे में जानते हैं और Google API के साथ OAuth2 का इस्तेमाल करने का तरीका जानते हैं.
क्या आपको एपीआई में पुष्टि करने के बारे में ज़्यादा जानना है?
वीडियो लाइब्रेरी: पुष्टि करना और अनुमति देना
दायरा
एक ऐक्सेस टोकन, कई एपीआई को अलग-अलग लेवल का ऐक्सेस दे सकता है. scope नाम का वैरिएबल पैरामीटर, उन संसाधनों और ऑपरेशन के सेट को कंट्रोल करता है जिन्हें ऐक्सेस टोकन से अनुमति मिलती है. ऐक्सेस टोकन के अनुरोध के दौरान, आपका ऐप्लिकेशन
scope पैरामीटर में एक या उससे ज़्यादा वैल्यू भेजता है.
Google Ads API का दायरा:
https://www.googleapis.com/auth/adwords
बिना इंटरनेट के इस्तेमाल
Google Ads API क्लाइंट ऐप्लिकेशन के लिए, ऑफ़लाइन ऐक्सेस का अनुरोध करना आम बात है. उदाहरण के लिए, हो सकता है कि आपका ऐप्लिकेशन, बैच जॉब तब चलाना चाहे, जब आपका उपयोगकर्ता आपकी वेबसाइट को ब्राउज़ न कर रहा हो.
किसी वेब ऐप्लिकेशन टाइप के लिए ऑफ़लाइन ऐक्सेस का अनुरोध करने के लिए, पक्का करें कि आपने access_type पैरामीटर को offline पर सेट किया हो. ज़्यादा जानकारी के लिए, Google की OAuth2 गाइड देखें.
डेस्कटॉप ऐप्लिकेशन के लिए, ऑफ़लाइन ऐक्सेस की सुविधा डिफ़ॉल्ट रूप से चालू रहती है. इसके लिए, आपको साफ़ तौर पर अनुरोध करने की ज़रूरत नहीं होती.
अनुरोध के हेडर
gRPC हेडर
gRPC API का इस्तेमाल करते समय, हर अनुरोध में ऐक्सेस टोकन शामिल करें. किसी चैनल पर सभी अनुरोधों के लिए, Credential को Channel से जोड़ा जा सकता है. आपके पास हर कॉल के लिए, पसंद के मुताबिक क्रेडेंशियल भेजने का विकल्प भी होता है. gRPC के लिए अनुमति से जुड़ी गाइड में, अनुमति मैनेज करने के बारे में ज़्यादा जानकारी दी गई है.
REST हेडर
REST API का इस्तेमाल करते समय, एचटीटीपी हेडरAuthorization के ज़रिए ऐक्सेस टोकन पास करें. एचटीटीपी अनुरोध का उदाहरण यहां दिया गया है:
GET /v19/customers/123456789 HTTP/2 Host: googleads.googleapis.com User-Agent: INSERT_USER_AGENT Accept: */* Authorization: Bearer INSERT_ACCESS_TOKEN developer-token: INSERT_DEVELOPER_TOKEN
ऐक्सेस और रीफ़्रेश टोकन
ज़्यादातर मामलों में, आपको रीफ़्रेश टोकन को सुरक्षित तरीके से सेव करना होगा, ताकि उसे बाद में इस्तेमाल किया जा सके. ऐक्सेस और रीफ़्रेश टोकन का अनुरोध करने के तरीके के बारे में ज़्यादा जानने के लिए, अपने ऐप्लिकेशन टाइप के लिए बनी गाइड पढ़ें:
रीफ़्रेश टोकन की समयसीमा खत्म होना
रीफ़्रेश टोकन के खत्म होने के बारे में ज़्यादा जानकारी के लिए, Google Identity Platform OAuth दस्तावेज़ देखें.
ऐक्सेस टोकन की समयसीमा खत्म होना
ऐक्सेस टोकन की समयसीमा खत्म होने के बाद, वह अमान्य हो जाता है. समयसीमा, expires_in वैल्यू के आधार पर तय होती है. रीफ़्रेश टोकन का इस्तेमाल करके, समयसीमा खत्म हो चुके ऐक्सेस टोकन को रीफ़्रेश किया जा सकता है. डिफ़ॉल्ट रूप से, हमारी क्लाइंट लाइब्रेरी, समयसीमा खत्म हो चुके ऐक्सेस टोकन को अपने-आप रीफ़्रेश कर देती हैं.