রিলিজ নোট

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

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_input (বিজ্ঞাপনদাতা কর্তৃক সরাসরি প্রদত্ত ঘোষণা) এবং system_input (সিস্টেম দ্বারা স্বয়ংক্রিয়ভাবে শনাক্ত বা প্রদত্ত অ্যাটেস্টেশন)।

এই ফিচারটি 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 নতুন রিপোর্টিং রিসোর্স ক্লিক করা পণ্যের পাশাপাশি বিক্রি হওয়া নির্দিষ্ট পণ্য (ব্র্যান্ড, ইত্যাদি) অনুযায়ী কনভার্সন মেট্রিক্সকে বিভক্ত করে রিপোর্ট প্রকাশ করে।
অ-নিলামযোগ্য মেট্রিক্স নতুন ক্ষেত্র সমস্ত মিলে যাওয়া রিসোর্সগুলিতে নন-বিডেবল মেট্রিক (যেসব মেট্রিক এমন কনভার্সন দেখায় যার জন্য ক্যাম্পেইন অপটিমাইজ করা হচ্ছে না) যোগ করা হয়েছে:
conversion_attribution_event_type নতুন অংশ ShoppingPerformanceView তে যোগ করা হয়েছে।
কেনাকাটা
ShoppingProduct অ্যাপ ক্যাম্পেইন নতুন বৈশিষ্ট্য ShoppingProduct রিসোর্সের মধ্যে অ্যাপ ক্যাম্পেইনগুলো সমর্থিত। নোটের স্ট্যাটাস এবং ইস্যু সমর্থিত নয়।
ট্যাগ-ভিত্তিক পণ্য ফিল্টারিং নতুন বৈশিষ্ট্য লজিক্যাল সেট এক্সপ্রেশন ব্যবহার করে ডায়নামিকভাবে ফিল্টারিং চালু করা হয়েছে: এই ফিচারটি শুধুমাত্র অনুমোদিত তালিকায় থাকা অ্যাকাউন্টগুলোর জন্য উপলব্ধ।

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

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

v23.3 (2026-06-24)

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

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
সাধারণ
Asset.synthetic_content_info
Ad.synthetic_content_info		 নতুন ক্ষেত্র 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).

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

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

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

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

বহু-পক্ষীয় অনুমোদন নতুন বৈশিষ্ট্য বহু-পক্ষীয় অনুমোদন (এমপিএ) পর্যালোচনার জন্য সমর্থন যোগ করা হয়েছে:

v23.2 (2026-03-25)

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

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
সম্পদ
VideoEnhancement নতুন সম্পদ এতে ভিডিও বিজ্ঞাপনের উন্নতি-সংক্রান্ত নির্দিষ্ট তথ্য থাকে, যেমন এটি গুগল দ্বারা তৈরি নাকি বিজ্ঞাপনদাতা দ্বারা সরবরাহ করা। আরও জানতে ‘ভিডিও উন্নতি সম্পর্কে’ অংশটি দেখুন।
AppTopCombinationView নতুন সম্পদ অ্যাপ ক্যাম্পেইনে সেরা পারফর্মিং অ্যাসেট কম্বিনেশনগুলো সম্পর্কে ধারণা দেওয়ার জন্য একটি রিড-অনলি রিসোর্স।
CustomerAsset নতুন বৈশিষ্ট্য BUSINESS_LOGO তে field_type সেট করা CustomerAsset পুনরুদ্ধার করার জন্য সমর্থন যোগ করা হয়েছে।
প্রচারণা
AdGroupAd.start_date_time
AdGroupAd.end_date_time		 নতুন ক্ষেত্র ক্যাম্পেইনের তারিখগুলোর উপর আরও সুনির্দিষ্ট সময়সূচী নির্ধারণের সীমাবদ্ধতা আরোপ করুন। এই সুবিধাটি শুধুমাত্র কিছু নির্দিষ্ট অ্যাড গ্রুপ টাইপের জন্য উপলব্ধ।
HotelSettingInfo.disable_hotel_setting নতুন ক্ষেত্র ডিমান্ড জেন ক্যাম্পেইনে হোটেল ফিড নিষ্ক্রিয় করার সুবিধা দেয়।
সাধারণ
CustomerClientLinkError নতুন এনাম মান / ত্রুটি দুটি নতুন এরর কোড যোগ করা হয়েছে: MAX_CUSTOMER_LIMIT_REACHED এবং ACCOUNT_CREATION_POLICY_VIOLATION ।
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS আচরণগত পরিবর্তন এই বাতিলকৃত ব্যবহারকারী তালিকা ও গ্রাহক প্রকারের বিভাগটি ব্যবহার করার চেষ্টা করলে এখন একটি ত্রুটি দেখা দেয়।
পরিকল্পনা
GenerateTrendingInsights
GenerateCreatorInsights		 নতুন বৈশিষ্ট্য এনটিটি, টপিক এবং অডিয়েন্সের কাস্টম AND/OR সমন্বয়ের জন্য সমর্থন যোগ করা হয়েছে।
ReachPlanService.GenerateReachForecast নতুন এনাম মান নতুন লক্ষ্যযোগ্য বয়সের সীমা যোগ করা হয়েছে, যেমন AGE_RANGE_21_44 বা AGE_RANGE_21_49 ।
youtube_select_lineup_targeting নতুন ক্ষেত্র ReachPlanService.ListPlannableProducts এ এটি যোগ করা হয়েছে, যা youtube_select_lineups প্রতিস্থাপন করবে। উভয় ফিল্ডই বর্তমানে তথ্য দ্বারা পূর্ণ আছে।
ReachPlanSurface নতুন এনাম মান IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS একটি সারফেস অপশন হিসেবে যোগ করা হয়েছে।
Forecast নতুন ক্ষেত্র ReachPlanService.GenerateReachForecast এ Demand Gen Max Clicks (CPC)-এর জন্য clicks যোগ করা হয়েছে।
partnership_opportunities নতুন ক্ষেত্র ContentCreatorInsightsService.GenerateCreatorInsights এবং ContentCreatorInsightsService.GenerateTrendingInsights এ যোগ করা হয়েছে।
প্রতিবেদন
biddable_indirect_install_first_in_app_conversion_micros নতুন ক্ষেত্র Campaign , Customer এবং AdGroup রিসোর্সে যোগ করা হয়েছে।
ভিডিও
ShareablePreviewService নতুন বৈশিষ্ট্য preview_type YOUTUBE_LIVE_PREVIEW এ সেট করার মাধ্যমে ইউটিউব লাইভ প্রিভিউ সমর্থন করার জন্য এটিকে সম্প্রসারিত করা হয়েছে। ShareablePreviewError এ UNSUPPORTED_AD_TYPE এবং TOO_MANY_RESOURCES_IN_REQUEST যোগ করা হয়েছে। এটি শুধুমাত্র কিছু নির্দিষ্ট অ্যাড টাইপের জন্য সমর্থিত।

