Authentication

ReachPlanService এ করা অনুরোধের জন্য অবশ্যই OAuth ক্রেডেনশিয়াল এবং একটি কাস্টমার আইডি সরবরাহ করতে হবে, যেটিতে আপনার OAuth ক্রেডেনশিয়াল অ্যাক্সেস করতে পারে। এছাড়াও, OAuth ক্রেডেনশিয়ালগুলো যে Google Cloud প্রজেক্টের অন্তর্গত, সেই প্রজেক্টটিকে এই পরিষেবাটি ব্যবহারের জন্য অনুমোদিত হতে হবে।

এই নির্দেশিকায় ReachPlanService জন্য নির্দিষ্ট প্রমাণীকরণের বিবরণ দেওয়া হয়েছে। আপনি যদি ইতিমধ্যেই তা না করে থাকেন, তাহলে প্রথমে 'শুরু করুন' অংশে বর্ণিত ধাপগুলো সম্পন্ন করুন, তারপর এই পর্যায়ে ফিরে আসুন।

OAuth পরিচয়পত্র

'Get started'- এ প্রদত্ত নির্দেশনার পাশাপাশি নিম্নলিখিত বিষয়গুলো মনে রাখবেন:

  1. ReachPlanService সাথে সংযোগ করার জন্য আপনার Google Cloud প্রজেক্ট নম্বরটি অবশ্যই উপযুক্ত allowlist-এ যুক্ত করতে হবে, এমনকি যদি এটি অন্যান্য Google Ads API পরিষেবাগুলির সাথে ব্যবহারের জন্য ইতিমধ্যেই অনুমোদিত হয়ে থাকে। আরও তথ্যের জন্য, যোগ্যতার প্রয়োজনীয়তাগুলি দেখুন।
  2. Google Ads API-এর সাথে সংযোগ স্থাপন করতে হলে আপনাকে অবশ্যই Google Ads API-এর পরিষেবার শর্তাবলী মেনে নিতে হবে।
  3. যে ব্যবহারকারীর কাছে আপনার OAuth রিফ্রেশ টোকেন রয়েছে, তিনিই নির্ধারণ করেন যে আপনি ReachPlanService এ কোন গ্রাহক আইডিগুলো কোয়েরি করতে পারবেন। এটি আপনার ইন্টিগ্রেশনকে প্রভাবিত করে এবং পরবর্তী বিভাগগুলোতে এ বিষয়ে আরও বিস্তারিতভাবে ব্যাখ্যা করা হয়েছে।

গ্রাহক আইডি

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

অভ্যন্তরীণ সরঞ্জাম

আপনি যদি আপনার প্রতিষ্ঠানে অভ্যন্তরীণ ব্যবহারের জন্য টুল তৈরি করেন, তবে আমাদের এই সুপারিশগুলো রইল।

সরাসরি ক্লায়েন্ট অ্যাকাউন্টে অ্যাক্সেস ছাড়া পরিকল্পনাকারীরা

যদি আপনার প্ল্যানারদের আপনার ক্লায়েন্টদের গুগল অ্যাডস অ্যাকাউন্টে অ্যাক্সেস না থাকে, তাহলে আপনার ম্যানেজার অ্যাকাউন্টে অ্যাক্সেস আছে এমন একজন ব্যবহারকারীর জন্য একক-ব্যবহারকারী প্রমাণীকরণ প্রবাহ ব্যবহার করে OAuth ক্রেডেনশিয়াল তৈরি করুন। এরপর, আপনার টুল ব্যবহারকারী প্রতিটি টিমের জন্য একটি গুগল অ্যাডস অ্যাকাউন্ট তৈরি করুন বা সংগ্রহ করুন এবং সেগুলোকে আপনার ম্যানেজার অ্যাকাউন্টের সাথে লিঙ্ক করুনReachPlanService এ অনুরোধ করার সময়, ব্যবহারকারীর টিমের সাথে সম্পর্কিত কাস্টমার আইডি প্রদান করুন।

ক্লায়েন্ট অ্যাকাউন্টে অ্যাক্সেস সহ পরিকল্পনাকারীরা

