রিলিজ নোট

বর্তমান এবং পরিকল্পিত ফিচার বাতিলের একটি হালনাগাদ তালিকার জন্য ফিচার বাতিল অংশটি দেখুন।

v25 প্রধান এবং অপ্রধান সংস্করণ

Google Ads API v25-এ নিম্নলিখিত নতুন ফিচার, আপডেট এবং বড় ধরনের পরিবর্তনগুলো অন্তর্ভুক্ত রয়েছে।

v25.2 (2026-09-23)

Google Ads API v25.2-এ নিম্নলিখিত নতুন বৈশিষ্ট্য এবং আপডেটগুলি যোগ করা হয়েছে। v25.2-এর মতো ছোট সংস্করণগুলিতে বড় ধরনের কোনো পরিবর্তন থাকে না।

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
সম্পদ
AssetGroup জন্য ইউআরএল বিকল্পগুলি নতুন ক্ষেত্র AssetGroup ইউআরএল অপশনের জন্য সমর্থন যোগ করা হয়েছে, যা বিজ্ঞাপনদাতাদের অ্যাসেট গ্রুপ স্তরে ট্র্যাকিং টেমপ্লেট, কাস্টম প্যারামিটার এবং চূড়ান্ত ইউআরএল সাফিক্স নির্দিষ্ট করার সুযোগ দেবে:
  • AssetGroup.tracking_url_template : ট্র্যাকিং ইউআরএল তৈরির জন্য ইউআরএল টেমপ্লেট।
  • AssetGroup.url_custom_parameters : tracking_url_template , final_urls , বা final_mobile_urls এ URL কাস্টম প্যারামিটার ট্যাগ প্রতিস্থাপনের জন্য ব্যবহৃত ম্যাপিংগুলির একটি তালিকা।
  • AssetGroup.final_url_suffix : প্যারালাল ট্র্যাকিংয়ের মাধ্যমে পরিবেশিত ল্যান্ডিং পেজের ইউআরএল-এ প্যারামিটার যুক্ত করার জন্য ইউআরএল টেমপ্লেট।
প্রচারণা
স্বয়ংক্রিয় ভিডিও ক্রল তথ্য নতুন ক্ষেত্র এবং এনাম Campaign.AssetAutomationSetting এ AssetAutomationType.AUTOMATED_VIDEO_CRAWL এর সাথে AutomatedVideoCrawlSetting যোগ করা হয়েছে, যা আপনাকে একটি Performance Max ক্যাম্পেইনের জন্য স্বয়ংক্রিয় ভিডিও ক্রল সেটিংস নির্দিষ্ট করার সুযোগ দেয়। AutomatedVideoCrawlSetting.automated_video_crawl_infos AutomatedVideoCrawlInfo এন্ট্রিগুলির একটি তালিকা থাকে, যার প্রতিটি একটি ক্রল url , source_platform ( VideoCrawlSourcePlatform : LANDING_PAGE , SOCIAL , বা YOUTUBE ), এবং enabled অপ্ট-ইন স্ট্যাটাস কনফিগার করে।
গ্রাহক জীবনচক্র অপ্টিমাইজেশন মান গুণক ত্রুটি নতুন এনাম মান এবং ত্রুটি কাস্টমার লাইফসাইকেল অপটিমাইজেশনের জন্য ভ্যালু মাল্টিপ্লায়ার ( value_multiplier এবং high_lifetime_value_multiplier ) কনফিগার করার সময় নতুন ভ্যালিডেশন ত্রুটির কারণ যোগ করা হয়েছে:
SmartCampaignSettingService.GeneratePMaxDraftCampaign নতুন বৈশিষ্ট্য বিদ্যমান একটি স্মার্ট ক্যাম্পেইন থেকে পারফরম্যান্স ম্যাক্স ড্রাফট ক্যাম্পেইন তৈরি করার জন্য SmartCampaignSettingService.GeneratePMaxDraftCampaign যোগ করা হয়েছে, যা CampaignStatus.PAUSED স্ট্যাটাস এবং CampaignCreationStatus.INCOMPLETE ক্রিয়েশন স্ট্যাটাস দিয়ে ইনিশিয়ালাইজ করা হয় (দেখুন স্মার্ট ক্যাম্পেইনকে PMax ক্যাম্পেইনে রূপান্তর করুন ):
রূপান্তর
ফায়ারবেস বিজ্ঞাপন ইম্প্রেশন নতুন রূপান্তর ক্রিয়া প্রকার এবং বিভাগ FIREBASE_ANDROID_APP_AD_IMPRESSION এবং FIREBASE_IOS_APP_AD_IMPRESSION কনভার্সন অ্যাকশন টাইপগুলো উন্মুক্ত করা হয়েছে, যা আপনাকে এই কনভার্সন অ্যাকশনগুলো পুনরুদ্ধার এবং পরিবর্তন করার সুযোগ দেবে। এছাড়াও, ইন-অ্যাপ বিজ্ঞাপন থেকে আয় ট্র্যাক করার জন্য ConversionActionCategory এর অধীনে IN_APP_AD_REVENUE ক্যাটাগরিটি উন্মুক্ত করা হয়েছে।
সাধারণ
BusinessProfileLocationSyncError নতুন এনাম এবং ত্রুটি LOCATION_SYNC টাইপের AssetSet এ লোকেশন সিঙ্ক করার সময় বিজনেস প্রোফাইল লোকেশন সিঙ্ক ত্রুটির কারণগুলি যোগ করা হয়েছে। একটি সাধারণ UNKNOWN ত্রুটি ফেরত দেওয়ার পরিবর্তে, API এখন নির্দিষ্ট কারণসহ ( EMAIL_INVALID , OAUTH_TOKEN_INVALID , ACCOUNT_REMOVED , এবং NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT ) BusinessProfileLocationSyncError ফেরত দেয়।
পরিকল্পনা
BenchmarksService.GenerateBenchmarksMetrics পার্সেন্টাইল মেট্রিক্স নতুন বৈশিষ্ট্য

অন্যান্য বিজ্ঞাপনদাতাদের মধ্যে গ্রাহকের প্রতিযোগিতামূলক অবস্থানকে পার্সেন্টাইল টিয়ার ফরম্যাটে উপস্থাপনকারী মেট্রিক্স প্রদানের জন্য BenchmarksService.GenerateBenchmarksMetrics আপডেট করা হয়েছে। মেট্রিক্সগুলো নতুন CustomerMetrics.percentile_metrics ফিল্ডে ( GenerateBenchmarksMetricsResponse.customer_metrics এবং BreakdownMetrics.customer_metrics উভয় ক্ষেত্রেই) PercentileMetrics হিসেবে ফেরত আসে এবং BenchmarksCustomerPercentileTier ব্যবহার করে উপস্থাপন করা হয়।

GenerateBenchmarksMetricsRequest এ নিম্নলিখিত উভয় শর্ত পূরণ হলেই CustomerMetrics.percentile_metrics ডেটা যুক্ত হয়:

ListBenchmarksAvailableDatesResponse.supported_dates (যা BenchmarksService.ListBenchmarksAvailableDates দ্বারা রিটার্ন করা হয়)-এর মধ্যে থাকা ওপেন কোয়ার্টার তারিখগুলোর জন্য পার্সেন্টাইল মেট্রিক্সের সাপোর্ট যোগ করা হয়েছে। যদিও কাস্টমার অ্যাগ্রিগেট মেট্রিক্স ( CustomerMetrics.aggregate_metrics ), কাস্টমার রেট মেট্রিক্স ( CustomerMetrics.average_rate_metrics ), এবং কাস্টমার পার্সেন্টাইল মেট্রিক্স ( CustomerMetrics.percentile_metrics ) supported_dates এর অন্তর্ভুক্ত সমস্ত তারিখে (ওপেন কোয়ার্টার সহ) সমর্থিত, কাস্টমার শেয়ার মেট্রিক্স ( CustomerMetrics.share_metrics ) এবং বেঞ্চমার্ক সোর্সের রেট মেট্রিক্স ( average_benchmarks_metrics , যেমন "/Apparel/Clothing" অ্যাডের average_cpm ) ওপেন কোয়ার্টারের জন্য সমর্থিত নয় এবং রেসপন্স থেকে বাদ দেওয়া হয়, যদি না অনুরোধ করা date_range ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics সংকীর্ণ পরিসরের মধ্যে পড়ে।

ব্যবহারযোগ্যতা উন্নত করার জন্য একটি কাস্টম BenchmarksError.NO_METRICS_FOUND এরর যোগ করা হয়েছে, যা নির্দেশ করে যে নির্বাচিত ইনপুটগুলোর সমন্বয়ের জন্য কোনো মেট্রিক খুঁজে পাওয়া যায়নি।

ক্রিয়েটর ইনসাইটস-এর জন্য ইউটিউব চ্যানেল হ্যান্ডেল নতুন বৈশিষ্ট্য ContentCreatorInsightsService.GenerateCreatorInsights আপডেট করা হয়েছে, যা এখন YouTubeChannels.youtube_channel_handles ব্যবহার করে ইউটিউব চ্যানেল হ্যান্ডেল দিয়ে সার্চ করার সুবিধা দেয় (বৈধ চ্যানেল হ্যান্ডেল অবশ্যই @ দিয়ে শুরু হতে হবে, যেমন @channel_handle )। এই অপশনটি ইউটিউব চ্যানেল আইডি দিয়ে সার্চ করার মতোই। রেসপন্সে অনুরোধ করা ইউটিউব ক্রিয়েটরদের সম্পর্কে ইনসাইটস থাকে।
সুপারিশসমূহ
CPA এবং ROAS দরপত্র সুপারিশ নতুন সুপারিশ সার্চ ক্যাম্পেইনগুলোর জন্য নিলামে প্রবেশের ক্ষেত্রে বিড খুব কম হলে টার্গেট সিপিএ বাড়ানো বা টার্গেট আরওএএস কমানোর সুবিধা দিতে, ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low এবং Recommendation.lower_target_roas_performance_bid_too_low_recommendation RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW Recommendation.raise_target_cpa_performance_bid_too_low_recommendation LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW এবং ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low ( LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW ) যোগ করা হয়েছে।
প্রতিবেদন
হোটেল ভ্রমণসূচীর মাত্রা বিভাগ নতুন বিভাগ Segments এ নিম্নলিখিত হোটেল এবং ভ্রমণ বুকিং ইটিনারি ডাইমেনশন সেগমেন্টগুলি যোগ করা হয়েছে ( campaign , ad_group এবং customer দিয়ে নির্বাচনযোগ্য):
  • Segments.advance_booking_window : ভ্রমণসূচীটির জন্য অগ্রিম বুকিংয়ের সময়সীমা (দিনে)।
  • Segments.length_of_booking : ভ্রমণসূচীটির জন্য বুকিংয়ের সময়কাল (দিনে)।
  • Segments.start_date : বুকিং শুরুর তারিখ, যা yyyy-MM-dd ফরম্যাটে থাকবে।
  • Segments.start_day_of_week : বুকিং-এর সপ্তাহের শুরুর দিন ( DayOfWeek )।
  • Segments.user_set_dates : ব্যবহারকারী-নির্দিষ্ট তারিখ নির্বাচন করা হয়েছে কিনা তা নির্দেশ করে ( HotelDateSelectionType )।
