Authentication

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

Ad Manager API স্কোপের সাথে অ্যাক্সেস টোকেন জেনারেট করতে Ad Manager ক্লায়েন্ট লাইব্রেরি অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল ব্যবহার করে। এই নির্দেশিকা দেখায় কীভাবে অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র কনফিগার করতে হয়।

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

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

আপনার যাচাইকরণের ধরন নির্ধারণ করা

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

Ad Manager API চালু করুন

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

  2. প্রম্পট করা হলে, কোনও প্রোজেক্ট বেছে নিন অথবা নতুন একটি তৈরি করুন।

ক্রেডেনশিয়াল তৈরি করুন

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

সার্ভিস অ্যাকাউন্ট

Google Cloud-এ

Google Cloud-এ চলা কোনও ওয়ার্কলোড যাচাই করতে, আপনার কোড যেখানে চলছে সেই কম্পিউট রিসোর্সের সাথে অ্যাটাচ করা পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল ব্যবহার করেন।

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

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

অন-প্রিমিসেস বা অন্য কোনও ক্লাউড পরিষেবা প্রদানকারীতে

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

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

  1. Google API Console ক্রেডেনশিয়াল পৃষ্ঠা খুলুন।

  2. 'ক্রেডেনশিয়াল' পৃষ্ঠায়, ক্রেডেনশিয়াল তৈরি করুন বিকল্প বেছে নিন, তারপর পরিষেবা অ্যাকাউন্ট বিকল্প বেছে নিন।

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

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

  5. কী যোগ করুন ড্রপ-ডাউন মেনুতে ক্লিক করে নতুন কী তৈরি করুন বিকল্প বেছে নিন।

  6. কী-এর ধরন হিসেবে JSON বেছে নিন এবং তৈরি করুন বিকল্পে ক্লিক করুন।

  7. JSON ফাইলের পাথে এনভায়রনমেন্ট ভেরিয়েবেল GOOGLE_APPLICATION_CREDENTIALS সেট করুন।

Linux বা macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

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

  1. Google API Console ক্রেডেনশিয়াল পৃষ্ঠা খুলুন।

  2. প্রম্পট করা হলে, যে প্রোজেক্টে Ad Manager API চালু করেছেন সেটি বেছে নিন।

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

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

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

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

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

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

আপনার লোকাল এনভায়রনমেন্টে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) সেট-আপ করুন।

Google Cloud CLI ইনস্টল করুন, তারপর নিম্নলিখিত কমান্ড রান করে এটি শুরু করুন:

gcloud init

আপনার Google অ্যাকাউন্টের জন্য স্থানীয় যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল তৈরি করুন এবং Ad Manager 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 সেট করে পরিষেবা অ্যাকাউন্ট হিসেবে যাচাই করুন।

Linux বা macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

আপনার Ad Manager নেটওয়ার্ক কনফিগার করুন

সার্ভিস অ্যাকাউন্ট

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

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

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

স্থানীয় ডেভেলপমেন্ট

  1. আপনার Ad Manager নেটওয়ার্কে যান।
  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

সুযোগ

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

সুযোগ অনুমতি
https://www.googleapis.com/auth/admanager Google Ad Manager-এ আপনার ক্যাম্পেন দেখুন এবং ম্যানেজ করুন।
https://www.googleapis.com/auth/admanager.readonly Google Ad Manager-এ আপনার ক্যাম্পেন ও ডেটা দেখুন।