v23.1 (2026-02-25)

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

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
অ্যাকাউন্ট ব্যবস্থাপনা
advertising_partner_properties.allowed_domain নতুন ক্ষেত্র ProductLinkInvitation এবং ProductLink রিসোর্স-এ যোগ করা হয়েছে। বিজ্ঞাপনদাতা শুধুমাত্র এই ডোমেইনে বিজ্ঞাপন দিতে পারবেন।
Customer.contains_eu_political_advertising নতুন ক্ষেত্র অ্যাকাউন্টটিতে ইইউ-কে লক্ষ্য করে কোনো রাজনৈতিক বিজ্ঞাপন আছে কিনা, সেই সংক্রান্ত অ্যাকাউন্ট-স্তরের ঘোষণার অবস্থা পুনরুদ্ধার করে এবং একটি EuPoliticalAdvertisingStatus ফেরত দেয়।
প্রচারণা
Campaign.text_guidelines নতুন ক্ষেত্র টেক্সট গাইডলাইনের জন্য সমর্থন যোগ করা হয়েছে, যা পারফরম্যান্স ম্যাক্স এবং সার্চ ক্যাম্পেইনের সাথে ব্যবহার করে এআই-দ্বারা তৈরি টেক্সট অ্যাসেটগুলোকে প্রোগ্রাম্যাটিকভাবে নিয়ন্ত্রণ করা যায়। text_guidelines এর মধ্যে আপনি term_exclusions এবং messaging_restrictions নির্ধারণ করতে পারেন।
CampaignPrimaryStatusReason নতুন এনাম মান FIXED_CPM বিডিং স্ট্র্যাটেজিযুক্ত ক্যাম্পেইনগুলোর জন্য প্রাথমিক স্ট্যাটাসের কারণ হিসেবে CAMPAIGN_NOT_BOOKED , BOOKING_HOLD_EXPIRING , BOOKING_HOLD_EXPIRED এবং BOOKING_CANCELLED যোগ করা হয়েছে।
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure
Campaign.VideoCampaignSettings.booking_details		 নতুন ক্ষেত্র রিজার্ভেশন বিজ্ঞাপনের ক্যাটাগরি স্বয়ংক্রিয়ভাবে প্রকাশ এবং শুধুমাত্র-পঠ্য বুকিং বিবরণের জন্য সমর্থন যোগ করা হয়েছে।
Campaign.missing_eu_political_advertising_declaration নতুন ক্ষেত্র যেসব ক্যাম্পেইনে ইইউ-কে লক্ষ্য করে রাজনৈতিক বিজ্ঞাপন আছে কিনা সে সম্পর্কে কোনো ঘোষণা নেই, সেগুলোকে অনুসন্ধান ও ফিল্টার করা সমর্থন করে।
রূপান্তর
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS নতুন এনাম মান যেসব ব্যবহারকারী একটি বিজ্ঞাপন দেখার পর একই চ্যানেল থেকে ভিডিও দেখেন, তাদের ট্র্যাক করা সমর্থন করে।
সাধারণ
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED নতুন এনাম মান / ত্রুটি জনসংখ্যাতাত্ত্বিক মাত্রাগুলিতে শুধুমাত্র অনির্ধারিত বিভাগটিকে লক্ষ্য করার চেষ্টা করার সময় এই ত্রুটিটি ফেরত এসেছে।
প্রণোদনা
IncentiveErrorEnum নতুন এনাম মান / ত্রুটি দুটি নতুন এরর কোড যোগ করা হয়েছে: MAX_INCENTIVES_REDEEMED এবং ACCOUNT_TOO_OLD । ২০২৬ সালের ১১ই মার্চ বা তার পরে করা অনুরোধগুলোর ক্ষেত্রে এই এররগুলো দেখা দিতে পারে।
পরিকল্পনা
GenerateBenchmarksMetrics নতুন বৈশিষ্ট্য BreakdownDefinition ব্যবহার করে তারিখ অনুযায়ী বিভাজনের সুবিধা যোগ করা হয়েছে।
ReachPlanService.GenerateReachForecast নতুন এনাম মান ডিমান্ড জেন ম্যাক্স কনভার্সনের জন্য GOOGLE_DISPLAY_NETWORK একটি টার্গেটযোগ্য সারফেস হিসেবে যুক্ত করা হয়েছে।
GenerateTrendingInsights নতুন ক্ষেত্র বিষয় অনুযায়ী অনুসন্ধান করার সময় TrendInsightDataPoint এর ঐতিহাসিক ট্রেন্ড লাইনের তথ্য TrendInsights এ যোগ করা হয়েছে।
প্রতিবেদন
অনন্য ব্যবহারকারীর ফ্রিকোয়েন্সি মেট্রিক্স নতুন ক্ষেত্র নতুন মেট্রিক যোগ করা হয়েছে যা রিপোর্ট করে কতজন ব্যবহারকারী আপনার বিজ্ঞাপনটি অন্তত দুই, তিন, চার, পাঁচ বা দশবার দেখেছেন: unique_users_two_plus , unique_users_three_plus , unique_users_four_plus , unique_users_five_plus , এবং unique_users_ten_plus ।
SearchTermMatchSource নতুন এনাম মান ট্র্যাভেল অ্যাডস এনটিটি টার্গেটিং-এর মতো ভার্টিকাল অ্যাড ডেটা ফিড সমর্থন করার জন্য VERTICAL_ADS_DATA_FEED যোগ করা হয়েছে।
ইউটিউব ভিডিও আপলোড
YouTubeVideoUpload নতুন পরিষেবা / সম্পদ ইউটিউবে ভিডিও আপলোড ও পরিচালনা করার জন্য YouTubeVideoUpload সার্ভিস এবং আপলোড স্ট্যাটাস ও মেটাডেটা সংগ্রহ করার জন্য YouTubeVideoUpload রিসোর্স যোগ করা হয়েছে। এই ফিচারটি শুধুমাত্র REST এবং পাইথন ক্লায়েন্ট লাইব্রেরির জন্য সমর্থিত।

