দ্রুত শুরু

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

মূল ধারণা

  • বিকাশকারী টোকেন : একটি বিকাশকারী টোকেন হল একটি আলফানিউমেরিক স্ট্রিং, 22টি অক্ষর দীর্ঘ, যা আপনার অ্যাপটিকে Google Ads API সার্ভারে সনাক্ত করে। API কল করার জন্য এটি প্রয়োজন।
  • API অ্যাক্সেস লেভেল: আপনার ডেভেলপার টোকেনের API অ্যাক্সেস লেভেল আপনি প্রতিদিন কতগুলো API কল করতে পারবেন এবং যে পরিবেশে আপনি API কল করতে পারবেন তা নিয়ন্ত্রণ করে।
  • Google Ads ম্যানেজার অ্যাকাউন্ট: একটি Google Ads ম্যানেজার অ্যাকাউন্ট অন্যান্য Google বিজ্ঞাপন অ্যাকাউন্টগুলি পরিচালনা করতে ব্যবহৃত হয়। একটি Google বিজ্ঞাপন ম্যানেজার অ্যাকাউন্ট Google বিজ্ঞাপন ক্লায়েন্ট অ্যাকাউন্ট বা অন্যান্য Google বিজ্ঞাপন পরিচালক অ্যাকাউন্ট পরিচালনা করতে ব্যবহার করা যেতে পারে। ডেভেলপার টোকেন পেতে আপনার একটি Google Ads ম্যানেজার অ্যাকাউন্ট প্রয়োজন।
  • Google Ads ক্লায়েন্ট অ্যাকাউন্ট: যে Google বিজ্ঞাপন অ্যাকাউন্টের বিরুদ্ধে আপনি API কল করছেন।
  • ক্লায়েন্ট গ্রাহক আইডি: 10-সংখ্যার নম্বর যা একটি Google Ads ক্লায়েন্ট অ্যাকাউন্টকে শনাক্ত করে।
  • OAuth 2.0: OAuth 2.0 হল অনুমোদনের জন্য একটি ইন্ডাস্ট্রি-স্ট্যান্ডার্ড প্রোটোকল, যা সমস্ত Google API দ্বারা ব্যবহৃত হয়। API কল করার জন্য OAuth 2.0 শংসাপত্র তৈরি করতে আপনার একটি পরিষেবা অ্যাকাউন্ট এবং কী প্রয়োজন৷
  • Google ক্লাউড প্রকল্প: একটি Google ক্লাউড প্রকল্প API এবং OAuth 2.0 API শংসাপত্রগুলি পরিচালনা সহ সমস্ত Google পরিষেবা তৈরি, সক্ষম এবং ব্যবহারের জন্য ভিত্তি তৈরি করে৷ আপনি Google ক্লাউড কনসোল থেকে একটি তৈরি করতে পারেন।
  • পরিষেবা অ্যাকাউন্ট: একটি বিশেষ ধরনের Google অ্যাকাউন্ট যা একটি পৃথক ব্যবহারকারীর পরিবর্তে আপনার অ্যাপ্লিকেশনের অন্তর্গত। এটি Google বিজ্ঞাপন 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 কনসোল প্রকল্পটি Google API এবং OAuth 2.0 API শংসাপত্র পরিচালনার জন্য ব্যবহৃত হয়। আপনি আপনার বিদ্যমান Google API কনসোল প্রকল্পগুলি খুঁজে পেতে পারেন বা Google API কনসোলে গিয়ে একটি তৈরি করতে পারেন৷

Google API কনসোল খুলুন

আপনার প্রোজেক্টে Google Ads API চালু করে শুরু করুন:

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

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

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

  1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > Service Accounts- এ যান।

    সার্ভিস অ্যাকাউন্টে যান

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

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

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

আপনি যে Google বিজ্ঞাপন অ্যাকাউন্টের বিরুদ্ধে API কল করছেন সেটি চিহ্নিত করে শুরু করুন। আপনি যে ধরনের অ্যাকাউন্টে API কল করতে পারেন তা আপনার বিকাশকারী টোকেনের API অ্যাক্সেস স্তরের উপর নির্ভর করে। আপনার API অ্যাক্সেস স্তর খুঁজে বের করতে আপনার API কেন্দ্র পরীক্ষা করুন.

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

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

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

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

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

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

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

    একটি Google বিজ্ঞাপন পরীক্ষা পরিচালক অ্যাকাউন্ট তৈরি করুন

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

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

কীভাবে আপনার Google বিজ্ঞাপন অ্যাকাউন্টে পরিষেবা অ্যাকাউন্ট অ্যাক্সেস দিতে হয়

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

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

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

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

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

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

কার্ল

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

Google ক্লাউড 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>40.0.0</version>
</dependency>

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

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

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 প্যাকেজে একটি নুগেট রেফারেন্স যোগ করে শুরু করুন।

dotnet add package Google.Ads.GoogleAds --version 18.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.V21.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

পিএইচপি

ক্লায়েন্ট লাইব্রেরি প্যাকেজ প্যাকেজিস্ট সংগ্রহস্থলে প্রকাশিত হয়। আপনার প্রকল্পের রুট ডিরেক্টরিতে পরিবর্তন করুন এবং আপনার প্রকল্পের রুট ডিরেক্টরির 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 জেম হোস্টিং সাইটে প্রকাশিত হয়। ইনস্টল করার প্রস্তাবিত উপায় হল বান্ডলার ব্যবহার করা। আপনার জেমফাইলে একটি লাইন যোগ করুন: 

gem 'google-ads-googleads', '~> 35.2.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::V21::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/v21/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"
}
পূর্ববর্তী
ভূমিকা
পরবর্তী
সাধারণ ত্রুটি