क्रेडेंशियल मैनेजमेंट

इस टेबल में, उन क्रेडेंशियल की सूची दी गई है जिन्हें किसी ऐप्लिकेशन को मैनेज करना चाहिए. अलग-अलग तरह के ऐप्लिकेशन के बारे में जानने के लिए, हमारा OAuth दस्तावेज़ पढ़ें.

पुष्टि करने का वर्कफ़्लो	क्रेडेंशियल	क्रेडेंशियल का टाइप	मकसद
सभी तरह के ऐप्लिकेशन	डेवलपर टोकन	ऐप्लिकेशन के क्रेडेंशियल	इस कुकी की मदद से, अनुमोदित ऐक्सेस लेवल के साथ Google Ads API का इस्तेमाल किया जा सकता है.
JavaScript वेब ऐप्लिकेशन Android ऐप्लिकेशन	OAuth क्लाइंट आईडी	ऐप्लिकेशन के क्रेडेंशियल	यह कुकी, OAuth फ़्लो के दौरान ऐप्लिकेशन की यूनीक तरीके से पहचान करती है.
	ऐक्सेस टोकन और रीफ़्रेश टोकन	उपयोगकर्ता के क्रेडेंशियल	इससे पता चलता है कि उपयोगकर्ता ने ऐप्लिकेशन को अपने Google Ads खाते को ऐक्सेस करने की अनुमति दी है.
सर्वर-साइड वेब ऐप्लिकेशन डेस्कटॉप और iOS ऐप्लिकेशन टीवी और डिवाइस के ऐप्लिकेशन	OAuth क्लाइंट आईडी और क्लाइंट सीक्रेट	ऐप्लिकेशन के क्रेडेंशियल	यह कुकी, OAuth फ़्लो के दौरान ऐप्लिकेशन की यूनीक तरीके से पहचान करती है.
	ऐक्सेस टोकन और रीफ़्रेश टोकन	उपयोगकर्ता के क्रेडेंशियल	यह कुकी, उपयोगकर्ता की अनुमति को दिखाती है. इससे ऐप्लिकेशन को उपयोगकर्ता की ओर से, उसके Google Ads खाते को ऐक्सेस करने की अनुमति मिलती है.
सेवा खाते	OAuth सेवा खाते की कुंजी	ऐप्लिकेशन के क्रेडेंशियल	इस कुकी का इस्तेमाल, OAuth अनुरोध पर हस्ताक्षर करने के लिए किया जाता है.
	सेवा खाते का ऐक्सेस टोकन	उपयोगकर्ता के क्रेडेंशियल	यह सेवा खाते के लिए अनुमति दिखाता है. उपयोगकर्ता ने अपने Google Ads खाते को सेवा खाते के साथ शेयर किया है.

Google Ads API ऐप्लिकेशन के क्रेडेंशियल मैनेज करते समय, इन बातों का ध्यान रखें.

ऐप्लिकेशन के क्रेडेंशियल को सुरक्षित तरीके से मैनेज करना

ऐप्लिकेशन क्रेडेंशियल, आपके ऐप्लिकेशन से जुड़ी सेटिंग को कहते हैं. ये सेटिंग, एक उपयोगकर्ता से दूसरे उपयोगकर्ता के लिए अलग-अलग नहीं होती हैं. OAuth ऐप्लिकेशन के क्रेडेंशियल का इस्तेमाल बहुत सावधानी से करें. ऐसा इसलिए, क्योंकि इन क्रेडेंशियल का इस्तेमाल करके कोई भी व्यक्ति, आपके ऐप्लिकेशन की पहचान का इस्तेमाल करके उपयोगकर्ता की जानकारी को ऐक्सेस कर सकता है. अपने OAuth ऐप्लिकेशन के क्रेडेंशियल को किसी सुरक्षित जगह पर सेव करें और उन्हें सुरक्षित रखें. ठीक उसी तरह जैसे पासवर्ड को सुरक्षित रखा जाता है. जहां भी हो सके, ऐप्लिकेशन के क्रेडेंशियल सेव करने के लिए, सीक्रेट मैनेजर का इस्तेमाल करें. जैसे, Google Cloud Secret Manager. आपको क्लाइंट क्रेडेंशियल को सार्वजनिक तौर पर उपलब्ध कोड रिपॉज़िटरी में कभी सबमिट नहीं करना चाहिए. हमारा सुझाव है कि आप इन्हें किसी भी कोड रिपॉज़िटरी में सेव न करें.

उपयोगकर्ता के क्रेडेंशियल को सुरक्षित तरीके से मैनेज करना