v23 (2026-01-28)

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

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

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

প্রাথমিক অবস্থা নতুন রাজ্য ধরণ পরিবর্তন করুন বাস্তবায়ন নির্দেশিকা
বিজ্ঞাপন
বিজ্ঞাপন শেয়ার করার অনুমতি আছে AdGroupAdError.AD_SHARING_NOT_ALLOWED আচরণগত পরিবর্তন একাধিক অ্যাড গ্রুপের মধ্যে বিজ্ঞাপন শেয়ার করার অনুমতি এখন আর নেই। বিজ্ঞাপন শেয়ার করার অনুরোধ করলে AD_SHARING_NOT_ALLOWED ত্রুটি দেখা দেবে।
CallAd এবং CallAdInfo জন্য সমর্থন কোনোটিই না অপসারণ কল বিজ্ঞাপনের জন্য সমর্থন তুলে নেওয়া হয়েছে। অনুগ্রহ করে হেল্প সেন্টারের ‘কল বিজ্ঞাপন সম্পর্কে’ নিবন্ধটি দেখুন।
প্রচারণা
Campaign.start_date
Campaign.end_date		 Campaign.start_date_time
Campaign.end_date_time		 নাম পরিবর্তন / প্রতিস্থাপন ক্যাম্পেইনের সময় উপাদানগুলো নির্দিষ্ট করতে নতুন তারিখ-সময় ফিল্ডগুলো ব্যবহার করুন। আগের শুধু-তারিখের ফিল্ডগুলো সরিয়ে দেওয়া হয়েছে।
চাহিদা তৈরি
DemandGenMultiAssetAdInfo.lead_form_only কোনোটিই না অপসারণ lead_form_only ফিল্ডটি সরিয়ে ফেলা হয়েছে। আপনার কোডে রেফারেন্সগুলো আপডেট করুন।
প্রতিবেদন
সামগ্রিক সম্পদ কর্মক্ষমতা লেবেল মেট্রিক্স এবং এনাম কোনোটিই না অপসারণ সামগ্রিক অ্যাসেট পারফরম্যান্স লেবেল মেট্রিকগুলো সরিয়ে ফেলা হয়েছে। সার্চ এবং ডিসপ্লে-এর জন্য পারফরম্যান্স লেবেল এনামটি আর ফেরত দেওয়া হয় না।

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

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
বিজ্ঞাপন
AdFormatType নতুন এনাম মান নতুন ফরম্যাট টাইপ যোগ করা হয়েছে: TEXT , VERTICAL_ADS_BOOKING_LINK , এবং VERTICAL_ADS_PROMOTION ।
সম্পদ
asset_group দৃশ্য নতুন ক্ষেত্র নিম্নলিখিত মেট্রিকগুলো যোগ করা হয়েছে: metrics.engagements , metrics.engagement_rate , এবং metrics.average_cpe ।
asset_group_asset দৃশ্য নতুন ক্ষেত্র নিম্নলিখিত মেট্রিকগুলো যোগ করা হয়েছে: metrics.average_cpe , metrics.average_cpm , metrics.trueview_average_cpv , metrics.video_trueview_view_rate , metrics.video_trueview_views , এবং metrics.interaction_event_types ।
Asset.orientation নতুন ক্ষেত্র ছবি এবং ভিডিও অ্যাসেটে রিড-অনলি ওরিয়েন্টেশন ফিল্ড যোগ করা হয়েছে।
CampaignAsset নতুন বৈশিষ্ট্য যেসব ক্যাম্পেইন অ্যাসেটের field_type HEADLINE এবং DESCRIPTION এ সেট করা আছে, সেগুলোকে পুনরুদ্ধার করার সুবিধা যোগ করা হয়েছে।
ServedAssetFieldType নতুন এনাম মান সাইটলিঙ্ক হিসেবে ব্যবহৃত অ্যাসেটগুলোর জন্য HEADLINE_AS_SITELINK_POSITION_ONE , HEADLINE_AS_SITELINK_POSITION_TWO , DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE , এবং DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO যোগ করা হয়েছে।
BusinessMessageAsset নতুন বৈশিষ্ট্য / সমর্থন হালনাগাদকৃত ব্যবসায়িক বার্তা সম্পদসমূহ:
  • প্রোভাইডার হিসেবে ফেসবুক মেসেঞ্জার এবং জালো-র জন্য সমর্থন যোগ করা হয়েছে।
  • BusinessMessageProvider এ FACEBOOK_MESSENGER এবং ZALO যোগ করা হয়েছে।
  • facebook_messenger_info এবং zalo_info ফিল্ডগুলো যোগ করা হয়েছে।
  • AssetError এ CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS যোগ করা হয়েছে।
