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