দ্রুত শুরু

এই দ্রুত শুরু নির্দেশিকাটি আপনাকে Google Ads API-তে আপনার প্রথম API কল করতে সাহায্য করবে।

মূল ধারণা

  • ডেভেলপার টোকেন : ডেভেলপার টোকেন হল ২২ অক্ষরের একটি বর্ণানুক্রমিক স্ট্রিং যা আপনার অ্যাপটিকে Google Ads API সার্ভারের সাথে শনাক্ত করে। API কল করার জন্য এটি প্রয়োজন।
  • API অ্যাক্সেস লেভেল: আপনার ডেভেলপার টোকেনের API অ্যাক্সেস লেভেল আপনি প্রতিদিন কতগুলি API কল করতে পারবেন এবং কোন পরিবেশে আপনি API কল করতে পারবেন তা নিয়ন্ত্রণ করে।
  • গুগল বিজ্ঞাপন ম্যানেজার অ্যাকাউন্ট: একটি গুগল বিজ্ঞাপন ম্যানেজার অ্যাকাউন্ট অন্যান্য গুগল বিজ্ঞাপন অ্যাকাউন্ট পরিচালনা করতে ব্যবহৃত হয়। একটি গুগল বিজ্ঞাপন ম্যানেজার অ্যাকাউন্ট গুগল বিজ্ঞাপন ক্লায়েন্ট অ্যাকাউন্ট বা অন্যান্য গুগল বিজ্ঞাপন ম্যানেজার অ্যাকাউন্ট পরিচালনা করতে ব্যবহার করা যেতে পারে। ডেভেলপার টোকেন পেতে আপনার একটি গুগল বিজ্ঞাপন ম্যানেজার অ্যাকাউন্ট প্রয়োজন।
  • Google Ads ক্লায়েন্ট অ্যাকাউন্ট: যে Google Ads অ্যাকাউন্টের বিরুদ্ধে আপনি API কল করছেন।
  • ক্লায়েন্ট গ্রাহক আইডি: ১০-সংখ্যার নম্বর যা একটি Google বিজ্ঞাপন ক্লায়েন্ট অ্যাকাউন্ট শনাক্ত করে।
  • OAuth 2.0: OAuth 2.0 হল অনুমোদনের জন্য একটি শিল্প-মানক প্রোটোকল, যা সমস্ত Google API দ্বারা ব্যবহৃত হয়। API কল করার জন্য OAuth 2.0 শংসাপত্র তৈরি করার জন্য আপনার একটি পরিষেবা অ্যাকাউন্ট এবং কী প্রয়োজন।
  • গুগল ক্লাউড প্রজেক্ট: একটি গুগল ক্লাউড প্রজেক্ট API এবং OAuth 2.0 API ক্রেডেনশিয়াল পরিচালনা সহ সমস্ত গুগল পরিষেবা তৈরি, সক্ষম এবং ব্যবহারের ভিত্তি তৈরি করে। আপনি গুগল ক্লাউড কনসোল থেকে একটি তৈরি করতে পারেন।
  • পরিষেবা অ্যাকাউন্ট: একটি বিশেষ ধরণের Google অ্যাকাউন্ট যা কোনও একক ব্যবহারকারীর নয় বরং আপনার অ্যাপ্লিকেশনের। এটি Google Ads API-তে আপনার অ্যাপ্লিকেশনটিকে প্রমাণীকরণ করতে ব্যবহৃত হয়। একটি পরিষেবা অ্যাকাউন্ট পেতে আপনার একটি Google ক্লাউড প্রকল্পের প্রয়োজন।
  • পরিষেবা অ্যাকাউন্ট কী: একটি JSON অ্যাপ ক্রেডেনশিয়াল ফাইল যাতে আপনার পরিষেবা অ্যাকাউন্টের জন্য প্রাইভেট কী থাকে। এটি Google Ads API API কল করার সময় কোনও পরিষেবা অ্যাকাউন্টকে প্রমাণীকরণের জন্য OAuth 2.0 ক্রেডেনশিয়াল তৈরি করতে ব্যবহৃত হয়। একটি পরিষেবা অ্যাকাউন্ট কী পেতে আপনার একটি পরিষেবা অ্যাকাউন্টের প্রয়োজন।

