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

অন্যান্য 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 বিজ্ঞাপন অ্যাকাউন্ট পরিচালনা করার জন্য পরিষেবা অ্যাকাউন্টের শংসাপত্র ব্যবহার করতে পারে। লাইব্রেরিটি নিম্নরূপ কনফিগার করা হয়েছে:

// Initialize a GoogleAdsConfig class.
GoogleAdsConfig config = new GoogleAdsConfig()
{
    DeveloperToken = "******",
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "PATH_TO_CREDENTIALS_JSON",
    LoginCustomerId = ******
};

// Initialize a GoogleAdsClient class.
GoogleAdsClient client = new GoogleAdsClient(config);

আরও জানতে পরিষেবা অ্যাকাউন্ট ওয়ার্কফ্লো নির্দেশিকাটি দেখুন।

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

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

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

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

GoogleAdsConfig googleAdsConfig = new GoogleAdsConfig()
{
    DeveloperToken = DEVELOPER_TOKEN,
    LoginCustomerId = LOGIN_CUSTOMER_ID,
    OAuth2ClientId = OAUTH_CLIENT_ID,
    OAuth2ClientSecret = OAUTH_CLIENT_SECRET,
    OAuth2RefreshToken = REFRESH_TOKEN,
};

GoogleAdsClient googleAdsClient = new GoogleAdsClient(googleAdsConfig);

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

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

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

GoogleAdsConfig googleAdsConfig = new GoogleAdsConfig()
{
    DeveloperToken = DEVELOPER_TOKEN,
    LoginCustomerId = LOGIN_CUSTOMER_ID,
    OAuth2ClientId = OAUTH_CLIENT_ID,
    OAuth2ClientSecret = OAUTH_CLIENT_SECRET,
    OAuth2RefreshToken = REFRESH_TOKEN,
};

GoogleAdsClient googleAdsClient = new GoogleAdsClient(googleAdsConfig);

আরও জানতে মাল্টি-ইউজার অথেনটিকেশন ওয়ার্কফ্লো গাইডটি দেখুন। .NET ক্লায়েন্ট লাইব্রেরিতে রেফারেন্সের জন্য দুটি কোড উদাহরণ রয়েছে:

1. AuthenticateInAspNetCoreApplication কোড উদাহরণটি ব্যাখ্যা করে যে কীভাবে একটি ওয়েব অ্যাপ তৈরি করতে হয় যা রানটাইমের সময় ব্যবহারকারীর প্রমাণীকরণ গ্রহণ করে তাদের পক্ষে তাদের Google বিজ্ঞাপন অ্যাকাউন্ট পরিচালনা করে। অ্যাপটি ব্যবহারকারীর OAuth 2.0 শংসাপত্র ব্যবহার করে তাদের Google বিজ্ঞাপন অ্যাকাউন্টে প্রচারণাগুলি পুনরুদ্ধার করে।

2. GenerateUserCredentials হল একটি কমান্ড লাইন কোড উদাহরণ যা রানটাইমে ব্যবহারকারীর প্রমাণীকরণ কীভাবে তাদের পক্ষে তাদের Google বিজ্ঞাপন অ্যাকাউন্ট পরিচালনা করতে হয় তা দেখায়। আপনি এই কোড উদাহরণটি এমন ডেস্কটপ অ্যাপ তৈরি করতে রেফারেন্স হিসাবে ব্যবহার করতে পারেন যার জন্য ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন।

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

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

1. GetAccountHierarchy কোডের উদাহরণটি দেখায় কিভাবে একটি Google Ads ম্যানেজার অ্যাকাউন্টের অধীনে থাকা সমস্ত অ্যাকাউন্টের তালিকা পুনরুদ্ধার করতে হয়।
2. ListAccessibleCustomers কোড উদাহরণটি দেখায় যে কীভাবে একজন ব্যবহারকারীর সরাসরি অ্যাক্সেস আছে এমন সমস্ত অ্যাকাউন্টের তালিকা পুনরুদ্ধার করা যায়। এই অ্যাকাউন্টগুলি LoginCustomerId সেটিং এর জন্য বৈধ মান হিসাবে ব্যবহার করা যেতে পারে।

অ্যাপ্লিকেশনের ডিফল্ট শংসাপত্র

.NET ক্লায়েন্ট লাইব্রেরি অ্যাপ্লিকেশন ডিফল্ট শংসাপত্রের সাহায্যে প্রমাণীকরণ সমর্থন করে।

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

Google Ads API-এর জন্য, নিশ্চিত করুন যে আপনার অ্যাপ্লিকেশনের ডিফল্ট ক্রেডেনশিয়ালগুলি https://www.googleapis.com/auth/adwords OAuth2.0 স্কোপ অ্যাক্সেস করতে পারে।

অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল ব্যবহার করতে, আপনার GoogleAdsConfig এ UseApplicationDefaultCredentials বিকল্পটিকে true তে সেট করুন: এটি ক্লায়েন্ট লাইব্রেরিতে অন্যান্য কনফিগারেশন বৈশিষ্ট্য সেট করার মতো একইভাবে করা যেতে পারে, তাই আপনার কোডে, একটি কনফিগারেশন ফাইলে অথবা পরিবেশ ভেরিয়েবল ব্যবহার করে।

.NET ক্লায়েন্ট লাইব্রেরি কনফিগার করার জন্য উপলব্ধ বিকল্পগুলি সম্পর্কে আরও তথ্যের জন্য কনফিগারেশন পৃষ্ঠাটি দেখুন।