বিলিং
InvoiceService.ListInvoices নতুন বিকল্পগুলি এখন ListInvoicesRequest এ include_granular_level_invoice_details সেট করার মাধ্যমে Invoice আরও সূক্ষ্ম বিবরণ পাওয়া যাবে, যার মধ্যে ক্যাম্পেইন-স্তরের খরচের বিভাজন, আইটেমভিত্তিক নিয়ন্ত্রক খরচ এবং সমন্বয়ের তথ্য অন্তর্ভুক্ত।
RegulatoryFeeType
UnitOfMeasure		 নতুন এনাম নিয়ন্ত্রক ফি এবং পরিমাপের এককের জন্য সহায়ক এনাম যোগ করা হয়েছে।
প্রচারণা
CampaignError নতুন এনাম মান / ত্রুটি DURATION_TOO_LONG_FOR_TOTAL_BUDGET এবং END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET ত্রুটি কোডগুলো যোগ করা হয়েছে।
রূপান্তর
রূপান্তর ক্রিয়া বিভাগ নতুন এনাম মান যেসব ব্যবহারকারী একটি বিজ্ঞাপন দেখার পর একই চ্যানেলের ভিডিও দেখেন, তাদের ট্র্যাক করার জন্য YOUTUBE_FOLLOW_ON_VIEWS যুক্ত করা হয়েছে।
চাহিদা তৈরি
DemandGenVideoResponsiveAdInfo.companion_banner নতুন ক্ষেত্র ডিমান্ড জেন রেসপন্সিভ ভিডিও বিজ্ঞাপনে কম্প্যানিয়ন ব্যানারের জন্য সমর্থন যোগ করা হয়েছে।
প্রণোদনা
নিজের পছন্দমতো (CYO) প্রণোদনা সহায়তা যোগ করা হয়েছে:
  • একজন ব্যবহারকারীর জন্য উপলব্ধ ব্যক্তিগতকৃত প্রণোদনাগুলো পুনরুদ্ধার করতে FetchIncentive মেথডটি যোগ করা হয়েছে।
  • গ্রাহকের অ্যাকাউন্টে নির্বাচিত ইনসেনটিভ প্রয়োগ করার জন্য ApplyIncentive মেথডটি যোগ করা হয়েছে।
  • রিডেম্পশনের বিবরণ প্রদানের জন্য AppliedIncentive রিসোর্সটি যোগ করা হয়েছে ( Search এবং SearchStream ব্যবহার করে অনুসন্ধানযোগ্য)।
  • IncentiveError এবং AuthenticationError.INVALID_EMAIL_ADDRESS এ নতুন ত্রুটি কোড যোগ করা হয়েছে।

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

পরিকল্পনা
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST নতুন এনাম মান GenerateAudienceCompositionInsights , GenerateSuggestedTargetingInsights , GenerateInsightsFinderReport , এবং GenerateCreatorInsights এ লাইফ ইভেন্ট ব্যবহার করে অডিয়েন্স তৈরি করার সুযোগ দেয়।

AudienceInsightsService.GenerateAudienceOverlap এবং AudienceInsightsService.GenerateTargetingSuggestionMetrics এর মতো অন্যান্য AudienceInsightsService মেথডগুলোর জন্য লাইফ ইভেন্ট সমর্থিত নয়।

