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

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

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

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

ডিপেন্ডেন্সি ভার্সন ম্যানেজ করতে 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 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'