Authentication

এই ডকুমেন্টে অ্যাড ম্যানেজার এপিআই-তে কীভাবে প্রমাণীকরণ করতে হয় তা বর্ণনা করা হয়। আপনি কীভাবে প্রমাণীকরণ করবেন তা আপনার ব্যবহৃত ইন্টারফেস এবং আপনার কোডটি যে পরিবেশে চলছে তার উপর নির্ভর করে, তবে সমস্ত এপিআই অনুরোধে অ্যাড ম্যানেজার এপিআই স্কোপের সাথে একটি অ্যাক্সেস টোকেন অন্তর্ভুক্ত থাকতে হবে।

অ্যাড ম্যানেজার ক্লায়েন্ট লাইব্রেরিগুলি অ্যাড ম্যানেজার এপিআই স্কোপ ব্যবহার করে অ্যাক্সেস টোকেন তৈরি করতে অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র ব্যবহার করে। এই নির্দেশিকাটি দেখায় যে কীভাবে অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র কনফিগার করতে হয়।

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

প্রমাণীকরণ এবং অনুমোদন সম্পর্কে আরও তথ্যের জন্য, OAuth 2.0 ব্যবহার নির্দেশিকা দেখুন।

আপনার প্রমাণীকরণের ধরণ নির্ধারণ করুন

প্রমাণীকরণের ধরণ বিবরণ
পরিষেবা অ্যাকাউন্ট যদি আপনি কোনও নির্দিষ্ট ব্যক্তির পরিবর্তে ডেডিকেটেড অ্যাকাউন্ট হিসেবে প্রমাণীকরণ করতে চান তবে এটি বেছে নিন।
আরও জানুন ।
ওয়েব অ্যাপ্লিকেশন আপনার অ্যাপ্লিকেশনকে তাদের বিজ্ঞাপন ম্যানেজার ডেটা অ্যাক্সেস করার অনুমতি প্রদানকারী কোনও ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে চাইলে এটি বেছে নিন।
আরও জানুন
স্থানীয় উন্নয়ন আপনার নিজস্ব Google অ্যাকাউন্ট অথবা আপনার স্থানীয় উন্নয়ন পরিবেশ থেকে একটি পরিষেবা অ্যাকাউন্ট হিসেবে প্রমাণীকরণ করতে চাইলে এটি বেছে নিন।

বিজ্ঞাপন পরিচালক API সক্ষম করুন

  1. আপনার Google API কনসোল ক্লাউড প্রোজেক্টে Ad Manager API সক্ষম করুন।

  2. যদি অনুরোধ করা হয়, একটি প্রকল্প নির্বাচন করুন, অথবা একটি নতুন প্রকল্প তৈরি করুন।

শংসাপত্র তৈরি করুন

আপনার প্রমাণীকরণের ধরণের ট্যাবে ক্লিক করুন এবং আপনার শংসাপত্র তৈরি করতে নির্দেশাবলী অনুসরণ করুন:

পরিষেবা অ্যাকাউন্ট

গুগল ক্লাউডে

গুগল ক্লাউডে চলমান একটি ওয়ার্কলোড প্রমাণীকরণ করতে, আপনি যে কম্পিউট রিসোর্সে আপনার কোডটি চলছে তার সাথে সংযুক্ত পরিষেবা অ্যাকাউন্টের শংসাপত্র ব্যবহার করেন।

উদাহরণস্বরূপ, আপনি একটি Compute Engine ভার্চুয়াল মেশিন (VM) ইনস্ট্যান্স, একটি Cloud Run পরিষেবা, অথবা একটি Dataflow কাজের সাথে একটি পরিষেবা অ্যাকাউন্ট সংযুক্ত করতে পারেন। এই পদ্ধতিটি Google Cloud compute রিসোর্সে কোড চালানোর জন্য পছন্দের প্রমাণীকরণ পদ্ধতি।

কোন কোন রিসোর্সে আপনি একটি সার্ভিস অ্যাকাউন্ট সংযুক্ত করতে পারেন এবং রিসোর্সে পরিষেবা অ্যাকাউন্ট সংযুক্ত করতে সাহায্য করার জন্য, একটি সার্ভিস অ্যাকাউন্ট সংযুক্ত করার ডকুমেন্টেশন দেখুন।

প্রাঙ্গণে অথবা অন্য কোনও ক্লাউড প্রদানকারীতে