পূর্বশর্ত

Google Ads API কল করতে, আপনাকে নিম্নলিখিত ধাপগুলি সম্পূর্ণ করতে হবে।

আপনার ডেভেলপার টোকেন পান

আপনি যদি অতীতে কোনও ডেভেলপার টোকেনের জন্য সাইন আপ করে থাকেন, তাহলে আপনার Google Ads ম্যানেজার অ্যাকাউন্টে লগ ইন করে API সেন্টারে গিয়ে এটি খুঁজে পেতে পারেন।

API কেন্দ্র অ্যাক্সেস করুন

যদি আপনার কাছে ডেভেলপার টোকেন না থাকে, তাহলে আপনি API সেন্টারে একটির জন্য সাইন আপ করতে পারেন।

ডেভেলপার টোকেনের জন্য কীভাবে সাইন আপ করবেন

  1. আপনার ওয়েব ব্রাউজারে API সেন্টারে যান। অনুরোধ করা হলে আপনার Google Ads ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন। যদি আপনার Google Ads ম্যানেজার অ্যাকাউন্ট না থাকে তবে একটি তৈরি করুন ।
  2. API অ্যাক্সেস ফর্মটি পূরণ করুন এবং শর্তাবলী স্বীকার করুন।
    • আপনার তথ্য সঠিক এবং আপনার কোম্পানির ওয়েবসাইটের URL কাজ করছে কিনা তা নিশ্চিত করুন। যদি ওয়েবসাইটটি লাইভ না থাকে, তাহলে Google আপনার আবেদন প্রক্রিয়া করতে এবং প্রত্যাখ্যান করতে সক্ষম নাও হতে পারে।
    • নিশ্চিত করুন যে আপনার প্রদত্ত API যোগাযোগের ইমেলটি নিয়মিত পর্যবেক্ষণ করা ইনবক্সে নিয়ে যায়। পর্যালোচনা প্রক্রিয়া চলাকালীন Google এর API কমপ্লায়েন্স টিম স্পষ্টীকরণের জন্য এই ইমেল ঠিকানায় যোগাযোগ করতে পারে। যদি আপনার সাথে যোগাযোগ না করা যায়, তাহলে Google আপনার আবেদনটি চালিয়ে যেতে নাও পারে।
    • আপনি API সেন্টারে আপনার API যোগাযোগের ইমেলটি সম্পাদনা করতে পারেন। আবেদন প্রক্রিয়ার পরেও এই তথ্য আপডেট রাখুন, যাতে Google আপনাকে গুরুত্বপূর্ণ পরিষেবা ঘোষণা পাঠাতে পারে।

আবেদন প্রক্রিয়া সম্পন্ন করার পর, ডেভেলপার টোকেনটি আপনার API সেন্টারে একটি মুলতুবি অনুমোদনের অবস্থা সহ প্রদর্শিত হবে। আপনার ডেভেলপার টোকেনটিতে এখন টেস্ট অ্যাকাউন্ট অ্যাক্সেস লেভেল রয়েছে।

আপনার Google API কনসোল প্রকল্প কনফিগার করুন

Google API Console প্রকল্পটি Google API এবং OAuth 2.0 API শংসাপত্র পরিচালনার জন্য ব্যবহৃত হয়। আপনি আপনার বিদ্যমান Google API Console প্রকল্পগুলি খুঁজে পেতে পারেন অথবা Google API Console এ গিয়ে একটি তৈরি করতে পারেন।

গুগল এপিআই কনসোল খুলুন

আপনার প্রোজেক্টে Google Ads API সক্রিয় করে শুরু করুন:

Google বিজ্ঞাপন API সক্ষম করুন

এরপর, API কল করার জন্য আপনার একটি পরিষেবা অ্যাকাউন্ট এবং পরিষেবা অ্যাকাউন্ট কী প্রয়োজন। আপনি যদি ইতিমধ্যেই অন্য একটি Google API ব্যবহার করে থাকেন এবং একটি OAuth 2.0 পরিষেবা অ্যাকাউন্ট এবং কী তৈরি করে থাকেন, তাহলে আপনি এই ধাপটি এড়িয়ে যেতে পারেন এবং বিদ্যমান শংসাপত্রগুলি পুনরায় ব্যবহার করতে পারেন।