আপনার প্ল্যানারদের যদি এমন একটি গুগল অ্যাডস ম্যানেজার অ্যাকাউন্টে অ্যাক্সেস থাকে যা আপনার ক্লায়েন্টদের অ্যাকাউন্ট পরিচালনা করে, তাহলে আপনার অ্যাপকে প্ল্যানারদের OAuth ক্রেডেনশিয়াল ব্যবহার করার অনুমতি দিতে মাল্টি-ইউজার অথেন্টিকেশন ফ্লো প্রয়োগ করুন। এরপর আপনি আপনার প্ল্যানের গ্রাহকের সাথে সম্পর্কিত কাস্টমার আইডিটি পাস করতে পারবেন।

বাহ্যিক সরঞ্জাম

আপনি যদি বহিরাগত ব্যবহারকারীদের জন্য কোনো টুল তৈরি করেন, তাহলে আমরা অনুরূপ পদ্ধতি অবলম্বনের পরামর্শ দিই:

প্রতি-ক্লায়েন্ট অ্যাকাউন্ট

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

ব্যবহারকারী-প্রদত্ত অ্যাক্সেস

মাল্টি-ইউজার অথেন্টিকেশন ফ্লো ব্যবহার করে আপনার ব্যবহারকারীদেরকে তাদের অ্যাকাউন্টে আপনার টুলকে অ্যাক্সেস দেওয়ার ক্ষমতা দিন। একবার কোনো ব্যবহারকারী অনুমতি দিলে, CustomerService ব্যবহার করে তাদেরকে সেইসব গুগল অ্যাডস অ্যাকাউন্টের একটি তালিকা প্রদান করুন যেগুলোতে তারা অ্যাক্সেস করতে পারবে।

এর লক্ষ্য হলো ReachPlanService ব্যবহার করার সময় পরিকল্পনাকারীদের যেন সর্বনিম্ন অসুবিধা হয় তা নিশ্চিত করা। API ইন্টিগ্রেট করার আগে, আপনার পরিস্থিতি অনুযায়ী দুটি পদ্ধতির মধ্যে একটি বেছে নিন এবং পরীক্ষা করার জন্য কয়েকটি গ্রাহক আইডি শনাক্ত করুন। সন্দেহ থাকলে, আপনার টুলের ধরনের জন্য প্রথম প্রস্তাবিত পদ্ধতিটি ব্যবহার করুন।

এরপর কী?

কীভাবে একটি মিডিয়া প্ল্যান নির্দিষ্ট করতে হয় তা জানুন।

,

ReachPlanService এ করা অনুরোধের জন্য অবশ্যই OAuth ক্রেডেনশিয়াল এবং একটি কাস্টমার আইডি সরবরাহ করতে হবে, যেটিতে আপনার OAuth ক্রেডেনশিয়াল অ্যাক্সেস করতে পারে। এছাড়াও, OAuth ক্রেডেনশিয়ালগুলো যে Google Cloud প্রজেক্টের অন্তর্গত, সেই প্রজেক্টটিকে এই পরিষেবাটি ব্যবহারের জন্য অনুমোদিত হতে হবে।

এই নির্দেশিকায় ReachPlanService জন্য নির্দিষ্ট প্রমাণীকরণের বিবরণ দেওয়া হয়েছে। আপনি যদি ইতিমধ্যেই তা না করে থাকেন, তাহলে প্রথমে 'শুরু করুন' অংশে বর্ণিত ধাপগুলো সম্পন্ন করুন, তারপর এই পর্যায়ে ফিরে আসুন।

OAuth পরিচয়পত্র

'Get started'- এ প্রদত্ত নির্দেশনার পাশাপাশি নিম্নলিখিত বিষয়গুলো মনে রাখবেন:

  1. ReachPlanService সাথে সংযোগ করার জন্য আপনার Google Cloud প্রজেক্ট নম্বরটি অবশ্যই উপযুক্ত allowlist-এ যুক্ত করতে হবে, এমনকি যদি এটি অন্যান্য Google Ads API পরিষেবাগুলির সাথে ব্যবহারের জন্য ইতিমধ্যেই অনুমোদিত হয়ে থাকে। আরও তথ্যের জন্য, যোগ্যতার প্রয়োজনীয়তাগুলি দেখুন।
  2. Google Ads API-এর সাথে সংযোগ স্থাপন করতে হলে আপনাকে অবশ্যই Google Ads API-এর পরিষেবার শর্তাবলী মেনে নিতে হবে।
  3. যে ব্যবহারকারীর কাছে আপনার OAuth রিফ্রেশ টোকেন রয়েছে, তিনিই নির্ধারণ করেন যে আপনি ReachPlanService এ কোন গ্রাহক আইডিগুলো কোয়েরি করতে পারবেন। এটি আপনার ইন্টিগ্রেশনকে প্রভাবিত করে এবং পরবর্তী বিভাগগুলোতে এ বিষয়ে আরও বিস্তারিতভাবে ব্যাখ্যা করা হয়েছে।

