শুরু হচ্ছে

আমরা Apache Maven (বা Gradle) এর সাথে ক্লায়েন্ট লাইব্রেরি ব্যবহার করার পরামর্শ দিই।

একটি নতুন Maven/Gradle প্রকল্প তৈরি করুন

আপনার পছন্দের IDE-তে একটি নতুন Maven/Gradle প্রকল্প তৈরি করুন। আমাদের শিল্পকর্মগুলি মাভেন কেন্দ্রীয় ভান্ডারে প্রকাশিত হয়।

Maven নির্ভরতা হল:

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>31.0.0</version>
</dependency>

গ্রেডেল নির্ভরতা হল:

implementation 'com.google.api-ads:google-ads:31.0.0'

আপনি উত্স থেকেও তৈরি করতে পারেন। এই নির্দেশিকাটির উদ্দেশ্যে, এটা ধরে নেওয়া হয় যে আপনার কাছে প্রয়োজনীয় নির্ভরশীলতার সাথে একটি প্রকল্প সেটআপ আছে।

API এর সাথে প্রমাণীকরণের জন্য শংসাপত্র প্রাপ্ত করুন

Google Ads API-এ অ্যাক্সেসের জন্য OAuth শংসাপত্র এবং একটি Google বিজ্ঞাপন API ডেভেলপার টোকেন প্রয়োজন। এই বিভাগটি ব্যাখ্যা করে যে এগুলি কী, কীভাবে সেগুলি ব্যবহার করা হয় এবং কীভাবে সেগুলি পাওয়া যায়৷

বিকাশকারী টোকেন (এপিআই অ্যাক্সেসের জন্য)

ডেভেলপার টোকেনটি একটি ম্যানেজার অ্যাকাউন্টের সাথে লিঙ্ক করা আছে এবং এটি Google Ads ওয়েব ইন্টারফেসে পাওয়া যাবে।

যদিও বিকাশকারী টোকেনটি একটি ম্যানেজার অ্যাকাউন্টের সাথে লিঙ্ক করা হয়েছে, এটি সেই অ্যাকাউন্টে অ্যাক্সেস প্রদান করে না। পরিবর্তে, বিকাশকারী টোকেন সাধারণভাবে API-তে অ্যাক্সেস মঞ্জুর করে এবং অ্যাকাউন্ট স্তরের অ্যাক্সেস OAuth এর মাধ্যমে কনফিগার করা হয়।

OAuth শংসাপত্র (Google বিজ্ঞাপন অ্যাকাউন্ট অ্যাক্সেসের জন্য)

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

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

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

যদি Google Ads গ্রাহক অ্যাকাউন্টে আপনার অ্যাক্সেস একটি Google Ads ম্যানেজার অ্যাকাউন্টের মাধ্যমে হয়, তাহলে আপনাকে অবশ্যই নীচে বর্ণিত একটি লগইন গ্রাহক আইডি উল্লেখ করতে হবে।

লগইন গ্রাহক আইডি (একটি ম্যানেজার অ্যাকাউন্টের মাধ্যমে Google বিজ্ঞাপন অ্যাকাউন্ট অ্যাক্সেসের জন্য)

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

আপনার শংসাপত্রের সাথে ক্লায়েন্ট লাইব্রেরি কনফিগার করুন

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

নিম্নলিখিত সামগ্রী সহ একটি ফাইল ~/ads.properties তৈরি করুন:

api.googleads.clientId=INSERT_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE

পূর্ববর্তী ধাপে প্রাপ্ত আপনার শংসাপত্রগুলির সাথে স্থানধারকগুলিকে প্রতিস্থাপন করুন৷

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

api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

শংসাপত্রগুলি যাচাই করুন

সবকিছু সঠিকভাবে সেটআপ করা হয়েছে তা নিশ্চিত করতে, আমরা GetCampaigns উদাহরণটি চালাব।

প্রথমে, google-ads-examples ডিরেক্টরিতে নেভিগেট করুন।

$ cd google-ads-examples

এই উদাহরণের জন্য একটি --customerId প্যারামিটার প্রয়োজন যেখানে মানটি ড্যাশ ছাড়াই আপনার Google Ads অ্যাকাউন্টের গ্রাহক আইডি।

Gradle এর সাথে চালানোর জন্য:

$ ./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"

অন্যান্য উদাহরণ অন্বেষণ

google-ads-examples উদাহরণ প্যাকেজে বেশ কিছু দরকারী উদাহরণ রয়েছে। বেশিরভাগ উদাহরণের জন্য পরামিতি প্রয়োজন। আপনি হয় প্যারামিটারগুলিকে আর্গুমেন্ট হিসাবে পাস করতে পারেন (প্রস্তাবিত) অথবা উৎস কোডে INSERT_XXXXX_HERE মানগুলি সম্পাদনা করতে পারেন৷ একটি উদাহরণের জন্য একটি ব্যবহার বিবৃতি দেখতে, একমাত্র যুক্তি হিসাবে --help পাস করুন।

গ্রেডলের সাথে:

$ ./gradlew -q runExample --example="basicoperations.GetCampaigns --help"

এছাড়াও আপনি Gradle-এ listExamples টাস্ক ব্যবহার করতে পারেন সমস্ত উদাহরণ তালিকাভুক্ত করতে, একটি সাবডিরেক্টরিতে উদাহরণ, অথবা উদাহরণ যেখানে বিবরণ একটি অনুসন্ধান শব্দ অন্তর্ভুক্ত করে।

# List all examples:
$ ./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
$ ./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
$ ./gradlew -q listExamples --searchTerm='Performance Max'