বস্তু পুনরুদ্ধার করা হচ্ছে

GoogleAdsService হল Google Ads API-এর ইউনিফাইড অবজেক্ট পুনরুদ্ধার এবং রিপোর্টিং পরিষেবা। পরিষেবাটির পদ্ধতি রয়েছে যা:

  • বস্তুর নির্দিষ্ট বৈশিষ্ট্য পুনরুদ্ধার করুন।
  • একটি তারিখ ব্যাপ্তির উপর ভিত্তি করে বস্তুর জন্য কর্মক্ষমতা মেট্রিক্স পুনরুদ্ধার করুন.
  • তাদের বৈশিষ্ট্যের উপর ভিত্তি করে বস্তুর অর্ডার করুন।
  • প্রতিক্রিয়াতে আপনি কোন বস্তুগুলি ফিরিয়ে দিতে চান তা নির্দেশ করতে শর্তগুলি ব্যবহার করুন৷
  • ফিরে আসা বস্তুর সংখ্যা সীমিত করুন।

GoogleAdsService দুটি উপায়ে ফলাফল ফেরত দিতে পারে:

  • GoogleAdsService.SearchStream একটি একক স্ট্রিমিং প্রতিক্রিয়াতে সমস্ত সারি প্রদান করে যা বড় (10,000 সারির চেয়ে বেশি) ফলাফল সেটের জন্য আরও কার্যকর। এটি আরও উপযুক্ত হতে পারে যদি আপনার ব্যাচ অ্যাপ্লিকেশন যত দ্রুত সম্ভব ডেটা ডাউনলোড করতে চায়।
  • GoogleAdsService.Search ফলাফলের পরিচালনাযোগ্য পৃষ্ঠাগুলিতে বড় প্রতিক্রিয়াগুলিকে বিভক্ত করে৷ এটি আরও উপযুক্ত হতে পারে যদি আপনার ইন্টারেক্টিভ অ্যাপ্লিকেশন একবারে ফলাফলের একটি পৃষ্ঠা প্রদর্শন করে।

পেজিং বনাম স্ট্রিমিং সম্পর্কে আরও জানুন।

একটি অনুরোধ করুন

অনুসন্ধান পদ্ধতির জন্য একটি SearchGoogleAdsRequest প্রয়োজন, যা নিম্নলিখিত বৈশিষ্ট্যগুলি নিয়ে গঠিত:

  • একটি customer_id
  • একটি Google বিজ্ঞাপন ক্যোয়ারী ল্যাঙ্গুয়েজ query যা নির্দেশ করে যে কোন রিসোর্স কোয়েরি করতে হবে, অ্যাট্রিবিউট, সেগমেন্ট এবং মেট্রিক্স পুনরুদ্ধার করতে হবে এবং কোন বস্তু ফেরত দেওয়া হবে তা সীমাবদ্ধ করতে ব্যবহার করার শর্তগুলি
  • ( শুধুমাত্র GoogleAdsService.Search ) পেজিং ব্যবহার করার সময় একটি একক প্রতিক্রিয়ায় কতগুলি বস্তু ফেরত দিতে হবে তা নির্দেশ করার জন্য একটি page_size
  • ( শুধুমাত্র GoogleAdsService.Search ) পেজিং ব্যবহার করার সময় পরবর্তী ব্যাচের ফলাফল পুনরুদ্ধার করার জন্য একটি ঐচ্ছিক page_token

Google বিজ্ঞাপন কোয়েরি ভাষা সম্পর্কে আরও তথ্যের জন্য, Google বিজ্ঞাপন ক্যোয়ারী ভাষা নির্দেশিকা দেখুন।

একটি প্রতিক্রিয়া প্রক্রিয়া

GoogleAdsService GoogleAdsRow অবজেক্টের একটি তালিকা প্রদান করে।

প্রতিটি GoogleAdsRow একটি ক্যোয়ারী দ্বারা প্রত্যাবর্তিত একটি বস্তুর প্রতিনিধিত্ব করে এবং SELECT ক্লজে অনুরোধ করা ক্ষেত্রগুলির উপর ভিত্তি করে তৈরি করা বৈশিষ্ট্যগুলির একটি সেট নিয়ে গঠিত। SELECT ক্লজে অন্তর্ভুক্ত নয় এমন বৈশিষ্ট্যগুলি প্রতিক্রিয়াতে GoogleAdsRow অবজেক্টে পপুলেট করা হয় না।

