Authentication

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

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

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

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

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

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

অ্যাড ম্যানেজার API সক্ষম করুন

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

  2. অনুরোধ করা হলে, একটি প্রকল্প নির্বাচন করুন, বা একটি নতুন তৈরি করুন৷

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

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

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

গুগল ক্লাউডে

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

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

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

প্রাঙ্গনে বা একটি ভিন্ন ক্লাউড প্রদানকারীতে

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

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

  1. Google API কনসোল শংসাপত্র পৃষ্ঠা খুলুন।

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

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

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

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

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

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

লিনাক্স বা ম্যাকোস 

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

উইন্ডোজ 

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

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

  1. Google API কনসোল শংসাপত্র পৃষ্ঠা খুলুন।

  2. প্রম্পট করা হলে, আপনি যে প্রজেক্টে অ্যাড ম্যানেজার এপিআই চালু করেছেন সেটি বেছে নিন।

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

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

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

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

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

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

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

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

gcloud init

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

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 ব্যবহার করা দেখুন।

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

একটি access_token ক্যোয়ারী প্যারামিটার বা একটি Authorization HTTP শিরোনাম Bearer মান অন্তর্ভুক্ত করে API-তে একটি অনুরোধে আপনার অ্যাক্সেস টোকেন অন্তর্ভুক্ত করুন। যখন সম্ভব, 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

ব্যাপ্তি

প্রতিটি অ্যাক্সেস টোকেন এক বা একাধিক স্কোপের সাথে যুক্ত। একটি স্কোপ সম্পদ এবং ক্রিয়াকলাপগুলির সেট নিয়ন্ত্রণ করে যা একটি অ্যাক্সেস টোকেন অনুমতি দেয়। অ্যাড ম্যানেজার REST API-এর শুধুমাত্র একটি সুযোগ রয়েছে। অনুমোদন পণ্যের মধ্যে ব্যবহারকারী স্তরে সঞ্চালিত করা উচিত.

ব্যাপ্তি অনুমতি
https://www.googleapis.com/auth/admanager গুগল অ্যাড ম্যানেজারে আপনার প্রচারগুলি দেখুন এবং পরিচালনা করুন৷