রিলিজ নোট

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

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

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

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	নতুন ক্ষেত্র	এআই ম্যাক্স-এ আসন্ন স্বয়ংক্রিয় স্থানান্তর ট্র্যাক করুন।
রূপান্তর
ব্র্যান্ড লিফট পরিমাপ	নতুন বৈশিষ্ট্য	নিম্নলিখিত আপডেটগুলির মাধ্যমে ব্র্যান্ড লিফট পরিমাপের জন্য সমর্থন যোগ করা হয়েছে: লিফট স্টাডির ফলাফলের জন্য নতুন পঠনযোগ্য মাত্রিক রিসোর্স যোগ করা হয়েছে: LiftMeasurementAgeRange , LiftMeasurementCampaign , LiftMeasurementDevice , LiftMeasurementGender , এবং LiftMeasurementVideo । LiftMeasurementConfig এবং নতুন ডাইমেনশনাল রিসোর্সগুলোর সাহায্যে ব্র্যান্ড লিফট বিশ্লেষণকে সমর্থন করার জন্য নতুন সেগমেন্ট ও মেট্রিক যোগ করা হয়েছে। নিম্নলিখিত এনামগুলি যোগ করা হয়েছে: BrandLiftMeasurementType , LiftMeasurementFlightStatus , SurveyIntendedAction , SurveyLiftFlightTargetResponseMode , এবং SurveySubjectType ।
রূপান্তর লিফট পরিমাপ	নতুন বৈশিষ্ট্য	নিম্নলিখিত আপডেটগুলির মাধ্যমে কনভার্সন লিফট পরিমাপের জন্য সমর্থন যোগ করা হয়েছে: একটি লিফট স্টাডির প্রতিনিধিত্বকারী LiftMeasurementConfig নামে একটি নতুন পঠনযোগ্য রিসোর্স যোগ করা হয়েছে। লিফট ফলাফলকে ভাগ ও ফিল্টার করার জন্য নতুন নির্বাচনযোগ্য সেগমেন্ট যোগ করা হয়েছে। লিফট পারফরম্যান্সের বিশদ পরিসংখ্যানগত বিশ্লেষণের জন্য ২৪টি নতুন কনভার্সন লিফট মেট্রিক এবং উইনার স্কোর মেট্রিক যোগ করা হয়েছে। ক্যাম্পেইনের বিবরণ এবং কনভার্সন লক্ষ্যমাত্রা পুনরুদ্ধারের সুবিধা যোগ করা হয়েছে। Experiment.lift_measurement_config নামে একটি নতুন ঐচ্ছিক ফিল্ড যোগ করা হয়েছে। ConversionLiftIncludedConversionActionTypes enum-টি যোগ করা হয়েছে।
LiftMeasurementFlight	নতুন সম্পদ	একটি নতুন পঠনযোগ্য রিসোর্স যা একটি লিফট পরিমাপ কনফিগারেশনের জন্য ফ্লাইটের বিবরণ উপস্থাপন করে, যার মধ্যে পরিমাপকৃত ফ্লাইটের শুরু এবং শেষের তারিখ ( start_date এবং end_date ) অন্তর্ভুক্ত রয়েছে।
সাধারণ
SmartCampaignError	নতুন এনাম মান	পারফরম্যান্স ম্যাক্স জেনারেশন সীমাবদ্ধতার জন্য নতুন নির্দিষ্ট ত্রুটি কোড যোগ করা হয়েছে: VALIDATE_ONLY_GENERATE_PMAX_NOT_SUPPORTED GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	নতুন এনাম মান / ত্রুটি	যখন TEST অ্যাক্সেস লেভেলযুক্ত কোনো গুগল ক্লাউড প্রজেক্ট একটি নন-টেস্ট অ্যাকাউন্টের বিরুদ্ধে অনুরোধ পাঠানোর চেষ্টা করে, তখন এটি ফেরত আসে।
পরিকল্পনা
ব্র্যান্ডের মনোভাব সম্পর্কিত অন্তর্দৃষ্টি	নতুন বৈশিষ্ট্য	ContentCreatorInsightsService এ ব্র্যান্ড সেন্টিমেন্ট ইনসাইটস-এর জন্য সমর্থন যোগ করা হয়েছে: BrandSentimentInsight , SentimentInsightDistribution এবং SentimentInsightSummary মেসেজগুলো যোগ করা হয়েছে। Sentiment enum যোগ করা হয়েছে। ContentCreatorInsightsSupplementalData enum-এ BRAND_SENTIMENT_DATA ভ্যালুটি যোগ করা হয়েছে। InsightsKnowledgeGraphEntityCapabilities enum-এ BRAND ভ্যালুটি যোগ করা হয়েছে।
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 )	কোনোটিই না	অপসারণ	সংশোধিত সমন্বিত লক্ষ্য কাঠামো ব্যবহার করুন: Goal রিসোর্সের মধ্যে new_customer_acquisition_goal_settings ফিল্ডটি ব্যবহার করুন। ক্যাম্পেইন-নির্দিষ্ট ওভাররাইড কনফিগার করতে CampaignGoalConfig রিসোর্সের campaign_new_customer_acquisition_settings ফিল্ডটি ব্যবহার করুন।
সাধারণ
ইনসেনটিভ সার্ভিস অনুরোধ এবং প্রতিক্রিয়া বার্তাগুলিতে নেস্টেড এনুম ফিল্ড: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	স্বতন্ত্র এনাম ক্ষেত্রসমূহ: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_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 সম্পূর্ণরূপে পরিবর্তনযোগ্য।
প্রচারণা
আনুগত্য ধরে রাখার লক্ষ্য	নতুন বৈশিষ্ট্য / সেটিংস	লয়্যালটি রিটেনশন গোলের জন্য সমর্থন যোগ করা হয়েছে, যা বিজ্ঞাপনদাতাদের লয়্যালটি প্রোগ্রামের সদস্যদের ধরে রাখার জন্য ক্যাম্পেইন অপ্টিমাইজ করতে সাহায্য করে। GoalType enum-এ LOYALTY_RETENTION যোগ করা হয়েছে। ক্যাম্পেইন-নির্দিষ্ট লয়্যালটি রিটেনশন সেটিংস কনফিগার করার জন্য CampaignGoalConfig.campaign_loyalty_retention_settings যোগ করা হয়েছে, যার মধ্যে বিড অ্যাডজাস্টমেন্ট এবং পিএলএ ফরম্যাটে মেম্বার বেনিফিট দেখানো অন্তর্ভুক্ত। অ্যাকাউন্ট-স্তরের লয়্যালটি রিটেনশন গোল সেটিংস কনফিগার করার জন্য Goal.loyalty_retention_goal_settings যোগ করা হয়েছে। নতুন ত্রুটি কোড যোগ করা হয়েছে: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
নতুন গ্রাহক অর্জনের লক্ষ্য	নতুন বৈশিষ্ট্য / সেটিংস	সংশোধিত একীভূত গোল স্কিমার সাথে সামঞ্জস্য রেখে গুগল অ্যাডস এপিআই-তে নতুন গ্রাহক অধিগ্রহণ গোলের সাপোর্ট আপডেট করা হয়েছে: new_customer_acquisition_goal_settings ফিল্ডটি ব্যবহার করে নতুন গ্রাহক অধিগ্রহণ (New Customer Acquisition) সেটিংস সমর্থন করার জন্য ` Goal রিসোর্সটিকে সম্প্রসারিত করা হয়েছে। campaign_new_customer_acquisition_settings ফিল্ড ব্যবহার করে নতুন গ্রাহক অধিগ্রহণের জন্য ক্যাম্পেইন-নির্দিষ্ট ওভাররাইড সমর্থন করতে CampaignGoalConfig রিসোর্সটি সম্প্রসারিত করা হয়েছে। সমর্থিত গোল সাবটাইপগুলো সংজ্ঞায়িত করার জন্য নতুন CustomerLifecycleOptimizationGoalSubType enum যোগ করা হয়েছে। GoalType enum-এ NEW_CUSTOMER_ACQUISITION যোগ করা হয়েছে। GoalError এ নতুন ভ্যালিডেশন ত্রুটির কারণ যোগ করা হয়েছে: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS CampaignGoalConfigError এ নতুন ভ্যালিডেশন ত্রুটির কারণ যোগ করা হয়েছে: CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS ভ্যালিডেশন ত্রুটির জন্য নতুন IncompatibleCloGoalsErrorDetails স্ট্রাকচারটি প্রকাশ করতে ErrorDetails.incompatible_clo_goal_error_details যোগ করা হয়েছে।
রূপান্তর
ইউটিউব তৃতীয় পক্ষের রূপান্তর অ্যাট্রিবিউশন	নতুন ক্ষেত্র	তৃতীয় পক্ষের অংশীদারদের ব্যবহার করে ইউটিউব কনভার্সন অ্যাট্রিবিউশন যাচাইকরণের জন্য সমর্থন যোগ করা হয়েছে: গ্রাহক পর্যায়ে ইন্টিগ্রেশন পার্টনার কনফিগার করার সুযোগ দিতে CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners যোগ করা হয়েছে। ক্যাম্পেইন পর্যায়ে ইন্টিগ্রেশন পার্টনার কনফিগার করার সুবিধা দিতে CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners যোগ করা হয়েছে। আরও জানতে সহায়তা কেন্দ্রের নিবন্ধটি দেখুন।
সাধারণ
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 এ যোগ করা হয়েছে। এটি তখনই সত্যি হয়, যখন কোনো ক্রিয়েটর অপ্রকাশ্য ডেটা শেয়ার করার জন্য সম্মতি দিয়ে থাকেন। সেক্ষেত্রে, নিম্নলিখিত ফিল্ডগুলো পূরণ করা হয়: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
প্রতিবেদন
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 সাথে নির্বাচনযোগ্য।
ভিডিও-নির্দিষ্ট সামাজিক মেট্রিক্স	নতুন ক্ষেত্র / মেট্রিক্স	ইউটিউবে শর্টস বিজ্ঞাপনের জন্য বিজ্ঞাপনদাতাদের ব্যবহারকারীর সম্পৃক্ততা (মন্তব্য, লাইক এবং শেয়ার) ট্র্যাক করতে সাহায্য করার জন্য ভিডিও-নির্দিষ্ট সোশ্যাল মেট্রিক্স যোগ করা হয়েছে: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares এগুলো 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 চালু হলে আপনার সিস্টেম পূর্ণ রাইট ক্ষমতার জন্য প্রস্তুত থাকে।
বহু-পক্ষীয় অনুমোদন	নতুন বৈশিষ্ট্য	বিটা: এই ফিচারটি বর্তমানে বিটা পর্যায়ে রয়েছে এবং ভবিষ্যতের সংস্করণগুলিতে এতে পরিবর্তন আসতে পারে। বহু-পক্ষীয় অনুমোদন (এমপিএ) পর্যালোচনার জন্য সমর্থন যোগ করা হয়েছে: MultiPartyAuthReview রিসোর্স এবং সংশ্লিষ্ট MultiPartyAuthReviewService যোগ করা হয়েছে। রিভিউ স্ট্যাটাস ট্র্যাক করার জন্য MultiPartyAuthReviewStatus enum যোগ করা হয়েছে। একটি মুলতুবি থাকা পর্যালোচনার সাথে লিঙ্ক করার জন্য CustomerUserAccess.pending_multi_party_auth_review যোগ করা হয়েছে। সংশ্লিষ্ট রিভিউ রিসোর্সের নাম ফেরত দেওয়ার জন্য MutateCustomerUserAccessResult.multi_party_auth_review এবং MutateCustomerUserAccessInvitationResult.multi_party_auth_review যোগ করা হয়েছে। ভ্যালিডেশন ত্রুটির জন্য MultiPartyAuthReviewError যোগ করা হয়েছে। এই ফিচারটি 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 এ অপ্রচলিত কীওয়ার্ড পরিকল্পনা / পূর্বাভাস ক্ষেত্র	কোনোটিই না	অপসারণ	নিম্নলিখিত পরিকল্পনা / পূর্বাভাস ক্ষেত্র এবং প্রকারগুলি সরানো হয়েছে: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords এবং ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate সেই অনুযায়ী ইন্টিগ্রেশনগুলো আপডেট করুন।
প্রতিবেদন
campaign_budget বাজেটে ad_sub_network_type সেগমেন্ট	কোনোটিই না	অপসারণ	campaign_budget রিসোর্সের জন্য ad_sub_network_type সেগমেন্টটি সরানো হয়েছে।
অ্যাসেট ভিউতে click_type সেগমেন্ট	কোনোটিই না	অপসারণ	AdGroupAsset , CampaignAsset , এবং CustomerAsset ভিউগুলো থেকে সেগমেন্টটি সরানো হয়েছে।
ভিডিও
ShareablePreviewService.GenerateShareablePreviews এ আংশিক ব্যর্থতার অনুমতি দেওয়া হয়েছে।	কোনো আংশিক ব্যর্থতা নেই	আচরণগত পরিবর্তন	অনুরোধের মধ্যে থাকা কোনো আইডি যাচাইকরণে ব্যর্থ হলে, অনুরোধটি ব্যর্থ হবে এবং একটি ত্রুটি দেখাবে।
ShareablePreviewError লিগ্যাসি কোডসমূহ: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	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	নতুন রিপোর্টিং রিসোর্স	ক্লিক করা পণ্যের পাশাপাশি বিক্রি হওয়া নির্দিষ্ট পণ্য (ব্র্যান্ড, ইত্যাদি) অনুযায়ী কনভার্সন মেট্রিক্সকে বিভক্ত করে রিপোর্ট প্রকাশ করে।
অ-নিলামযোগ্য মেট্রিক্স	নতুন ক্ষেত্র	সমস্ত মিলে যাওয়া রিসোর্সগুলিতে নন-বিডেবল মেট্রিক (যেসব মেট্রিক এমন কনভার্সন দেখায় যার জন্য ক্যাম্পেইন অপটিমাইজ করা হচ্ছে না) যোগ করা হয়েছে: all_average_cart_size all_average_order_value_micros all_cost_of_goods_sold_micros all_cross_sell_cost_of_goods_sold_micros all_cross_sell_gross_profit_micros all_cross_sell_revenue_micros all_cross_sell_units_sold all_gross_profit_margin all_gross_profit_micros all_lead_cost_of_goods_sold_micros all_lead_gross_profit_micros all_lead_revenue_micros all_lead_units_sold all_orders all_revenue_micros all_units_sold
conversion_attribution_event_type	নতুন অংশ	ShoppingPerformanceView তে যোগ করা হয়েছে।
কেনাকাটা
ShoppingProduct অ্যাপ ক্যাম্পেইন	নতুন বৈশিষ্ট্য	ShoppingProduct রিসোর্সের মধ্যে অ্যাপ ক্যাম্পেইনগুলো সমর্থিত। নোটের স্ট্যাটাস এবং ইস্যু সমর্থিত নয়।
ট্যাগ-ভিত্তিক পণ্য ফিল্টারিং	নতুন বৈশিষ্ট্য	লজিক্যাল সেট এক্সপ্রেশন ব্যবহার করে ডায়নামিকভাবে ফিল্টারিং চালু করা হয়েছে: RETAIL_FILTER_BUNDLE এবং RETAIL_FILTER ক্রাইটেরিয়ন টাইপ যোগ করা হয়েছে। RETAIL_FILTER শেয়ার্ড সেট টাইপ যোগ করা হয়েছে। AdGroupCriterion এ retail_filter_bundle ফিল্ডটি যোগ করা হয়েছে। SharedCriterion এ retail_filter ফিল্ডটি যোগ করা হয়েছে। ListingGroupFilterListingSource এ RETAIL যোগ করা হয়েছে। AssetGroupListingGroupFilter এ RetailFilter ডাইমেনশনটি যোগ করা হয়েছে। CriterionError এবং AssetGroupListingGroupFilterError এ সংশ্লিষ্ট নতুন ভ্যালিডেশন ত্রুটি যোগ করা হয়েছে। এই ফিচারটি শুধুমাত্র অনুমোদিত তালিকায় থাকা অ্যাকাউন্টগুলোর জন্য উপলব্ধ।

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	নতুন ক্ষেত্র	কৃত্রিম/এআই-নির্মিত কন্টেন্টের জন্য অ্যাটেস্টেশন রয়েছে, যা দুটি ভাগে বিভক্ত: advertiser_attestation (বিজ্ঞাপনদাতার সরাসরি দেওয়া ঘোষণা) এবং system_attestation (গুগলের সিস্টেম দ্বারা স্বয়ংক্রিয়ভাবে শনাক্ত বা প্রদত্ত অ্যাটেস্টেশন)। v25-এর জন্য আপনার আসন্ন ইন্টিগ্রেশন কাজের পরিকল্পনায় সাহায্য করার জন্য, v22 এবং তার পরবর্তী সংস্করণগুলিতে অ্যাডভার্টাইজার অ্যাটেস্টেশন ফিল্ড পরিবর্তন করার ইন্টারফেসটি আগেভাগেই চালু করা হচ্ছে। এই সংস্করণগুলিতে ইন্টারফেসটি দেখা যাবে, কিন্তু synthetic_content_info.advertiser_attestation.status এবং synthetic_content_info.advertiser_attestation.source এই সংস্করণগুলির জন্য অপরিবর্তনীয় থাকবে। আপনি যদি এই ফিল্ডগুলির কোনো একটিতে মিউটেট রিকোয়েস্ট করার চেষ্টা করেন, তাহলে এই ত্রুটিগুলির মধ্যে একটি ফেরত আসবে: "যে ফিল্ডটি পরিবর্তন করার চেষ্টা করা হচ্ছে তা অপরিবর্তনযোগ্য" অথবা "ফিল্ডটি সেট করা যাবে না"। v25 থেকে এই ফিল্ডগুলো সম্পূর্ণরূপে পরিবর্তনযোগ্য হয়ে যাবে। আমরা সুপারিশ করছি যে, আপনার অভ্যন্তরীণ লজিক তৈরি ও পরীক্ষা করার জন্য এখনই ইন্টারফেসটি ব্যবহার করুন, যাতে v25 চালু হলে আপনার সিস্টেম পূর্ণ রাইট ক্ষমতার জন্য প্রস্তুত থাকে।
বহু-পক্ষীয় অনুমোদন	নতুন বৈশিষ্ট্য	বিটা: এই ফিচারটি বর্তমানে বিটা পর্যায়ে রয়েছে এবং ভবিষ্যতের সংস্করণগুলিতে এতে পরিবর্তন আসতে পারে। বহু-পক্ষীয় অনুমোদন (এমপিএ) পর্যালোচনার জন্য সমর্থন যোগ করা হয়েছে: MultiPartyAuthReview রিসোর্স এবং সংশ্লিষ্ট MultiPartyAuthReviewService যোগ করা হয়েছে। রিভিউ স্ট্যাটাস ট্র্যাক করার জন্য MultiPartyAuthReviewStatus enum যোগ করা হয়েছে। একটি মুলতুবি থাকা পর্যালোচনার সাথে লিঙ্ক করার জন্য CustomerUserAccess.pending_multi_party_auth_review যোগ করা হয়েছে। সংশ্লিষ্ট রিভিউ রিসোর্সের নাম ফেরত দেওয়ার জন্য MutateCustomerUserAccessResult.multi_party_auth_review এবং MutateCustomerUserAccessInvitationResult.multi_party_auth_review যোগ করা হয়েছে। ভ্যালিডেশন ত্রুটির জন্য MultiPartyAuthReviewError যোগ করা হয়েছে।

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 জন্য সমর্থন	কোনোটিই না	অপসারণ	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	কোনোটিই না	Removal	The lead_form_only field has been removed. Update references in your code.
প্রতিবেদন
Aggregate asset performance label metrics and enum	কোনোটিই না	Removal	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	New field	Read-only orientation field added to image and video assets.
CampaignAsset	New feature	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: Added support for Facebook Messenger and Zalo as providers. Added FACEBOOK_MESSENGER and ZALO to BusinessMessageProvider . Added fields facebook_messenger_info and zalo_info . Added CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS to AssetError .
বিলিং
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.
Conversions
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	New field	Added support for companion banners in Demand Gen responsive video ads.
Incentives
Added Choose Your Own (CYO) incentives support: Added the FetchIncentive method to retrieve available personalized incentives for a user. Added the ApplyIncentive method to apply a selected incentive to a customer account. Added the AppliedIncentive resource (queryable using Search and SearchStream ) to provide redemption details. Added new error codes in IncentiveError and AuthenticationError.INVALID_EMAIL_ADDRESS . 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	New service	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	New field	Evaluates how relevant a creator is for a topic weighted by views.
TrendInsightMetrics.trend_change_percent	New field	Represents the percentage change in a trend's value over the comparison period.
সুপারিশসমূহ
GenerateRecommendationsRequest	New field	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	New feature	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	New field	Added to ShoppingProduct .
Vertical ads
AdGroup.vertical_ads_format_setting	New field	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	New feature	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	New field	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	New features	Beta: This feature is currently in beta and is subject to change in future releases. Added support for multi-party approvals (MPA) reviews: Added the MultiPartyAuthReview resource and corresponding MultiPartyAuthReviewService . Added the MultiPartyAuthReviewStatus enum to track the review status. Added CustomerUserAccess.pending_multi_party_auth_review to link to a pending review. Added MutateCustomerUserAccessResult.multi_party_auth_review and MutateCustomerUserAccessInvitationResult.multi_party_auth_review to return the associated review resource name. Added MultiPartyAuthReviewError for validation errors.

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	প্রকার	বর্ণনা
Account management
Customer.contains_eu_political_advertising	New field	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	New field	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.
Performance Max
Asset performance labels	কোনোটিই না	Removal	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	New feature	Added support for the fixed share of voice bidding strategy type.
Campaign.feed_types	New field	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	New feature	Allowed attaching negative keywords shared sets to multi-channel (for App campaigns) and local campaigns.
Demand Gen
TargetCPC bidding	New feature	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.
Performance Max
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: ad_using_product_data : Indicates if an ad uses Google Merchant Center product data. ad_using_video : Indicates if an ad uses a video asset.
পরিকল্পনা
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	New field	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	New message	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	New feature	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	New feature	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.

,

Refer to Feature deprecations for an up to date list of current and planned feature deprecations.

v25 major and minor versions

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

v25.1 (2026-08-19)

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

Features and updates	প্রকার	বর্ণনা
সম্পদ
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER	New enum values	Added support for text disclaimer assets.
প্রচারণা
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time	New fields	Track the upcoming auto-migration to AI Max.
Conversions
Brand Lift measurements	New features	Added support for Brand Lift measurements with the following updates: Added new read-only dimensional resources for lift study results: LiftMeasurementAgeRange , LiftMeasurementCampaign , LiftMeasurementDevice , LiftMeasurementGender , and LiftMeasurementVideo . Added new segments and metrics to support Brand Lift analysis with LiftMeasurementConfig and the new dimensional resources. Added the following enums: BrandLiftMeasurementType , LiftMeasurementFlightStatus , SurveyIntendedAction , SurveyLiftFlightTargetResponseMode , and SurveySubjectType .
Conversion Lift measurements	New features	Added support for Conversion Lift measurements with the following updates: Added a new read-only resource LiftMeasurementConfig representing a lift study. Added new selectable segments to segment and filter lift results. Added 24 new Conversion Lift metrics and winner score metrics supporting detailed statistical analysis of lift performance. Added support to retrieve campaign details and conversion goals. Added a new optional field Experiment.lift_measurement_config . Added the ConversionLiftIncludedConversionActionTypes enum.
LiftMeasurementFlight	New resource	A new read-only resource representing flight details for a lift measurement configuration, including measured flight start and end dates ( start_date and end_date ).
সাধারণ
SmartCampaignError	New enum values	Added new specific error codes for Performance Max generation constraints: VALIDATE_ONLY_GENERATE_PMAX_NOT_SUPPORTED GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	New enum value / error	Returned when a Google Cloud project with TEST access level attempts to make requests against a non-test account.
পরিকল্পনা
Brand sentiment insights	New features	Added support for brand sentiment insights in ContentCreatorInsightsService : Added the BrandSentimentInsight , SentimentInsightDistribution , and SentimentInsightSummary messages. Added the Sentiment enum. Added the BRAND_SENTIMENT_DATA value to the ContentCreatorInsightsSupplementalData enum. Added the BRAND value to the InsightsKnowledgeGraphEntityCapabilities enum.
BenchmarksService enhancements	New features	Added support for categories as filters for scoping a benchmarks analysis. Also supported additional business critical metrics: Added an option to benchmark against all advertisers running Ads in one or more Product & Service Categories using BenchmarksService.GenerateBenchmarksMetrics and the category_filter . Surfaced more customer ad metrics such as the customer's aggregate cost, views, etc. and share metrics such as share_of_voice . Metrics are returned using AggregateMetrics and ShareMetrics . The list of supported categories can be retrieved using BenchmarksService.ListBenchmarksSources with the CATEGORY source type.
Parental status targeting	New feature	Added support for parental status targeting in reach planning. The new field parental_statuses has been added to Targeting for service ReachPlanService.GenerateReachForecast , and parental_statuses has been added to PlannableTargeting for service ReachPlanService.ListPlannableProducts .
সুপারিশসমূহ
Recommendation.campaign_specific_app_goal_recommendation	New recommendation	Suggests adding a campaign-specific app conversion goal. The new EffectiveAutomaticGoal resource is used to represent current goals within this recommendation.
প্রতিবেদন
Metrics.original_conversion_value	New field	Represents the original conversion value from biddable conversions. This is the unadjusted value of conversions before any value rule adjustments, such as conversion value rules or lifecycle goals adjustments are applied.
Loyalty membership stats	New features	Added support for segmenting stats by user loyalty membership program status, and added loyalty membership primary dimension for conversion value rules: Added the Segments.loyalty_membership segment to support segmenting report metrics by the loyalty program tier of the converting user. Added the LOYALTY_MEMBERSHIP primary dimension to identify when a loyalty membership condition was satisfied for a conversion value rule.
Targeting
vertical_ads_item_bid	New criterion type	Added the new vertical_ads_item_bid criterion type to AdGroupCriterion.criterion .

v25 (2026-07-22)

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

See Upgrade to the latest version for guidance.

Breaking changes

Initial state	New state	Change type	Implementation guidance
প্রচারণা
Standalone fields additional_value and additional_high_lifetime_value in CustomerLifecycleOptimizationValueSettings	Part of value_adjustment and high_lifetime_value_adjustment oneofs respectively, alongside the new value_multiplier and high_lifetime_value_multiplier fields	Structural change	Update references to these fields as they are now part of oneofs.
Legacy CustomerLifecycleGoal and CampaignLifecycleGoal resources, their corresponding services CustomerLifecycleGoalService and CampaignLifecycleGoalService , and legacy settings/enums ( CustomerAcquisitionGoalSettings , CustomerAcquisitionOptimizationModeEnum , LifecycleGoalValueSettings )	কোনোটিই না	Removal	Use the revamped unified goals schema: Use the new_customer_acquisition_goal_settings field in the Goal resource. Use the campaign_new_customer_acquisition_settings field in the CampaignGoalConfig resource to configure campaign-specific overrides.
সাধারণ
Nested enum fields in Incentive Service request and response messages: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	Standalone enum fields: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	Rename / removal	Use the new standalone enum fields instead of the legacy type fields.
Optional selected_incentive_id and customer_id fields in ApplyIncentiveRequest	প্রয়োজনীয় ক্ষেত্রসমূহ	Behavioral shift	Ensure you provide both fields when calling ApplyIncentive .
The consumer email address field ContactDetails.email in the LocalServicesLead resource	কোনোটিই না	Removal	Remove references to this field because it is no longer supported.
Optional allowed_domain field in AdvertisingPartnerLinkInvitationProperties	Required field when calling CreateProductLinkInvitation for an advertising partner	Behavioral shift	Ensure you provide allowed_domain when creating a product link invitation for an advertising partner.
পরিকল্পনা
The search_brand field in GenerateCreatorInsightsRequest	কোনোটিই না	Removal	Use search_topics instead.
The plannable_location_id field in Targeting and cookie_frequency_cap field in GenerateReachForecastRequest	কোনোটিই না	Removal	Switch to using plannable_location_ids and cookie_frequency_cap_setting .
প্রতিবেদন
customer_metrics field in GenerateBenchmarksMetricsResponse and BreakdownMetrics of type Metrics	Field of type CustomerMetrics	Type change / behavioral shift	Update your integrations to use the new CustomerMetrics type, which only contains metrics representing the customer's ad performance.

Features and updates (non-breaking)

Features and updates	প্রকার	বর্ণনা
বিজ্ঞাপন
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	New enum value / behavior	Available for DemandGenMultiAssetAds . If enabled, it generates animated images using non-animated images as input. New DemandGenMultiAssetAds are opted in by default starting with this API version.
Synthetic content info mutability	Behavior change	Asset.synthetic_content_info and Ad.synthetic_content_info are now fully mutable in v25, v24, and v23.
প্রচারণা
Loyalty Retention Goal	New features / settings	Added support for Loyalty Retention Goal, which allows advertisers to optimize campaigns for retaining loyalty program members. Added LOYALTY_RETENTION to the GoalType enum. Added CampaignGoalConfig.campaign_loyalty_retention_settings to configure campaign-specific loyalty retention settings, including bid adjustments and showing member benefits in PLA format. Added Goal.loyalty_retention_goal_settings to configure account-level loyalty retention goal settings. Added new error codes: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
New Customer Acquisition Goal	New features / settings	Updated New Customer Acquisition Goal support in the Google Ads API to reflect the revamped unified goals schema: Extended the Goal resource to support New Customer Acquisition settings using the new_customer_acquisition_goal_settings field. Extended the CampaignGoalConfig resource to support campaign-specific overrides for New Customer Acquisition using the campaign_new_customer_acquisition_settings field. Added the new CustomerLifecycleOptimizationGoalSubType enum to define supported goal subtypes. Added NEW_CUSTOMER_ACQUISITION to the GoalType enum. Added new validation error reasons to GoalError : NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS Added new validation error reasons to CampaignGoalConfigError : CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS Added ErrorDetails.incompatible_clo_goal_error_details to expose the new IncompatibleCloGoalsErrorDetails structure for validation errors.
Conversions
YouTube third-party conversion attribution	New fields	Added support for YouTube conversion attribution verification using third-party partners: Added CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners to allow configuring integration partners at the customer level. Added CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners to allow configuring integration partners at the campaign level. See the Help Center article to learn more.
সাধারণ
ContactDetails.phone_number_extension	New field	Added to the LocalServicesLead resource.
IncentiveError	New enum values / errors	Added new specific error codes for incentive redemption failures: BILLING_COUNTRY_NOT_ELIGIBLE (the customer's billing country is not eligible for the incentive) USER_IS_MCC_MANAGER (the user is a manager account and cannot redeem the incentive) USER_SUSPENDED (the customer account is suspended) MAX_PENDING_INCENTIVES (the customer has reached the maximum number of pending incentives) ACCOUNT_HAD_RECENT_SPEND (the account had recent spend and is not eligible) MAX_INCENTIVES_REDEEMED_FROM_OFFER (the customer has already redeemed the maximum number of incentives from this offer) MISMATCHING_BILLING_COUNTRY_CODE (the billing country code provided in the request does not match the customer's account country)
পরিকল্পনা
YouTube channel details in trending insights	New fields	Added support for more YouTube channel details of related videos when searching trending insights. The new fields channel_id , channel_name , and channel_url have been added to YouTubeVideoAttributeMetadata .
YouTubeChannelInsights.data_sharing_consent_given	New field	Added to YouTubeChannelInsights . This is true if a creator has consented to sharing non-public data. If so, the following fields are populated: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
প্রতিবেদন
ad_sub_format_type	New segment	Provides a breakdown of YouTube instream non-skippable ads by duration: INSTREAM_NON_SKIPPABLE_STANDARD (standard duration instream non-skippable ad) INSTREAM_NON_SKIPPABLE_MAX30_SEC (instream non-skippable ad no longer than 30.99 seconds) INSTREAM_NON_SKIPPABLE_MAX60_SEC (instream non-skippable ad no longer than 60.99 seconds) This segment must always be selected together with ad_format_type . It is selectable with AdGroup , AdGroupAd , Campaign , Customer , Video , and VideoEnhancement .
Video-specific social metrics	New fields / metrics	Added video-specific social metrics to help advertisers track user engagement (comments, likes, and shares) for Shorts ads on YouTube: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares They are available in AdGroup , AdGroupAd , Asset , Campaign , Customer , and Video .

v24 major and minor versions

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

v24.2 (2026-06-24)

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

Features and updates	প্রকার	বর্ণনা
বিজ্ঞাপন
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	New enum value	Generates text information from the landing page to be shown in the engagement panel for DemandGenVideoResponsiveAd instances (which are opted in by default starting with this API version).
সম্পদ
AssetGroup.google_local_services_info	New field	Added to support Local Services Ads information (category ID and callouts) in Performance Max campaigns.
AssetGroupSignal.local_services_id	New field	Added to support Local Services Ads service ID signals in Performance Max campaigns.
AssetGroupSignal.vertical_ads_item_group_rule_list	New field	Added to support vertical ads item group rules for selecting items from attached vertical feeds in Performance Max campaigns. This feature is only available to accounts on the allowlist.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	New enum value / error	Returned when attempting to remove all asset groups from a campaign.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	New enum value / error	Returned when attempting to remove all signals from an asset group.
প্রচারণা
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	New fields	Support identifying Local Services Performance Max campaigns.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	New field	Includes Google Maps in the selectable channels for Demand Gen ad groups.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	New enum value / error	Returned when attempting to remove all locations from a local services Performance Max campaign.
SmartCampaignErrorEnum.CREATION_FAILED	New enum value / error	Returned when attempting to create new Smart Campaigns.
Conversions
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	New enum values	Represent conversions that occur when a user clicks on a local services ad and calls, messages, or books the advertiser.
Experiments
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	New enum values	Added support for new ExperimentType types: COMPARE_CAMPAIGNS : For campaign mix experiments and custom Performance Max experiments that compare multiple campaigns of the same or different types in a single experiment. PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION : For Performance Max optimization experiments for text customization and Final URL expansion.
সাধারণ
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 the system). This feature has been backported to v23 and v22. 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 Authorization	New features	Beta: This feature is currently in beta and is subject to change in future releases. Added support for Multi-Party Authorization (MPA) reviews: Added the MultiPartyAuthReview resource and corresponding MultiPartyAuthReviewService . Added the MultiPartyAuthReviewStatus enum to track the review status. Added CustomerUserAccess.pending_multi_party_auth_review to link to a pending review. Added MutateCustomerUserAccessResult.multi_party_auth_review and MutateCustomerUserAccessInvitationResult.multi_party_auth_review to return the associated review resource name. Added MultiPartyAuthReviewError for validation errors. This feature has been backported to v23.3 , v22.2 , and v21.2 .
IncentiveService.FetchIncentive	Behavioral change	When an invalid email address is provided in the request, the method now gracefully falls back to returning the default incentive offers instead of throwing an AuthenticationError.INVALID_EMAIL_ADDRESS error.
পরিকল্পনা
GenerateCreatorInsightsRequest.search_topics	New field	Added to the ContentCreatorInsightsService.GenerateCreatorInsights service. This option searches for creators talking about a topic in the country specified in country_locations (supports searching for one country only).
CREATOR_TOPIC_INSIGHTS	New enum value	Added to InsightsKnowledgeGraphEntityCapabilities to signify entities for searching creators talking about a topic. These entities should be used in the search_topics field. Retrieved using AudienceInsightsService.ListAudienceInsightsAttributes .
KnowledgeGraphEntitySearchOptions	New type / options	Contains additional search options for topics in ListAudienceInsightsAttributes , including options to retrieve all topics supported as creator attributes, and filtering by capabilities.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	New fields	Optional inputs to the ContentCreatorInsightsService methods. Supplying this field populates additional locations or creator attributes in the response.
local_creator_insights related_local_creators	New fields	Populated when supplemental_data contains the LOCAL_CREATOR_DATA enum. Exposes local creators viewed in or based in the chosen country who consented to share location data.
GenerateTrendingInsightsRequest.sub_country_locations	New field	Added to ContentCreatorInsightsService.GenerateTrendingInsights , allowing searches for trending insights using country location and sub country locations.
প্রতিবেদন
PerformanceMaxPlacementView	Segments extension	Made segmentable by ad_network_type .
কেনাকাটা
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	New field	If true, brand exclusions are ignored for Shopping ads. Only supported for Shopping campaigns.
Targeting
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	New enum value / error	Returned when attempting to target a language that is not allowed.
ভিডিও
DataLink.youtube_link_metadata	New field	Contains brand_channel_id to specify the ID of the linked YouTube brand channel.

v24.1 (2026-05-13)

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

Features and updates	প্রকার	বর্ণনা
বিজ্ঞাপন
DemandGenMultiAssetAdInfo.classic_display_images	New field	Custom uploaded display images served without requiring extra responsive assets.
Experiments
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	New enum values	Added support for new ExperimentType types: ADOPT_AI_MAX : For experiments that test how AI Max can help you engage more customers with Google AI and broad match keywords. ADOPT_BROAD_MATCH_KEYWORDS : For experiments that test how broad match keywords can impact the number of searches your ads appear in. OPTIMIZE_ASSETS : For custom experiments for optimizing assets. PMAX_REPLACEMENT_SHOPPING : For experiments that test how your Shopping campaigns perform compared to Performance Max.
Experiment.video_experiment	New field	Configuration support for existing YOUTUBE_CUSTOM experiments consisting of Video campaigns.
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	New fields	Exposes fields to support asset testing, asset groups, and Performance Max settings in experiment arms: asset_testing_info : Details of assets associated with the experimental copies of ads. asset_groups : List of asset groups in the experiment arm for Optimize Assets experiments. performance_max_experiment_arm_info : Settings for Performance Max campaigns in PMAX_REPLACEMENT_SHOPPING experiments.
সাধারণ
CustomerUserAccess.passkey_enabled	New field	Read-only field indicating whether the user has a passkey enabled.
প্রতিবেদন
mobile_device_platform	New segment	Allows segmenting reports by the user device's platform (such as iOS or Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	New enum value / error	Returned when the requested daily, hourly, or weekly time granularity is not supported for query date ranges (only available for the last 37 months).
vertical_ads_listing_user_rating vertical_ads_listing_venue	New segments	New segments to be used for vertical ads.
user_rating , venue , event_participant_display_name	New filter criteria	Supported filtering in VerticalAdsItemGroupRuleInfo for the SharedCriterion resource.
Control/treatment experiment metrics	New fields	Added control values ( control_clicks , etc.), treatment values ( clicks , etc.), point estimates ( clicks_point_estimate , etc.), margins of error ( clicks_margin_of_error , etc.), and p-values ( clicks_p_value , etc.) across seven core metric families (Clicks, Impressions, Cost, Conversions, Cost per conversion, Conversion value, Conversion value per cost).
Conversions absolute change metrics	New fields	Support for Conversions absolute difference estimations using point estimate, margin of error, and p-value fields.
Targeting
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	New enum value / error	Returned when attempting to exclude all demographics targets.
ভিডিও
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	New enum value	Published ZEFR as a third party viewability integration partner.
DataLink.youtube_video.channel_id	New field	Exposes the YouTube channel ID associated with the data link.

v24 (2026-04-22)

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

See Upgrade to the latest version for guidance.

Breaking changes

Initial state	New state	Change type	Implementation guidance
বিজ্ঞাপন
Optional videos and logo_images in DemandGenVideoResponsiveAdInfo	প্রয়োজনীয় ক্ষেত্রসমূহ	Behavioral shift	Provide videos and logo_images when creating or mutating responsive Demand Gen video ads.
Optional videos , business_name , and logo_images in VideoResponsiveAdInfo	প্রয়োজনীয় ক্ষেত্রসমূহ	Behavioral shift	Provide videos , business_name , and logo_images when creating or mutating video responsive ads. Note that VideoResponsiveAdInfo is now mutable.
প্রচারণা
Campaign.video_brand_safety_suitability	কোনোটিই না	Removal	Campaign-level suitability control is removed. Brand safety suitability is still available on the customer level. Use Customer.video_brand_safety_suitability instead.
Conversions
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	কোনোটিই না	Removal	The loyalty sign ups user category has been removed. Remove code references to it.
পরিকল্পনা
InsightsAudienceAttributeGroup type for topic_audience_combinations	common. InsightsAudienceAttributeGroup type	Behavioral shift / type change	Typed client libraries integrations must be updated to use the new resource namespaces.
youtube_select_lineups field in ReachPlanService.ListPlannableProducts	কোনোটিই না	Removal	Switch to using lineups from youtube_select_lineup_targeting .
is_brand_connect_creator field in ContentCreatorInsightsService.GenerateCreatorInsights and GenerateTrendingInsights	কোনোটিই না	Removal	Instead, check if a creator has CREATOR_PARTNERSHIPS available in partnership_opportunities .
geo_modifiers and biddable_keywords in KeywordPlanIdeaService.GenerateKeywordForecastMetrics	geo_target_constants and keywords	Rename / removal	Replaced by CampaignToForecast.geo_target_constants[] and ForecastAdGroup.keywords[] .
Deprecated keywords plan / forecast fields in GenerateKeywordForecastMetrics	কোনোটিই না	Removal	Removed the following plan / forecast fields and types: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords and ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate Update integrations accordingly.
প্রতিবেদন
ad_sub_network_type segment in campaign_budget	কোনোটিই না	Removal	Removed ad_sub_network_type segment for the campaign_budget resource.
click_type segment in asset views	কোনোটিই না	Removal	Removed segment from AdGroupAsset , CampaignAsset , and CustomerAsset views.
ভিডিও
Partial failure allowed in ShareablePreviewService.GenerateShareablePreviews	No partial failure	Behavioral shift	Requests will fail and throw an error if any ID within it fails validation.
ShareablePreviewError legacy codes: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	Rename / behavioral shift	Error codes returned for asset groups are modified to align with ad group ad errors. Update validation catch logic.

Features and updates (non-breaking)

Features and updates	প্রকার	বর্ণনা
বিজ্ঞাপন
Mutability of VideoResponsiveAdInfo	Behavioral change	Responsive video ads information objects are now mutable.
সম্পদ
travel_feed_data in AssetSet	New field	Added to retrieve travel feed assets attributes ( hotel_center_account_id , merchant_center_id , partner_center_id , subset_id , travel_feed_vertical_type ).
প্রচারণা
Campaign.view_through_conversion_optimization_enabled	New field	Allows enabling View-Through Conversion (VTC) Optimization (default false ) in Demand Gen and App campaigns.
CampaignCriterion.gender	New feature	Enabled gender exclusions for Performance Max campaigns on all Google Ads API versions.
Conversions
Lead Gen conversion types	New enum values	Added new GA4/Firebase conversion action type enums in ConversionActionType : 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	New enum value / error	Returned when attempting to create multiple identical lookalike lists.
পরিকল্পনা
ProductCoreAttributes fields in ListPlannableProductsResponse	New fields	Added plannable product description, marketing objective, cost model, and buying method to ProductCoreAttributes under ListPlannableProductsResponse .
প্রতিবেদন
CartDataSalesView	New reporting resource	Exposes reports segmenting conversions metrics by the specific product sold (brand, etc.) in addition to the clicked product.
Non-biddable metrics	New fields	Added non-biddable metrics (metrics showing conversions that campaigns are not optimizing for) to all matching resources: all_average_cart_size all_average_order_value_micros all_cost_of_goods_sold_micros all_cross_sell_cost_of_goods_sold_micros all_cross_sell_gross_profit_micros all_cross_sell_revenue_micros all_cross_sell_units_sold all_gross_profit_margin all_gross_profit_micros all_lead_cost_of_goods_sold_micros all_lead_gross_profit_micros all_lead_revenue_micros all_lead_units_sold all_orders all_revenue_micros all_units_sold
conversion_attribution_event_type	New segment	Added to ShoppingPerformanceView .
কেনাকাটা
App campaigns in ShoppingProduct	New feature	Supported App campaigns inside the ShoppingProduct resource. Note status and issues are not supported.
Tag-based product filtering	New feature	Introduced filtering using logical set expressions dynamically: Added RETAIL_FILTER_BUNDLE and RETAIL_FILTER criterion types. Added RETAIL_FILTER shared set type. Added the retail_filter_bundle field to AdGroupCriterion . Added the retail_filter field to SharedCriterion . Added RETAIL to ListingGroupFilterListingSource . Added RetailFilter dimension to AssetGroupListingGroupFilter . Added related new validation errors in CriterionError and AssetGroupListingGroupFilterError . 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	New features	Beta: This feature is currently in beta and is subject to change in future releases. Added support for multi-party approvals (MPA) reviews: Added the MultiPartyAuthReview resource and corresponding MultiPartyAuthReviewService . Added the MultiPartyAuthReviewStatus enum to track the review status. Added CustomerUserAccess.pending_multi_party_auth_review to link to a pending review. Added MutateCustomerUserAccessResult.multi_party_auth_review and MutateCustomerUserAccessInvitationResult.multi_party_auth_review to return the associated review resource name. Added MultiPartyAuthReviewError for validation errors.

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	New feature	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	New field	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	New features	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	New field	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	New field	Added clicks for Demand Gen Max Clicks (CPC) in ReachPlanService.GenerateReachForecast .
partnership_opportunities	New field	Added to ContentCreatorInsightsService.GenerateCreatorInsights and ContentCreatorInsightsService.GenerateTrendingInsights .
প্রতিবেদন
biddable_indirect_install_first_in_app_conversion_micros	New field	Added to Campaign , Customer , and AdGroup resources.
ভিডিও
ShareablePreviewService	New feature	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	প্রকার	বর্ণনা
Account management
advertising_partner_properties.allowed_domain	New field	Added to ProductLinkInvitation and ProductLink resources. The advertising partner will only be able to advertise on this domain.
Customer.contains_eu_political_advertising	New field	Retrieves the account-level declaration status of whether it contains political advertising targeted towards the EU, and returns an EuPoliticalAdvertisingStatus .
প্রচারণা
Campaign.text_guidelines	New field	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	New field	Supports querying and filtering campaigns that are missing declarations about whether they contain political advertising targeted towards the EU.
Conversions
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.
Incentives
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	New feature	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	কোনোটিই না	Removal	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	কোনোটিই না	Removal	The lead_form_only field has been removed. Update references in your code.
প্রতিবেদন
Aggregate asset performance label metrics and enum	কোনোটিই না	Removal	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	New field	Read-only orientation field added to image and video assets.
CampaignAsset	New feature	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: Added support for Facebook Messenger and Zalo as providers. Added FACEBOOK_MESSENGER and ZALO to BusinessMessageProvider . Added fields facebook_messenger_info and zalo_info . Added CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS to AssetError .
বিলিং
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.
Conversions
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	New field	Added support for companion banners in Demand Gen responsive video ads.
Incentives
Added Choose Your Own (CYO) incentives support: Added the FetchIncentive method to retrieve available personalized incentives for a user. Added the ApplyIncentive method to apply a selected incentive to a customer account. Added the AppliedIncentive resource (queryable using Search and SearchStream ) to provide redemption details. Added new error codes in IncentiveError and AuthenticationError.INVALID_EMAIL_ADDRESS . 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	New service	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	New field	Evaluates how relevant a creator is for a topic weighted by views.
TrendInsightMetrics.trend_change_percent	New field	Represents the percentage change in a trend's value over the comparison period.
সুপারিশসমূহ
GenerateRecommendationsRequest	New field	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	New feature	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	New field	Added to ShoppingProduct .
Vertical ads
AdGroup.vertical_ads_format_setting	New field	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	New feature	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	New field	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	New features	Beta: This feature is currently in beta and is subject to change in future releases. Added support for multi-party approvals (MPA) reviews: Added the MultiPartyAuthReview resource and corresponding MultiPartyAuthReviewService . Added the MultiPartyAuthReviewStatus enum to track the review status. Added CustomerUserAccess.pending_multi_party_auth_review to link to a pending review. Added MutateCustomerUserAccessResult.multi_party_auth_review and MutateCustomerUserAccessInvitationResult.multi_party_auth_review to return the associated review resource name. Added MultiPartyAuthReviewError for validation errors.

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	প্রকার	বর্ণনা
Account management
Customer.contains_eu_political_advertising	New field	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	New field	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.
Performance Max
Asset performance labels	কোনোটিই না	Removal	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	New feature	Added support for the fixed share of voice bidding strategy type.
Campaign.feed_types	New field	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	New feature	Allowed attaching negative keywords shared sets to multi-channel (for App campaigns) and local campaigns.
Demand Gen
TargetCPC bidding	New feature	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.
Performance Max
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: ad_using_product_data : Indicates if an ad uses Google Merchant Center product data. ad_using_video : Indicates if an ad uses a video asset.
পরিকল্পনা
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	New field	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	New message	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	New feature	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	New feature	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.