উদাহরণস্বরূপ, যদিও একটি ad_group_criterion একটি status অ্যাট্রিবিউট আছে, তবুও সারির ad_group_criterion অ্যাট্রিবিউটের status ক্ষেত্রটি একটি প্রশ্নের উত্তরে পপুলেট করা হয় না যেখানে SELECT ক্লজ ad_group_criterion.status অন্তর্ভুক্ত করে না। একইভাবে, সারির campaign বৈশিষ্ট্যটি পপুলেট করা হয় না যদি SELECT ক্লজ campaign সংস্থান থেকে কোনো ক্ষেত্র অন্তর্ভুক্ত না করে।

প্রতিটি GoogleAdsRow একই ফলাফল সেটে অন্য সারি থেকে বিভিন্ন বৈশিষ্ট্য এবং মেট্রিক্স থাকতে পারে; তাই সারিগুলিকে একটি টেবিলের নির্দিষ্ট সারি না করে বস্তু হিসাবে দেখা উচিত।

অজানা enum প্রকার

যে সম্পদগুলি এক প্রকার UNKNOWN দিয়ে ফেরত দেওয়া হয় সেগুলি সেই API সংস্করণে সম্পূর্ণরূপে সমর্থিত নয়৷ এই সম্পদগুলি অন্যান্য ইন্টারফেসের মাধ্যমে তৈরি করা যেতে পারে যেমন Google বিজ্ঞাপন UI। আপনি মেট্রিক্স নির্বাচন করতে পারেন যখন কোনো সম্পদে এক প্রকার UNKNOWN থাকে, কিন্তু আপনি API-এর মাধ্যমে সম্পদকে পরিবর্তন করতে পারবেন না। এর একটি উদাহরণ হল একটি নতুন প্রচারাভিযান বা বিজ্ঞাপন যা UI-তে চালু করা হচ্ছে, কিন্তু আপনি যে API সংস্করণটি অনুসন্ধান করছেন তাতে সমর্থিত নয়।

মনে রাখার জন্য এখানে কিছু বিবেচনা রয়েছে:

  • একটি UNKNOWN প্রকারের একটি সংস্থান পরে সমর্থিত হতে পারে বা অনির্দিষ্টকালের জন্য UNKNOWN থাকতে পারে৷
  • UNKNOWN টাইপ সহ নতুন অবজেক্ট যে কোন সময় উপস্থিত হতে পারে। এই বস্তুগুলি পশ্চাদমুখী সামঞ্জস্যপূর্ণ কারণ enum মান ইতিমধ্যে উপলব্ধ। রিসোর্সগুলি এই পরিবর্তনের সাথে প্রবর্তন করা হয়েছে কারণ সেগুলি উপলব্ধ রয়েছে যাতে আপনার অ্যাকাউন্টের সঠিক দৃশ্য থাকে৷ UNKNOWN সংস্থানটি অন্যান্য ইন্টারফেসের মাধ্যমে আপনার অ্যাকাউন্টে নতুন ক্রিয়াকলাপের কারণে বা যখন কোনও সংস্থান আর সমর্থিত নয় তখন উপস্থিত হতে পারে৷
  • UNKNOWN সংস্থানগুলির সাথে বিস্তারিত মেট্রিক্স সংযুক্ত থাকতে পারে যা জিজ্ঞাসাযোগ্য।
  • UNKNOWN সংস্থানগুলি সাধারণত Google Ads UI-তে সম্পূর্ণরূপে দৃশ্যমান হয়।
  • UNKNOWN সম্পদ সাধারণত পরিবর্তন করা যাবে না.

সেগমেন্টেশন

প্রতিক্রিয়াটিতে নিম্নলিখিতগুলির প্রতিটি সংমিশ্রণের জন্য একটি GoogleAdsRow থাকবে:

  • FROM ধারায় উল্লেখ করা প্রধান সম্পদের উদাহরণ
  • প্রতিটি নির্বাচিত segment ক্ষেত্রের মান

উদাহরণস্বরূপ, একটি প্রশ্নের উত্তর যা FROM campaign নির্বাচন করে এবং SELECT ক্লজে segments.ad_network_type এবং segments.date আছে নিম্নলিখিতগুলির প্রতিটি সংমিশ্রণের জন্য একটি সারি থাকবে:

  • campaign
  • segments.ad_network_type
  • segments.date

ফলাফলগুলি প্রধান সম্পদের প্রতিটি দৃষ্টান্ত দ্বারা অন্তর্নিহিতভাবে বিভক্ত করা হয়, নির্বাচিত পৃথক ক্ষেত্রগুলির মান দ্বারা নয়। যেমন,

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

প্রতি প্রচারাভিযানে এক সারিতে ফলাফল হয়, campaign.status ক্ষেত্রের স্বতন্ত্র মান প্রতি এক সারি নয়।