কিভাবে একটি পরিষেবা অ্যাকাউন্ট এবং কী তৈরি করবেন

  1. গুগল ক্লাউড কনসোলে, মেনু > IAM & Admin > পরিষেবা অ্যাকাউন্ট এ যান।

    পরিষেবা অ্যাকাউন্টগুলিতে যান।

  2. আপনার পরিষেবা অ্যাকাউন্ট নির্বাচন করুন।
  3. কী > কী যোগ করুন > নতুন কী তৈরি করুন ক্লিক করুন।
  4. JSON নির্বাচন করুন, তারপর Create এ ক্লিক করুন।

    আপনার নতুন পাবলিক/প্রাইভেট কী জোড়া তৈরি করা হয়েছে এবং আপনার মেশিনে একটি নতুন ফাইল হিসেবে ডাউনলোড করা হয়েছে। ডাউনলোড করা JSON ফাইলটি আপনার কার্যকরী ডিরেক্টরিতে credentials.json হিসেবে সংরক্ষণ করুন। এই ফাইলটি এই কী-এর একমাত্র কপি।

  5. বন্ধ করুন ক্লিক করুন।

আপনি যে Google Ads অ্যাকাউন্টের বিরুদ্ধে API কল করছেন তা শনাক্ত করে শুরু করুন। আপনি যে ধরণের অ্যাকাউন্টে API কল করতে পারবেন তা আপনার ডেভেলপার টোকেনের API অ্যাক্সেস স্তরের উপর নির্ভর করে। আপনার API অ্যাক্সেস স্তরটি জানতে আপনার API সেন্টারে যান।

বেসিক এবং স্ট্যান্ডার্ড অ্যাক্সেস লেভেল

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

অ্যাকাউন্ট অ্যাক্সেস লেভেল পরীক্ষা করুন

আপনার ডেভেলপার টোকেনটি Google Ads প্রোডাকশন অ্যাকাউন্টে API কল করার জন্য ব্যবহার করা যাবে না । আপনি শুধুমাত্র Google Ads টেস্ট অ্যাকাউন্টের বিরুদ্ধে API কল করতে পারবেন।

কিভাবে একটি Google Ads পরীক্ষা অ্যাকাউন্ট তৈরি করবেন

নিম্নলিখিত নির্দেশাবলী একটি Google Ads পরীক্ষা ব্যবস্থাপক অ্যাকাউন্ট এবং তার নীচে একটি Google Ads পরীক্ষা Google Ads বিজ্ঞাপনদাতা অ্যাকাউন্ট তৈরি করে।

  1. একটি Google Ads পরীক্ষা ব্যবস্থাপক অ্যাকাউন্ট তৈরি করতে নীল বোতামে ক্লিক করুন। যদি অনুরোধ করা হয়, তাহলে এমন একটি Google অ্যাকাউন্ট দিয়ে সাইন ইন করুন যা আপনার Google Ads উৎপাদন ব্যবস্থাপক অ্যাকাউন্টের সাথে লিঙ্ক করা নেই। যদি আপনার একটি না থাকে, তাহলে একটি নতুন Google অ্যাকাউন্ট তৈরি করতে সেই পৃষ্ঠায় অ্যাকাউন্ট তৈরি করুন বোতামটি ব্যবহার করুন।

    একটি Google Ads পরীক্ষা ব্যবস্থাপক অ্যাকাউন্ট তৈরি করুন

  2. আপনার Google Ads টেস্ট ম্যানেজার অ্যাকাউন্টে থাকাকালীন, একটি Google Ads টেস্ট গ্রাহক অ্যাকাউন্ট তৈরি করুন: অ্যাকাউন্ট > > নতুন অ্যাকাউন্ট তৈরি করুন ক্লিক করুন এবং ফর্মটি পূরণ করুন। আপনার Google Ads টেস্ট ম্যানেজার অ্যাকাউন্ট থেকে আপনি যে কোনও Google Ads অ্যাকাউন্ট তৈরি করবেন তা স্বয়ংক্রিয়ভাবে Google Ads টেস্ট অ্যাকাউন্ট হয়ে যাবে।
  3. ঐচ্ছিকভাবে, Google Ads পৃষ্ঠা থেকে Google Ads টেস্ট ক্লায়েন্ট অ্যাকাউন্টের অধীনে কয়েকটি প্রচারণা তৈরি করুন।

