শুরু হচ্ছে

আমরা Apache Maven অথবা Gradle এর সাথে ক্লায়েন্ট লাইব্রেরি ব্যবহার করার পরামর্শ দিচ্ছি।

একটি নতুন Maven/Gradle প্রকল্প তৈরি করুন

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

নির্ভরতা ভার্সন পরিচালনা করার জন্য আমরা Google Ads API এর বিল অফ ম্যাটেরিয়ালস (BOM) ব্যবহার করার পরামর্শ দিচ্ছি। এটি Guava এবং GAX এর মতো লাইব্রেরিগুলির সাথে নির্ভরতা দ্বন্দ্ব এড়াতে সর্বোত্তম উপায়, যা অন্যান্য ফ্রেমওয়ার্ক দ্বারাও ব্যবহৃত হয়। BOM নিশ্চিত করে যে আপনি Google Ads ক্লায়েন্ট লাইব্রেরিতে পরীক্ষা করা এই নির্ভরতাগুলির সঠিক সংস্করণগুলি ব্যবহার করছেন।

মাভেন নির্ভরতা হল:

<!-- 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>41.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:41.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 স্বয়ংক্রিয়ভাবে এই লাইব্রেরির সংস্করণগুলি পরিচালনা করে, সামঞ্জস্যতা নিশ্চিত করে।

উদাহরণস্বরূপ, Maven-এ Guava dependence ঘোষণা করতে, নিম্নলিখিতগুলি ব্যবহার করুন:

<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 Ads API ডেভেলপার টোকেন প্রয়োজন। এই বিভাগে ব্যাখ্যা করা হয়েছে যে এগুলি কী, কীভাবে ব্যবহার করা হয় এবং কীভাবে এগুলি পাওয়া যায়।

ডেভেলপার টোকেন (API অ্যাক্সেসের জন্য)

ডেভেলপার টোকেনটি একটি ম্যানেজার অ্যাকাউন্টের সাথে লিঙ্ক করা আছে এবং এটি Google বিজ্ঞাপন ওয়েব ইন্টারফেসে পাওয়া যাবে।

যদিও ডেভেলপার টোকেনটি একটি ম্যানেজার অ্যাকাউন্টের সাথে লিঙ্ক করা থাকে, তবুও এটি সেই অ্যাকাউন্টে অ্যাক্সেস প্রদান করে না। পরিবর্তে, ডেভেলপার টোকেন সাধারণভাবে API-তে অ্যাক্সেস প্রদান করে এবং অ্যাকাউন্ট স্তরের অ্যাক্সেস OAuth এর মাধ্যমে কনফিগার করা হয়।

OAuth শংসাপত্র (Google বিজ্ঞাপন অ্যাকাউন্ট অ্যাক্সেসের জন্য)

Google Ads অ্যাকাউন্ট অ্যাক্সেস করার জন্য Google অ্যাকাউন্ট ব্যবহারকারী হিসেবে অনুমোদন পেতে, আপনাকে OAuth ক্রেডেনশিয়ালের একটি সেট প্রদান করতে হবে।

সাধারণত দুটি OAuth ফ্লো ব্যবহার করা হয়: ডেস্কটপ (ইনস্টল করা) অ্যাপ অথবা ওয়েব অ্যাপ। এই দুটির মধ্যে প্রধান পার্থক্য হল, ডেস্কটপ অ্যাপগুলিকে সিস্টেম ব্রাউজার খুলতে হবে এবং Google-এর অনুমোদন সার্ভার থেকে প্রতিক্রিয়া পরিচালনা করার জন্য একটি স্থানীয় পুনর্নির্দেশ URI সরবরাহ করতে হবে, যেখানে ওয়েব অ্যাপগুলি অনুমোদন সম্পূর্ণ করতে এবং আপনার সার্ভারে শংসাপত্র ফেরত পাঠাতে একটি ইচ্ছামত তৃতীয় পক্ষের ব্রাউজার পুনর্নির্দেশ করতে পারে। লাইব্রেরিটি কম ব্যবহৃত পরিষেবা অ্যাকাউন্ট প্রবাহকেও সমর্থন করে।

