প্রাথমিক ব্যবহার

Java ক্লায়েন্ট লাইব্রেরির প্রাথমিক ব্যবহার নিচে দেওয়া হল:

নতুন Maven বা Gradle প্রোজেক্ট তৈরি করুন

আপনার পছন্দের IDE-তে নতুন Maven বা Gradle প্রোজেক্ট তৈরি করুন। আর্টিফ্যাক্টগুলি Maven সেন্ট্রাল রিপোজিটরিতে প্রকাশ করা হয়।

ডিপেন্ডেন্সি ভার্সন ম্যানেজ করতে Google Ads API বিল অফ মেটেরিয়াল (BOM) ব্যবহার করুন।

আপনি যদি google-ads-examples মডিউলে অন্তর্ভুক্ত প্রি-প্যাকেজ করা কোডের উদাহরণ রান করতে চান, তাহলে GitHub থেকে google-ads-java রিপোজিটরি ক্লোন করুন অথবা সোর্স থেকে তৈরি করুন। আপনি যদি সোর্স থেকে তৈরি করেন, তাহলে আপনার IDE-তে অ্যানোটেশন প্রসেসিং চালু করেছেন কিনা তা নিশ্চিত করুন।

API অ্যাক্সেস কনফিগার করা

Google Ads API-এর সাথে কানেক্ট করতে, আপনাকে যাচাইকরণ ও অনুমোদনের ক্রেডেনশিয়াল দিতে হবে। প্রয়োজনীয় ক্রেডেনশিয়াল এবং ক্লায়েন্ট লাইব্রেরি কীভাবে কনফিগার করতে হয় সেই সম্পর্কে বিস্তারিত জানতে যাচাইকরণ ও অনুমোদনের নির্দেশিকা দেখুন।

আপনার প্রথম কল করুন

আপনার ক্রেডেনশিয়াল কনফিগার করা হয়ে গেলে, আপনি প্রথম API কল করার জন্য প্রস্তুত।

আপনার ক্রেডেনশিয়াল যাচাই করতে এবং ক্লোন করা google-ads-java রিপোজিটরি ব্যবহার করে আপনার প্রথম কল করতে, GetCampaigns উদাহরণ রান করুন।

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

cd google-ads-examples

এই উদাহরণের জন্য --customerId প্যারামিটার প্রয়োজন যেখানে ভ্যালু হল আপনার Google Ads অ্যাকাউন্ট কাস্টমার আইডি, হাইফেন (-) ছাড়া।

Gradle-এর সাথে রান করতে:

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

Maven-এর সাহায্যে রান করতে:

mvn exec:java \
  -Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
  -Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"

অন্যান্য উদাহরণ এক্সপ্লোর করুন

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

Gradle-এর সাথে:

./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'