গুগল ক্লাউডের বাইরে থেকে প্রমাণীকরণ সেট আপ করার জন্য পছন্দের পদ্ধতি হল ওয়ার্কলোড আইডেন্টিটি ফেডারেশন ব্যবহার করা; আপনি একটি ক্রেডেনশিয়াল কনফিগারেশন ফাইল তৈরি করেন এবং GOOGLE_APPLICATION_CREDENTIALS এনভায়রনমেন্ট ভেরিয়েবল সেট করেন যা এটি নির্দেশ করে। এই পদ্ধতিটি একটি পরিষেবা অ্যাকাউন্ট কী তৈরি করার চেয়ে বেশি নিরাপদ।

যদি আপনি ওয়ার্কলোড আইডেন্টিটি ফেডারেশন কনফিগার করতে না পারেন, তাহলে আপনাকে একটি সার্ভিস অ্যাকাউন্ট তৈরি করতে হবে এবং সার্ভিস অ্যাকাউন্টের জন্য একটি কী তৈরি করতে হবে:

  1. গুগল এপিআই কনসোল শংসাপত্র পৃষ্ঠাটি খুলুন।

  2. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন নির্বাচন করুন, তারপর পরিষেবা অ্যাকাউন্ট নির্বাচন করুন।

  3. আপনি যে পরিষেবা অ্যাকাউন্টের জন্য একটি কী তৈরি করতে চান তার ইমেল ঠিকানায় ক্লিক করুন।

  4. কী ট্যাবে ক্লিক করুন।

  5. Add key ড্রপ-ডাউন মেনুতে ক্লিক করুন, তারপর Create new key নির্বাচন করুন।

  6. কী টাইপ হিসেবে JSON নির্বাচন করুন এবং Create এ ক্লিক করুন।

  7. পরিবেশ পরিবর্তনশীল GOOGLE_APPLICATION_CREDENTIALS JSON ফাইলের পথে সেট করুন।

লিনাক্স বা ম্যাকওএস 

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

জানালা 

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

ওয়েব অ্যাপ্লিকেশন

  1. গুগল এপিআই কনসোল শংসাপত্র পৃষ্ঠাটি খুলুন।

  2. যদি অনুরোধ করা হয়, তাহলে সেই প্রকল্পটি নির্বাচন করুন যেখানে আপনি বিজ্ঞাপন পরিচালক API সক্ষম করেছেন।

  3. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন নির্বাচন করুন, তারপর OAuth ক্লায়েন্ট আইডি নির্বাচন করুন।

  4. ওয়েব অ্যাপ্লিকেশন অ্যাপ্লিকেশনের ধরণ নির্বাচন করুন।

  5. ফর্মটি পূরণ করুন এবং Create এ ক্লিক করুন। PHP, Java, Python, Ruby, এবং .NET এর মতো ভাষা এবং ফ্রেমওয়ার্ক ব্যবহার করে এমন অ্যাপ্লিকেশনগুলিকে অনুমোদিত পুনর্নির্দেশ URI নির্দিষ্ট করতে হবে। পুনর্নির্দেশ URI হল সেই শেষ বিন্দু যেখানে OAuth 2.0 সার্ভার প্রতিক্রিয়া পাঠাতে পারে। এই শেষ বিন্দুগুলিকে Google এর বৈধতা নিয়ম মেনে চলতে হবে।

  6. আপনার শংসাপত্র তৈরি করার পরে, client_secret.json ফাইলটি ডাউনলোড করুন। ফাইলটি নিরাপদে এমন একটি স্থানে সংরক্ষণ করুন যেখানে শুধুমাত্র আপনার অ্যাপ্লিকেশন অ্যাক্সেস করতে পারে।

এখান থেকে, OAuth 2.0 অ্যাক্সেস টোকেন পেতে ধাপগুলি অনুসরণ করুন।

স্থানীয় উন্নয়ন

আপনার স্থানীয় পরিবেশে অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র (ADC) সেট আপ করুন।

গুগল ক্লাউড সিএলআই ইনস্টল করুন, তারপর নিম্নলিখিত কমান্ডটি চালিয়ে এটি শুরু করুন:

gcloud init

আপনার Google অ্যাকাউন্টের জন্য স্থানীয় প্রমাণীকরণ শংসাপত্র তৈরি করুন এবং প্রোজেক্ট আইডি এমন একটি প্রোজেক্টে সেট করুন যেখানে অ্যাড ম্যানেজার API সক্রিয় আছে:

gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
gcloud auth application-default set-quota-project PROJECT_ID

বিকল্পভাবে, আপনার কী ফাইলের পাথে GOOGLE_APPLICATION_CREDENTIALS পরিবেশ পরিবর্তনশীল সেট করে একটি পরিষেবা অ্যাকাউন্ট হিসাবে প্রমাণীকরণ করুন।