उपयोगकर्ता के क्रेडेंशियल का मतलब, OAuth टोकन से है. ये टोकन, उपयोगकर्ता की अनुमति को दिखाते हैं. ये टोकन, उन उपयोगकर्ताओं से मिलते हैं जिन्होंने आपको उनकी ओर से कार्रवाई करने और डेटा ऐक्सेस करने की अनुमति दी है. यह अनुमति, सीधे तौर पर आपके ऐप्लिकेशन की पुष्टि करके या परोक्ष रूप से अपने Google Ads खाते को आपके सेवा खाते के साथ शेयर करके दी जाती है. टोकन को कभी भी सामान्य टेक्स्ट में ट्रांसमिट न करें. साथ ही, डेटा के गलत इस्तेमाल की स्थिति में सुरक्षा की एक और लेयर जोड़ने के लिए, हमेशा एन्क्रिप्ट (सुरक्षित) किए गए टोकन को स्टोर करें. जब आपको किसी उपयोगकर्ता के खाते का ऐक्सेस नहीं चाहिए, तब टोकन या सेवा खाते की अनुमतियां रद्द करें. टोकन रद्द होने के बाद, उन्हें अपने ऐप्लिकेशन या सिस्टम से हमेशा के लिए मिटा दें.

रीफ़्रेश टोकन के रद्द होने और उसके खत्म होने की प्रोसेस को मैनेज करना

अगर उपयोगकर्ता की पुष्टि करने वाले फ़्लो का इस्तेमाल किया जा रहा है, तो आपको यह ध्यान रखना चाहिए कि रीफ़्रेश टोकन कभी भी अमान्य किए जा सकते हैं. उदाहरण के लिए, अगर डिवाइस के एक से ज़्यादा उपयोगकर्ताओं के लिए पुष्टि करने के फ़्लो का इस्तेमाल किया जा रहा है, तो उपयोगकर्ता आपके ऐप्लिकेशन का ऐक्सेस रद्द कर सकता है. हालांकि, एक उपयोगकर्ता के लिए पुष्टि करने के फ़्लो का इस्तेमाल करने वाले ऐप्लिकेशन पर इस तरह का असर पड़ने की संभावना कम होती है. इसके अलावा, उपयोगकर्ताओं की सुरक्षा के लिए डिज़ाइन की गई मैन्युअल या ऑटोमेटेड प्रोसेस भी रीफ़्रेश टोकन को पूरी तरह मिटा सकती है या रीफ़्रेश टोकन की समयसीमा खत्म हो सकती है. अगर आपके ऐप्लिकेशन में उपयोगकर्ताओं को बेहतर अनुभव देने के लिए, टोकन रद्द होने की सूचना देना ज़रूरी है, तो आपको हमारी क्रॉस-अकाउंट प्रोटेक्शन सेवा के साथ इंटिग्रेट करना होगा.

अपने सभी एपीआई अनुरोधों में उपयोगकर्ता के क्रेडेंशियल का फिर से इस्तेमाल करना

OAuth ऐक्सेस टोकन की वैधता कम समय के लिए होती है और यह एक घंटे में खत्म हो जाती है. हमारी क्लाइंट लाइब्रेरी का इस्तेमाल करने पर, ऐक्सेस टोकन की समयसीमा खत्म होने और उसे रीफ़्रेश करने की प्रोसेस को थ्रेड-सेफ़ तरीके से मैनेज किया जाता है. आपको बस सही OAuth क्रेडेंशियल के साथ एक Google Ads API सेशन ऑब्जेक्ट बनाना होगा. साथ ही, इसे पूरे समय के लिए फिर से इस्तेमाल करना होगा.

अगर आपने ऐक्सेस टोकन को रीफ़्रेश करने और मैनेज करने की रणनीति खुद बनाई है, तो आपको ऐक्सेस टोकन की समयसीमा खत्म होने पर नज़र रखनी चाहिए. साथ ही, इसका ज़्यादा से ज़्यादा बार इस्तेमाल करना चाहिए. अगर आपको यह नहीं पता कि ऐक्सेस टोकन को पिछली बार कब रीफ़्रेश किया गया था, तो इसे रीफ़्रेश करने की कोशिश करें. ऐसा तब करें, जब आपको लगता है कि इसकी समयसीमा पहले ही खत्म हो चुकी है. अगर ऐक्सेस टोकन की समयसीमा खत्म होने में ज़्यादा समय बाकी है, तो सर्वर वही ऐक्सेस टोकन दिखाता है. साथ ही, टोकन की समयसीमा खत्म होने में बचे हुए मिलीसेकंड भी दिखाता है. हमारा सुझाव है कि अगर ऐक्सेस टोकन की समयसीमा खत्म होने में पांच मिनट से कम समय बचा है, तो उसे तुरंत रीफ़्रेश करें.