Auth সেট আপ করা হচ্ছে

ডিসপ্লে ও ভিডিও ৩৬০ সেলার এপিআই অনবোর্ডিং

Display & Video 360 Seller API-এর সাথে যুক্ত হওয়ার জন্য কয়েকটি গুরুত্বপূর্ণ ধাপ রয়েছে। DV360 Seller API হলো একটি allowlist-ভিত্তিক Google Cloud API এবং এটি প্রমাণীকরণ ও অনুমোদনের জন্য OAuth 2.0 ব্যবহার করে।

সক্রিয়করণ প্রক্রিয়াটি ডিসপ্লে অ্যান্ড ভিডিও ৩৬০ সেলার এপিআই টিম দ্বারা পরিচালিত হয়।

দ্রষ্টব্য: যদি আপনার অ্যাপ্লিকেশনটি DV360 সেলার এপিআই (DV360 Seller API) অ্যাক্সেস করে, তবে এটিকে অবশ্যই OAuth ভেরিফিকেশন রিভিউ পাস করতে হবে। আপনার অ্যাপ্লিকেশনটি পরীক্ষা করার সময় যদি স্ক্রিনে ‘অপরিষ্কার অ্যাপ’ (unverified app) দেখতে পান, তবে সেটি সরানোর জন্য আপনাকে অবশ্যই একটি ভেরিফিকেশন অনুরোধ জমা দিতে হবে। অপরিষ্কার অ্যাপ সম্পর্কে আরও জানুন অথবা অ্যাপ ভেরিফিকেশন সম্পর্কিত প্রায়শই জিজ্ঞাসিত প্রশ্নগুলির উত্তর পান।

অনবোর্ডিং ধাপসমূহ:

1. https://console.cloud.google.com/ -এ গিয়ে একটি গুগল অ্যাকাউন্ট তৈরি করুন।
   • এই অ্যাকাউন্টটি আপনার প্রোডাকশন ক্লায়েন্টের অ্যাক্সেস টোকেন পরিচালনা করতে ব্যবহৃত হবে। ব্যক্তিগত জিমেইল অ্যাকাউন্ট ব্যবহার করবেন না।
   • অ্যাকাউন্টটি গুগল গ্রুপ হতে পারবে না।
   • আপনি যদি একটি বিদ্যমান গুগল ক্লাউড প্রজেক্ট ব্যবহার করেন: অ্যাকাউন্টটিকে অবশ্যই প্রজেক্টটির অ্যাডমিনিস্ট্রেটর হতে হবে।
