এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

প্রমাণীকরণ এবং অনুমোদন

অন্যান্য Google API-এর মতো, Google Ads API প্রমাণীকরণ এবং অনুমোদনের জন্য OAuth 2.0 প্রোটোকল ব্যবহার করে। OAuth 2.0 আপনার Google Ads API ক্লায়েন্ট অ্যাপকে ব্যবহারকারীর লগইন তথ্য পরিচালনা বা সংরক্ষণ না করেই একজন ব্যবহারকারীর Google Ads অ্যাকাউন্ট অ্যাক্সেস করতে সক্ষম করে।

গুগল বিজ্ঞাপন অ্যাক্সেস মডেলটি বুঝুন

Google Ads API-এর সাথে কার্যকরভাবে কাজ করার জন্য, আপনার Google Ads অ্যাক্সেস মডেল কীভাবে কাজ করে তা বুঝতে হবে। আমরা আপনাকে Google Ads অ্যাক্সেস মডেল নির্দেশিকাটি পড়ার পরামর্শ দিচ্ছি।

OAuth ওয়ার্কফ্লো

Google Ads API-এর সাথে কাজ করার সময় তিনটি সাধারণ ওয়ার্কফ্লো ব্যবহার করা হয়।

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

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

Perl ক্লায়েন্ট লাইব্রেরিতে একটি পরিষেবা অ্যাকাউন্টের মাধ্যমে আপনার নিজস্ব শংসাপত্র ব্যবহার করে API অ্যাক্সেসের জন্য OAuth2 কীভাবে সেট আপ করবেন তা এখানে দেওয়া হল:

OAuth2 শংসাপত্র তৈরি করুন:
একটি পরিষেবা অ্যাকাউন্ট এবং একটি *.JSON ফাইল তৈরি করতে নির্দেশাবলী অনুসরণ করুন।
ক্লায়েন্ট লাইব্রেরি সেট আপ করুন:
আপনার কনফিগারেশনে প্রাইভেট কী JSON পাথ সেট করুন। যদি আপনি googleads.properties ফাইল ব্যবহার করেন, তাহলে নিম্নলিখিতগুলি যোগ করুন:
```
jsonKeyFilePath=PRIVATE_KEY_FILE_PATH
```
যদি আপনি পরিবেশ ভেরিয়েবল ব্যবহার করেন, তাহলে আপনার Bash কনফিগারেশন বা পরিবেশে নিম্নলিখিতগুলি যোগ করুন:
```
export GOOGLE_ADS_JSON_KEY_FILE_PATH=PRIVATE_KEY_FILE_PATH
```
মূল বিষয়: কনফিগারেশন লোড করার সময়, লাইব্রেরি প্রথমে OAuth2 ডেস্কটপ বা ওয়েব অ্যাপ ফ্লো থেকে ক্রেডেনশিয়াল খোঁজে, এবং যদি পাওয়া যায় তাহলে সেগুলো ব্যবহার করে। সুতরাং, যদি আপনি প্রমাণীকরণের জন্য একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করতে চান, তাহলে নিশ্চিত করুন যে অন্যান্য ফ্লোগুলির ক্রেডেনশিয়াল আপনার কনফিগারেশনে উপস্থিত নেই ।
আরও জানতে পরিষেবা অ্যাকাউন্ট ওয়ার্কফ্লো নির্দেশিকাটি দেখুন।

একক-ব্যবহারকারী প্রমাণীকরণ প্রবাহ

যদি আপনি পরিষেবা অ্যাকাউন্ট ব্যবহার করতে না পারেন তবে এই ওয়ার্কফ্লো ব্যবহার করা যেতে পারে। এই ওয়ার্কফ্লোটির জন্য দুটি কনফিগারেশন ধাপ প্রয়োজন:

Google Ads API ব্যবহার করে পরিচালিত সমস্ত অ্যাকাউন্টে একজন ব্যবহারকারীকে অ্যাক্সেস দিন। একটি সাধারণ পদ্ধতি হল ব্যবহারকারীকে একটি Google Ads API ম্যানেজার অ্যাকাউন্টে অ্যাক্সেস দেওয়া এবং সেই ম্যানেজার অ্যাকাউন্টের অধীনে সমস্ত Google Ads অ্যাকাউন্ট লিঙ্ক করা।
ব্যবহারকারী generate_user_credentials.pl কোড উদাহরণটি চালান যাতে আপনার অ্যাপ তাদের পক্ষ থেকে তাদের সমস্ত Google বিজ্ঞাপন অ্যাকাউন্ট পরিচালনা করতে পারে।

