আপনি আপনার এজেন্সি অ্যাকাউন্টের পারফরম্যান্স সম্পর্কে ধারণা দিতে পারে এমন রিপোর্ট তৈরি করতে এজেন্সি ও ব্র্যান্ডস এপিআই ব্যবহার করতে পারেন।
এজেন্সি অ্যাকাউন্ট
একটি এজেন্সি অ্যাকাউন্ট সেইসব বিজ্ঞাপনী সংস্থাকে বোঝায় যারা গুগল অ্যাড ম্যানেজার পাবলিশারদের সাথে কাজ করে। আপনার গুগল অ্যাকাউন্টে লগ ইন থাকা অবস্থায় এজেন্সি UI দেখে আপনি আপনার এজেন্সি অ্যাকাউন্টের অ্যাকাউন্ট আইডি খুঁজে নিতে পারেন।
প্রমাণীকরণ সেট আপ করুন
গুগল এপিআই প্রমাণীকরণ এবং অনুমোদনের জন্য OAuth 2.0 প্রোটোকল ব্যবহার করে। এজেন্সি এবং ব্র্যান্ড এপিআই অ্যাক্সেস করার জন্য একটি সার্ভিস অ্যাকাউন্ট সেট আপ করার পদ্ধতি নিচে দেওয়া হলো:
যদি আপনি ইতিমধ্যে তা না করে থাকেন, তাহলে একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন যেখানে এপিআই অ্যাক্সেস করার জন্য ব্যবহৃত আপনার ক্রেডেনশিয়ালগুলো থাকবে।
Google Cloud কনসোলের Enabled APIs পৃষ্ঠায় যান। আপনার পূর্বে তৈরি করা প্রজেক্টটি নির্বাচন করুন।
আপনি সক্রিয় করা এপিআই এবং পরিষেবাগুলির একটি তালিকা দেখতে পাবেন। এজেন্সি ও ব্র্যান্ড এপিআই অ্যাক্সেস করতে হলে, আপনাকে এটি সক্রিয় করতে হবে। যদি এটি সক্রিয় করা না থাকে, তাহলে ‘+এপিআই ও পরিষেবা সক্রিয় করুন’ (+Enable APIs and services) -এ ক্লিক করুন এবং ‘এজেন্সি ও ব্র্যান্ড এপিআই’ (Agencies & Brands API) অনুসন্ধান করে, সেটি নির্বাচন করুন এবং ‘সক্রিয় করুন ’ (Enable)-এ ক্লিক করুন।
এটি একটি পরিচিত সমস্যা যে আপনি গুগল ক্লাউড কনসোল সার্চ বক্সে এজেন্সি ও ব্র্যান্ডস এপিআই (Agencies & Brands API) খুঁজে নাও পেতে পারেন। এর বিকল্প হিসেবে, আপনি এপিআইটি সক্রিয় করতে গুগল ক্লাউড সিএলআই (Google Cloud CLI) ব্যবহার করতে পারেন। জিক্লাউড সিএলআই (gcloud CLI) ইনস্টল করার পরে, আপনি নিম্নলিখিত কমান্ডের মাধ্যমে এজেন্সি ও ব্র্যান্ডস এপিআই সক্রিয় করতে পারেন:
gcloud services enable agenciesandbrands.googleapis.com --project=CLOUD_PROJECT_IDনেভিগেশন মেনু থেকে ক্রেডেনশিয়ালস নির্বাচন করুন।
+Create credentials-এ ক্লিক করুন, এবং ফলস্বরূপ মেনু থেকে Service account নির্বাচন করুন।
সার্ভিস অ্যাকাউন্টের জন্য 'Name' ফিল্ডে একটি নাম লিখুন। তৈরির সময় সার্ভিস অ্যাকাউন্ট আইডি স্বয়ংক্রিয়ভাবে তৈরি হয়ে যায়। পরবর্তী একটি ধাপে এই মানটির প্রয়োজন হবে। ইচ্ছা হলে একটি বিবরণ লিখুন। 'Create and continue'- তে ক্লিক করুন।
ঐচ্ছিকভাবে সার্ভিস অ্যাকাউন্টের জন্য অনুমতি কনফিগার করুন এবং 'চালিয়ে যান'-এ ক্লিক করুন।
ঐচ্ছিকভাবে সেইসব ব্যবহারকারী বা গোষ্ঠী কনফিগার করুন যারা পরিষেবা অ্যাকাউন্ট হিসাবে কাজগুলি সম্পাদন করতে পারবে এবং 'সম্পন্ন' ক্লিক করুন।
আপনার নতুন সার্ভিস অ্যাকাউন্টটি 'সার্ভিস অ্যাকাউন্টস'- এর অধীনে তালিকাভুক্ত আছে। আপনি এইমাত্র তৈরি করা সার্ভিস অ্যাকাউন্ট আইডিটিতে ক্লিক করুন।
Keys ট্যাবে ক্লিক করুন।
Add key মেনুতে, Create new key নির্বাচন করুন।
Key type হিসেবে JSON নির্বাচন করুন এবং Create-এ ক্লিক করুন।
কী-টি আপনার ওয়ার্কিং ডিরেক্টরিতে ডাউনলোড করুন। আপনার কী নিরাপদে সংরক্ষণ করার বিষয়ে আরও তথ্যের জন্য, ‘সার্ভিস অ্যাকাউন্ট কী পরিচালনা’ দেখুন। আপনার অ্যাপ্লিকেশন এপিআই (API) কল করার জন্য এই কী-টি ব্যবহার করে।
আপনার এজেন্সি অ্যাকাউন্টের সাথে সার্ভিস অ্যাকাউন্টটি লিঙ্ক করার জন্য, আপনার টেকনিক্যাল অ্যাকাউন্ট ম্যানেজারের সাথে সার্ভিস অ্যাকাউন্ট আইডিটি শেয়ার করুন।
এপিআই স্কোপ
এপিআই কল করার জন্য ব্যবহৃত অ্যাক্সেস টোকেন পেতে OAuth 2.0 অনুমোদন প্রক্রিয়ার ধাপগুলো অনুসরণ করার সময়, আপনাকে অবশ্যই এপিআই স্কোপ নির্দিষ্ট করতে হবে:
https://www.googleapis.com/auth/agencies-and-brands
পরবর্তী পদক্ষেপ
- এজেন্সি ও ব্র্যান্ড এপিআই রেফারেন্স : এপিআই রেফারেন্স ডকুমেন্টেশনে রিসোর্স এবং মেথডগুলো অন্বেষণ করুন।
- রিলিজ নোট : এজেন্সি এবং ব্র্যান্ড এপিআই-এর আপডেট এবং রিলিজের ইতিহাস পর্যালোচনা করুন।