Authentication

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

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

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

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

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

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

অ্যাড ম্যানেজার এপিআই সক্রিয় করুন

  1. আপনার গুগল এপিআই কনসোল ক্লাউড প্রজেক্টে অ্যাড ম্যানেজার এপিআই সক্রিয় করুন।

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

পরিচয়পত্র তৈরি করুন

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

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

গুগল ক্লাউডে

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

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

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

নিজস্ব প্রাঙ্গণে অথবা অন্য কোনো ক্লাউড প্রোভাইডারে

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

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

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

  2. ক্রেডেনশিয়ালস পেজে, ' ক্রিয়েট ক্রেডেনশিয়ালস' নির্বাচন করুন, তারপর 'সার্ভিস অ্যাকাউন্ট' নির্বাচন করুন।

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

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

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

  6. Key type হিসেবে JSON নির্বাচন করুন এবং Create-এ ক্লিক করুন।

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

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

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

উইন্ডোজ 

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

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

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

  2. অনুরোধ করা হলে, সেই প্রজেক্টটি নির্বাচন করুন যেখানে আপনি অ্যাড ম্যানেজার এপিআই (Ad Manager API) সক্রিয় করেছেন।

  3. ক্রেডেনশিয়ালস পেজে, 'Create credentials' নির্বাচন করুন, তারপর 'OAuth client ID' নির্বাচন করুন।

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

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

  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 এনভায়রনমেন্ট ভেরিয়েবলটি সেট করে একটি সার্ভিস অ্যাকাউন্ট হিসেবে প্রমাণীকরণ করুন।

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

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

উইন্ডোজ 

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

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

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

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

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

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

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

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

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

আপনি ক্লায়েন্ট লাইব্রেরি ব্যবহার না করলেও, আমরা প্রমাণীকরণের জন্য একটি OAuth2 লাইব্রেরি ব্যবহার করার জন্য দৃঢ়ভাবে সুপারিশ করি।

অ্যাক্সেস টোকেন পাওয়ার বিস্তারিত নির্দেশাবলীর জন্য, “Using OAuth2 with Google APIs” দেখুন।

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

এপিআই-তে অনুরোধ করার সময় আপনার অ্যাক্সেস টোকেনটি অন্তর্ভুক্ত করতে, হয় একটি 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

পরিধি

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

পরিধি অনুমতি
https://www.googleapis.com/auth/admanager গুগল অ্যাড ম্যানেজারে আপনার ক্যাম্পেইনগুলো দেখুন ও পরিচালনা করুন।
https://www.googleapis.com/auth/admanager.readonly গুগল অ্যাড ম্যানেজারে আপনার ক্যাম্পেইন ও ডেটা দেখুন।