যদি আপনি আপনার নিজস্ব শংসাপত্র ব্যবহার করে অনুমোদন করেন (ডেস্কটপ অ্যাপ প্রবাহ)
OAuth ডেস্কটপ অ্যাপ ফ্লো দেখুন। এতে আপনার নিজস্ব শংসাপত্রের সাথে অনুমোদনের জন্য প্রয়োজনীয় সমস্ত বিবরণ অন্তর্ভুক্ত রয়েছে।
যদি আপনি তৃতীয় পক্ষের Google ব্যবহারকারী (ওয়েব ফ্লো) হিসেবে অনুমোদন করেন
OAuth ওয়েব অ্যাপ ফ্লো দেখুন। এটি একটি উদাহরণ দেয় যে কীভাবে ইচ্ছামত তৃতীয় পক্ষের ব্যবহারকারীদের জন্য OAuth অনুমোদন সেট আপ করতে হয়।
যদি আপনি একজন Google Apps ডোমেন ব্যবহারকারী হিসেবে অনুমোদন করেন (পরিষেবা অ্যাকাউন্ট প্রবাহ)
OAuth পরিষেবা অ্যাকাউন্ট প্রবাহ দেখুন। এটি Google Apps ডোমেন ব্যবহারকারীদের জন্য OAuth অনুমোদন কীভাবে সেট আপ করতে হয় তার একটি উদাহরণ দেয়।

যদি আপনার Google Ads গ্রাহক অ্যাকাউন্টে অ্যাক্সেস Google Ads ম্যানেজার অ্যাকাউন্টের মাধ্যমে হয়, তাহলে আপনাকে নীচে বর্ণিত লগইন গ্রাহক আইডিও উল্লেখ করতে হবে।

লগইন গ্রাহক আইডি (ম্যানেজার অ্যাকাউন্টের মাধ্যমে গুগল বিজ্ঞাপন অ্যাকাউন্টগুলিতে অ্যাক্সেসের জন্য)

ঐচ্ছিকভাবে, একটি ম্যানেজার অ্যাকাউন্টের গ্রাহক আইডি নির্দিষ্ট করুন যা পরিবেশনকারী অ্যাকাউন্টে অ্যাক্সেস দেয়। যদি আপনার গ্রাহক অ্যাকাউন্টে অ্যাক্সেস একটি ম্যানেজার অ্যাকাউন্টের মাধ্যমে হয় তবে এটি অবশ্যই নির্দিষ্ট করতে হবে। গ্রাহক আইডির পথে সমস্ত ম্যানেজার অ্যাকাউন্ট নির্দিষ্ট করার প্রয়োজন নেই, শুধুমাত্র অ্যাক্সেস অনুমতির জন্য আপনি যে শীর্ষস্থানীয় ম্যানেজার আইডি ব্যবহার করছেন তা নির্দিষ্ট করার প্রয়োজন নেই। আরও বিস্তারিত জানার জন্য, সম্পর্কিত ডকুমেন্টেশন দেখুন।

আপনার শংসাপত্রের সাহায্যে ক্লায়েন্ট লাইব্রেরি কনফিগার করুন

আপনি ক্লায়েন্ট লাইব্রেরিটি কনফিগারেশন ফাইল, এনভায়রনমেন্ট ভেরিয়েবল, অথবা প্রোগ্রাম্যাটিকভাবে কনফিগার করতে পারেন। এই নির্দেশিকার জন্য, আমরা কনফিগারেশন ফাইল পদ্ধতি ব্যবহার করব এবং ডেস্কটপ এবং ওয়েব ফ্লোতে ফোকাস করব। একটি কনফিগারেশন ফাইল ব্যবহার করা সাধারণত একটি ভাল পদ্ধতি যদি আপনার কেবল একটি সেট শংসাপত্র থাকে (উদাহরণস্বরূপ, আপনি একটি একক পরিচালকের অধীনে অ্যাকাউন্ট পরিচালনা করেন)।

নিম্নলিখিত কন্টেন্ট সহ ~/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 অ্যাকাউন্টের গ্রাহক আইডি, কোনও ড্যাশ ছাড়াই।

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

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