একজন Google Ads গ্রাহককে API কল করার জন্য, আপনাকে অবশ্যই Google Ads গ্রাহক অ্যাকাউন্টে আপনার পরিষেবা অ্যাকাউন্টের অ্যাক্সেস এবং উপযুক্ত অনুমতি দিতে হবে। এটি করার জন্য, আপনার গ্রাহক অ্যাকাউন্টে প্রশাসকের অ্যাক্সেস প্রয়োজন।

আপনার Google Ads অ্যাকাউন্টে পরিষেবা অ্যাকাউন্টের অ্যাক্সেস কীভাবে দেবেন

  1. প্রশাসক হিসেবে আপনার Google বিজ্ঞাপন অ্যাকাউন্টে সাইন ইন করে শুরু করুন।
  2. অ্যাডমিন > অ্যাক্সেস এবং সুরক্ষা এ নেভিগেট করুন।
  3. ব্যবহারকারী ট্যাবের অধীনে বোতামে ক্লিক করুন।
  4. ইমেল ইনপুট বাক্সে পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানা টাইপ করুন। উপযুক্ত অ্যাকাউন্ট অ্যাক্সেস স্তর নির্বাচন করুন এবং অ্যাকাউন্ট যোগ করুন বোতামে ক্লিক করুন। মনে রাখবেন যে পরিষেবা অ্যাকাউন্টগুলির জন্য ইমেল অ্যাক্সেস স্তর সমর্থিত নয়।
  5. পরিষেবা অ্যাকাউন্টটি অ্যাক্সেসের অনুমতি দেওয়া হয়েছে।
  6. [ঐচ্ছিক] ডিফল্টরূপে, আপনি কোনও পরিষেবা অ্যাকাউন্টে প্রশাসকের অ্যাক্সেস দিতে পারবেন না। যদি আপনার API কলগুলিতে প্রশাসকের অ্যাক্সেসের প্রয়োজন হয়, তাহলে আপনি নিম্নলিখিতভাবে অ্যাক্সেস আপগ্রেড করতে পারেন।
    1. অ্যাক্সেস লেভেল কলামে পরিষেবা অ্যাকাউন্টের অ্যাক্সেস লেভেলের পাশে থাকা ড্রপ-ডাউন তীরটিতে ক্লিক করুন।
    2. ড্রপ-ডাউন তালিকা থেকে অ্যাডমিন নির্বাচন করুন।

টুল এবং ক্লায়েন্ট লাইব্রেরি ডাউনলোড করুন

আপনি কীভাবে API কল করতে চান তার উপর নির্ভর করে আপনি একটি ক্লায়েন্ট লাইব্রেরি অথবা একটি HTTP ক্লায়েন্ট ডাউনলোড করতে পারেন।

একটি ক্লায়েন্ট লাইব্রেরি ব্যবহার করুন

আপনার পছন্দের একটি ক্লায়েন্ট লাইব্রেরি ডাউনলোড এবং ইনস্টল করুন।

HTTP ক্লায়েন্ট (REST) ​​ব্যবহার করুন

কার্ল করা

URL এর মাধ্যমে ডেটা স্থানান্তরের জন্য কমান্ড লাইন টুল, curl ডাউনলোড এবং ইনস্টল করুন।

গুগল ক্লাউড সিএলআই

gcloud CLI ইনস্টল করার জন্য নির্দেশাবলী অনুসরণ করুন।

এই নির্দেশিকার বাকি অংশের নির্দেশাবলী gcloud টুলের নিম্নলিখিত সংস্করণের সাথে কাজ করার জন্য যাচাই করা হয়েছে এবং অ্যাপ্লিকেশন আচরণ বা কমান্ড-লাইন বিকল্পগুলির পার্থক্যের কারণে পূর্ববর্তী সংস্করণগুলির সাথে কাজ নাও করতে পারে।