নিম্নলিখিত ধাপগুলি একটি ইন্টারেক্টিভ কোড উদাহরণ চালায়, যার পরে আপনাকে ইনপুট প্রদান করতে হবে।

টার্মিনালে, examples ডিরেক্টরিতে generate_user_credentials.pl উদাহরণটি চালান। আপনি চালানোর আগে উদাহরণে INSERT_XXX_HERE মানগুলি পরিবর্তন করতে পারেন অথবা client ID এর জন্য -client_id এবং client secret এর জন্য -client_secret কমান্ড-লাইন আর্গুমেন্ট ব্যবহার করতে পারেন।
```
perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}
```
এই কোড উদাহরণটি আপনাকে এমন একটি URL দেখার জন্য অনুরোধ করে যেখানে আপনাকে আপনার পক্ষ থেকে আপনার Google বিজ্ঞাপন অ্যাকাউন্ট অ্যাক্সেস করার জন্য অ্যাপটিকে অনুমোদন করতে হবে।
```
Paste this url in your browser:
https://accounts.google.com/o/oauth2/v2/auth?response_type=code&access_type=offline&client_id=...
```
একটি ব্যক্তিগত ব্রাউজার সেশন বা একটি ছদ্মবেশী উইন্ডোতে URL-এ নেভিগেট করুন। Google Ads অ্যাক্সেস করার জন্য আপনি যে Google অ্যাকাউন্ট ব্যবহার করেন তা দিয়ে সাইন ইন করুন। সাধারণত, এটি এমন একটি ইমেল অ্যাকাউন্ট যার একটি Google Ads ম্যানেজার অ্যাকাউন্টে অ্যাক্সেস থাকে যার অ্যাকাউন্টের অনুক্রমের মধ্যে আপনার পরিচালনা করার জন্য প্রয়োজনীয় সমস্ত অ্যাকাউন্ট থাকে। OAuth 2.0 সম্মতি স্ক্রিনে " চালিয়ে যান " এ ক্লিক করুন।
আপনাকে একটি পৃষ্ঠায় পুনঃনির্দেশিত করা হবে যেখানে একটি বার্তা থাকবে যে অনুমোদন সফল হয়েছে।
```
Authorization code was successfully retrieved.
```
আপনি যে কনসোলে কোড উদাহরণটি চালাচ্ছেন সেখানে ফিরে যান। আপনি দেখতে পাবেন যে কোড উদাহরণটি সম্পন্ন হয়েছে এবং আপনার রিফ্রেশ টোকেন এবং কিছু নির্দেশাবলী প্রদর্শন করছে, তারপরে ক্লায়েন্ট লাইব্রেরি কনফিগার করার জন্য আপনাকে যে নির্দেশাবলী অনুসরণ করতে হবে তা অনুসরণ করুন:
```
Replace the following keys and values in your googleads.properties configuration file:

clientId==***********************apps.googleusercontent.com
clientSecret=****
refreshToken=****
```
প্রক্রিয়াটি শেষ করতে Ctrl + C টিপুন। তারপর জেনারেট করা রিফ্রেশ টোকেনটি ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট সহ আপনার googleads.properties ফাইলে কপি করুন অথবা রানটাইমের সময় লাইব্রেরিটি ইন্সট্যান্ট করার সময় ব্যবহার করার জন্য অন্য কোথাও সংরক্ষণ করুন।

googleads.properties এ নিম্নলিখিত সেট করে ব্যবহারকারীর OAuth 2.0 শংসাপত্র ব্যবহার করে লাইব্রেরিটি শুরু করা যেতে পারে:

clientId=OAUTH_CLIENT_ID
clientSecret=OAUTH_CLIENT_SECRET
refreshToken=REFRESH_TOKEN
developerToken=DEVELOPER_TOKEN
loginCustomerId=LOGIN_CUSTOMER_ID

বিকল্পভাবে, পরিবেশগত পরিবর্তনশীল ব্যবহার করুন:

export GOOGLE_ADS_CLIENT_ID=OAUTH_CLIENT_ID
export GOOGLE_ADS_CLIENT_SECRET=OAUTH_CLIENT_SECRET
export GOOGLE_ADS_REFRESH_TOKEN=REFRESH_TOKEN
export GOOGLE_ADS_DEVELOPER_TOKEN=DEVELOPER_TOKEN
export GOOGLE_ADS_LOGIN_CUSTOMER_ID=LOGIN_CUSTOMER_ID