ReachPlanService.GenerateConversionRates নতুন ক্ষেত্র / বিকল্পগুলি এই রেসপন্সে এখন সারফেস কন্ট্রোলের (যেমন, জিমেইল, শর্টস) উপর ভিত্তি করে কনভার্সন রেট সাজেশনের জন্য সারফেস অন্তর্ভুক্ত করা হয়েছে। এটি শুধুমাত্র ডিমান্ড জেন ক্যাম্পেইনের জন্য সমর্থিত।
LanguageDistribution নতুন ক্ষেত্র / প্রকার ইউটিউব চ্যানেলের কন্টেন্টে ভাষা বণ্টনের বিস্তারিত তথ্য প্রদানের জন্য এটিকে YouTubeChannelInsights এ যুক্ত করা হয়েছে।
BenchmarksService নতুন পরিষেবা ইউটিউব বিজ্ঞাপনের ডেটাকে শিল্প খাতের মানদণ্ডের সাথে তুলনা করে।
AudienceInsightsService.GenerateAudienceDefinition নতুন পদ্ধতি জেনারেটিভ এআই ব্যবহার করে কোনো টার্গেট অডিয়েন্সের মুক্ত টেক্সট বিবরণকে তাদের সাথে সামঞ্জস্যপূর্ণ অডিয়েন্স অ্যাট্রিবিউটে রূপান্তরিত করে।
YouTubeChannelInsights.relevance_score নতুন ক্ষেত্র কোনো একটি বিষয়ের জন্য একজন নির্মাতা কতটা প্রাসঙ্গিক, তা ভিউয়ের সংখ্যার ভিত্তিতে মূল্যায়ন করে।
TrendInsightMetrics.trend_change_percent নতুন ক্ষেত্র এটি তুলনামূলক সময়কালে কোনো প্রবণতার মানের শতকরা পরিবর্তনকে নির্দেশ করে।
সুপারিশসমূহ
GenerateRecommendationsRequest নতুন ক্ষেত্র is_new_customer যোগ করা হয়েছে। CAMPAIGN_BUDGET সুপারিশের জন্য এটি true সেট করা হলে, এটি নতুন গ্রাহকদের জন্য অপ্টিমাইজ করা একটি মডেল ব্যবহার করে (শুধুমাত্র সেইসব গ্রাহকদের জন্য সুপারিশ করা হয় যাদের কোনো ক্যাম্পেইন নেই)।
প্রতিবেদন
AdGroupAdAssetView নতুন বৈশিষ্ট্য / মেট্রিক্স সমর্থন এখন RESPONSIVE_DISPLAY_AD জন্য ইম্প্রেশন, পারফরম্যান্স এবং কনভার্সন মেট্রিক্স সমর্থন করে।
ad_sub_network_type সেগমেন্ট নতুন অংশ একটি অ্যাড নেটওয়ার্কের মধ্যে পারফরম্যান্সের বিশদ বিবরণ প্রদান করে। প্রাথমিকভাবে ইউটিউবের ডিমান্ড জেন ক্যাম্পেইনের (ইন-স্ট্রিম, ইন-ফিড, শর্টস) জন্য উপলব্ধ। ad_network_type সাথে এটি অবশ্যই নির্বাচন করতে হবে।
পারফরম্যান্স ম্যাক্স রিপোর্টিং নতুন বৈশিষ্ট্য পারফরম্যান্স ম্যাক্স ক্যাম্পেইনগুলির জন্য বিজ্ঞাপন নেটওয়ার্কের প্রকারভেদের বিভাজন সক্রিয় করা হয়েছে।
UserLocationView
GeographicView		 নতুন সেগমেন্ট সমর্থন রূপান্তরের তারিখ অনুসারে বিভক্ত মেট্রিকগুলো সমর্থন করে: 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 , এবং cross_device_conversions_value_by_conversion_date ।
উল্লম্ব বিজ্ঞাপন বিভাগ নতুন বিভাগ নিম্নলিখিত সেগমেন্টগুলি যোগ করা হয়েছে: 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 , এবং vertical_ads_vertical ।
PerStoreView
MatchedLocationInterestView		 নতুন রিপোর্টিং রিসোর্স স্টোরের অবস্থানের বিবরণ জানতে PerStoreView এবং আগ্রহের ভৌগোলিক অবস্থান অনুযায়ী পারফরম্যান্স মেট্রিক্স প্রদান করতে MatchedLocationInterestView (AI Max ক্যাম্পেইনের জন্য) যোগ করা হয়েছে।
কেনাকাটা
ShoppingPerformanceView নতুন মেট্রিক্স সমর্থন এখন রূপান্তরের তারিখ অনুসারে বিভক্ত নিম্নলিখিত মেট্রিকগুলি সমর্থন করে: conversions_by_conversion_date , all_conversions_by_conversion_date , conversions_value_by_conversion_date , value_per_conversions_by_conversion_date , value_per_all_conversions_by_conversion_date ।
ShoppingPerformanceView নতুন মেট্রিক্স সমর্থন নিম্নলিখিতগুলির জন্য সমর্থন যোগ করা হয়েছে: search_budget_lost_impression_share , search_rank_lost_impression_share , search_budget_lost_absolute_top_impression_share , এবং search_rank_lost_absolute_top_impression_share ।
ShoppingProduct.product_image_uri নতুন ক্ষেত্র ShoppingProduct -এ যোগ করা হয়েছে।
উল্লম্ব বিজ্ঞাপন
AdGroup.vertical_ads_format_setting নতুন ক্ষেত্র ট্র্যাভেল ফিড ব্যবহার করে সার্চ ক্যাম্পেইনে কোন বিজ্ঞাপন ফরম্যাটগুলো দেখানো যাবে, তা নিয়ন্ত্রণ করা যায়।
AdGroupCriterion
SharedCriterion		 নতুন ক্ষেত্র / মানদণ্ড ট্র্যাভেল ফিড ব্যবহার করে সার্চ ক্যাম্পেইনে আইটেম গ্রুপ টার্গেট করার অনুমতি দেওয়ার জন্য AdGroupCriterion এ vertical_ads_item_group_rule_list ক্রাইটেরিয়ন টাইপ এবং SharedCriterion এ vertical_ads_item_group_rule যোগ করা হয়েছে।
উল্লম্ব বিজ্ঞাপন ডেটা ফিড ইন্টিগ্রেশন নতুন বৈশিষ্ট্য এখন AI Max চালিত একটি সার্চ ক্যাম্পেইনের সাথে ভার্টিকাল অ্যাডস ডেটা ফিড সংযুক্ত করে টেক্সট অ্যাডের পাশাপাশি প্রপার্টি প্রোমোশন এবং বুকিং লিঙ্ক ট্র্যাভেল অ্যাড দেখানো যাবে। vertical_ads_format_setting দিয়ে ফরম্যাট নিয়ন্ত্রণ করুন এবং vertical_ads_item_group_rule ব্যবহার করে নিয়ম নির্ধারণ করুন। AdFormatType এবং ভার্টিকাল অ্যাডস ডেটা ফিড ডাইমেনশন অনুযায়ী রিপোর্টিং সেগমেন্ট করুন।
ভিডিও
AdVideoAssetInfo.ad_video_asset_feature_control নতুন ক্ষেত্র ভিডিও বিজ্ঞাপন অ্যাসেটগুলির জন্য ফিচার নিয়ন্ত্রণের বিকল্প যোগ করা হয়েছে।
CampaignCriterionError নতুন এনাম মান / ত্রুটি INVALID_VIDEO_LINEUP_ID ত্রুটি কোডটি যোগ করা হয়েছে।
ইউটিউব শ্রবণযোগ্যতা মেট্রিক্স নতুন মেট্রিক্স ইউটিউবে অডিও বিজ্ঞাপনের জন্য শ্রবণযোগ্যতার মেট্রিক্স যোগ করা হয়েছে, যা থেকে জানা যাবে বিজ্ঞাপনটি শোনা যাচ্ছিল কিনা এবং কতগুলো ইম্প্রেশনের উপর ভিত্তি করে শ্রবণযোগ্যতা পরিমাপ করা সম্ভব হয়েছে।

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

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