:~$ gcloud version
Google Cloud SDK 492.0.0
alpha 2024.09.06
beta 2024.09.06
bq 2.1.8
bundled-python3-unix 3.11.9
core 2024.09.06
enterprise-certificate-proxy 0.3.2
gcloud-crc32c 1.0.0
gsutil 5.30

একটি API কল করুন

API কল করার নির্দেশাবলীর জন্য আপনার পছন্দের ক্লায়েন্ট নির্বাচন করুন:

জাভা

ক্লায়েন্ট লাইব্রেরি আর্টিফ্যাক্টগুলি Maven কেন্দ্রীয় সংগ্রহস্থলে প্রকাশিত হয়। আপনার প্রকল্পের নির্ভরতা হিসাবে ক্লায়েন্ট লাইব্রেরিটি নিম্নরূপ যোগ করুন:

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

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>41.0.0</version>
</dependency>

গ্রেডল নির্ভরতা হল:

implementation 'com.google.api-ads:google-ads:41.0.0'

নিম্নলিখিত কন্টেন্ট সহ ~/ads.properties ফাইল তৈরি করুন:

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

নিম্নরূপ একটি GoogleAdsClient অবজেক্ট তৈরি করুন:

GoogleAdsClient googleAdsClient = null;
try {
  googleAdsClient = GoogleAdsClient.newBuilder().fromPropertiesFile().build();
} catch (FileNotFoundException fnfe) {
  System.err.printf(
      "Failed to load GoogleAdsClient configuration from file. Exception: %s%n",
      fnfe);
  System.exit(1);
} catch (IOException ioe) {
  System.err.printf("Failed to create GoogleAdsClient. Exception: %s%n", ioe);
  System.exit(1);
}

এরপর, আপনার অ্যাকাউন্টে প্রচারণাগুলি পুনরুদ্ধার করতে GoogleAdsService.SearchStream পদ্ধতি ব্যবহার করে একটি প্রচারণা প্রতিবেদন চালান। এই নির্দেশিকাটি রিপোর্টিংয়ের বিশদ বিবরণ কভার করে না।

private void runExample(GoogleAdsClient googleAdsClient, long customerId) {
  try (GoogleAdsServiceClient googleAdsServiceClient =
      googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
    String query = "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id";
    // Constructs the SearchGoogleAdsStreamRequest.
    SearchGoogleAdsStreamRequest request =
        SearchGoogleAdsStreamRequest.newBuilder()
            .setCustomerId(Long.toString(customerId))
            .setQuery(query)
            .build();

    // Creates and issues a search Google Ads stream request that will retrieve all campaigns.
    ServerStream<SearchGoogleAdsStreamResponse> stream =
        googleAdsServiceClient.searchStreamCallable().call(request);

    // Iterates through and prints all of the results in the stream response.
    for (SearchGoogleAdsStreamResponse response : stream) {
      for (GoogleAdsRow googleAdsRow : response.getResultsList()) {
        System.out.printf(
            "Campaign with ID %d and name '%s' was found.%n",
            googleAdsRow.getCampaign().getId(), googleAdsRow.getCampaign().getName());
      }
    }
  }
}
GetCampaigns.java

সি#

ক্লায়েন্ট লাইব্রেরি প্যাকেজগুলি Nuget.org রিপোজিটরিতে প্রকাশিত হয়। Google.Ads.GoogleAds প্যাকেজে একটি nuget রেফারেন্স যোগ করে শুরু করুন।

dotnet add package Google.Ads.GoogleAds --version 24.1.0

প্রাসঙ্গিক সেটিংস ব্যবহার করে একটি GoogleAdsConfig অবজেক্ট তৈরি করুন এবং এটি ব্যবহার করে একটি GoogleAdsClient অবজেক্ট তৈরি করুন।

GoogleAdsConfig config = new GoogleAdsConfig()
{
    DeveloperToken = "******",
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "PATH_TO_CREDENTIALS_JSON",
    LoginCustomerId = ******
};
GoogleAdsClient client = new GoogleAdsClient(config);