উল্লম্ব বিজ্ঞাপন মেট্রিক্স নতুন মেট্রিক্স হোটেল এবং ট্র্যাভেল ভার্টিক্যাল অ্যাড রিপোর্টিং-এর জন্য Metrics এ নিম্নলিখিত মেট্রিক্সগুলো যোগ করা হয়েছে ( campaign , ad_group এবং customer দিয়ে নির্বাচনযোগ্য):
  • Metrics.vertical_ads_average_booking_value_micros : হোটেল বুকিংয়ের ক্ষেত্রে, মোট অবস্থানকালের জন্য কর ও ফি সহ, ক্লিক-ভিত্তিক গড় দৈনিক রেট (মাইক্রো এককে)।
  • Metrics.vertical_ads_potential_impressions : কোয়েরি কনটেক্সট জুড়ে উপলব্ধ মোট ভিউ-ক্যাপড যোগ্য ইম্প্রেশন।
  • Metrics.vertical_ads_price_difference_percentage : একই সম্পত্তির জন্য বিজ্ঞাপনদাতার প্রস্তাবিত মূল্য এবং সর্বনিম্ন প্রতিযোগী মূল্যের মধ্যে শতাংশ পার্থক্য।
উল্লম্ব বিজ্ঞাপন বিভাগ নতুন বিভাগ হোটেল এবং ট্র্যাভেল ভার্টিক্যাল অ্যাড রিপোর্টিং-এর জন্য Segments -এ নিম্নলিখিত সেগমেন্টগুলি যোগ করা হয়েছে ( campaign , ad_group এবং customer দিয়ে নির্বাচনযোগ্য):

v25.1 (২০২৬-০৮-১৯)

Google Ads API v25.1-এ নিম্নলিখিত নতুন বৈশিষ্ট্য এবং আপডেটগুলি যোগ করা হয়েছে। v25.1-এর মতো ছোট সংস্করণগুলিতে বড় ধরনের কোনো পরিবর্তন থাকে না।

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
সম্পদ
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER
নতুন এনাম মান টেক্সট ডিসক্লেইমার অ্যাসেটের জন্য সমর্থন যোগ করা হয়েছে।
প্রচারণা
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time
নতুন ক্ষেত্র এআই ম্যাক্স-এ আসন্ন স্বয়ংক্রিয় স্থানান্তর ট্র্যাক করুন।
রূপান্তর
ব্র্যান্ড লিফট পরিমাপ নতুন বৈশিষ্ট্য নিম্নলিখিত আপডেটগুলির মাধ্যমে ব্র্যান্ড লিফট পরিমাপের জন্য সমর্থন যোগ করা হয়েছে:
রূপান্তর লিফট পরিমাপ নতুন বৈশিষ্ট্য নিম্নলিখিত আপডেটগুলির মাধ্যমে কনভার্সন লিফট পরিমাপের জন্য সমর্থন যোগ করা হয়েছে:
  • একটি লিফট স্টাডির প্রতিনিধিত্বকারী LiftMeasurementConfig নামে একটি নতুন পঠনযোগ্য রিসোর্স যোগ করা হয়েছে।
  • লিফট ফলাফলকে ভাগ ও ফিল্টার করার জন্য নতুন নির্বাচনযোগ্য সেগমেন্ট যোগ করা হয়েছে।
  • লিফট পারফরম্যান্সের বিশদ পরিসংখ্যানগত বিশ্লেষণের জন্য ২৪টি নতুন কনভার্সন লিফট মেট্রিক এবং উইনার স্কোর মেট্রিক যোগ করা হয়েছে।
  • ক্যাম্পেইনের বিবরণ এবং কনভার্সন লক্ষ্যমাত্রা পুনরুদ্ধারের সুবিধা যোগ করা হয়েছে।
  • Experiment.lift_measurement_config নামে একটি নতুন ঐচ্ছিক ফিল্ড যোগ করা হয়েছে।
  • ConversionLiftIncludedConversionActionTypes enum-টি যোগ করা হয়েছে।
LiftMeasurementFlight নতুন সম্পদ একটি নতুন পঠনযোগ্য রিসোর্স যা একটি লিফট পরিমাপ কনফিগারেশনের জন্য ফ্লাইটের বিবরণ উপস্থাপন করে, যার মধ্যে পরিমাপকৃত ফ্লাইটের শুরু এবং শেষের তারিখ ( start_date এবং end_date ) অন্তর্ভুক্ত রয়েছে।
সাধারণ
SmartCampaignError নতুন এনাম মান পারফরম্যান্স ম্যাক্স জেনারেশন সীমাবদ্ধতার জন্য নতুন নির্দিষ্ট ত্রুটি কোড যোগ করা হয়েছে:
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION নতুন এনাম মান / ত্রুটি যখন TEST অ্যাক্সেস লেভেলযুক্ত কোনো গুগল ক্লাউড প্রজেক্ট একটি নন-টেস্ট অ্যাকাউন্টের বিরুদ্ধে অনুরোধ পাঠানোর চেষ্টা করে, তখন এটি ফেরত আসে।
পরিকল্পনা
ব্র্যান্ডের মনোভাব সম্পর্কিত অন্তর্দৃষ্টি নতুন বৈশিষ্ট্য ContentCreatorInsightsService এ ব্র্যান্ড সেন্টিমেন্ট ইনসাইটস-এর জন্য সমর্থন যোগ করা হয়েছে:
BenchmarksService উন্নয়ন নতুন বৈশিষ্ট্য বেঞ্চমার্ক বিশ্লেষণের পরিধি নির্ধারণের জন্য ফিল্টার হিসেবে ক্যাটাগরি ব্যবহারের সুবিধা যোগ করা হয়েছে। এছাড়াও অতিরিক্ত ব্যবসায়িক গুরুত্বপূর্ণ মেট্রিকগুলো সমর্থন করা হয়েছে:
  • BenchmarksService.GenerateBenchmarksMetrics এবং category_filter ব্যবহার করে এক বা একাধিক পণ্য ও পরিষেবা বিভাগে বিজ্ঞাপন চালানো সমস্ত বিজ্ঞাপনদাতাদের সাথে বেঞ্চমার্ক করার একটি বিকল্প যোগ করা হয়েছে।
  • গ্রাহকের মোট খরচ ও ভিউ-এর মতো আরও গ্রাহক বিজ্ঞাপন মেট্রিক এবং share_of_voice এর মতো শেয়ার মেট্রিক প্রকাশ করা হয়েছে। AggregateMetrics এবং ShareMetrics ব্যবহার করে মেট্রিকগুলো ফেরত দেওয়া হয়।
  • CATEGORY সোর্স টাইপ ব্যবহার করে BenchmarksService.ListBenchmarksSources এর মাধ্যমে সমর্থিত ক্যাটাগরিগুলোর তালিকা পাওয়া যাবে।
পিতামাতার অবস্থা লক্ষ্য নির্ধারণ নতুন বৈশিষ্ট্য রিচ প্ল্যানিং-এ প্যারেন্টাল স্ট্যাটাস টার্গেটিং-এর জন্য সাপোর্ট যোগ করা হয়েছে। ReachPlanService.GenerateReachForecast সার্ভিসের Targeting এ parental_statuses নতুন ফিল্ডটি এবং ReachPlanService.ListPlannableProducts সার্ভিসের PlannableTargeting -এ parental_statuses যোগ করা হয়েছে।
সুপারিশসমূহ
Recommendation.campaign_specific_app_goal_recommendation নতুন সুপারিশ ক্যাম্পেইন-নির্দিষ্ট একটি অ্যাপ কনভার্সন গোল যোগ করার পরামর্শ দেওয়া হচ্ছে। এই সুপারিশের মধ্যে বর্তমান গোলগুলো উপস্থাপন করতে নতুন EffectiveAutomaticGoal রিসোর্সটি ব্যবহার করা হয়েছে।
প্রতিবেদন
Metrics.original_conversion_value নতুন ক্ষেত্র এটি বিডযোগ্য রূপান্তর থেকে প্রাপ্ত মূল রূপান্তর মানকে বোঝায়। রূপান্তর মান বিধি বা জীবনচক্র লক্ষ্য সমন্বয়ের মতো কোনো মান বিধি সমন্বয় প্রয়োগ করার আগে, এটি হলো রূপান্তরগুলোর অপরিবর্তিত মান।
আনুগত্য সদস্যপদ পরিসংখ্যান নতুন বৈশিষ্ট্য ব্যবহারকারীর লয়্যালটি মেম্বারশিপ প্রোগ্রামের স্ট্যাটাস অনুযায়ী পরিসংখ্যান বিভাজনের জন্য সমর্থন যোগ করা হয়েছে, এবং কনভার্সন ভ্যালু রুলসের জন্য লয়্যালটি মেম্বারশিপ প্রাইমারি ডাইমেনশন যোগ করা হয়েছে:
  • রূপান্তরকারী ব্যবহারকারীর লয়্যালটি প্রোগ্রাম টিয়ার অনুযায়ী রিপোর্ট মেট্রিক্সকে ভাগ করার জন্য Segments.loyalty_membership সেগমেন্টটি যোগ করা হয়েছে।
  • একটি কনভার্সন ভ্যালু রুলের জন্য লয়্যালটি মেম্বারশিপের শর্ত কখন পূরণ হয়েছে তা শনাক্ত করতে LOYALTY_MEMBERSHIP প্রাইমারি ডাইমেনশনটি যোগ করা হয়েছে।
লক্ষ্য নির্ধারণ
vertical_ads_item_bid নতুন মানদণ্ড প্রকার AdGroupCriterion.criterion এ নতুন vertical_ads_item_bid ক্রাইটেরিয়ন টাইপটি যোগ করা হয়েছে।

