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

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

पुष्टि करने का वर्कफ़्लो	क्रेडेंशियल	क्रेडेंशियल का टाइप	मकसद
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 ऐक्सेस टोकन कुछ समय के लिए ही मान्य होते हैं और एक घंटे के बाद खत्म हो जाते हैं. अगर Google Ads API क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है, तो लाइब्रेरी, ऐक्सेस टोकन की समयसीमा खत्म होने और उसे थ्रेड-सेफ़ तरीके से रीफ़्रेश करने की प्रोसेस को मैनेज करती है. सही OAuth क्रेडेंशियल के साथ Google Ads API क्लाइंट ऑब्जेक्ट बनाएं और इसे इसकी पूरी लाइफ़टाइम के दौरान फिर से इस्तेमाल करें.

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