Google Ads API के लिए OAuth2 Internals

हमारी क्लाइंट लाइब्रेरी नीचे दी गई जानकारी का अपने-आप ख्याल रखती है, इसलिए पढ़ना जारी रखें केवल तभी जब आपकी दिलचस्पी हो कि YouTube पर या अगर आप हमारी क्लाइंट लाइब्रेरी में से किसी का इस्तेमाल नहीं कर रहे हैं.

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

क्या आपको एपीआई में पुष्टि करने के बारे में ज़्यादा जानना है?

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है वीडियो लाइब्रेरी: पुष्टि करना और अनुमति देना

दायरा

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

Google Ads API का दायरा यह है:

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

बिना इंटरनेट के इस्तेमाल

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

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

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

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

gRPC हेडर

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

REST हेडर

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

GET /v17/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 पहचान प्लैटफ़ॉर्म OAuth दस्तावेज़.

ऐक्सेस टोकन की समयसीमा खत्म होने की तारीख

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