DV360 এক্সচেঞ্জ রিপোর্টিং এপিআই থার্ড-পার্টি এক্সচেঞ্জ (3PE) পার্টনারদেরকে ডিসপ্লে অ্যান্ড ভিডিও 360 থেকে পারফরম্যান্স রিপোর্টগুলিতে প্রোগ্রাম্যাটিক অ্যাক্সেস প্রদান করে।
DV360 Exchange Reporting API-টি একটি allowlist ভিত্তিক Google Cloud API হিসেবে উন্মুক্ত করা হয়েছে, যা OAuth ব্যবহার করে। allowlist প্রক্রিয়াটি DV360 Exchange Reporting API টিম দ্বারা পরিচালিত হয়।
পদ্ধতি
DV360 Exchange Reporting API অনবোর্ডিং-এর ধাপগুলো নিচে দেওয়া হলো:
গুগল ক্লাউড কনসোলে একটি গুগল অ্যাকাউন্ট তৈরি করুন।
মনে রাখবেন, এই অ্যাকাউন্টটি আপনার প্রোডাকশন ক্লায়েন্টের অ্যাক্সেস টোকেন পরিচালনা করতে ব্যবহার করা হবে, তাই আপনার ব্যক্তিগত জিমেইল অ্যাকাউন্ট ব্যবহার করবেন না।
অনুমোদিত তালিকায় যুক্ত করার জন্য অ্যাকাউন্টের তথ্যসহ গুগল ডিভি৩৬০ (Google DV360)-এর সাথে যোগাযোগ করুন।
আপনাকে অনুমতি তালিকায় অন্তর্ভুক্ত করার বিজ্ঞপ্তি পাওয়ার পর, আপনার অ্যাপকে
doubleclickbidmanagerস্কোপে অ্যাক্সেস দেওয়ার জন্য একটি OAuth ভেরিফিকেশন পর্যালোচনার অনুরোধ করুন।গুগল ক্লাউড কনসোলে সাইন ইন করুন।
API & Services > Library > Private- এ যান। সেখানে আপনার জন্য উপলব্ধ API-গুলোর মধ্যে একটি হিসেবে DV360 Exchange Reporting API-কে তালিকাভুক্ত দেখতে পাবেন। DV360 Exchange Reporting API-টি সক্রিয় করুন।
Credentials > Create a Credential > Service Account Key- তে যান। একটি সার্ভিস অ্যাকাউন্ট তৈরি করার জন্য নির্দেশাবলী অনুসরণ করুন।
পরিষেবা অ্যাকাউন্ট
একটি সার্ভিস অ্যাকাউন্ট আপনার কোডকে সরাসরি এপিআই-তে অ্যাপ্লিকেশন ক্রেডেনশিয়াল পাঠাতে দেয়। একটি ইউজার অ্যাকাউন্টের মতোই, একটি সার্ভিস অ্যাকাউন্টও একটি ইমেল অ্যাড্রেস দ্বারা চিহ্নিত করা হয়। তবে, ইউজার অ্যাকাউন্টের থেকে ভিন্ন, একটি সার্ভিস অ্যাকাউন্ট শুধুমাত্র একটি অ্যাপ্লিকেশনের অন্তর্গত এবং এটি কেবল সেই এপিআই অ্যাক্সেস করার জন্যই ব্যবহার করা যায়, যার জন্য এটি তৈরি করা হয়েছে।
গুগল ক্লাউড কনসোল ব্যবহার করে সার্ভিস অ্যাকাউন্ট ক্রেডেনশিয়াল তৈরি করার ধাপগুলো নিচে দেওয়া হলো:
API ম্যানেজার > ক্রেডেনশিয়ালস পৃষ্ঠা থেকে, ক্রেডেনশিয়ালস তৈরি করুন → পরিষেবা অ্যাকাউন্ট কী নির্বাচন করুন।
সার্ভিস অ্যাকাউন্ট ড্রপ-ডাউন থেকে নতুন সার্ভিস অ্যাকাউন্ট নির্বাচন করুন।
এই সার্ভিস অ্যাকাউন্টের জন্য একটি নাম লিখুন। এই নামটি আপনার সার্ভিস অ্যাকাউন্ট আইডির ডিফল্ট নাম হিসেবে ব্যবহৃত হবে এবং তৈরি হওয়া সার্ভিস অ্যাকাউন্ট আইডি অ্যাড্রেসে
@চিহ্নের বাম দিকে থাকবে।‘Key type’-এর অধীনে, আমরা আপনাকে এই মানটি
JSONহিসাবে রাখার পরামর্শ দিচ্ছি। একটি.jsonটেক্সট ফাইল হিসাবে JSON কী তৈরি করতে Create-এ ক্লিক করুন। অনুরোধ করা হলে, ফাইলটি আপনার কম্পিউটারে ডাউনলোড করুন এবং একটি ‘Service account created’ ডায়ালগ বক্স প্রদর্শিত হবে।
এখানে একটি নমুনা 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>api@project-id.iam.gserviceaccount.com", "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 ফাইলটি নিরাপদে সংরক্ষণ করুন, কারণ এতে আপনার প্রাইভেট কী রয়েছে এবং এই ফাইলটিই সেই কী-এর একমাত্র অনুলিপি। আপনার কোড যখন API-তে কল করে, তখন এই ফাইলের ক্রেডেনশিয়ালগুলির প্রয়োজন হয়।
আপনার তৈরি করা সার্ভিস অ্যাকাউন্টের তথ্য, বিশেষ করে সার্ভিস অ্যাকাউন্টের ইমেল ঠিকানাটি সহ DV360-এর সাথে যোগাযোগ করুন। এটি API অ্যাক্সেসের জন্য অনুমতি তালিকা (allowlist) প্রক্রিয়ার একটি অংশ।
অ্যাক্সেস টোকেন
আপনার সার্ভিস অ্যাকাউন্টটি এপিআই-তে কল করার জন্য অনুমোদিত হয়ে গেলে, আপনি এপিআই গাইডের উদাহরণগুলো নিয়ে এগিয়ে যেতে পারেন। ম্যানুয়ালি অ্যাক্সেস টোকেন পেতে, আপনি oauth2l- এর মতো কোনো টুল ব্যবহার করতে পারেন; অথবা, প্রোগ্রাম্যাটিকভাবে প্রমাণীকরণের জন্য আমাদের ক্লায়েন্ট লাইব্রেরিগুলোর একটি ব্যবহার করতে পারেন।