মৌলিক ব্যবহার

জাভা ক্লায়েন্ট লাইব্রেরির মৌলিক ব্যবহার নিম্নরূপ:

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

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

ডিপেন্ডেন্সি ভার্সনগুলো পরিচালনা করতে গুগল অ্যাডস এপিআই বিল অফ মেটেরিয়ালস (BOM) ব্যবহার করুন।

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

এপিআই অ্যাক্সেস কনফিগার করুন

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

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

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

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

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

cd google-ads-examples

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

গ্রেডল দিয়ে চালানোর জন্য:

./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 পাস করুন।

গ্রেডল সহ:

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