লিনাক্স বা ম্যাকওএস 

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

জানালা 

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

আপনার বিজ্ঞাপন ম্যানেজার নেটওয়ার্ক কনফিগার করুন

পরিষেবা অ্যাকাউন্ট

  1. আপনার বিজ্ঞাপন পরিচালক নেটওয়ার্কে যান।
  2. অ্যাডমিন ট্যাবে ক্লিক করুন।
  3. নিশ্চিত করুন যে API অ্যাক্সেস সক্ষম করা আছে।
  4. একটি পরিষেবা অ্যাকাউন্ট ব্যবহারকারী যোগ করুন বোতামে ক্লিক করুন।
  5. পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানা ব্যবহার করে ফর্মটি পূরণ করুন। আপনার API ইন্টিগ্রেশনের জন্য পরিষেবা অ্যাকাউন্ট ব্যবহারকারীকে উপযুক্ত ভূমিকা এবং দলে যোগ করতে হবে।
  6. সংরক্ষণ বোতামে ক্লিক করুন। আপনার পরিষেবা অ্যাকাউন্ট যোগ করার বিষয়টি নিশ্চিত করে একটি বার্তা প্রদর্শিত হবে।
  7. ব্যবহারকারী ট্যাবে গিয়ে পরিষেবা অ্যাকাউন্ট ফিল্টারে ক্লিক করে বিদ্যমান পরিষেবা অ্যাকাউন্ট ব্যবহারকারীদের দেখুন।

ওয়েব অ্যাপ্লিকেশন

  1. আপনার বিজ্ঞাপন পরিচালক নেটওয়ার্কে যান।
  2. অ্যাডমিন ট্যাবে ক্লিক করুন।
  3. নিশ্চিত করুন যে API অ্যাক্সেস সক্ষম করা আছে।

স্থানীয় উন্নয়ন

  1. আপনার বিজ্ঞাপন পরিচালক নেটওয়ার্কে যান।
  2. অ্যাডমিন ট্যাবে ক্লিক করুন।
  3. নিশ্চিত করুন যে API অ্যাক্সেস সক্ষম করা আছে।

ক্লায়েন্ট লাইব্রেরি ছাড়া

যদি আপনি কোনও ক্লায়েন্ট লাইব্রেরি ব্যবহার না করেন, তবুও আমরা প্রমাণীকরণের জন্য OAuth2 লাইব্রেরি ব্যবহার করার জোরালো পরামর্শ দিচ্ছি।

অ্যাক্সেস টোকেন পাওয়ার বিস্তারিত নির্দেশাবলীর জন্য, Google API গুলির সাথে OAuth2 ব্যবহার দেখুন।

অ্যাক্সেস টোকেন

API-এর অনুরোধে আপনার অ্যাক্সেস টোকেন অন্তর্ভুক্ত করুন, একটি access_token কোয়েরি প্যারামিটার অথবা একটি Authorization HTTP হেডার Bearer মান অন্তর্ভুক্ত করে। সম্ভব হলে, HTTP হেডারটি পছন্দনীয়, কারণ কোয়েরি স্ট্রিংগুলি সার্ভার লগে দৃশ্যমান থাকে।

উদাহরণস্বরূপ:

GET /v1/networks/1234
Host: admanager.googleapis.com
Authorization: Bearer ya29.a0Ad52N3_shYLX

GET https://admanager.googleapis.com/v1/networks/1234?access_token=1/fFAGRNJru1FTz70BzhT3Zg

ব্যাপ্তি

প্রতিটি অ্যাক্সেস টোকেন এক বা একাধিক স্কোপের সাথে যুক্ত। একটি স্কোপ একটি অ্যাক্সেস টোকেন দ্বারা অনুমোদিত রিসোর্স এবং ক্রিয়াকলাপের সেট নিয়ন্ত্রণ করে। অ্যাড ম্যানেজার API-এর দুটি স্কোপ রয়েছে। যদি আপনার অ্যাপ্লিকেশনের ডেটা লেখার প্রয়োজন না হয় তবে আমরা সংকীর্ণ admanager.readonly স্কোপ ব্যবহার করার পরামর্শ দিই।

ব্যাপ্তি অনুমতিসমূহ
https://www.googleapis.com/auth/admanager Google বিজ্ঞাপন ম্যানেজারে আপনার প্রচারণাগুলি দেখুন এবং পরিচালনা করুন।
https://www.googleapis.com/auth/admanager.readonly Google বিজ্ঞাপন ম্যানেজারে আপনার প্রচারাভিযান এবং ডেটা দেখুন।