অন্যান্য Google API-এর মতো, Google Ads API প্রমাণীকরণ এবং অনুমোদনের জন্য OAuth 2.0 প্রোটোকল ব্যবহার করে। OAuth 2.0 আপনার Google Ads API ক্লায়েন্ট অ্যাপকে ব্যবহারকারীর লগইন তথ্য পরিচালনা বা সংরক্ষণ না করেই ব্যবহারকারীর Google Ads অ্যাকাউন্ট অ্যাক্সেস করতে সক্ষম করে।
Google বিজ্ঞাপন অ্যাক্সেস মডেল বুঝুন
Google Ads API-এর সাথে কার্যকরভাবে কাজ করার জন্য, Google Ads অ্যাক্সেস মডেল কীভাবে কাজ করে তা আপনাকে বুঝতে হবে। আমরা দৃঢ়ভাবে Google বিজ্ঞাপন অ্যাক্সেস মডেল গাইড পড়ার পরামর্শ দিই।
OAuth কার্যপ্রবাহ
Google Ads API-এর সাথে কাজ করার সময় তিনটি সাধারণ ওয়ার্কফ্লো ব্যবহার করা হয়।
পরিষেবা অ্যাকাউন্ট প্রবাহ
আপনার ওয়ার্কফ্লোতে কোনো মানুষের মিথস্ক্রিয়া প্রয়োজন না হলে এটি প্রস্তাবিত ওয়ার্কফ্লো। এই ওয়ার্কফ্লোটির জন্য একটি কনফিগারেশন ধাপ প্রয়োজন, যেখানে ব্যবহারকারী তাদের Google Ads অ্যাকাউন্টে একটি পরিষেবা অ্যাকাউন্ট যোগ করে। অ্যাপটি তারপর ব্যবহারকারীর 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);
আরও জানতে পরিষেবা অ্যাকাউন্ট ওয়ার্কফ্লো গাইড পড়ুন।
একক-ব্যবহারকারী প্রমাণীকরণ প্রবাহ
আপনি পরিষেবা অ্যাকাউন্ট ব্যবহার করতে না পারলে এই কর্মপ্রবাহ ব্যবহার করা হতে পারে। এই কর্মপ্রবাহের জন্য দুটি কনফিগারেশন পদক্ষেপ প্রয়োজন:
- Google Ads API ব্যবহার করে পরিচালনা করা সমস্ত অ্যাকাউন্টে একজন একক ব্যবহারকারীকে অ্যাক্সেস দিন। একটি সাধারণ পদ্ধতি হল ব্যবহারকারীকে Google Ads API ম্যানেজার অ্যাকাউন্টে দেওয়া এবং সেই ম্যানেজার অ্যাকাউন্টের অধীনে সমস্ত Google Ads অ্যাকাউন্ট লিঙ্ক করা।
- ব্যবহারকারী একটি টুল চালান যেমন gcloud CLI বা
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 ক্লায়েন্ট লাইব্রেরিতে রেফারেন্সের জন্য দুটি কোড উদাহরণ রয়েছে:
AuthenticateInAspNetCoreApplication
কোডের উদাহরণটি ব্যাখ্যা করে যে কীভাবে একটি ওয়েব অ্যাপ তৈরি করতে হয় যা রানটাইমে ব্যবহারকারীর প্রমাণীকরণ পায় তাদের পক্ষে তাদের Google বিজ্ঞাপন অ্যাকাউন্ট পরিচালনা করতে। অ্যাপটি ব্যবহারকারীর OAuth 2.0 শংসাপত্র ব্যবহার করে তাদের Google বিজ্ঞাপন অ্যাকাউন্টে প্রচারণা পুনরুদ্ধার করে।GenerateUserCredentials হল একটি কমান্ড লাইন কোডের উদাহরণ যেটি ব্যাখ্যা করে কিভাবে রানটাইমে ব্যবহারকারীর প্রমাণীকরণ পেতে হয় তাদের পক্ষে তাদের Google Ads অ্যাকাউন্ট পরিচালনা করতে। ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন হয় এমন ডেস্কটপ অ্যাপ তৈরি করতে আপনি এই কোডের উদাহরণটি রেফারেন্স হিসেবে ব্যবহার করতে পারেন।
আমার ব্যবহারকারী একাধিক অ্যাকাউন্ট পরিচালনা করলে কি হবে?
একজন ব্যবহারকারীর পক্ষে একাধিক Google Ads অ্যাকাউন্ট পরিচালনা করা সাধারণ, হয় অ্যাকাউন্টগুলিতে সরাসরি অ্যাক্সেসের মাধ্যমে বা Google Ads ম্যানেজার অ্যাকাউন্টের মাধ্যমে। .NET ক্লায়েন্ট লাইব্রেরি নিম্নলিখিত কোড উদাহরণগুলি প্রদান করে যা এই ধরনের কেসগুলি কীভাবে পরিচালনা করতে হয় তা ব্যাখ্যা করে৷
- GetAccountHierarchy কোডের উদাহরণ দেখায় যে কীভাবে Google Ads ম্যানেজার অ্যাকাউন্টের অধীনে সমস্ত অ্যাকাউন্টের তালিকা পুনরুদ্ধার করতে হয়।
- ListAccessibleCustomers কোডের উদাহরণটি দেখায় কিভাবে একজন ব্যবহারকারীর সরাসরি অ্যাক্সেস আছে এমন সমস্ত অ্যাকাউন্টের তালিকা পুনরুদ্ধার করতে হয়। এই অ্যাকাউন্টগুলি তখন
LoginCustomerId
সেটিংসের জন্য বৈধ মান হিসাবে ব্যবহার করা যেতে পারে।