গ্রাহক আইডি

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

অভ্যন্তরীণ সরঞ্জাম

আপনি যদি আপনার প্রতিষ্ঠানে অভ্যন্তরীণ ব্যবহারের জন্য টুল তৈরি করেন, তবে আমাদের এই সুপারিশগুলো রইল।

সরাসরি ক্লায়েন্ট অ্যাকাউন্টে অ্যাক্সেস ছাড়া পরিকল্পনাকারীরা

যদি আপনার প্ল্যানারদের আপনার ক্লায়েন্টদের গুগল অ্যাডস অ্যাকাউন্টে অ্যাক্সেস না থাকে, তাহলে আপনার ম্যানেজার অ্যাকাউন্টে অ্যাক্সেস আছে এমন একজন ব্যবহারকারীর জন্য একক-ব্যবহারকারী প্রমাণীকরণ প্রবাহ ব্যবহার করে OAuth ক্রেডেনশিয়াল তৈরি করুন। এরপর, আপনার টুল ব্যবহারকারী প্রতিটি টিমের জন্য একটি গুগল অ্যাডস অ্যাকাউন্ট তৈরি করুন বা সংগ্রহ করুন এবং সেগুলোকে আপনার ম্যানেজার অ্যাকাউন্টের সাথে লিঙ্ক করুনReachPlanService এ অনুরোধ করার সময়, ব্যবহারকারীর টিমের সাথে সম্পর্কিত কাস্টমার আইডি প্রদান করুন।

ক্লায়েন্ট অ্যাকাউন্টে অ্যাক্সেস সহ পরিকল্পনাকারীরা

আপনার প্ল্যানারদের যদি এমন একটি গুগল অ্যাডস ম্যানেজার অ্যাকাউন্টে অ্যাক্সেস থাকে যা আপনার ক্লায়েন্টদের অ্যাকাউন্ট পরিচালনা করে, তাহলে আপনার অ্যাপকে প্ল্যানারদের OAuth ক্রেডেনশিয়াল ব্যবহার করার অনুমতি দিতে মাল্টি-ইউজার অথেন্টিকেশন ফ্লো প্রয়োগ করুন। এরপর আপনি আপনার প্ল্যানের গ্রাহকের সাথে সম্পর্কিত কাস্টমার আইডিটি পাস করতে পারবেন।

বাহ্যিক সরঞ্জাম

আপনি যদি বহিরাগত ব্যবহারকারীদের জন্য কোনো টুল তৈরি করেন, তাহলে আমরা অনুরূপ পদ্ধতি অবলম্বনের পরামর্শ দিই:

প্রতি-ক্লায়েন্ট অ্যাকাউন্ট

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

ব্যবহারকারী-প্রদত্ত অ্যাক্সেস

মাল্টি-ইউজার অথেন্টিকেশন ফ্লো ব্যবহার করে আপনার ব্যবহারকারীদেরকে তাদের অ্যাকাউন্টে আপনার টুলকে অ্যাক্সেস দেওয়ার ক্ষমতা দিন। একবার কোনো ব্যবহারকারী অনুমতি দিলে, CustomerService ব্যবহার করে তাদেরকে সেইসব গুগল অ্যাডস অ্যাকাউন্টের একটি তালিকা প্রদান করুন যেগুলোতে তারা অ্যাক্সেস করতে পারবে।

এর লক্ষ্য হলো ReachPlanService ব্যবহার করার সময় পরিকল্পনাকারীদের যেন সর্বনিম্ন অসুবিধা হয় তা নিশ্চিত করা। API ইন্টিগ্রেট করার আগে, আপনার পরিস্থিতি অনুযায়ী দুটি পদ্ধতির মধ্যে একটি বেছে নিন এবং পরীক্ষা করার জন্য কয়েকটি গ্রাহক আইডি শনাক্ত করুন। সন্দেহ থাকলে, আপনার টুলের ধরনের জন্য প্রথম প্রস্তাবিত পদ্ধতিটি ব্যবহার করুন।

এরপর কী?

কীভাবে একটি মিডিয়া প্ল্যান নির্দিষ্ট করতে হয় তা জানুন।