2. আপনার অ্যাকাউন্টটি অনুমোদিত তালিকায় যুক্ত করার জন্য অ্যাকাউন্টের বিবরণসহ গুগল ডিভি৩৬০ টিমের সাথে যোগাযোগ করুন।
3. আপনার অ্যাকাউন্টটি সক্রিয় হওয়ার নিশ্চিতকরণের জন্য অপেক্ষা করুন।
4. ঐচ্ছিক এবং বাধাহীন: https://www.googleapis.com/auth/doubleclickbidmanager স্কোপটি অ্যাক্সেস করার জন্য আপনার অ্যাপ্লিকেশনের পক্ষ থেকে একটি OAuth ভেরিফিকেশন রিভিউ অনুরোধ জমা দিন।
5. গুগল ক্লাউড কনসোলে , APIs & Services > Library > Private- এ যান। সেখানে আপনি আপনার প্রোজেক্টের জন্য DV360 Seller API- টি উপলব্ধ দেখতে পাবেন।
6. DV360 সেলার এপিআই সক্রিয় করুন।
7. APIs & Services > Credentials > Create Credentials > Service Account Key- তে যান। OAuth 2.0 Service Account ডকুমেন্টেশনে দেওয়া সেটআপ নির্দেশাবলী অনুসরণ করুন।

   একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন:

   দ্রষ্টব্য: আপনি যদি DV360 রিপোর্টিং API-এর জন্য ব্যবহৃত কোনো বিদ্যমান পরিষেবা অ্যাকাউন্ট পুনরায় ব্যবহার করতে চান, তাহলে আমাদের জানান।

   গুগল ক্লাউড এপিআই অথেন্টিকেশন এবং অথরাইজেশন (সাধারণত একত্রে "auth" নামে পরিচিত) সাধারণত একটি সার্ভিস অ্যাকাউন্ট ব্যবহার করে করা হয়। একটি সার্ভিস অ্যাকাউন্ট আপনার কোডকে সরাসরি ক্লাউড এপিআই-তে অ্যাপ্লিকেশন ক্রেডেনশিয়াল পাঠাতে দেয়। একটি ইউজার অ্যাকাউন্টের মতোই, একটি সার্ভিস অ্যাকাউন্টও একটি ইমেল অ্যাড্রেস দ্বারা চিহ্নিত করা হয়। তবে, একটি ইউজার অ্যাকাউন্টের থেকে ভিন্ন, একটি সার্ভিস অ্যাকাউন্ট শুধুমাত্র একটি অ্যাপ্লিকেশনের অন্তর্গত এবং এটি কেবল সেই এপিআই অ্যাক্সেস করার জন্য ব্যবহার করা যেতে পারে যার জন্য এটি তৈরি করা হয়েছে। উদাহরণস্বরূপ, এই নির্দেশিকাটি দেখায় কিভাবে গুগল ক্লাউড কনসোল ব্যবহার করে সার্ভিস অ্যাকাউন্ট ক্রেডেনশিয়াল তৈরি করতে হয়।

   গুগল ক্লাউড কনসোল ব্যবহার করে

   Google Cloud কনসোলের API Manager→Credentials পৃষ্ঠা থেকে, "Create credentials→Service account key" নির্বাচন করুন।

   

   এরপর, "সার্ভিস অ্যাকাউন্ট" ড্রপ-ডাউন থেকে "নতুন সার্ভিস অ্যাকাউন্ট" নির্বাচন করুন।

   

   এই সার্ভিস অ্যাকাউন্টের জন্য একটি "নাম" টাইপ করুন। এই নামটি আপনার "সার্ভিস অ্যাকাউন্ট আইডি"-এর ডিফল্ট নাম হিসেবে ব্যবহৃত হবে (তৈরি হওয়া সার্ভিস অ্যাকাউন্ট আইডি অ্যাড্রেসে "@" চিহ্নের বাম দিকে), তবে আপনি চাইলে এই সার্ভিস অ্যাকাউন্ট আইডির নামটি পরিবর্তন করতে পারেন। এই নামগুলো ইচ্ছামতো হতে পারে; শুধু এগুলো মনে রাখাই জরুরি। "কী টাইপ"-এর অধীনে, আমরা আপনাকে এই ভ্যালুটি "JSON" হিসেবে রাখার পরামর্শ দিই। "তৈরি করুন" (Create) বোতামে ক্লিক করুন, এবং গুগল ক্লাউড কনসোল একটি JSON কী ( .json টেক্সট ফাইল হিসেবে) তৈরি করবে, ফাইলটি আপনার কম্পিউটারে ডাউনলোড করার জন্য আপনাকে অনুরোধ করবে এবং একটি "সার্ভিস অ্যাকাউন্ট তৈরি হয়েছে " ডায়ালগ বক্স প্রদর্শন করবে।

   

   তৈরি হওয়া JSON কী-টি নিম্নলিখিত নমুনা JSON কী-এর অনুরূপ হবে:

   {
     "type": "service_account",
     "project_id": "project-id",
     "private_key_id": "some_number",
     "private_key": "-----BEGIN PRIVATE KEY-----\n....
     =\n-----END PRIVATE KEY-----\n",
     "client_email": "<api-name>[e-mail]",
     "client_id": "...",
     "auth_uri": "https://accounts.google.com/o/oauth2/auth",
     "token_uri": "https://accounts.google.com/o/oauth2/token",
     "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
     "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
   }

   এই JSON ফাইলটি নিরাপদে সংরক্ষণ করুন, কারণ এতে আপনার প্রাইভেট কী রয়েছে (এবং এই ফাইলটিই সেই কী-এর একমাত্র কপি)। যখন আপনি Google Cloud API-তে ক্রেডেনশিয়াল পাঠাতে চাইবেন, তখন আপনার কোডের মধ্যে এই সার্ভিস অ্যাকাউন্ট কী ফাইলটি উল্লেখ করতে হবে।

8. আপনার তৈরি করা সার্ভিস অ্যাকাউন্টের তথ্য (বিশেষ করে, সার্ভিস অ্যাকাউন্টের ইমেল অ্যাড্রেস) সহ DV360 টিমের সাথে যোগাযোগ করুন। এটি অনুমোদনের জন্য অ্যালাওলিস্টের দ্বিতীয় ধাপ।
9. আপনার সার্ভিস অ্যাকাউন্টটি এপিআই (API) কল করার জন্য অনুমোদিত হয়ে গেলে, আপনি ডিভি ৩৬০ সেলার এপিআই (DV360 Seller API) ডকুমেন্টেশন দেখতে পারেন। ম্যানুয়ালি একটি অথ টোকেন (auth token) পেতে, ওঅথ২এল (oauth2l) টুল রিপোজিটরিতে দেওয়া নির্দেশাবলী দেখুন (আপনার ডাউনলোড করা জেএসওএন সার্ভিস অ্যাকাউন্ট কী (JSON service account key) ব্যবহার করে)। প্রোগ্রাম্যাটিকভাবে ওঅথ টোকেন (OAuth token) পাওয়ার বিস্তারিত নির্দেশাবলী গুগল ক্লাউড অথেন্টিকেশন (Google Cloud Authentication) ডকুমেন্টেশনে পাওয়া যাবে।

গুরুত্বপূর্ণ: OAuth স্কোপ অবশ্যই https://www.googleapis.com/auth/doubleclickbidmanager হতে হবে।