এরপর, আপনার অ্যাকাউন্টে প্রচারণাগুলি পুনরুদ্ধার করতে GoogleAdsService.SearchStream পদ্ধতি ব্যবহার করে একটি প্রচারণা প্রতিবেদন চালান। এই নির্দেশিকাটি রিপোর্টিংয়ের বিশদ বিবরণ কভার করে না।

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the GoogleAdsService.
    GoogleAdsServiceClient googleAdsService = client.GetService(
        Services.V22.GoogleAdsService);

    // Create a query that will retrieve all campaigns.
    string query = @"SELECT
                    campaign.id,
                    campaign.name,
                    campaign.network_settings.target_content_network
                FROM campaign
                ORDER BY campaign.id";

    try
    {
        // Issue a search request.
        googleAdsService.SearchStream(customerId.ToString(), query,
            delegate (SearchGoogleAdsStreamResponse resp)
            {
                foreach (GoogleAdsRow googleAdsRow in resp.Results)
                {
                    Console.WriteLine("Campaign with ID {0} and name '{1}' was found.",
                        googleAdsRow.Campaign.Id, googleAdsRow.Campaign.Name);
                }
            }
        );
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
GetCampaigns.cs

পিএইচপি

ক্লায়েন্ট লাইব্রেরি প্যাকেজগুলি Packagist রিপোজিটরিতে প্রকাশিত হয়। আপনার প্রকল্পের রুট ডিরেক্টরিতে পরিবর্তন করুন এবং আপনার প্রকল্পের রুট ডিরেক্টরির vendor/ ডিরেক্টরিতে লাইব্রেরি এবং এর সমস্ত নির্ভরতা ইনস্টল করতে নিম্নলিখিত কমান্ডটি চালান। 

composer require googleads/google-ads-php:31.0.0

GitHub রিপোজিটরি থেকে google_ads_php.ini ফাইলের একটি কপি তৈরি করুন এবং আপনার শংসাপত্র অন্তর্ভুক্ত করার জন্য এটি পরিবর্তন করুন। 

[GOOGLE_ADS]
developerToken = "INSERT_DEVELOPER_TOKEN_HERE"
loginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"

[OAUTH2]
jsonKeyFilePath = "INSERT_ABSOLUTE_PATH_TO_OAUTH2_JSON_KEY_FILE_HERE"
scopes = "https://www.googleapis.com/auth/adwords"

GoogleAdsClient অবজেক্টের একটি উদাহরণ তৈরি করুন। 

$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile('/path/to/google_ads_php.ini')
    ->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile('/path/to/google_ads_php.ini')
    ->withOAuth2Credential($oAuth2Credential)
    ->build();

এরপর, আপনার অ্যাকাউন্টে প্রচারণাগুলি পুনরুদ্ধার করতে GoogleAdsService.SearchStream পদ্ধতি ব্যবহার করে একটি প্রচারণা প্রতিবেদন চালান। এই নির্দেশিকাটি রিপোর্টিংয়ের বিশদ বিবরণ কভার করে না। 

public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId)
{
    $googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient();
    // Creates a query that retrieves all campaigns.
    $query = 'SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id';
    // Issues a search stream request.
    /** @var GoogleAdsServerStreamDecorator $stream */
    $stream = $googleAdsServiceClient->searchStream(
        SearchGoogleAdsStreamRequest::build($customerId, $query)
    );

    // Iterates over all rows in all messages and prints the requested field values for
    // the campaign in each row.
    foreach ($stream->iterateAllElements() as $googleAdsRow) {
        /** @var GoogleAdsRow $googleAdsRow */
        printf(
            "Campaign with ID %d and name '%s' was found.%s",
            $googleAdsRow->getCampaign()->getId(),
            $googleAdsRow->getCampaign()->getName(),
            PHP_EOL
        );
    }
}
GetCampaigns.php

পাইথন

ক্লায়েন্ট লাইব্রেরিটি PyPI তে বিতরণ করা হয়েছে। pip কমান্ড ব্যবহার করে এটি ইনস্টল করা যেতে পারে: 

python -m pip install google-ads==21.3.0

