আমরা Apache Maven বা Gradle এর সাথে ক্লায়েন্ট লাইব্রেরি ব্যবহার করার পরামর্শ দিই।
একটি নতুন Maven/Gradle প্রকল্প তৈরি করুন
আপনার পছন্দের IDE-তে একটি নতুন Maven বা Gradle প্রকল্প তৈরি করুন। আমাদের শিল্পকর্মগুলি মাভেন কেন্দ্রীয় ভান্ডারে প্রকাশিত হয়।
নির্ভরতা সংস্করণ পরিচালনা করতে আমরা Google Ads API-এর বিল অফ ম্যাটেরিয়ালস (BOM) ব্যবহার করার পরামর্শ দিই। Guava এবং GAX মতো লাইব্রেরির সাথে নির্ভরতা দ্বন্দ্ব এড়াতে এটি সর্বোত্তম উপায় যা অন্যান্য ফ্রেমওয়ার্ক দ্বারা ব্যবহৃত হয়। BOM নিশ্চিত করে যে আপনি এই নির্ভরতাগুলির সঠিক সংস্করণগুলি ব্যবহার করছেন যেগুলি Google Ads ক্লায়েন্ট লাইব্রেরির সাথে পরীক্ষা করা হয়েছে।
Maven নির্ভরতা হল:
<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
versions of all google-ads libraries. -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads-bom</artifactId>
<version>40.0.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<!-- Add the google-ads dependency, without a version. The version is
managed by the BOM. -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
</dependency>
গ্রেডেল নির্ভরতা হল:
// Import the Bill of Materials (BOM).
implementation platform('com.google.api-ads:google-ads-bom:40.0.0')
// Add the google-ads dependency, without a version.
implementation 'com.google.api-ads:google-ads'
আপনি উত্স থেকেও তৈরি করতে পারেন। এই নির্দেশিকাটির উদ্দেশ্যে, এটা ধরে নেওয়া হয় যে আপনার কাছে প্রয়োজনীয় নির্ভরশীলতার সাথে একটি প্রকল্প সেটআপ আছে।
আপনি যদি উৎস থেকে তৈরি করেন, নিশ্চিত করুন যে আপনি আপনার IDE-তে টীকা প্রক্রিয়াকরণ সক্ষম করেছেন।
BOM দ্বারা আচ্ছাদিত নির্ভরতা ঘোষণা করা
Google Ads API BOM-এ Guava , Protobuf , GAX , এবং gRPC মতো বেশ কিছু সাধারণ লাইব্রেরির সংস্করণ ব্যবস্থাপনা অন্তর্ভুক্ত রয়েছে। সম্ভাব্য নির্ভরতা দ্বন্দ্ব এড়াতে, BOM কভার করে এমন নির্ভরতা ঘোষণা করার সময় আপনাকে অবশ্যই একটি সংস্করণ নির্দিষ্ট করতে হবে না । BOM স্বয়ংক্রিয়ভাবে এই লাইব্রেরির সংস্করণগুলি পরিচালনা করে, সামঞ্জস্য নিশ্চিত করে।
উদাহরণস্বরূপ, মাভেনে Guava নির্ভরতা ঘোষণা করতে, নিম্নলিখিতগুলি ব্যবহার করুন:
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<!-- NO VERSION SPECIFIED -->
</dependency>
এবং গ্রেডলে:
implementation 'com.google.guava:guava' // NO VERSION SPECIFIED
সংস্করণ বাদ দিয়ে, আপনি BOM-কে এটি পরিচালনা করতে দেন, যা বেমানান নির্ভরতা সংস্করণগুলির কারণে সৃষ্ট সমস্যাগুলি প্রতিরোধ করতে সহায়তা করে। নির্ভরতা দ্বন্দ্বের সাধারণ সূচকগুলির মধ্যে রয়েছে NoSuchMethodError বা ClassNotFoundException , যা প্রায়শই সমস্ত BOM-পরিচালিত নির্ভরতাগুলির কোনও সংস্করণ নির্দিষ্ট নেই তা নিশ্চিত করে সমাধান করা যেতে পারে।
API এর সাথে প্রমাণীকরণের জন্য শংসাপত্র প্রাপ্ত করুন
Google Ads API-এ অ্যাক্সেসের জন্য OAuth শংসাপত্র এবং একটি Google বিজ্ঞাপন API ডেভেলপার টোকেন প্রয়োজন। এই বিভাগটি ব্যাখ্যা করে যে এগুলি কী, কীভাবে সেগুলি ব্যবহার করা হয় এবং কীভাবে সেগুলি পাওয়া যায়৷
বিকাশকারী টোকেন (এপিআই অ্যাক্সেসের জন্য)
ডেভেলপার টোকেনটি একটি ম্যানেজার অ্যাকাউন্টের সাথে লিঙ্ক করা আছে এবং এটি Google Ads ওয়েব ইন্টারফেসে পাওয়া যাবে।
যদিও বিকাশকারী টোকেনটি একটি ম্যানেজার অ্যাকাউন্টের সাথে লিঙ্ক করা হয়েছে, এটি সেই অ্যাকাউন্টে অ্যাক্সেস প্রদান করে না। পরিবর্তে, বিকাশকারী টোকেন সাধারণভাবে API-তে অ্যাক্সেস মঞ্জুর করে এবং অ্যাকাউন্ট স্তরের অ্যাক্সেস OAuth এর মাধ্যমে কনফিগার করা হয়।
OAuth শংসাপত্র (Google বিজ্ঞাপন অ্যাকাউন্ট অ্যাক্সেসের জন্য)
Google বিজ্ঞাপন অ্যাকাউন্টগুলিতে অ্যাক্সেস সহ Google অ্যাকাউন্ট ব্যবহারকারী হিসাবে অনুমোদন করতে, আপনাকে অবশ্যই OAuth শংসাপত্রের একটি সেট সরবরাহ করতে হবে।
দুটি OAuth ফ্লো আছে যা সাধারণত ব্যবহৃত হয়: ডেস্কটপ (ইনস্টল করা) অ্যাপ বা ওয়েব অ্যাপ। উভয়ের মধ্যে প্রধান পার্থক্য হল যে ডেস্কটপ অ্যাপগুলিকে অবশ্যই সিস্টেম ব্রাউজার খুলতে হবে এবং Google এর অনুমোদন সার্ভার থেকে প্রতিক্রিয়াগুলি পরিচালনা করার জন্য একটি স্থানীয় পুনঃনির্দেশ URI সরবরাহ করতে হবে, যেখানে ওয়েব অ্যাপগুলি অনুমোদন সম্পূর্ণ করতে এবং আপনার সার্ভারে শংসাপত্রগুলি ফেরত পাঠাতে একটি নির্বিচারে তৃতীয় পক্ষের ব্রাউজারকে পুনঃনির্দেশ করতে পারে৷ লাইব্রেরিটি কম ব্যবহৃত পরিষেবা অ্যাকাউন্ট প্রবাহকেও সমর্থন করে।
- আপনি যদি আপনার নিজস্ব শংসাপত্র ব্যবহার করার অনুমতি দেন (ডেস্কটপ অ্যাপ ফ্লো)
- 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'