ক্রেডেনশিয়াল ম্যানেজমেন্ট

অ্যাপকে অবশ্যই ম্যানেজ করতে হবে এমন ক্রেডেনশিয়ালের সারসংক্ষেপ নিচের সারণীতে দেওয়া হল। অ্যাপের ধরন সম্পর্কে আরও জানতে, Google Identity OAuth 2.0 ডকুমেন্টেশন দেখুন।

যাচাইকরণ ওয়ার্কফ্লো	ক্রেডেনশিয়াল	ক্রেডেনশিয়ালের ধরন	উদ্দেশ্য
জাভাস্ক্রিপ্ট ওয়েব অ্যাপ 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 অ্যাকাউন্ট শেয়ার করে। কখনও প্লেনটেক্সটে টোকেন ট্রান্সমিট করবেন না এবং ডেটার নিরাপত্তা লঙ্ঘনের মতো ঘটনার ক্ষেত্রে সুরক্ষার অতিরিক্ত স্তর প্রদান করতে সবসময় এনক্রিপ্ট করা টোকেন স্টোর করুন। ব্যবহারকারীর অ্যাকাউন্টে অ্যাক্সেসের আর প্রয়োজন না থাকলে, টোকেন বা পরিষেবা অ্যাকাউন্টের অনুমতি প্রত্যাহার করুন। টোকেন প্রত্যাহার করার পরে, আপনার অ্যাপ্লিকেশন বা সিস্টেম থেকে সেগুলি স্থায়ীভাবে মুছে দিন।

রিফ্রেশ টোকেন প্রত্যাহার ও মেয়াদ শেষ হওয়া ম্যানেজ করা

আপনি যদি ব্যবহারকারীর যাচাইকরণ ফ্লো ব্যবহার করেন, তাহলে মনে রাখবেন যে রিফ্রেশ টোকেন যেকোনও সময় বাতিল করা হতে পারে। যেমন, আপনি যদি মাল্টি-ইউজার যাচাইকরণ ফ্লো ব্যবহার করেন, তাহলে ব্যবহারকারী আপনার অ্যাপে অ্যাক্সেস তুলে নেওয়ার সিদ্ধান্ত নিতে পারেন। যদিও, সিঙ্গল-ইউজার যাচাইকরণ ফ্লো ব্যবহার করে এমন অ্যাপের ক্ষেত্রে এই ধরনের সমস্যা হওয়ার সম্ভাবনা কম, তবুও ব্যবহারকারীদের সুরক্ষিত রাখার জন্য ডিজাইন করা ম্যানুয়াল বা অটোমেটিক প্রসেস রিফ্রেশ টোকেন মুছে দিতে পারে অথবা রিফ্রেশ টোকেনের মেয়াদ শেষ হয়ে যেতে পারে। ব্যবহারকারীদের ভালো অভিজ্ঞতা প্রদান করার জন্য আপনার অ্যাপে টোকেন প্রত্যাহার সংক্রান্ত বিজ্ঞপ্তি প্রয়োজন হলে, আপনাকে অবশ্যই ক্রস-অ্যাকাউন্ট সুরক্ষা পরিষেবার সাথে ইন্টিগ্রেট করতে হবে।

আপনার API অনুরোধ জুড়ে ব্যবহারকারীর ক্রেডেনশিয়াল আবার ব্যবহার করুন

OAuth অ্যাক্সেস টোকেন অল্প সময়ের জন্য কাজ করে এবং এক ঘণ্টা পরে এর মেয়াদ শেষ হয়ে যায়। আপনি যদি Google Ads API ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, তাহলে লাইব্রেরি অ্যাক্সেস টোকেনের মেয়াদ শেষ হওয়া এবং থ্রেড-নিরাপদ উপায়ে রিফ্রেশ করার বিষয়টি ম্যানেজ করে। উপযুক্ত OAuth ক্রেডেনশিয়াল সহ Google Ads API ক্লায়েন্ট অবজেক্ট তৈরি করুন এবং এর লাইফটাইম জুড়ে এটি আবার ব্যবহার করুন।

আপনি যদি নিজের অ্যাক্সেস টোকেন রিফ্রেশ এবং ম্যানেজমেন্ট স্ট্র্যাটেজি তৈরি করেন, তাহলে অ্যাক্সেস টোকেনের মেয়াদ শেষ হওয়ার বিষয়টি ট্র্যাক করুন এবং টোকেনগুলি বৈধ থাকাকালীন পুনরায় ব্যবহার করুন। আপনি টোকেন রিফ্রেশ করার অনুরোধ করলে, অনুমোদন সার্ভার সেকেন্ডে বাকি থাকা লাইফটাইম (expires_in) সহ নতুন অ্যাক্সেস টোকেন ফেরত দেয়। মেয়াদ শেষ হওয়ার ৫ মিনিটের কম সময় বাকি থাকলে, আমরা অ্যাক্সেস টোকেন রিফ্রেশ করার সাজেশন দিই।