আরও জানতে একক-ব্যবহারকারী প্রমাণীকরণ কর্মপ্রবাহ নির্দেশিকাটি দেখুন।

একাধিক ব্যবহারকারীর প্রমাণীকরণ প্রবাহ

যদি আপনার অ্যাপ ব্যবহারকারীদের সাইন ইন করতে এবং তাদের পক্ষ থেকে তাদের Google বিজ্ঞাপন অ্যাকাউন্ট পরিচালনা করার জন্য আপনার অ্যাপকে অনুমোদন দেয়, তাহলে এটিই প্রস্তাবিত কর্মপ্রবাহ। আপনার অ্যাপ OAuth 2.0 ব্যবহারকারীর শংসাপত্র তৈরি এবং পরিচালনা করে।

Perl-এর জন্য, আপনি সাধারণত একটি ওয়েব অ্যাপ্লিকেশন ফ্লো বাস্তবায়ন করবেন যেখানে আপনার অ্যাপ্লিকেশন OAuth 2.0 পুনঃনির্দেশ এবং টোকেন ব্যবস্থাপনা পরিচালনা করে। ব্যবহারকারী আপনার অ্যাপ্লিকেশনের মাধ্যমে প্রমাণীকরণ করে এবং আপনার অ্যাপ্লিকেশন ব্যবহারকারীর রিফ্রেশ টোকেন সংরক্ষণ করে এবং তাদের পক্ষ থেকে API কল করে।

প্রাপ্ত শংসাপত্রগুলি ব্যবহারের জন্য কনফিগারেশন একক-ব্যবহারকারী প্রমাণীকরণ প্রবাহের মতোই:

clientId=OAUTH_CLIENT_ID
clientSecret=OAUTH_CLIENT_SECRET
refreshToken=REFRESH_TOKEN
developerToken=DEVELOPER_TOKEN
loginCustomerId=LOGIN_CUSTOMER_ID

বিকল্পভাবে, পরিবেশ ভেরিয়েবল ব্যবহার করুন:

export GOOGLE_ADS_CLIENT_ID=OAUTH_CLIENT_ID
export GOOGLE_ADS_CLIENT_SECRET=OAUTH_CLIENT_SECRET
export GOOGLE_ADS_REFRESH_TOKEN=REFRESH_TOKEN
export GOOGLE_ADS_DEVELOPER_TOKEN=DEVELOPER_TOKEN
export GOOGLE_ADS_LOGIN_CUSTOMER_ID=LOGIN_CUSTOMER_ID

আরও জানতে মাল্টি-ইউজার অথেনটিকেশন ওয়ার্কফ্লো গাইডটি দেখুন।

যদি আমার ব্যবহারকারী একাধিক অ্যাকাউন্ট পরিচালনা করে?

একজন ব্যবহারকারীর পক্ষে একাধিক Google Ads অ্যাকাউন্ট পরিচালনা করা সাধারণ, হয় সরাসরি অ্যাকাউন্ট অ্যাক্সেসের মাধ্যমে, অথবা একটি Google Ads ম্যানেজার অ্যাকাউন্টের মাধ্যমে। Perl ক্লায়েন্ট লাইব্রেরি এমন উদাহরণ প্রদান করে যা এই ধরনের ঘটনাগুলি কীভাবে পরিচালনা করতে হয় তা ব্যাখ্যা করে।

get_account_hierarchy.pl উদাহরণটি দেখায় কিভাবে একটি Google Ads ম্যানেজার অ্যাকাউন্টের অধীনে থাকা সমস্ত অ্যাকাউন্টের তালিকা পুনরুদ্ধার করতে হয়।
list_accessible_customers.pl উদাহরণটি দেখায় যে কীভাবে একজন ব্যবহারকারীর সরাসরি অ্যাক্সেস আছে এমন সমস্ত অ্যাকাউন্টের তালিকা পুনরুদ্ধার করা যায়। এই অ্যাকাউন্টগুলি googleads.properties ফাইলে LoginCustomerId সেটিং বা GOOGLE_ADS_LOGIN_CUSTOMER_ID পরিবেশ ভেরিয়েবলের জন্য বৈধ মান হিসাবে ব্যবহার করা যেতে পারে।