v25 (২০২৬-০৭-২২)

গুগল অ্যাডস এপিআই ভি২৫-এ নিম্নলিখিত নতুন ফিচার, আপডেট এবং ব্রেকিং চেঞ্জগুলো যোগ করা হয়েছে, যা একটি মেজর রিলিজ।

নির্দেশনার জন্য সর্বশেষ সংস্করণে আপগ্রেড দেখুন।

ব্রেকিং পরিবর্তন

প্রাথমিক অবস্থা নতুন রাজ্য ধরণ পরিবর্তন করুন বাস্তবায়ন নির্দেশিকা
প্রচারণা
CustomerLifecycleOptimizationValueSettings এ additional_value এবং additional_high_lifetime_value নামক স্বতন্ত্র ফিল্ড যথাক্রমে value_adjustment এবং high_lifetime_value_adjustment ওয়ানঅফগুলোর অংশ, নতুন value_multiplier এবং high_lifetime_value_multiplier ফিল্ডগুলোর পাশাপাশি। কাঠামোগত পরিবর্তন এই ফিল্ডগুলোর রেফারেন্স আপডেট করুন, কারণ এগুলো এখন ওয়ানঅফ (oneof) এর অংশ।
লিগ্যাসি CustomerLifecycleGoal এবং CampaignLifecycleGoal রিসোর্সসমূহ, তাদের সংশ্লিষ্ট সার্ভিস CustomerLifecycleGoalService এবং CampaignLifecycleGoalService , এবং লিগ্যাসি সেটিংস/এনামসমূহ ( CustomerAcquisitionGoalSettings , CustomerAcquisitionOptimizationModeEnum , LifecycleGoalValueSettings ) কোনোটিই না অপসারণ সংশোধিত সমন্বিত লক্ষ্য কাঠামো ব্যবহার করুন:
সাধারণ
ইনসেনটিভ সার্ভিস অনুরোধ এবং প্রতিক্রিয়া বার্তাগুলিতে নেস্টেড এনুম ফিল্ড:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
স্বতন্ত্র এনাম ক্ষেত্রসমূহ: নাম পরিবর্তন / অপসারণ পুরানো type ফিল্ডগুলির পরিবর্তে নতুন স্বতন্ত্র এনাম ফিল্ডগুলি ব্যবহার করুন।
ApplyIncentiveRequest এ ঐচ্ছিক selected_incentive_id এবং customer_id ফিল্ড প্রয়োজনীয় ক্ষেত্রসমূহ আচরণগত পরিবর্তন ApplyIncentive কল করার সময় উভয় ফিল্ডই পূরণ করা নিশ্চিত করুন।
LocalServicesLead রিসোর্সের ContactDetails.email নামক গ্রাহকের ইমেল ঠিকানা ফিল্ড। কোনোটিই না অপসারণ এই ফিল্ডটির উল্লেখগুলো মুছে ফেলুন কারণ এটি আর সমর্থিত নয়।
AdvertisingPartnerLinkInvitationProperties এর ঐচ্ছিক allowed_domain ফিল্ড বিজ্ঞাপন অংশীদারের জন্য CreateProductLinkInvitation কল করার সময় এই ফিল্ডটি আবশ্যক। আচরণগত পরিবর্তন বিজ্ঞাপনী অংশীদারের জন্য প্রোডাক্ট লিঙ্ক আমন্ত্রণ তৈরি করার সময় allowed_domain প্রদান করা নিশ্চিত করুন।
পরিকল্পনা
GenerateCreatorInsightsRequest এর search_brand ফিল্ড কোনোটিই না অপসারণ এর পরিবর্তে search_topics ব্যবহার করুন।
Targeting এর plannable_location_id ফিল্ড এবং GenerateReachForecastRequest এর cookie_frequency_cap ফিল্ড কোনোটিই না অপসারণ plannable_location_ids এবং cookie_frequency_cap_setting ব্যবহার শুরু করুন।
প্রতিবেদন
Metrics টাইপের GenerateBenchmarksMetricsResponse এবং BreakdownMetrics এর customer_metrics ফিল্ড CustomerMetrics ধরনের ক্ষেত্র ধরণ পরিবর্তন / আচরণগত পরিবর্তন আপনার ইন্টিগ্রেশনগুলিকে নতুন CustomerMetrics টাইপ ব্যবহার করার জন্য আপডেট করুন, যেটিতে শুধুমাত্র গ্রাহকের বিজ্ঞাপনের পারফরম্যান্সের মেট্রিকগুলি থাকে।

বৈশিষ্ট্য এবং আপডেট (অস্থায়ী নয়)

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
বিজ্ঞাপন
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS নতুন এনাম মান / আচরণ DemandGenMultiAssetAds জন্য উপলব্ধ। সক্রিয় করা হলে, এটি ইনপুট হিসাবে নন-অ্যানিমেটেড ছবি ব্যবহার করে অ্যানিমেটেড ছবি তৈরি করে। এই API সংস্করণ থেকে নতুন DemandGenMultiAssetAds ডিফল্টরূপে অপ্ট-ইন করা থাকে।
কৃত্রিম বিষয়বস্তু তথ্যের পরিবর্তনশীলতা আচরণ পরিবর্তন v25, v24, এবং v23-এ এখন Asset.synthetic_content_info এবং Ad.synthetic_content_info সম্পূর্ণরূপে পরিবর্তনযোগ্য।
প্রচারণা
আনুগত্য ধরে রাখার লক্ষ্য নতুন বৈশিষ্ট্য / সেটিংস লয়্যালটি রিটেনশন গোলের জন্য সমর্থন যোগ করা হয়েছে, যা বিজ্ঞাপনদাতাদের লয়্যালটি প্রোগ্রামের সদস্যদের ধরে রাখার জন্য ক্যাম্পেইন অপ্টিমাইজ করতে সাহায্য করে।
নতুন গ্রাহক অর্জনের লক্ষ্য নতুন বৈশিষ্ট্য / সেটিংস সংশোধিত একীভূত গোল স্কিমার সাথে সামঞ্জস্য রেখে গুগল অ্যাডস এপিআই-তে নতুন গ্রাহক অধিগ্রহণ গোলের সাপোর্ট আপডেট করা হয়েছে:
রূপান্তর
ইউটিউব তৃতীয় পক্ষের রূপান্তর অ্যাট্রিবিউশন নতুন ক্ষেত্র তৃতীয় পক্ষের অংশীদারদের ব্যবহার করে ইউটিউব কনভার্সন অ্যাট্রিবিউশন যাচাইকরণের জন্য সমর্থন যোগ করা হয়েছে: আরও জানতে সহায়তা কেন্দ্রের নিবন্ধটি দেখুন।
সাধারণ
ContactDetails.phone_number_extension নতুন ক্ষেত্র LocalServicesLead রিসোর্সে যোগ করা হয়েছে।
IncentiveError নতুন এনাম মান এবং ত্রুটি ইনসেনটিভ রিডেম্পশন ব্যর্থতার জন্য নতুন নির্দিষ্ট এরর কোড যোগ করা হয়েছে:
  • BILLING_COUNTRY_NOT_ELIGIBLE দেশ যোগ্য নয় (গ্রাহকের বিলিং দেশ প্রণোদনার জন্য যোগ্য নয়)
  • USER_IS_MCC_MANAGER (ব্যবহারকারী একজন ম্যানেজার অ্যাকাউন্ট এবং ইনসেনটিভটি রিডিম করতে পারবেন না)
  • USER_SUSPENDED (গ্রাহক অ্যাকাউন্টটি স্থগিত করা হয়েছে)
  • MAX_PENDING_INCENTIVES (গ্রাহক সর্বোচ্চ সংখ্যক অপেক্ষাধীন প্রণোদনায় পৌঁছেছেন)
  • ACCOUNT_HAD_RECENT_SPEND (অ্যাকাউন্টটিতে সম্প্রতি খরচ হয়েছে এবং এটি যোগ্য নয়)
  • অফার থেকে MAX_INCENTIVES_REDEEMED_FROM_OFFER সংখ্যক ইনসেনটিভ রিডিম করা হয়েছে (গ্রাহক ইতিমধ্যেই এই অফার থেকে সর্বাধিক সংখ্যক ইনসেনটিভ রিডিম করেছেন)
  • বিলিং দেশের কোড MISMATCHING_BILLING_COUNTRY_CODE (অনুরোধে প্রদত্ত বিলিং দেশের কোড গ্রাহকের অ্যাকাউন্টের দেশের সাথে মেলে না)
পরিকল্পনা
ট্রেন্ডিং ইনসাইটস-এ ইউটিউব চ্যানেলের বিবরণ নতুন ক্ষেত্র ট্রেন্ডিং ইনসাইটস অনুসন্ধান করার সময় সম্পর্কিত ভিডিওগুলির আরও ইউটিউব চ্যানেলের বিবরণ দেখানোর সুবিধা যোগ করা হয়েছে। YouTubeVideoAttributeMetadata তে channel_id , channel_name এবং channel_url এই নতুন ফিল্ডগুলি যোগ করা হয়েছে।
YouTubeChannelInsights.data_sharing_consent_given নতুন ক্ষেত্র YouTubeChannelInsights এ যোগ করা হয়েছে। এটি তখনই সত্যি হয়, যখন কোনো ক্রিয়েটর অপ্রকাশ্য ডেটা শেয়ার করার জন্য সম্মতি দিয়ে থাকেন। সেক্ষেত্রে, নিম্নলিখিত ফিল্ডগুলো পূরণ করা হয়:
প্রতিবেদন
ad_sub_format_type নতুন অংশ ইউটিউবের ইনস্ট্রিমে থাকা স্কিপ-অযোগ্য বিজ্ঞাপনগুলোর সময়কাল অনুযায়ী একটি বিশদ বিবরণ প্রদান করে:
  • INSTREAM_NON_SKIPPABLE_STANDARD (স্ট্যান্ডার্ড সময়কালের ইনস্ট্রিম নন-স্কিপেবল বিজ্ঞাপন)
  • INSTREAM_NON_SKIPPABLE_MAX30_SEC (স্ট্রিমের মধ্যে থাকা একটি নন-স্কিপেবল বিজ্ঞাপন, যা ৩০.৯৯ সেকেন্ডের বেশি দীর্ঘ নয়)
  • INSTREAM_NON_SKIPPABLE_MAX60_SEC (স্ট্রিমের মধ্যে থাকা একটি নন-স্কিপেবল বিজ্ঞাপন, যা ৬০.৯৯ সেকেন্ডের বেশি দীর্ঘ নয়)
