জাভা ক্লায়েন্ট লাইব্রেরির মৌলিক ব্যবহার নিম্নরূপ:
একটি নতুন Maven বা Gradle প্রজেক্ট তৈরি করুন
আপনার পছন্দের IDE-তে একটি নতুন Maven বা Gradle প্রজেক্ট তৈরি করুন। আমাদের আর্টিফ্যাক্টগুলো Maven সেন্ট্রাল রিপোজিটরিতে প্রকাশিত হয়।
ডিপেন্ডেন্সি ভার্সনগুলো পরিচালনা করার জন্য আমরা গুগল অ্যাডস এপিআই-এর বিল অফ মেটেরিয়ালস (BOM) ব্যবহার করার পরামর্শ দিই।
আপনি সোর্স থেকেও বিল্ড করতে পারেন। এই নির্দেশিকার জন্য, ধরে নেওয়া হচ্ছে যে আপনার একটি প্রজেক্ট সেটআপ করা আছে এবং সেখানে প্রয়োজনীয় ডিপেন্ডেন্সিগুলো উপলব্ধ রয়েছে।
আপনি যদি সোর্স থেকে বিল্ড করেন, তাহলে আপনার IDE-তে অ্যানোটেশন প্রসেসিং চালু করা আছে কিনা তা নিশ্চিত করুন।
এপিআই অ্যাক্সেস কনফিগার করুন
Google Ads API-এর সাথে সংযোগ করতে, আপনাকে প্রমাণীকরণ এবং অনুমোদন ক্রেডেনশিয়াল প্রদান করতে হবে। প্রয়োজনীয় ক্রেডেনশিয়াল এবং ক্লায়েন্ট লাইব্রেরি কীভাবে কনফিগার করতে হয়, সে সম্পর্কে বিস্তারিত জানতে প্রমাণীকরণ এবং অনুমোদন নির্দেশিকাটি দেখুন।
আপনার প্রথম কলটি করুন
একবার আপনার ক্রেডেনশিয়াল কনফিগার করা হয়ে গেলে, আপনি আপনার প্রথম API কলটি করার জন্য প্রস্তুত।
আপনার পরিচয়পত্র যাচাই করতে এবং প্রথম কলটি করার জন্য, আমরা GetCampaigns উদাহরণটি চালাবো।
প্রথমে, google-ads-examples ডিরেক্টরিতে প্রবেশ করুন।
cd google-ads-examples
এই উদাহরণটির জন্য একটি --customerId প্যারামিটার প্রয়োজন, যেখানে মানটি হবে আপনার গুগল অ্যাডস অ্যাকাউন্টের কাস্টমার আইডি (ড্যাশ ছাড়া)।
গ্রেডল দিয়ে চালানোর জন্য:
./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
অন্যান্য উদাহরণ অন্বেষণ করুন
google-ads-examples এর 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'