v22.2 (2026-06-24)

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

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
সাধারণ
Asset.synthetic_content_info
Ad.synthetic_content_info		 নতুন ক্ষেত্র কৃত্রিম/এআই-নির্মিত কন্টেন্টের জন্য অ্যাটেস্টেশন রয়েছে, যা দুটি ভাগে বিভক্ত: advertiser_attestation (বিজ্ঞাপনদাতার সরাসরি দেওয়া ঘোষণা) এবং system_attestation (গুগলের সিস্টেম দ্বারা স্বয়ংক্রিয়ভাবে শনাক্ত বা প্রদত্ত অ্যাটেস্টেশন)।

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

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

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

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

বহু-পক্ষীয় অনুমোদন নতুন বৈশিষ্ট্য বহু-পক্ষীয় অনুমোদন (এমপিএ) পর্যালোচনার জন্য সমর্থন যোগ করা হয়েছে:

v22.1 (2026-02-25)

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

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
অ্যাকাউন্ট ব্যবস্থাপনা
Customer.contains_eu_political_advertising নতুন ক্ষেত্র অ্যাকাউন্টটিতে ইইউ-কে লক্ষ্য করে কোনো রাজনৈতিক বিজ্ঞাপন আছে কিনা, সেই সংক্রান্ত অ্যাকাউন্ট-স্তরের ঘোষণার অবস্থা পুনরুদ্ধার করে এবং একটি EuPoliticalAdvertisingStatus ফেরত দেয়।
প্রচারণা
Campaign.missing_eu_political_advertising_declaration নতুন ক্ষেত্র যেসব ক্যাম্পেইনে ইইউ-কে লক্ষ্য করে রাজনৈতিক বিজ্ঞাপন আছে কিনা সে সম্পর্কে কোনো ঘোষণা নেই, সেগুলোকে অনুসন্ধান ও ফিল্টার করা সমর্থন করে।

v22 (২০২৫-১০-১৫)

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

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

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

প্রাথমিক অবস্থা নতুন রাজ্য ধরণ পরিবর্তন করুন বাস্তবায়ন নির্দেশিকা
চাহিদা তৈরি
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros নাম পরিবর্তন / বানান সংশোধন সঠিক ফিল্ড নামটি ব্যবহার করার জন্য রেফারেন্সগুলির নাম পরিবর্তন করুন।
সাধারণ
AddBatchJobOperations এ কোনো অপারেশন সীমা নেই। প্রতি অনুরোধে ১০,০০০ অপারেশনের সীমা আচরণগত পরিবর্তন নিশ্চিত করুন যে কোনো একক AddBatchJobOperations অনুরোধে ১০,০০০টির বেশি অপারেশন নেই।
ListBatchJobResultsRequest এ পৃষ্ঠার আকার নীরবে ১,০০০-এ সীমাবদ্ধ করা হয়েছে। INVALID_PAGE_SIZE ত্রুটি ফেরত দেয় আচরণগত পরিবর্তন নিশ্চিত করুন যে ListBatchJobResultsRequest.page_size ১,০০০ বা তার কম সেট করা আছে, কারণ এর চেয়ে বড় পেজ সাইজের অনুরোধ করলে এখন একটি ত্রুটি দেখা দেবে।
পারফরম্যান্স ম্যাক্স
সম্পদের কর্মক্ষমতা লেবেল কোনোটিই না অপসারণ পারফরম্যান্স ম্যাক্স ক্যাম্পেইনগুলির জন্য অ্যাসেট পারফরম্যান্স লেবেল সাপোর্ট এবং সংশ্লিষ্ট পারফরম্যান্স লেবেল এনাম সরিয়ে ফেলা হয়েছে। সেই অনুযায়ী ইন্টিগ্রেশনগুলি আপডেট করুন।
Campaign.url_expansion_opt_out AssetAutomationSetting এ FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION ফ্ল্যাগ অপসারণ / প্রতিস্থাপন চূড়ান্ত ইউআরএল সম্প্রসারণ টেক্সট অ্যাসেট অটোমেশন সেটিং ব্যবহার করুন। ক্যাম্পেইন-স্তরের ইউআরএল সম্প্রসারণ অপ্ট-আউট ফিল্ডটি সরিয়ে ফেলা হয়েছে।
পরিকল্পনা
views trueview_views অপসারণ / প্রতিস্থাপন ReachPlanService এ views এর রেফারেন্সগুলো নতুন trueview_views ফিল্ড দিয়ে প্রতিস্থাপন করুন।
ভিডিও
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		 পুনঃনামকরণ TrueView ভিডিও ভিউ নির্দেশকারী নতুন মেট্রিক নামগুলো ব্যবহার করার জন্য কোয়েরি স্ট্রিং এবং ইন্টিগ্রেশনগুলো আপডেট করুন।

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

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
সম্পদ
AssetFieldType.LANDING_PAGE_PREVIEW নতুন এনাম মান নতুন ইমেজ অ্যাসেট ফিল্ড টাইপ হিসেবে যোগ করা হয়েছে।
AssetGenerationService নতুন পরিষেবা (বিটা) জেনারেটিভ এআই ব্যবহার করে টেক্সট এবং ইমেজ অ্যাসেট তৈরি করার সুযোগ দেয়:
  • GenerateText : চূড়ান্ত URL, প্রম্পট, কীওয়ার্ড ইত্যাদির উপর ভিত্তি করে টেক্সট তৈরি করে।
  • GenerateImages : চূড়ান্ত URL, প্রম্পট অথবা পণ্যের ছবির পুনঃপ্রসঙ্গায়নের উপর ভিত্তি করে ছবি তৈরি করে।
  • AssetGenerationError থেকে প্রাপ্ত কোডসহ ত্রুটিগুলো ফেরত দেওয়া হয়।