এই সেগমেন্টটি অবশ্যই ad_format_type সাথে একত্রে নির্বাচন করতে হবে। এটি AdGroup , AdGroupAd , Campaign , Customer , Video এবং VideoEnhancement সাথে নির্বাচনযোগ্য।
ভিডিও-নির্দিষ্ট সামাজিক মেট্রিক্স নতুন ক্ষেত্র / মেট্রিক্স ইউটিউবে শর্টস বিজ্ঞাপনের জন্য বিজ্ঞাপনদাতাদের ব্যবহারকারীর সম্পৃক্ততা (মন্তব্য, লাইক এবং শেয়ার) ট্র্যাক করতে সাহায্য করার জন্য ভিডিও-নির্দিষ্ট সোশ্যাল মেট্রিক্স যোগ করা হয়েছে: এগুলো AdGroup , AdGroupAd , Asset , Campaign , Customer এবং Video তে পাওয়া যায়।

v24 প্রধান এবং অপ্রধান সংস্করণ

Google Ads API v24-এ নিম্নলিখিত নতুন ফিচার, আপডেট এবং বড় ধরনের পরিবর্তনগুলো অন্তর্ভুক্ত রয়েছে।

v24.2 (2026-06-24)

Google Ads API v24.2-এ নিম্নলিখিত নতুন বৈশিষ্ট্য এবং আপডেটগুলি যোগ করা হয়েছে। v24.2-এর মতো ছোট সংস্করণগুলিতে বড় ধরনের কোনো পরিবর্তন থাকে না।

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
বিজ্ঞাপন
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT নতুন এনাম মান DemandGenVideoResponsiveAd ইনস্ট্যান্সগুলির (যা এই API সংস্করণ থেকে ডিফল্টরূপে অপ্ট-ইন করা থাকে) এনগেজমেন্ট প্যানেলে দেখানোর জন্য ল্যান্ডিং পেজ থেকে টেক্সট তথ্য তৈরি করে।
সম্পদ
AssetGroup.google_local_services_info নতুন ক্ষেত্র পারফরম্যান্স ম্যাক্স ক্যাম্পেইনে লোকাল সার্ভিসেস অ্যাডের তথ্য (ক্যাটাগরি আইডি এবং কলআউট) সমর্থন করার জন্য এটি যুক্ত করা হয়েছে।
AssetGroupSignal.local_services_id নতুন ক্ষেত্র পারফরম্যান্স ম্যাক্স ক্যাম্পেইনে লোকাল সার্ভিসেস অ্যাডস সার্ভিস আইডি সিগন্যাল সমর্থন করার জন্য এটি যুক্ত করা হয়েছে।
AssetGroupSignal.vertical_ads_item_group_rule_list নতুন ক্ষেত্র পারফরম্যান্স ম্যাক্স ক্যাম্পেইনে সংযুক্ত ভার্টিকাল ফিড থেকে আইটেম নির্বাচন করার জন্য ভার্টিকাল অ্যাড আইটেম গ্রুপ রুল সমর্থন যোগ করা হয়েছে। এই ফিচারটি শুধুমাত্র অনুমোদিত তালিকায় থাকা অ্যাকাউন্টগুলোর জন্য উপলব্ধ।
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN নতুন এনাম মান / ত্রুটি একটি ক্যাম্পেইন থেকে সমস্ত অ্যাসেট গ্রুপ অপসারণ করার চেষ্টা করার সময় এটি ফেরত আসে।
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS নতুন এনাম মান / ত্রুটি একটি অ্যাসেট গ্রুপ থেকে সমস্ত সিগন্যাল অপসারণ করার চেষ্টা করার সময় এটি ফেরত এসেছে।
প্রচারণা
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled
নতুন ক্ষেত্র লোকাল সার্ভিসেস পারফরম্যান্স ম্যাক্স ক্যাম্পেইন শনাক্তকরণে সহায়তা করুন।
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps নতুন ক্ষেত্র ডিমান্ড জেন অ্যাড গ্রুপের নির্বাচনযোগ্য চ্যানেলগুলোর মধ্যে গুগল ম্যাপস অন্তর্ভুক্ত করা হয়েছে।
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN নতুন এনাম মান / ত্রুটি একটি লোকাল সার্ভিসেস পারফরম্যান্স ম্যাক্স ক্যাম্পেইন থেকে সমস্ত লোকেশন সরানোর চেষ্টা করার সময় এটি ফেরত এসেছে।
SmartCampaignErrorEnum.CREATION_FAILED নতুন এনাম মান / ত্রুটি নতুন স্মার্ট ক্যাম্পেইন তৈরি করার চেষ্টা করার সময় এটি ফেরত এসেছে।
রূপান্তর
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS
নতুন এনাম মান যখন কোনো ব্যবহারকারী স্থানীয় পরিষেবার বিজ্ঞাপনে ক্লিক করে বিজ্ঞাপনদাতাকে ফোন, মেসেজ বা বুকিং করেন, তখন যে রূপান্তরগুলো ঘটে, সেগুলোকে উপস্থাপন করুন।
পরীক্ষাগুলি
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION
নতুন এনাম মান নতুন ExperimentType প্রকারের জন্য সমর্থন যোগ করা হয়েছে:
  • COMPARE_CAMPAIGNS : ক্যাম্পেইন মিক্স এক্সপেরিমেন্ট এবং কাস্টম পারফরম্যান্স ম্যাক্স এক্সপেরিমেন্টের জন্য, যা একটিমাত্র এক্সপেরিমেন্টের মধ্যে একই বা ভিন্ন ধরনের একাধিক ক্যাম্পেইনের তুলনা করে।
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION : টেক্সট কাস্টমাইজেশন এবং ফাইনাল ইউআরএল এক্সপ্যানশনের জন্য পারফরম্যান্স ম্যাক্স অপটিমাইজেশন পরীক্ষার উদ্দেশ্যে।
সাধারণ
Asset.synthetic_content_info
Ad.synthetic_content_info
নতুন ক্ষেত্র কৃত্রিম/এআই-সৃষ্ট কন্টেন্টের জন্য অ্যাটেস্টেশন অন্তর্ভুক্ত, যা দুটি ভাগে বিভক্ত: advertiser_attestation (বিজ্ঞাপনদাতা কর্তৃক সরাসরি প্রদত্ত ঘোষণা) এবং system_attestation (সিস্টেম দ্বারা স্বয়ংক্রিয়ভাবে শনাক্ত বা প্রদত্ত অ্যাটেস্টেশন)।

এই ফিচারটি v23 এবং v22-এ ব্যাকপোর্ট করা হয়েছে।

v25-এর জন্য আপনার আসন্ন ইন্টিগ্রেশন কাজের পরিকল্পনায় সাহায্য করার জন্য, v22 এবং তার পরবর্তী সংস্করণগুলিতে অ্যাডভার্টাইজার অ্যাটেস্টেশন ফিল্ড পরিবর্তন করার ইন্টারফেসটি আগেভাগেই চালু করা হচ্ছে। এই সংস্করণগুলিতে ইন্টারফেসটি দেখা যাবে, কিন্তু synthetic_content_info.advertiser_attestation.status এবং synthetic_content_info.advertiser_attestation.source এই সংস্করণগুলির জন্য অপরিবর্তনীয় থাকবে।

আপনি যদি এই ফিল্ডগুলির কোনো একটিতে মিউটেট রিকোয়েস্ট করার চেষ্টা করেন, তাহলে এই ত্রুটিগুলির মধ্যে একটি ফেরত আসবে:

"যে ফিল্ডটি পরিবর্তন করার চেষ্টা করা হচ্ছে তা অপরিবর্তনযোগ্য" অথবা "ফিল্ডটি সেট করা যাবে না"।

v25 থেকে এই ফিল্ডগুলো সম্পূর্ণরূপে পরিবর্তনযোগ্য হয়ে যাবে। আমরা সুপারিশ করছি যে, আপনার অভ্যন্তরীণ লজিক তৈরি ও পরীক্ষা করার জন্য এখনই ইন্টারফেসটি ব্যবহার করুন, যাতে v25 চালু হলে আপনার সিস্টেম পূর্ণ রাইট ক্ষমতার জন্য প্রস্তুত থাকে।