GitHub রিপোজিটরি থেকে google-ads.yaml ফাইলের একটি কপি তৈরি করুন এবং আপনার শংসাপত্রগুলি অন্তর্ভুক্ত করার জন্য এটি পরিবর্তন করুন। 

developer_token: INSERT_DEVELOPER_TOKEN_HERE
login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE
json_key_file_path: JSON_KEY_FILE_PATH_HERE

GoogleAdsClient.load_from_storage পদ্ধতিতে কল করে একটি GoogleAdsClient ইনস্ট্যান্স তৈরি করুন। পদ্ধতিতে কল করার সময় আপনার google-ads.yaml এর পাথটি স্ট্রিং হিসেবে দিন: 

from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage("path/to/google-ads.yaml")

লাইব্রেরির লগারে একটি হ্যান্ডলার যোগ করুন যা লগগুলি কোথায় প্রিন্ট করতে হবে তা বলে দেবে। নিম্নলিখিতটি লাইব্রেরির লগারকে কনসোলে ( stdout ) প্রিন্ট করতে বলবে। 

import logging
import sys

logger = logging.getLogger('google.ads.googleads.client')
logger.addHandler(logging.StreamHandler(sys.stdout))

এরপর, আপনার অ্যাকাউন্টে প্রচারণাগুলি পুনরুদ্ধার করতে GoogleAdsService.SearchStream পদ্ধতি ব্যবহার করে একটি প্রচারণা প্রতিবেদন চালান। এই নির্দেশিকাটি রিপোর্টিংয়ের বিশদ বিবরণ কভার করে না। 

def main(client: GoogleAdsClient, customer_id: str) -> None:
    ga_service: GoogleAdsServiceClient = client.get_service("GoogleAdsService")

    query: str = """
        SELECT
          campaign.id,
          campaign.name
        FROM campaign
        ORDER BY campaign.id"""

    # Issues a search request using streaming.
    stream: Iterator[SearchGoogleAdsStreamResponse] = ga_service.search_stream(
        customer_id=customer_id, query=query
    )

    for batch in stream:
        rows: List[GoogleAdsRow] = batch.results
        for row in rows:
            print(
                f"Campaign with ID {row.campaign.id} and name "
                f'"{row.campaign.name}" was found.'
            )
get_campaigns.py

রুবি

ক্লায়েন্ট লাইব্রেরির জন্য রুবি জেমস Rubygems জেম হোস্টিং সাইটে প্রকাশিত হয়। ইনস্টল করার প্রস্তাবিত উপায় হল bundler ব্যবহার করা। আপনার জেমফাইলে একটি লাইন যোগ করুন: 

gem 'google-ads-googleads', '~> 36.0.0'

তারপর চালান: 

bundle install

GitHub রিপোজিটরি থেকে google_ads_config.rb ফাইলের একটি কপি তৈরি করুন এবং আপনার শংসাপত্রগুলি অন্তর্ভুক্ত করার জন্য এটি পরিবর্তন করুন। 

Google::Ads::GoogleAds::Config.new do |c|
  c.developer_token = 'INSERT_DEVELOPER_TOKEN_HERE'
  c.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
  c.keyfile = 'JSON_KEY_FILE_PATH'
end

এই ফাইলটি যেখানে রাখবেন সেখানে পাথটি দিয়ে একটি GoogleAdsClient ইনস্ট্যান্স তৈরি করুন। 

client = Google::Ads::GoogleAds::GoogleAdsClient.new('path/to/google_ads_config.rb')

এরপর, আপনার অ্যাকাউন্টে প্রচারণাগুলি পুনরুদ্ধার করতে GoogleAdsService.SearchStream পদ্ধতি ব্যবহার করে একটি প্রচারণা প্রতিবেদন চালান। এই নির্দেশিকাটি রিপোর্টিংয়ের বিশদ বিবরণ কভার করে না। 

def get_campaigns(customer_id)
  # GoogleAdsClient will read a config file from
  # ENV['HOME']/google_ads_config.rb when called without parameters
  client = Google::Ads::GoogleAds::GoogleAdsClient.new

  responses = client.service.google_ads.search_stream(
    customer_id: customer_id,
    query: 'SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id',
  )

  responses.each do |response|
    response.results.each do |row|
      puts "Campaign with ID #{row.campaign.id} and name '#{row.campaign.name}' was found."
    end
  end