প্রাথমিকভাবে শুধুমাত্র সীমিত সংখ্যক ক্লোজড বিটা অংশগ্রহণকারীদের জন্য উপলব্ধ।
প্রচারণা
AppCampaignBiddingStrategyGoalType নতুন এনাম মান কোনো টার্গেট নির্দিষ্ট না করেই অপ্টিমাইজ করার জন্য অ্যাপ ক্যাম্পেইনের (ACi) জন্য নতুন গোল যোগ করা হয়েছে:
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA : স্ট্যান্ডার্ড ম্যাক্সিমাইজ কনভার্সনস-এর সাথে ব্যবহার করুন।
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS : স্ট্যান্ডার্ড ম্যাক্সিমাইজ কনভার্সন ভ্যালু-এর সাথে ব্যবহার করুন।
BiddingStrategyType নতুন বৈশিষ্ট্য নির্দিষ্ট শেয়ার অফ ভয়েস বিডিং স্ট্র্যাটেজি টাইপের জন্য সমর্থন যোগ করা হয়েছে।
Campaign.feed_types নতুন ক্ষেত্র একটি ক্যাম্পেইনের সাথে সংযুক্ত ফিডগুলির প্রকারভেদ দেখায়। পারফরম্যান্স ম্যাক্স ক্যাম্পেইনের ক্ষেত্রে, এটি ব্যবসায়িক ক্ষেত্র নির্দেশ করতে পারে, যেমন খুচরা ব্যবসার জন্য MERCHANT_CENTER_FEED ।
শেয়ার্ড সেট টার্গেটিং নতুন বৈশিষ্ট্য মাল্টি-চ্যানেল (অ্যাপ ক্যাম্পেইনের জন্য) এবং লোকাল ক্যাম্পেইনে নেগেটিভ কীওয়ার্ড শেয়ার্ড সেট সংযুক্ত করার অনুমতি দেওয়া হয়েছে।
চাহিদা তৈরি
টার্গেটসিপিসি বিডিং নতুন বৈশিষ্ট্য 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 নতুন এনাম মান 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 আচরণগত পরিবর্তন 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 বাগ ফিক্স 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).

v21 major and minor versions

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

v21.2 (2026-06-24)

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

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
সাধারণ
Multi-party approvals নতুন বৈশিষ্ট্য Added support for multi-party approvals (MPA) reviews:

v21.1 (2026-02-25)

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

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
অ্যাকাউন্ট ব্যবস্থাপনা
Customer.contains_eu_political_advertising নতুন ক্ষেত্র Retrieves the account-level declaration status of whether it contains political advertising targeted towards the EU, and returns an EuPoliticalAdvertisingStatusEnum .
প্রচারণা
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.

v21 (2025-08-06)

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

See Upgrade to the latest version for guidance.

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

প্রাথমিক অবস্থা New state ধরণ পরিবর্তন করুন বাস্তবায়ন নির্দেশিকা
প্রচারণা
Returns CriterionError.INVALID_LISTING_GROUP_HIERARCHY Returns CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION Error code change For requests with a partial failure enabled, handle the new error code instead of the original hierarchy error code.
রূপান্তর
Access to debug_enabled mode in ConversionUploadService কোনোটিই না অপসারণ The debug_enabled field is removed. Update code referencing it to not set or query this parameter.
EU political advertising changes
Optional campaign self-declarations for EU political advertising Required contains_eu_political_advertising field for new campaigns Validation rule / behavioral shift API calls to create new campaigns will fail with a FieldError.REQUIRED error if this field is not set. Starting September 22, 2025, campaigns declared as CONTAINS_EU_POLITICAL_ADVERTISING will no longer serve in the EU.
Modifiable criteria without self-declaration Fails updates with CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Validation rule / behavioral shift Set the self-declaration status before attempting to create or update campaign- or ad group-level proximity, location, or location group targeting criteria for existing campaigns.
Experiments without self-declaration requirements Fails updates with ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Validation rule / behavioral shift Ensure that the self-declarations have been completed on the experiment's campaigns.
পারফরম্যান্স ম্যাক্স
brand_guidelines_enabled defaults to false Defaults to true আচরণগত পরিবর্তন For new Performance Max campaigns, brand guidelines are enabled by default. Explicitly set the field to false if they should be disabled.
পরিকল্পনা
Original input argument type for AudienceInsightsService.GenerateTargetingSuggestionMetrics Input of type InsightsAudience টাইপ পরিবর্তন Update implementations to pass the new input type which supports an AND-of-ORs combination of user interests, permitting potential reach metrics for custom audience definitions.

Features and updates (non-breaking)