বহু-পক্ষীয় অনুমোদন নতুন বৈশিষ্ট্য বহু-পক্ষীয় অনুমোদন (এমপিএ) পর্যালোচনার জন্য সমর্থন যোগ করা হয়েছে:
এই ফিচারটি v23.3 , v22.2 এবং v21.2- এ ব্যাকপোর্ট করা হয়েছে।
IncentiveService.FetchIncentive আচরণগত পরিবর্তন অনুরোধে একটি অবৈধ ইমেল ঠিকানা প্রদান করা হলে, পদ্ধতিটি এখন AuthenticationError.INVALID_EMAIL_ADDRESS ত্রুটি দেখানোর পরিবর্তে স্বয়ংক্রিয়ভাবে ডিফল্ট ইনসেনটিভ অফারগুলি ফেরত দেয়।
পরিকল্পনা
GenerateCreatorInsightsRequest.search_topics নতুন ক্ষেত্র ContentCreatorInsightsService.GenerateCreatorInsights সার্ভিসে যোগ করা হয়েছে। এই অপশনটি country_locations এ নির্দিষ্ট করা দেশে কোনো একটি বিষয় নিয়ে আলোচনা করা ক্রিয়েটরদের খুঁজে বের করে (শুধুমাত্র একটি দেশের জন্য অনুসন্ধান সমর্থন করে)।
CREATOR_TOPIC_INSIGHTS নতুন এনাম মান কোনো একটি বিষয় নিয়ে আলোচনা করা নির্মাতাদের অনুসন্ধানের জন্য এনটিটি বোঝাতে InsightsKnowledgeGraphEntityCapabilities এ যোগ করা হয়েছে। এই এনটিটিগুলো search_topics ফিল্ডে ব্যবহার করা উচিত। AudienceInsightsService.ListAudienceInsightsAttributes ব্যবহার করে এগুলো সংগ্রহ করা হয়।
KnowledgeGraphEntitySearchOptions নতুন প্রকার / বিকল্প ListAudienceInsightsAttributes এর টপিকগুলোর জন্য এতে অতিরিক্ত সার্চ অপশন রয়েছে, যার মধ্যে ক্রিয়েটর অ্যাট্রিবিউট হিসেবে সমর্থিত সমস্ত টপিক খুঁজে বের করার এবং ক্যাপাবিলিটি অনুসারে ফিল্টার করার অপশন অন্তর্ভুক্ত।
GenerateCreatorInsightsRequest.supplemental_data
GenerateTrendingInsightsRequest.supplemental_data
নতুন ক্ষেত্র ContentCreatorInsightsService মেথডগুলোর জন্য ঐচ্ছিক ইনপুট। এই ফিল্ডটি সরবরাহ করলে রেসপন্সে অতিরিক্ত লোকেশন বা ক্রিয়েটর অ্যাট্রিবিউটগুলো যুক্ত হয়।
local_creator_insights
related_local_creators
নতুন ক্ষেত্র যখন supplemental_data LOCAL_CREATOR_DATA enum থাকে, তখন এটি পূরণ করা হয়। এটি নির্বাচিত দেশে দেখা বা অবস্থিত সেইসব স্থানীয় নির্মাতাদের প্রদর্শন করে, যারা অবস্থানের তথ্য শেয়ার করতে সম্মতি দিয়েছেন।
GenerateTrendingInsightsRequest.sub_country_locations নতুন ক্ষেত্র ContentCreatorInsightsService.GenerateTrendingInsights এ এটি যুক্ত করা হয়েছে, যার ফলে দেশের অবস্থান এবং উপ-দেশের অবস্থান ব্যবহার করে ট্রেন্ডিং ইনসাইট অনুসন্ধান করা যাবে।
প্রতিবেদন
PerformanceMaxPlacementView সেগমেন্ট এক্সটেনশন ad_network_type অনুযায়ী বিভাজ্য করা হয়েছে।
কেনাকাটা
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads নতুন ক্ষেত্র সত্য হলে, শপিং বিজ্ঞাপনের জন্য ব্র্যান্ড বর্জন উপেক্ষা করা হয়। শুধুমাত্র শপিং ক্যাম্পেইনের জন্য সমর্থিত।
লক্ষ্য নির্ধারণ
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE নতুন এনাম মান / ত্রুটি অননুমোদিত কোনো ভাষাকে লক্ষ্য করার চেষ্টা করার ফলে এই ত্রুটিটি ফেরত এসেছে।
ভিডিও
DataLink.youtube_link_metadata নতুন ক্ষেত্র লিঙ্ক করা ইউটিউব ব্র্যান্ড চ্যানেলের আইডি নির্দিষ্ট করার জন্য এতে brand_channel_id থাকে।

v24.1 (২০২৬-০৫-১৩)

Google Ads API v24.1-এ নিম্নলিখিত নতুন বৈশিষ্ট্য এবং আপডেটগুলি যোগ করা হয়েছে। v24.1-এর মতো ছোট সংস্করণগুলিতে বড় ধরনের কোনো পরিবর্তন থাকে না।

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
বিজ্ঞাপন
DemandGenMultiAssetAdInfo.classic_display_images নতুন ক্ষেত্র অতিরিক্ত রেসপন্সিভ অ্যাসেটের প্রয়োজন ছাড়াই কাস্টম আপলোড করা ডিসপ্লে ইমেজ পরিবেশন করা হয়।
পরীক্ষাগুলি
ADOPT_AI_MAX
ADOPT_BROAD_MATCH_KEYWORDS
OPTIMIZE_ASSETS
PMAX_REPLACEMENT_SHOPPING
নতুন এনাম মান নতুন ExperimentType প্রকারের জন্য সমর্থন যোগ করা হয়েছে:
  • ADOPT_AI_MAX : সেইসব পরীক্ষার জন্য যা যাচাই করে যে, কীভাবে AI Max আপনাকে Google AI এবং ব্রড ম্যাচ কীওয়ার্ড ব্যবহার করে আরও বেশি গ্রাহককে সম্পৃক্ত করতে সাহায্য করতে পারে।
  • ADOPT_BROAD_MATCH_KEYWORDS : এই পরীক্ষাগুলোর জন্য যে, ব্রড ম্যাচ কীওয়ার্ড আপনার বিজ্ঞাপন প্রদর্শিত হওয়ার সংখ্যাকে কীভাবে প্রভাবিত করতে পারে।
  • OPTIMIZE_ASSETS : অ্যাসেট অপ্টিমাইজ করার জন্য কাস্টম এক্সপেরিমেন্টের জন্য।
  • PMAX_REPLACEMENT_SHOPPING : পারফরম্যান্স ম্যাক্স-এর তুলনায় আপনার শপিং ক্যাম্পেইনগুলো কেমন পারফর্ম করে, তা যাচাই করার জন্য ব্যবহৃত এক্সপেরিমেন্টগুলোর জন্য।
Experiment.video_experiment নতুন ক্ষেত্র ভিডিও ক্যাম্পেইন সমন্বিত বিদ্যমান YOUTUBE_CUSTOM এক্সপেরিমেন্টগুলোর জন্য কনফিগারেশন সাপোর্ট।
ExperimentArm.asset_testing_info
ExperimentArm.asset_groups
ExperimentArm.performance_max_experiment_arm_info
নতুন ক্ষেত্র এক্সপেরিমেন্ট আর্মগুলিতে অ্যাসেট টেস্টিং, অ্যাসেট গ্রুপ এবং পারফরম্যান্স ম্যাক্স সেটিংস সমর্থন করার জন্য ফিল্ডগুলি উন্মোচন করে:
  • asset_testing_info : বিজ্ঞাপনের পরীক্ষামূলক কপিগুলোর সাথে সংশ্লিষ্ট অ্যাসেটগুলোর বিবরণ।
  • asset_groups : ‘Optimize Assets’ এক্সপেরিমেন্টের এক্সপেরিমেন্ট আর্মে থাকা অ্যাসেট গ্রুপগুলোর তালিকা।
  • performance_max_experiment_arm_info : PMAX_REPLACEMENT_SHOPPING এক্সপেরিমেন্টগুলিতে পারফরম্যান্স ম্যাক্স ক্যাম্পেইনগুলির জন্য সেটিংস।
সাধারণ
CustomerUserAccess.passkey_enabled নতুন ক্ষেত্র ব্যবহারকারীর পাসকি সক্রিয় আছে কিনা তা নির্দেশকারী একটি পাঠযোগ্য ক্ষেত্র।
প্রতিবেদন
mobile_device_platform নতুন অংশ ব্যবহারকারীর ডিভাইসের প্ল্যাটফর্ম (যেমন iOS বা Android) অনুযায়ী রিপোর্ট ভাগ করার সুযোগ দেয়।
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED নতুন এনাম মান / ত্রুটি কোয়েরির তারিখের পরিসরের জন্য অনুরোধ করা দৈনিক, ঘণ্টাভিত্তিক বা সাপ্তাহিক সময়ের সূক্ষ্মতা সমর্থিত না হলে এটি ফেরত দেওয়া হয় (শুধুমাত্র শেষ ৩৭ মাসের জন্য উপলব্ধ)।
vertical_ads_listing_user_rating
vertical_ads_listing_venue
নতুন বিভাগ ভার্টিকাল বিজ্ঞাপনের জন্য নতুন সেগমেন্ট ব্যবহার করা হবে।
user_rating , venue , event_participant_display_name নতুন ফিল্টার মানদণ্ড SharedCriterion রিসোর্সের জন্য VerticalAdsItemGroupRuleInfo তে ফিল্টারিং সমর্থন করা হয়েছে।
নিয়ন্ত্রণ/চিকিৎসা পরীক্ষার মেট্রিক্স নতুন ক্ষেত্র সাতটি মূল মেট্রিক পরিবারের ( clicks , ইম্প্রেশন, খরচ, কনভার্সন, প্রতি কনভার্সনে খরচ, clicks_point_estimate ভ্যালু, প্রতি খরচে কনভার্সন ভ্যালু) জন্য কন্ট্রোল ভ্যালু ( control_clicks , ইত্যাদি), ট্রিটমেন্ট ভ্যালু (clicks, ইত্যাদি), পয়েন্ট এস্টিমেট (clicks_point_estimate, ইত্যাদি), মার্জিন অফ এরর ( clicks_margin_of_error , ইত্যাদি), এবং পি-ভ্যালু ( clicks_p_value , ইত্যাদি) যোগ করা হয়েছে।
রূপান্তর পরম পরিবর্তন মেট্রিক্স নতুন ক্ষেত্র পয়েন্ট এস্টিমেট, মার্জিন অফ এরর এবং পি-ভ্যালু ফিল্ড ব্যবহার করে Conversions অ্যাবসোলিউট ডিফারেন্স এস্টিমেশনের জন্য সাপোর্ট।
লক্ষ্য নির্ধারণ
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS নতুন এনাম মান / ত্রুটি সমস্ত জনসংখ্যাতাত্ত্বিক লক্ষ্যবস্তু বাদ দেওয়ার চেষ্টা করার সময় এটি ফেরত এসেছে।
ভিডিও
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR নতুন এনাম মান ZEFR-কে তৃতীয় পক্ষের ভিউএবিলিটি ইন্টিগ্রেশন পার্টনার হিসেবে প্রকাশ করা হয়েছে।
DataLink.youtube_video.channel_id নতুন ক্ষেত্র ডেটা লিঙ্কের সাথে যুক্ত ইউটিউব চ্যানেল আইডিটি প্রকাশ করে।

v24 (২০২৬-০৪-২২)

গুগল অ্যাডস এপিআই ভি২৪-এ নিম্নলিখিত নতুন ফিচার, আপডেট এবং ব্রেকিং চেঞ্জগুলো যোগ করা হয়েছে, যা একটি মেজর রিলিজ।

নির্দেশনার জন্য সর্বশেষ সংস্করণে আপগ্রেড দেখুন।

ব্রেকিং পরিবর্তন