end
get_campaigns.rb

পার্ল

লাইব্রেরিটি CPAN- তে বিতরণ করা হয়েছে। আপনার পছন্দের ডিরেক্টরিতে google-ads-perl রিপোজিটরি ক্লোন করে শুরু করুন। 

git clone https://github.com/googleads/google-ads-perl.git

google-ads-perl ডিরেক্টরিতে যান এবং লাইব্রেরি ব্যবহারের জন্য প্রয়োজনীয় সমস্ত নির্ভরতা ইনস্টল করতে কমান্ড প্রম্পটে নিম্নলিখিত কমান্ডটি চালান। 

cd google-ads-perl
cpan install Module::Build
perl Build.PL
perl Build installdeps

GitHub রিপোজিটরি থেকে googleads.properties ফাইলের একটি কপি তৈরি করুন এবং আপনার শংসাপত্র অন্তর্ভুক্ত করার জন্য এটি পরিবর্তন করুন। 

jsonKeyFilePath=JSON_KEY_FILE_PATH
developerToken=INSERT_DEVELOPER_TOKEN_HERE
loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

এই ফাইলটি যেখানে রাখবেন সেখানে পাথটি দিয়ে একটি Client ইনস্ট্যান্স তৈরি করুন। 

my $properties_file = "/path/to/googleads.properties";

my $api_client = Google::Ads::GoogleAds::Client->new({
  properties_file => $properties_file
});

এরপর, আপনার অ্যাকাউন্টে প্রচারণাগুলি পুনরুদ্ধার করতে GoogleAdsService.SearchStream পদ্ধতি ব্যবহার করে একটি প্রচারণা প্রতিবেদন চালান। এই নির্দেশিকাটি রিপোর্টিংয়ের বিশদ বিবরণ কভার করে না। 

sub get_campaigns {
  my ($api_client, $customer_id) = @_;

  # Create a search Google Ads stream request that will retrieve all campaigns.
  my $search_stream_request =
    Google::Ads::GoogleAds::V22::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
    ->new({
      customerId => $customer_id,
      query      =>
        "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id"
    });

  # Get the GoogleAdsService.
  my $google_ads_service = $api_client->GoogleAdsService();

  my $search_stream_handler =
    Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
      service => $google_ads_service,
      request => $search_stream_request
    });

  # Issue a search request and process the stream response to print the requested
  # field values for the campaign in each row.
  $search_stream_handler->process_contents(
    sub {
      my $google_ads_row = shift;
      printf "Campaign with ID %d and name '%s' was found.\n",
        $google_ads_row->{campaign}{id}, $google_ads_row->{campaign}{name};
    });

  return 1;
}
get_campaigns.pl

কার্ল করা

gcloud CLI-তে পরিষেবা অ্যাকাউন্টটিকে সক্রিয় শংসাপত্র হিসেবে সেট করে শুরু করুন। 

gcloud auth login --cred-file=PATH_TO_CREDENTIALS_JSON

এরপর, Google Ads API-এর জন্য একটি OAuth 2.0 অ্যাক্সেস টোকেন আনুন। 

gcloud auth \
  print-access-token \
  --scopes='https://www.googleapis.com/auth/adwords'

এরপর, আপনার অ্যাকাউন্টে প্রচারণাগুলি পুনরুদ্ধার করতে GoogleAdsService.SearchStream পদ্ধতি ব্যবহার করে একটি প্রচারণা প্রতিবেদন চালান। এই নির্দেশিকাটি রিপোর্টিংয়ের বিশদ বিবরণ কভার করে না। 

curl -i -X POST https://googleads.googleapis.com/v22/customers/CUSTOMER_ID/googleAds:searchStream \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer ACCESS_TOKEN" \
   -H "developer-token: DEVELOPER_TOKEN" \
   -H "login-customer-id: LOGIN_CUSTOMER_ID" \
   --data-binary "@query.json"

query.json এর বিষয়বস্তু নিম্নরূপ: 

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}
পূর্ববর্তী
ভূমিকা
পরবর্তী
সাধারণ ত্রুটি