বৈশিষ্ট্য এবং আপডেট প্রকার বর্ণনা
সার্চ ক্যাম্পেইনের জন্য এআই ম্যাক্স
ai_max_setting.enable_ai_max in Campaign নতুন ক্ষেত্র Enables AI Max to expand search term matching (respecting previous text asset automation and brand lists until toggled off). The field Campaign.ai_max_setting.bundling_required indicates if AI Max must be enabled to respect/modify those settings, and AdGroup.ai_max_ad_group_setting.disable_search_term_matching can disable matching at the ad group level. See Unlock next-level performance with AI Max for Search campaigns .
CampaignError.AI_MAX_MUST_BE_ENABLED New enum value / error Thrown when opting in to URL expansion text asset automation in Search campaigns without enabling AI Max.
Ad group level targeting নতুন বৈশিষ্ট্য Support added in AI Max for Search campaigns for brand lists, locations, and webpages (URL rules) at the ad group level.
ai_max_search_term_ad_combination_view New reporting resource Reports performance on combinations of search terms, headlines, and landing pages.
search_term_match_type segment New enum value Added AI_MAX as a search term match type option.
সম্পদ
PromotionAsset New fields Added terms_and_conditions_text , terms_and_conditions_uri , and oneof promotion_trigger options ( promotion_barcode_info , promotion_qr_code_info ). See About promotion assets .
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION New enum value Added to AssetAutomationType to control automated text and landing page generation from final URLs in Search campaigns.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset New service / method Allows removing automatically created final URL expansion assets from campaigns.
ServedAssetFieldType.DESCRIPTION_PREFIX New enum value Added to correct a reporting issue where the type was returned as UNKNOWN in ad_group_ad_asset_combination_view .
প্রচারণা
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING New enum value Returned when location-restricted campaigns lack location targeting (which now throws LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN if targeted outside the allowed area).
Third-party app analytics integration New fields Added support for VideoCustomer.third_party_integration_partners and Campaign.third_party_integration_partners . See Track app conversions with third-party app analytics .
Campaign.advertising_partner_ids New field support The field can now be set for existing campaigns (remains immutable after being set).
Manager-level negative placements নতুন বৈশিষ্ট্য Allows exclusions of placement lists across individual advertiser accounts using CustomerNegativeCriterion .
Tolerance configurations in target ROAS strategies New fields Added support for TargetRoas.target_roas_tolerance_percent_millis (for Search campaign portfolio strategies) in MaximizeConversionValue and TargetRoas .
LocationInterestView New reporting resource Summarizes performance of ad group location interest criteria.
রূপান্তর
conversion_attribution_event_type segment New enum value Added ENGAGED_VIEW to conversion attribution type options.
চাহিদা তৈরি
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM New enum value / error Added in preparation for enforcing minimum daily budgets for Demand Gen campaigns. Details are exposed using budgetDailyMinimumErrorDetails .
পারফরম্যান্স ম্যাক্স
campaign_search_term_view New reporting resource Aggregates search terms metrics at the campaign level, enabling search term analysis and reporting for Performance Max.
পরিকল্পনা
ReachPlanService.ListPlannableUserInterests New method Allows discovering plannable affinities and in-market interests for generateReachForecast .
AdditionalApplicationInfo নতুন ক্ষেত্র Added as an optional input in ReachPlanService.ListPlannableUserLists .
AudienceInsights attributes listing নতুন বৈশিষ্ট্য AudienceInsightsService.ListAudienceInsightsAttributes now fetches available 1P user lists.
AudienceCompositionInsights targeting CRM lists নতুন বৈশিষ্ট্য AudienceInsightsService.GenerateAudienceCompositionInsights now returns user list index details for AudienceInsightsDimension dimensions: AGE_RANGE , GENDER , AFFINITY_USER_INTEREST , and IN_MARKET_USER_INTEREST .
TrendInsightMetrics audience share নতুন ক্ষেত্র Represents the share of an audience for a trend.
KnowledgeGraphAttributeMetadata categories New fields Filters Knowledge Graph attributes by matching categories.
প্রতিবেদন
Asset views metrics New features / metrics Added multiple new metrics to AssetGroupAsset , ChannelAggregateAssetView , and CampaignAggregateAssetView . PMax campaigns also now report true values for impressions .
Selector extensions নতুন বৈশিষ্ট্য Made AssetSet and CampaignAssetSet queryable together inside ChangeStatus .
search_term_targeting_status New segment Selectable segment in the campaign search term view.
final_url_expansion_asset_view New reporting resource Reports final URL expansion asset performance details.
AssetGroup value adjustments New fields Added support for value_adjustment and all_value_adjustment metrics in the AssetGroup report.
landing_page_source New segment Provides a landing page source segment in landing_page_view .
search_term_match_source New segment Selectable segment in the search term and campaign search term views.
match_type New segment Selectable segment key in the keyword view.
Unique query intent clusters reporting New fields Added clicks_unique_query_clusters , conversions_unique_query_clusters , and impressions_unique_query_clusters to report unique query intent clusters.
ClickType.VEHICLE_ASSETS New enum value Track and report clicks related specifically to vehicle ad formats in the click_view report.
Smart Bidding Exploration
tolerance configurations in Search strategies New fields / settings Allows enabling Smart Bidding Exploration on Search campaigns by setting target_roas_tolerance_percent_millis between 10,000 (10%) and 30,000 (30%) inclusive (Maximize Conversions requires target_roas setting). See our blog post on Smart Bidding Exploration and help center article .
diversity reporting compatibility নতুন বৈশিষ্ট্য Aggregated diversity reporting is now supported for the following metrics for unique query intent clusters. A time segmented view is available in the Google Ads UI:
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
ভিডিও
YouTubeVideoListAsset New resource / field Allows establishing links between campaigns and video list assets using Asset.youtube_video_list_asset . See Use related videos .
Insights metadata extensions New fields Added new metadata to YouTubeChannelInsights and YouTubeVideoAttributeMetadata .
Interactive click types New enum values Added click types: VIDEO_RELATED_VIDEOS_CLICK , VIDEO_CHANNEL_CLICK , and PRODUCT_ASSETS .
VideoAdInventoryControl.allow_non_skippable_in_stream নতুন ক্ষেত্র Lets Video Responsive ads serve as non-skippable in-stream ads for campaigns mixing skip and non-skip formats.
Video sequencing settings New fields Added read-only sequencing configurations: Campaign.VideoCampaignSettings.video_ad_sequence and VideoAdSequenceStepSetting . See About video ad sequencing .
Video lineup targeting New criterion type / field Added VIDEO_LINEUP criterion type and corresponding field in CampaignCriterion and AdGroupCriterion . This feature is only available to accounts on the allowlist.
Content suitability placements views New reporting resources Added a Content Suitability report for both detail ( detail_content_suitability_placement_view ) and group ( group_content_suitability_placement_view ) levels. See About the 'Content suitability' report .

Archived release notes

See Sunsetted versions for archived release notes.