প্রাথমিক অবস্থা নতুন রাজ্য ধরণ পরিবর্তন করুন বাস্তবায়ন নির্দেশিকা
বিজ্ঞাপন
DemandGenVideoResponsiveAdInfo তে ঐচ্ছিক videos এবং logo_images প্রয়োজনীয় ক্ষেত্রসমূহ আচরণগত পরিবর্তন রেসপন্সিভ ডিমান্ড জেন ভিডিও বিজ্ঞাপন তৈরি বা পরিবর্তন করার সময় videos এবং logo_images প্রদান করুন।
VideoResponsiveAdInfo তে ঐচ্ছিক videos , business_name এবং logo_images প্রয়োজনীয় ক্ষেত্রসমূহ আচরণগত পরিবর্তন ভিডিও রেসপন্সিভ বিজ্ঞাপন তৈরি বা পরিবর্তন করার সময় videos , business_name এবং logo_images প্রদান করুন। উল্লেখ্য যে, VideoResponsiveAdInfo এখন পরিবর্তনযোগ্য।
প্রচারণা
Campaign.video_brand_safety_suitability কোনোটিই না অপসারণ ক্যাম্পেইন-স্তরের উপযুক্ততা নিয়ন্ত্রণ সরিয়ে ফেলা হয়েছে। গ্রাহক-স্তরে ব্র্যান্ড সুরক্ষার উপযুক্ততা এখনও উপলব্ধ আছে। এর পরিবর্তে Customer.video_brand_safety_suitability ব্যবহার করুন।
রূপান্তর
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS কোনোটিই না অপসারণ লয়ালটি সাইন আপ ব্যবহারকারী বিভাগটি সরিয়ে ফেলা হয়েছে। কোড থেকে এর সমস্ত রেফারেন্স মুছে ফেলুন।
পরিকল্পনা
topic_audience_combinations জন্য InsightsAudienceAttributeGroup টাইপ common. InsightsAudienceAttributeGroup প্রকার আচরণগত পরিবর্তন / প্রকার পরিবর্তন নতুন রিসোর্স নেমস্পেসগুলো ব্যবহার করার জন্য টাইপড ক্লায়েন্ট লাইব্রেরি ইন্টিগ্রেশনগুলো অবশ্যই আপডেট করতে হবে।
ReachPlanService.ListPlannableProducts এর youtube_select_lineups ফিল্ড কোনোটিই না অপসারণ youtube_select_lineup_targeting থেকে লাইনআপ ব্যবহার করা শুরু করুন।
ContentCreatorInsightsService.GenerateCreatorInsights এবং GenerateTrendingInsights এর is_brand_connect_creator ফিল্ড কোনোটিই না অপসারণ এর পরিবর্তে, যাচাই করুন যে কোনো নির্মাতার partnership_opportunities এ CREATOR_PARTNERSHIPS উপলব্ধ আছে কিনা।
KeywordPlanIdeaService.GenerateKeywordForecastMetrics এ geo_modifiers এবং biddable_keywords geo_target_constants এবং keywords নাম পরিবর্তন / অপসারণ CampaignToForecast.geo_target_constants[] এবং ForecastAdGroup.keywords[] দ্বারা প্রতিস্থাপিত হয়েছে।
GenerateKeywordForecastMetrics এ অপ্রচলিত কীওয়ার্ড পরিকল্পনা / পূর্বাভাস ক্ষেত্র কোনোটিই না অপসারণ নিম্নলিখিত পরিকল্পনা / পূর্বাভাস ক্ষেত্র এবং প্রকারগুলি সরানো হয়েছে: সেই অনুযায়ী ইন্টিগ্রেশনগুলো আপডেট করুন।
প্রতিবেদন
campaign_budget বাজেটে ad_sub_network_type সেগমেন্ট কোনোটিই না অপসারণ campaign_budget রিসোর্সের জন্য ad_sub_network_type সেগমেন্টটি সরানো হয়েছে।
অ্যাসেট ভিউতে click_type সেগমেন্ট কোনোটিই না অপসারণ AdGroupAsset , CampaignAsset , এবং CustomerAsset ভিউগুলো থেকে সেগমেন্টটি সরানো হয়েছে।
ভিডিও
ShareablePreviewService.GenerateShareablePreviews এ আংশিক ব্যর্থতার অনুমতি দেওয়া হয়েছে। কোনো আংশিক ব্যর্থতা নেই আচরণগত পরিবর্তন অনুরোধের মধ্যে থাকা কোনো আইডি যাচাইকরণে ব্যর্থ হলে, অনুরোধটি ব্যর্থ হবে এবং একটি ত্রুটি দেখাবে।
ShareablePreviewError লিগ্যাসি কোডসমূহ: MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST
নাম পরিবর্তন / আচরণগত পরিবর্তন অ্যাসেট গ্রুপের জন্য ফেরত আসা এরর কোডগুলো অ্যাড গ্রুপের এররের সাথে সামঞ্জস্য রেখে পরিবর্তন করা হয়েছে। ভ্যালিডেশন ক্যাচ লজিক আপডেট করুন।

বৈশিষ্ট্য এবং আপডেট (অস্থায়ী নয়)

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
বিজ্ঞাপন
VideoResponsiveAdInfo এর পরিবর্তনশীলতা আচরণগত পরিবর্তন রেসপন্সিভ ভিডিও বিজ্ঞাপনের ইনফরমেশন অবজেক্টগুলো এখন পরিবর্তনযোগ্য।
সম্পদ
AssetSet travel_feed_data নতুন ক্ষেত্র ট্র্যাভেল ফিড অ্যাসেট অ্যাট্রিবিউটগুলো ( hotel_center_account_id , merchant_center_id , partner_center_id , subset_id , travel_feed_vertical_type ) পুনরুদ্ধার করার জন্য যোগ করা হয়েছে।
প্রচারণা
Campaign.view_through_conversion_optimization_enabled নতুন ক্ষেত্র ডিমান্ড জেন এবং অ্যাপ ক্যাম্পেইনে ভিউ-থ্রু কনভার্সন (VTC) অপটিমাইজেশন (ডিফল্ট false ) সক্রিয় করার সুযোগ দেয়।
CampaignCriterion.gender নতুন বৈশিষ্ট্য Google Ads API-এর সকল সংস্করণে Performance Max ক্যাম্পেইনের জন্য লিঙ্গভিত্তিক বর্জন (gender exclusion) চালু করা হয়েছে।
রূপান্তর
লিড জেন রূপান্তরের প্রকারভেদ নতুন এনাম মান ConversionActionType এ নতুন GA4/Firebase রূপান্তর অ্যাকশন টাইপ এনাম যোগ করা হয়েছে:
  • GOOGLE_ANALYTICS_4_GENERATE_LEAD
  • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
  • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
  • FIREBASE_ANDROID_GENERATE_LEAD
  • FIREBASE_ANDROID_QUALIFY_LEAD
  • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
  • FIREBASE_IOS_GENERATE_LEAD
  • FIREBASE_IOS_QUALIFY_LEAD
  • FIREBASE_IOS_CLOSE_CONVERT_LEAD
সাধারণ
UserListErrorEnum.DUPLICATE_LOOKALIKE নতুন এনাম মান / ত্রুটি একাধিক অভিন্ন সাদৃশ্যপূর্ণ তালিকা তৈরি করার চেষ্টা করার সময় এটি ফেরত আসে।
পরিকল্পনা
ListPlannableProductsResponse এর ProductCoreAttributes ফিল্ডগুলি নতুন ক্ষেত্র ListPlannableProductsResponse অধীনে ProductCoreAttributes এ পরিকল্পনাযোগ্য পণ্যের বিবরণ, বিপণন উদ্দেশ্য, ব্যয় মডেল এবং ক্রয় পদ্ধতি যোগ করা হয়েছে।
প্রতিবেদন
CartDataSalesView নতুন রিপোর্টিং রিসোর্স ক্লিক করা পণ্যের পাশাপাশি বিক্রি হওয়া নির্দিষ্ট পণ্য (ব্র্যান্ড, ইত্যাদি) অনুযায়ী কনভার্সন মেট্রিক্সকে বিভক্ত করে রিপোর্ট প্রকাশ করে।
অ-নিলামযোগ্য মেট্রিক্স নতুন ক্ষেত্র Added non-biddable metrics (metrics showing conversions that campaigns are not optimizing for) to all matching resources:
conversion_attribution_event_type New segment Added to ShoppingPerformanceView .
কেনাকাটা
App campaigns in ShoppingProduct নতুন বৈশিষ্ট্য Supported App campaigns inside the ShoppingProduct resource. Note status and issues are not supported.
Tag-based product filtering নতুন বৈশিষ্ট্য Introduced filtering using logical set expressions dynamically: This feature is only available to accounts on the allowlist.

v23 major and minor versions

Google Ads API v23 includes the following new features, updates, and breaking changes.

v23.3 (2026-06-24)

The following new features and updates were added in Google Ads API v23.3. Minor versions like v23.3 don't contain breaking changes.

Features and updates প্রকার বর্ণনা
সাধারণ
Asset.synthetic_content_info
Ad.synthetic_content_info
New fields Contain attestations for synthetic/AI-generated content, split into advertiser_attestation (declarations provided directly by the advertiser) and system_attestation (attestations automatically detected or provided by Google's systems).

To help you plan your upcoming integration work for v25, the interface for mutating advertiser attestation fields is being introduced early for v22 and higher. The interface is visible in these versions, but synthetic_content_info.advertiser_attestation.status and synthetic_content_info.advertiser_attestation.source will remain immutable for these versions.

If you attempt a mutate request on either of these fields, one of these errors will be returned:

"The field attempted to be mutated is immutable" or "Field cannot be set".

These fields will become fully mutable starting in v25. We recommend using the interface now to build and test your internal logic so your system is ready for full write capabilities when v25 is launched.

Multi-party approvals নতুন বৈশিষ্ট্য Added support for multi-party approvals (MPA) reviews:

v23.2 (2026-03-25)

The following new features and updates were added in Google Ads API v23.2. Minor versions like v23.2 don't contain breaking changes.

Features and updates প্রকার বর্ণনা
সম্পদ
VideoEnhancement New resource Contains enhancement-specific video ad information, such as whether it's Google-generated or advertiser-provided. See the About video enhancements to learn more.
AppTopCombinationView New resource Read-only resource to provide insights into top-performing asset combinations in App campaigns.
CustomerAsset নতুন বৈশিষ্ট্য Added support to retrieve CustomerAsset with field_type set to BUSINESS_LOGO .
প্রচারণা
AdGroupAd.start_date_time
AdGroupAd.end_date_time
New fields Provide more granular scheduling constraints over the campaign's dates. This is only supported for some ad group types.
HotelSettingInfo.disable_hotel_setting নতুন ক্ষেত্র Allows disabling the hotel feed in Demand Gen campaigns.
সাধারণ
CustomerClientLinkError New enum values / errors Added two new error codes: MAX_CUSTOMER_LIMIT_REACHED and ACCOUNT_CREATION_POLICY_VIOLATION .
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Behavioral change An error is now thrown when attempting to use this sunsetted user list customer type category.
পরিকল্পনা
GenerateTrendingInsights
GenerateCreatorInsights
নতুন বৈশিষ্ট্য Added support for custom AND/OR combinations of entities, topics, and audiences.
ReachPlanService.GenerateReachForecast New enum values Added new targetable age ranges, such as AGE_RANGE_21_44 or AGE_RANGE_21_49 .
youtube_select_lineup_targeting নতুন ক্ষেত্র Added to ReachPlanService.ListPlannableProducts , which will replace youtube_select_lineups . Both fields are currently populated.
ReachPlanSurface New enum value Added IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS as a surface option.
Forecast নতুন ক্ষেত্র Added clicks for Demand Gen Max Clicks (CPC) in ReachPlanService.GenerateReachForecast .
partnership_opportunities নতুন ক্ষেত্র Added to ContentCreatorInsightsService.GenerateCreatorInsights and ContentCreatorInsightsService.GenerateTrendingInsights .
প্রতিবেদন
biddable_indirect_install_first_in_app_conversion_micros নতুন ক্ষেত্র Added to Campaign , Customer , and AdGroup resources.
ভিডিও
ShareablePreviewService নতুন বৈশিষ্ট্য Extended to support YouTube Live previews by setting preview_type to YOUTUBE_LIVE_PREVIEW . Added UNSUPPORTED_AD_TYPE and TOO_MANY_RESOURCES_IN_REQUEST to ShareablePreviewError . This is only supported for some ad types.

v23.1 (2026-02-25)

The following new features and updates were added in Google Ads API v23.1. Minor versions like v23.1 don't contain breaking changes.

Features and updates প্রকার বর্ণনা
অ্যাকাউন্ট ব্যবস্থাপনা
advertising_partner_properties.allowed_domain নতুন ক্ষেত্র Added to ProductLinkInvitation and ProductLink resources. The advertising partner will only be able to advertise on this domain.
Customer.contains_eu_political_advertising নতুন ক্ষেত্র Retrieves the account-level declaration status of whether it contains political advertising targeted towards the EU, and returns an EuPoliticalAdvertisingStatus .
প্রচারণা
Campaign.text_guidelines নতুন ক্ষেত্র Added support for text guidelines, which can be used with Performance Max and Search campaigns to programmatically control AI-generated text assets. Within text_guidelines , you can define term_exclusions and messaging_restrictions .
CampaignPrimaryStatusReason New enum values Added CAMPAIGN_NOT_BOOKED , BOOKING_HOLD_EXPIRING , BOOKING_HOLD_EXPIRED , and BOOKING_CANCELLED to provide primary status reasons for campaigns with the FIXED_CPM bidding strategy.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure
Campaign.VideoCampaignSettings.booking_details
New fields Added support for reservation ad category self disclosure and read-only booking details.
Campaign.missing_eu_political_advertising_declaration নতুন ক্ষেত্র Supports querying and filtering campaigns that are missing declarations about whether they contain political advertising targeted towards the EU.
রূপান্তর
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS New enum value Supports tracking users who watch an ad and later watch a video from the same channel.
সাধারণ
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED New enum value / error Returned when attempting to target only the undetermined category in demographics dimensions.
প্রণোদনা
IncentiveErrorEnum New enum values / errors Added two new error codes: MAX_INCENTIVES_REDEEMED and ACCOUNT_TOO_OLD . These errors can be returned for requests made on or after March 11, 2026.
পরিকল্পনা
GenerateBenchmarksMetrics নতুন বৈশিষ্ট্য Added support for date breakdowns using a BreakdownDefinition .
ReachPlanService.GenerateReachForecast New enum value Added GOOGLE_DISPLAY_NETWORK as a targetable surface for Demand Gen Max Conversions.
GenerateTrendingInsights New fields Added historical trend line information in TrendInsightDataPoint to TrendInsights when searching by topic.
প্রতিবেদন
Unique user frequency metrics New fields Added new metrics that report how many users saw your ad at least two, three, four, five or ten times: unique_users_two_plus , unique_users_three_plus , unique_users_four_plus , unique_users_five_plus , and unique_users_ten_plus .
SearchTermMatchSource New enum value Added VERTICAL_ADS_DATA_FEED to support vertical ad data feeds, such as Travel Ads entity targeting.
YouTubeVideoUpload
YouTubeVideoUpload New service / resource Added the YouTubeVideoUpload service to support uploading and managing videos on YouTube, and the YouTubeVideoUpload resource to support fetching upload status and metadata. This feature is only supported for REST and the Python client library.

v23 (2026-01-28)

The following new features, updates, and breaking changes were added in Google Ads API v23, which is a major release.

See Upgrade to the latest version for guidance.

Breaking changes

Initial state New state Change type Implementation guidance
বিজ্ঞাপন
Ad sharing permitted AdGroupAdError.AD_SHARING_NOT_ALLOWED Behavioral shift Ad sharing among multiple ad groups is no longer permitted. Requests attempting to share ads will return an AD_SHARING_NOT_ALLOWED error.
Support for CallAd and CallAdInfo কোনোটিই না অপসারণ Support for call ads has been removed. Refer to the About call ads help center article.
প্রচারণা
Campaign.start_date
Campaign.end_date
Campaign.start_date_time
Campaign.end_date_time
Rename / replacement Use the new date-time fields to specify time components for campaigns. The original date-only fields are removed.
Demand Gen
DemandGenMultiAssetAdInfo.lead_form_only কোনোটিই না অপসারণ The lead_form_only field has been removed. Update references in your code.
প্রতিবেদন
Aggregate asset performance label metrics and enum কোনোটিই না অপসারণ Removed aggregate asset performance label metrics. The performance label enum is no longer returned for Search and Display.

Features and updates (non-breaking)

Features and updates প্রকার বর্ণনা
বিজ্ঞাপন
AdFormatType New enum values Added new format types: TEXT , VERTICAL_ADS_BOOKING_LINK , and VERTICAL_ADS_PROMOTION .
সম্পদ
asset_group view New fields Added the following metrics: metrics.engagements , metrics.engagement_rate , and metrics.average_cpe .
asset_group_asset view New fields Added the following metrics: metrics.average_cpe , metrics.average_cpm , metrics.trueview_average_cpv , metrics.video_trueview_view_rate , metrics.video_trueview_views , and metrics.interaction_event_types .
Asset.orientation নতুন ক্ষেত্র Read-only orientation field added to image and video assets.
CampaignAsset নতুন বৈশিষ্ট্য Added support to retrieve campaign assets with field_type set to HEADLINE and DESCRIPTION .
ServedAssetFieldType New enum values Added HEADLINE_AS_SITELINK_POSITION_ONE , HEADLINE_AS_SITELINK_POSITION_TWO , DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE , and DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO for assets served as sitelinks.
BusinessMessageAsset New features / support Updated Business Message assets:
বিলিং
InvoiceService.ListInvoices New options Can now return more granular details in Invoice , including campaign-level cost breakdown, itemized regulatory costs, and adjustment information, by setting include_granular_level_invoice_details in ListInvoicesRequest .
RegulatoryFeeType
UnitOfMeasure
New enums Added helper enums for regulatory fees and units of measure.
প্রচারণা
CampaignError New enum values / errors Added DURATION_TOO_LONG_FOR_TOTAL_BUDGET and END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET error codes.
রূপান্তর
ConversionActionCategory New enum value Added YOUTUBE_FOLLOW_ON_VIEWS to support tracking users who watch an ad and later watch a video from the same channel.
Demand Gen
DemandGenVideoResponsiveAdInfo.companion_banner নতুন ক্ষেত্র Added support for companion banners in Demand Gen responsive video ads.
প্রণোদনা
Added Choose Your Own (CYO) incentives support:

To facilitate more granular programmatic handling of failures, we will add additional error codes to IncentivesService in future releases. We recommend that you monitor upcoming announcements and release notes for these new error codes to make sure your applications can manage these new failure modes.

পরিকল্পনা
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST New enum value Allows building audiences using Life Events in GenerateAudienceCompositionInsights , GenerateSuggestedTargetingInsights , GenerateInsightsFinderReport , and GenerateCreatorInsights .

Life Events are not supported for other AudienceInsightsService methods such as AudienceInsightsService.GenerateAudienceOverlap and AudienceInsightsService.GenerateTargetingSuggestionMetrics .

ReachPlanService.GenerateConversionRates New fields / options The response now includes surfaces to support conversion rate suggestions based on surface controls (eg, Gmail, Shorts). Only supported for Demand Gen campaigns.
LanguageDistribution New field / type Added to YouTubeChannelInsights to provide language distribution details in YouTube channel content.
BenchmarksService নতুন পরিষেবা Compares YouTube advertisement data against industry benchmarks.
AudienceInsightsService.GenerateAudienceDefinition New method Translates a free text description of a target audience into matching audience attributes using generative AI.
YouTubeChannelInsights.relevance_score নতুন ক্ষেত্র Evaluates how relevant a creator is for a topic weighted by views.
TrendInsightMetrics.trend_change_percent নতুন ক্ষেত্র Represents the percentage change in a trend's value over the comparison period.
সুপারিশসমূহ
GenerateRecommendationsRequest নতুন ক্ষেত্র Added is_new_customer . When set to true for CAMPAIGN_BUDGET recommendations, it uses a model optimized for new customers (only recommended for customers with no campaigns).
প্রতিবেদন
AdGroupAdAssetView New feature / metrics support Now supports impression, performance, and conversion metrics for RESPONSIVE_DISPLAY_AD .
ad_sub_network_type segment New segment Provides granular performance breakdown within an ad network. Initially available for Demand Gen campaigns on YouTube (In-stream, In-feed, Shorts). Must be selected along with ad_network_type .
Performance Max reporting নতুন বৈশিষ্ট্য Enabled ad network type breakdown for Performance Max campaigns.
UserLocationView
GeographicView
New segments support Support metrics segmented by conversion date: conversions_by_conversion_date , all_conversions_by_conversion_date , conversions_value_by_conversion_date , all_conversions_value_by_conversion_date , value_per_conversions_by_conversion_date , value_per_all_conversions_by_conversion_date , cross_device_conversions_by_conversion_date , and cross_device_conversions_value_by_conversion_date .
Vertical ads segments New segments Added the following segments: vertical_ads_event_participant_display_names , vertical_ads_hotel_class , vertical_ads_listing , vertical_ads_listing_brand , vertical_ads_listing_city , vertical_ads_listing_country , vertical_ads_listing_region , vertical_ads_partner_account , and vertical_ads_vertical .
PerStoreView
MatchedLocationInterestView
New reporting resources Added PerStoreView to query store location details, and MatchedLocationInterestView (for AI Max campaigns) to provide performance metrics by geographic locations of interest.
কেনাকাটা
ShoppingPerformanceView New metrics support Now supports the following metrics segmented by conversion date: conversions_by_conversion_date , all_conversions_by_conversion_date , conversions_value_by_conversion_date , and value_per_conversions_by_conversion_date , value_per_all_conversions_by_conversion_date .
ShoppingPerformanceView New metrics support Added support for: search_budget_lost_impression_share , search_rank_lost_impression_share , search_budget_lost_absolute_top_impression_share , and search_rank_lost_absolute_top_impression_share .
ShoppingProduct.product_image_uri নতুন ক্ষেত্র Added to ShoppingProduct .
Vertical ads
AdGroup.vertical_ads_format_setting নতুন ক্ষেত্র Allows control over which ad formats can serve in Search campaigns using travel feeds.
AdGroupCriterion
SharedCriterion
New fields / criteria Added vertical_ads_item_group_rule_list criterion type to AdGroupCriterion and vertical_ads_item_group_rule to SharedCriterion to permit targeting item groups in Search campaigns with travel feeds.
Vertical ads data feed integration নতুন বৈশিষ্ট্য Can now connect a vertical ads data feed to a search campaign running AI Max to show property promotion and booking link travel ads alongside text ads. Control formats with vertical_ads_format_setting and define rules using vertical_ads_item_group_rule . Segment reporting by AdFormatType and vertical ads data feed dimensions.
ভিডিও
AdVideoAssetInfo.ad_video_asset_feature_control নতুন ক্ষেত্র Added feature control options for video ad assets.
CampaignCriterionError New enum value / error Added the INVALID_VIDEO_LINEUP_ID error code.
YouTube audibility metrics New metrics Added audibility metrics for audio ads on YouTube, reporting whether an ad was audible and on how many impressions audibility could be measured.

v22 major and minor versions

Google Ads API v22 includes the following new features, updates, and breaking changes.

v22.2 (2026-06-24)

The following new features and updates were added in Google Ads API v22.2. Minor versions like v22.2 don't contain breaking changes.

Features and updates প্রকার বর্ণনা
সাধারণ
Asset.synthetic_content_info
Ad.synthetic_content_info
New fields Contain attestations for synthetic/AI-generated content, split into advertiser_attestation (declarations provided directly by the advertiser) and system_attestation (attestations automatically detected or provided by Google's systems).

To help you plan your upcoming integration work for v25, the interface for mutating advertiser attestation fields is being introduced early for v22 and higher. The interface is visible in these versions, but synthetic_content_info.advertiser_attestation.status and synthetic_content_info.advertiser_attestation.source will remain immutable for these versions.

If you attempt a mutate request on either of these fields, one of these errors will be returned:

"The field attempted to be mutated is immutable" or "Field cannot be set".

These fields will become fully mutable starting in v25. We recommend using the interface now to build and test your internal logic so your system is ready for full write capabilities when v25 is launched.

Multi-party approvals নতুন বৈশিষ্ট্য Added support for multi-party approvals (MPA) reviews:

v22.1 (2026-02-25)

The following new feature was added in Google Ads API v22.1. Minor versions like v22.1 don't contain breaking changes.

Features and updates প্রকার বর্ণনা
অ্যাকাউন্ট ব্যবস্থাপনা
Customer.contains_eu_political_advertising নতুন ক্ষেত্র Retrieves the account-level declaration status of whether it contains political advertising targeted towards the EU, and returns an EuPoliticalAdvertisingStatus .
প্রচারণা
Campaign.missing_eu_political_advertising_declaration নতুন ক্ষেত্র Supports querying and filtering campaigns that are missing declarations about whether they contain political advertising targeted towards the EU.

v22 (2025-10-15)

The following new features, updates, and breaking changes were added in Google Ads API v22, which is a major release.

See Upgrade to the latest version for guidance.

Breaking changes

Initial state New state Change type Implementation guidance
Demand Gen
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros Rename / spelling fix Rename references to use the corrected field name.
সাধারণ
No operations limit in AddBatchJobOperations 10,000 operations limit per request Behavioral shift Ensure that no single AddBatchJobOperations request contains more than 10,000 operations.
Silently capped page size at 1,000 in ListBatchJobResultsRequest Returns INVALID_PAGE_SIZE error Behavioral shift Ensure ListBatchJobResultsRequest.page_size is set to 1,000 or less, as requesting a larger page size will now result in an error.
পারফরম্যান্স ম্যাক্স
Asset performance labels কোনোটিই না অপসারণ Asset performance labels support and the associated performance label enum have been removed for Performance Max campaigns. Update integrations accordingly.
Campaign.url_expansion_opt_out FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION flag in AssetAutomationSetting Removal / replacement Use the final URL expansion text asset automation setting. The Campaign-level URL expansion opt-out field is removed.
পরিকল্পনা
views trueview_views Removal / replacement Replace references to views with the new trueview_views field in ReachPlanService .
ভিডিও
average_cpv
video_view_rate
video_views
video_view_rate_in_feed
video_view_rate_in_stream
video_view_rate_shorts
trueview_average_cpv
video_trueview_view_rate
video_trueview_views
video_trueview_view_rate_in_feed
video_trueview_view_rate_in_stream
video_trueview_view_rate_shorts
Renames Update query strings and integrations to use the new metric names representing TrueView video views.

Features and updates (non-breaking)

Features and updates প্রকার বর্ণনা
সম্পদ
AssetFieldType.LANDING_PAGE_PREVIEW New enum value Added as a new image asset field type.
AssetGenerationService New service (Beta) Allows generating text and image assets using generative AI:
  • GenerateText : Generates text based on final URL, prompts, keywords, etc.
  • GenerateImages : Generates images based on final URL, prompts, or recontextualizing product images.
  • Errors are returned with codes from AssetGenerationError .
Initially available only to a limited set of closed beta participants.
প্রচারণা
AppCampaignBiddingStrategyGoalType New enum values Added new goals for App campaigns for installs (ACi) to optimize without specifying a target:
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA : Use with standard Maximize Conversions.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS : Use with standard Maximize Conversion Value.
BiddingStrategyType নতুন বৈশিষ্ট্য Added support for the fixed share of voice bidding strategy type.
Campaign.feed_types নতুন ক্ষেত্র Shows the types of feeds attached to a campaign. For Performance Max campaigns, this can indicate the business vertical, such as MERCHANT_CENTER_FEED for retail.
Shared set targeting নতুন বৈশিষ্ট্য Allowed attaching negative keywords shared sets to multi-channel (for App campaigns) and local campaigns.
Demand Gen
TargetCPC bidding নতুন বৈশিষ্ট্য Added bidding strategy to maximize clicks at target CPC: set campaign-level target CPC using Campaign.target_cpc and override at ad group level using AdGroup.target_cpc_micros .
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES New enum value If enabled for DemandGenMultiAssetAdInfo , this adds design elements and embeds text assets into image assets to create new image assets with different aspect ratios (enabled by default).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS New enum value If enabled for DemandGenMultiAssetAdInfo , it generates videos using other assets like images and text, which can then be used to create new DemandGenVideoResponsiveAdInfo instances (enabled by default).
সাধারণ
ListBatchJobResultsRequest page size fallback Behavioral change If page_size is not set or is 0, it now defaults to the maximum of 1,000 (previously returned INVALID_PAGE_SIZE ).
QuotaError New enum value / error Added PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED to indicate when payment profile activation rate limit is exceeded.
পারফরম্যান্স ম্যাক্স
Asset automation settings New enum values Added new PMax asset automation options:
  • GENERATE_IMAGE_ENHANCEMENT : Enables automatic creation of enhanced images (auto-cropping). Enabled by default.
  • GENERATE_IMAGE_EXTRACTION : Sourced images from final URLs. Defaults to account Dynamic Image Extension setting.
PMax reporting segments New segments Added new segments unique to Performance Max campaigns:
পরিকল্পনা
CRM partner data lists New feature / enum value Added THIRD_PARTY_PARTNER_DATA to CRM data sources, along with partner audience validation error codes (such as tos acceptance, Link missing, etc.).
Livestream creator metrics নতুন ক্ষেত্র Added YouTubeMetrics.is_active_live_stream_creator , returned by creator insights to indicate if a creator published a livestream in the past 90 days.
Plannable CRM source metadata নতুন বার্তা Added PlannableUserListMetadata inside PlannableUserList , returned by ReachPlanService.ListPlannableUserLists , to show CRM data source types.
Support for related videos and creators in TrendInsight New fields Added support for related_videos and related_creators on TrendInsight , and watch properties in video_properties and publish_date .
InsightsFinder improvements নতুন বৈশিষ্ট্য GenerateInsightsFinderReport now supports parental_status , income_ranges , and more complex AND/OR targeting combinations.
প্রতিবেদন
New click types New enum values Added CLICK_TO_MESSAGE_THIRD_PARTY_CLICK and CLICK_TO_MESSAGE_LANDING_PAGE_CLICK .
AssetGroupAsset segmentation New segments support AssetGroupAsset is now segmentable by device , conversion_action , conversion_action_name , and conversion_action_category .
RSAs in AdGroupAdAssetView New feature / metrics support AdGroupAdAssetView now fully supports performance and conversion metrics for RESPONSIVE_SEARCH_AD (previously only impressions were returned).
Exploration query cluster metric segmentations New segments support Metrics clicks_unique_query_clusters , conversions_unique_query_clusters , and impressions_unique_query_clusters are now segmentable by date fields.
TargetingExpansionView New reporting resource Added TargetingExpansionView to report metrics for expansions over manual targeting, such as keywordless expansion for AI Max for Search Campaigns.
কেনাকাটা
Shopping scope fix Bug fix Fixed the campaign and ad group scoping of metrics in the ShoppingProduct resource.
Unified goals
Retention goals নতুন বৈশিষ্ট্য Added support for customer retention goals to optimize for re-engaging existing customers (eg, using target_option with TARGET_SPECIFIC or TARGET_ALL ).
ভিডিও
Video watch time metrics New fields Added watch time duration metrics: video_watch_time_duration_millis (total duration) and average_video_watch_time_duration_millis (average duration per impression).

Archived release notes

See Sunsetted versions for archived release notes.