रिलीज़ टिप्पणियां

मौजूदा और आने वाले समय में बंद होने वाली सुविधाओं की अपडेट की गई सूची देखने के लिए, सुविधाएं बंद होना लेख पढ़ें.

v24 के मेजर और माइनर वर्शन

Google Ads API v24 में ये नई सुविधाएं, अपडेट, और बड़े बदलाव शामिल हैं.

v24.2 (24-06-2026)

Google Ads API v24.2 में ये नई सुविधाएं और अपडेट जोड़े गए हैं. v24.2 जैसे माइनर वर्शन में, एपीआई में बड़े बदलाव नहीं होते.

सुविधाएं और अपडेट टाइप ब्यौरा
विज्ञापन
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT नई enum वैल्यू यह लैंडिंग पेज से टेक्स्ट की जानकारी जनरेट करता है, ताकि उसे DemandGenVideoResponsiveAd इंस्टेंस के लिए, जुड़ाव बढ़ाने वाले पैनल में दिखाया जा सके. इन इंस्टेंस के लिए, ऑप्ट-इन करने की सुविधा डिफ़ॉल्ट रूप से चालू होती है.
एसेट
AssetGroup.google_local_services_info नया फ़ील्ड परफ़ॉर्मेंस मैक्स कैंपेन में, Local Services Ads की जानकारी (कैटेगरी आईडी और कॉलआउट) दिखाने की सुविधा जोड़ी गई है.
AssetGroupSignal.local_services_id नया फ़ील्ड इसे परफ़ॉर्मेंस मैक्स कैंपेन में, Local Services Ads के सेवा आईडी सिग्नल के लिए सहायता जोड़ने के लिए जोड़ा गया है.
AssetGroupSignal.vertical_ads_item_group_rule_list नया फ़ील्ड इसे परफ़ॉर्मेंस मैक्स कैंपेन में वर्टिकल फ़ीड से आइटम चुनने के लिए, वर्टिकल विज्ञापनों के आइटम ग्रुप के नियमों को सपोर्ट करने के लिए जोड़ा गया है. यह सुविधा सिर्फ़ उन खातों के लिए उपलब्ध है जिन्हें अनुमति दी गई है.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN नई enum वैल्यू / गड़बड़ी इस गड़बड़ी का मैसेज तब दिखता है, जब किसी कैंपेन से सभी ऐसेट ग्रुप हटाने की कोशिश की जाती है.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS नई enum वैल्यू / गड़बड़ी इस गड़बड़ी का मैसेज तब दिखता है, जब किसी ऐसेट ग्रुप से सभी सिग्नल हटाने की कोशिश की जाती है.
कैंपेन
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled
नए फ़ील्ड लोकल सेवाओं के लिए परफ़ॉर्मेंस मैक्स कैंपेन की पहचान करने में मदद करता है.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps नया फ़ील्ड मांग बढ़ाने में मदद करने वाले कैंपेन के विज्ञापन ग्रुप के लिए, चुने जा सकने वाले चैनलों में Google Maps को शामिल किया गया है.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN नई enum वैल्यू / गड़बड़ी लोकल सेवाओं के लिए बनाए गए परफ़ॉर्मेंस मैक्स कैंपेन से सभी लोकेशन हटाने की कोशिश करने पर यह गड़बड़ी दिखती है.
SmartCampaignErrorEnum.CREATION_FAILED नई enum वैल्यू / गड़बड़ी यह तब दिखता है, जब नए स्मार्ट कैंपेन बनाने की कोशिश की जाती है.
कन्वर्ज़न
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS
नई enum वैल्यू ये उन कन्वर्ज़न को दिखाते हैं जो तब होते हैं, जब कोई व्यक्ति लोकल सर्विस विज्ञापन पर क्लिक करता है और विज्ञापन देने वाले व्यक्ति या कंपनी को कॉल करता है, मैसेज भेजता है या बुकिंग करता है.
प्रयोग
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION
नई enum वैल्यू नए ExperimentType टाइप के लिए सहायता जोड़ी गई:
  • COMPARE_CAMPAIGNS: कैंपेन मिक्स एक्सपेरिमेंट और परफ़ॉर्मेंस मैक्स कैंपेन के कस्टम एक्सपेरिमेंट के लिए. इनमें एक ही एक्सपेरिमेंट में, एक ही तरह के या अलग-अलग तरह के कई कैंपेन की तुलना की जाती है.
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: परफ़ॉर्मेंस मैक्स कैंपेन के ऑप्टिमाइज़ेशन एक्सपेरिमेंट के लिए, पसंद के मुताबिक टेक्स्ट बनाने की सुविधा और फ़ाइनल यूआरएल एक्सपैंशन.
सामान्य
Asset.synthetic_content_info
Ad.synthetic_content_info
नए फ़ील्ड इसमें एआई से बनाए गए कॉन्टेंट के लिए पुष्टि करने वाले स्टेटमेंट शामिल होते हैं. इन्हें advertiser_input (विज्ञापन देने वाले व्यक्ति या कंपनी से मिले एलान) और system_input (सिस्टम से अपने-आप पता चले या सिस्टम से मिले पुष्टि करने वाले स्टेटमेंट) में बांटा जाता है.

इस सुविधा को v23 और v22 में वापस लाया गया है.

v25 के लिए, इंटिग्रेशन से जुड़े काम की योजना बनाने में आपकी मदद करने के लिए, विज्ञापन देने वाले व्यक्ति या कंपनी के कानूनी समझौते से जुड़े फ़ील्ड में बदलाव करने वाले इंटरफ़ेस को v22 और इसके बाद के वर्शन के लिए पहले ही उपलब्ध कराया जा रहा है. इन वर्शन में इंटरफ़ेस दिखता है, लेकिन synthetic_content_info.advertiser_attestation.status और synthetic_content_info.advertiser_attestation.source इन वर्शन के लिए नहीं बदलेगा.

अगर इनमें से किसी भी फ़ील्ड के लिए म्यूटेट अनुरोध किया जाता है, तो इनमें से कोई एक गड़बड़ी दिखेगी:

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

ये फ़ील्ड, v25 से पूरी तरह से बदले जा सकेंगे. हमारा सुझाव है कि आप अभी इस इंटरफ़ेस का इस्तेमाल करके, अपने इंटरनल लॉजिक को बनाएं और उसकी जांच करें. इससे, v25 के लॉन्च होने पर आपका सिस्टम, पूरी तरह से लिखने की सुविधाओं के लिए तैयार रहेगा.

कई पक्षों से अनुमति नई सुविधाएं कई पक्षों से अनुमति लेने (एमपीए) की सुविधा के लिए समीक्षा की सुविधा जोड़ी गई है:
इस सुविधा को v23.3, v22.2, और v21.2 में वापस लाया गया है.
IncentiveService.FetchIncentive व्यवहार में बदलाव अनुरोध में अमान्य ईमेल पता दिए जाने पर, यह तरीका अब AuthenticationError.INVALID_EMAIL_ADDRESS गड़बड़ी दिखाने के बजाय, डिफ़ॉल्ट इंसेंटिव ऑफ़र दिखाता है.
प्लानिंग
GenerateCreatorInsightsRequest.search_topics नया फ़ील्ड ContentCreatorInsightsService.GenerateCreatorInsights सेवा में जोड़ा गया. इस विकल्प की मदद से, उस देश में किसी विषय पर बात करने वाले क्रिएटर्स को खोजा जाता है जिसे country_locations में बताया गया है. इससे सिर्फ़ एक देश के क्रिएटर्स को खोजा जा सकता है.
CREATOR_TOPIC_INSIGHTS नई enum वैल्यू इसे 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 नई enum वैल्यू / गड़बड़ी यह गड़बड़ी तब दिखती है, जब ऐसी भाषा को टारगेट करने की कोशिश की जाती है जिसकी अनुमति नहीं है.
वीडियो
DataLink.youtube_link_metadata नया फ़ील्ड इसमें brand_channel_id शामिल होता है, ताकि लिंक किए गए YouTube ब्रैंड चैनल का आईडी बताया जा सके.

v24.1 (13-05-2026)

Google Ads API v24.1 में ये नई सुविधाएं और अपडेट जोड़े गए हैं. v24.1 जैसे माइनर वर्शन में, एपीआई में बड़े बदलाव नहीं होते.

सुविधाएं और अपडेट टाइप ब्यौरा
विज्ञापन
DemandGenMultiAssetAdInfo.classic_display_images नया फ़ील्ड कस्टम तौर पर अपलोड की गई डिसप्ले इमेज, जिनके लिए अतिरिक्त रिस्पॉन्सिव ऐसेट की ज़रूरत नहीं होती.
प्रयोग
ADOPT_AI_MAX
ADOPT_BROAD_MATCH_KEYWORDS
OPTIMIZE_ASSETS
PMAX_REPLACEMENT_SHOPPING
नई enum वैल्यू नए ExperimentType टाइप के लिए सहायता जोड़ी गई:
  • ADOPT_AI_MAX: इन एक्सपेरिमेंट से यह पता चलता है कि एआई मैक्स, Google के एआई और ब्रॉड मैच वाले कीवर्ड का इस्तेमाल करके, ज़्यादा ग्राहकों से जुड़ने में आपकी कैसे मदद कर सकता है.
  • 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 नई enum वैल्यू / गड़बड़ी यह तब दिखता है, जब क्वेरी की तारीख की सीमाओं के लिए, हर दिन, हर घंटे या हर हफ़्ते के हिसाब से समय की जानकारी देने का अनुरोध किया जाता है. हालांकि, यह सुविधा सिर्फ़ पिछले 37 महीनों के लिए उपलब्ध है.
vertical_ads_listing_user_rating
vertical_ads_listing_venue
नए सेगमेंट वर्टिकल विज्ञापनों के लिए इस्तेमाल किए जाने वाले नए सेगमेंट.
user_rating, venue, event_participant_display_name फ़िल्टर करने की नई शर्तें SharedCriterion रिसॉर्स के लिए, VerticalAdsItemGroupRuleInfo में फ़िल्टर करने की सुविधा जोड़ी गई है.
कंट्रोल/ट्रीटमेंट एक्सपेरिमेंट की मेट्रिक नए फ़ील्ड सात मुख्य मेट्रिक फ़ैमिली (क्लिक, इंप्रेशन, लागत, कन्वर्ज़न, हर कन्वर्ज़न की लागत, कन्वर्ज़न वैल्यू, हर लागत की कन्वर्ज़न वैल्यू) के लिए, कंट्रोल वैल्यू (control_clicks वगैरह), ट्रीटमेंट वैल्यू (clicks वगैरह), पॉइंट अनुमान (clicks_point_estimate वगैरह), गड़बड़ी के मार्जिन (clicks_margin_of_error वगैरह), और पी-वैल्यू (clicks_p_value वगैरह) जोड़ी गईं.
कन्वर्ज़न में हुए कुल बदलाव की मेट्रिक नए फ़ील्ड पॉइंट अनुमान, मार्जिन ऑफ़ एरर, और पी-वैल्यू फ़ील्ड का इस्तेमाल करके, Conversions अंतर के अनुमान के लिए सहायता.
टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना)
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS नई enum वैल्यू / गड़बड़ी सभी डेमोग्राफ़िक टारगेट को बाहर करने की कोशिश करते समय यह गड़बड़ी दिखती है.
वीडियो
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR नई enum वैल्यू ZEFR को, विज्ञापन दिखने से जुड़े आंकड़ों की जानकारी देने वाले तीसरे पक्ष के इंटिग्रेशन पार्टनर के तौर पर पब्लिश किया गया.
DataLink.youtube_video.channel_id नया फ़ील्ड इसकी मदद से, डेटा लिंक से जुड़े YouTube चैनल का आईडी देखा जा सकता है.

v24 (22-04-2026)

Google Ads API के v24 वर्शन में ये नई सुविधाएं, अपडेट, और बड़े बदलाव जोड़े गए हैं. यह एक अहम रिलीज़ है.

निर्देशों के लिए, नए वर्शन पर अपग्रेड करें लेख पढ़ें.

नुकसान पहुंचा सकने वाले बदलाव

प्रारंभिक स्थिति नई स्थिति बदलाव का टाइप लागू करने के लिए दिशा-निर्देश
विज्ञापन
DemandGenVideoResponsiveAdInfo में videos और logo_images की जानकारी देना ज़रूरी नहीं है ज़रूरी फ़ील्ड व्यवहार में बदलाव मांग बढ़ाने में मदद करने वाले रिस्पॉन्सिव वीडियो विज्ञापन बनाते या उनमें बदलाव करते समय, videos और logo_images एसेट उपलब्ध कराएं.
VideoResponsiveAdInfo में videos, business_name, और logo_images ज़रूरी नहीं हैं ज़रूरी फ़ील्ड व्यवहार में बदलाव वीडियो रिस्पॉन्सिव विज्ञापन बनाते या बदलते समय, videos, business_name, और logo_images उपलब्ध कराएं. ध्यान दें कि VideoResponsiveAdInfo में अब बदलाव किया जा सकता है.
कैंपेन
Campaign.video_brand_safety_suitability कोई नहीं कॉन्टेंट हटाना कैंपेन-लेवल पर ब्रैंड के लिए सही कॉन्टेंट कंट्रोल को हटा दिया गया है. ब्रैंड के लिहाज़ से कॉन्टेंट कितना सही है, यह अब भी ग्राहक लेवल पर उपलब्ध है. इसके बजाय, Customer.video_brand_safety_suitability का इस्तेमाल करें.
कन्वर्ज़न
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS कोई नहीं कॉन्टेंट हटाना लॉयल्टी प्रोग्राम के लिए साइन अप करने वाले लोगों की कैटगरी को हटा दिया गया है. इसके कोड रेफ़रंस हटाएं.
प्लानिंग
topic_audience_combinations के लिए InsightsAudienceAttributeGroup टाइप common.InsightsAudienceAttributeGroup टाइप व्यवहार में बदलाव / टाइप में बदलाव टाइप की गई क्लाइंट लाइब्रेरी के इंटिग्रेशन को अपडेट करना होगा, ताकि नए संसाधन नेमस्पेस का इस्तेमाल किया जा सके.
ReachPlanService.ListPlannableProducts में youtube_select_lineups फ़ील्ड कोई नहीं कॉन्टेंट हटाना youtube_select_lineup_targeting से लाइनअप का इस्तेमाल करना शुरू करें.
ContentCreatorInsightsService.GenerateCreatorInsights और GenerateTrendingInsights में is_brand_connect_creator फ़ील्ड कोई नहीं कॉन्टेंट हटाना इसके बजाय, देखें कि किसी क्रिएटर के पास partnership_opportunities में CREATOR_PARTNERSHIPS उपलब्ध है या नहीं.
KeywordPlanIdeaService.GenerateKeywordForecastMetrics में geo_modifiers और biddable_keywords geo_target_constants और keywords नाम बदलना / हटाना CampaignToForecast.geo_target_constants[] और ForecastAdGroup.keywords[] से बदला गया.
GenerateKeywordForecastMetrics में कीवर्ड प्लान / अनुमान के लिए इस्तेमाल किए जाने वाले फ़ील्ड अब काम नहीं करते कोई नहीं कॉन्टेंट हटाना इन प्लान / अनुमान फ़ील्ड और टाइप को हटा दिया गया है: इसके हिसाब से इंटिग्रेशन अपडेट करें.
रिपोर्ट
campaign_budget में ad_sub_network_type सेगमेंट कोई नहीं कॉन्टेंट हटाना campaign_budget संसाधन के लिए, ad_sub_network_type सेगमेंट हटा दिया गया है.
ऐसेट व्यू में click_type सेगमेंट कोई नहीं कॉन्टेंट हटाना AdGroupAsset, CampaignAsset, और CustomerAsset व्यू से सेगमेंट हटाया गया.
वीडियो
ShareablePreviewService.GenerateShareablePreviews में कुछ हद तक फ़ेल होने की अनुमति है कोई भी फ़ाइल फ़ॉर्मैट नहीं बदली जा सकी व्यवहार में बदलाव अगर किसी आईडी की पुष्टि नहीं हो पाती है, तो अनुरोध पूरे नहीं होंगे और गड़बड़ी का मैसेज दिखेगा.
ShareablePreviewError लेगसी कोड: MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST
नाम बदलना / व्यवहार में बदलाव ऐसेट ग्रुप के लिए मिले गड़बड़ी कोड में बदलाव किया गया है, ताकि वे विज्ञापन ग्रुप के विज्ञापन से जुड़ी गड़बड़ियों के मुताबिक हों. पुष्टि करने से जुड़ी गड़बड़ी को पकड़ने वाले लॉजिक को अपडेट किया गया.

सुविधाएं और अपडेट (बिना किसी रुकावट के)

सुविधाएं और अपडेट टाइप ब्यौरा
विज्ञापन
VideoResponsiveAdInfo की म्यूटेबिलिटी व्यवहार में बदलाव रिस्पॉन्सिव वीडियो विज्ञापनों के सूचना ऑब्जेक्ट में अब बदलाव किया जा सकता है.
एसेट
AssetSet में travel_feed_data नया फ़ील्ड यात्रा के फ़ीड की ऐसेट एट्रिब्यूट (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type) को वापस पाने के लिए जोड़ा गया.
कैंपेन
Campaign.view_through_conversion_optimization_enabled नया फ़ील्ड इस कुकी की मदद से, मांग बढ़ाने में मदद करने वाले कैंपेन और ऐप्लिकेशन कैंपेन में व्यू-थ्रू कन्वर्ज़न (वीटीसी) ऑप्टिमाइज़ेशन (डिफ़ॉल्ट false) को चालू किया जा सकता है.
CampaignCriterion.gender नई सुविधा Google Ads API के सभी वर्शन पर, परफ़ॉर्मेंस मैक्स कैंपेन के लिए लिंग के आधार पर एक्सक्लूज़न की सुविधा चालू की गई.
कन्वर्ज़न
लीड जनरेशन के लिए कन्वर्ज़न टाइप नई enum वैल्यू 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 नई enum वैल्यू / गड़बड़ी एक जैसी मिलती-जुलती ऑडियंस की कई सूचियां बनाने की कोशिश करने पर यह गड़बड़ी दिखती है.
प्लानिंग
ListPlannableProductsResponse में ProductCoreAttributes फ़ील्ड नए फ़ील्ड ListPlannableProductsResponse में जाकर, ProductCoreAttributes में प्रॉडक्ट का ब्यौरा, मार्केटिंग का लक्ष्य, लागत मॉडल, और खरीदारी का तरीका जोड़ा गया.
रिपोर्ट
CartDataSalesView रिपोर्टिंग का नया संसाधन इससे, क्लिक किए गए प्रॉडक्ट के अलावा, बेचे गए प्रॉडक्ट (ब्रैंड वगैरह) के हिसाब से कन्वर्ज़न मेट्रिक को सेगमेंट करने वाली रिपोर्ट दिखती हैं.
बिडिंग के लिए उपलब्ध नहीं कराई गई मेट्रिक नए फ़ील्ड मैच करने वाले सभी संसाधनों में, बिडिंग के लिए उपलब्ध न होने वाली मेट्रिक जोड़ी गई हैं. ये ऐसी मेट्रिक होती हैं जो उन कन्वर्ज़न को दिखाती हैं जिनके लिए कैंपेन को ऑप्टिमाइज़ नहीं किया जा रहा है:
conversion_attribution_event_type नया सेगमेंट ShoppingPerformanceView में जोड़ा गया.
शॉपिंग
ShoppingProduct में ऐप्लिकेशन कैंपेन नई सुविधा ShoppingProduct रिसॉर्स में, ऐप्लिकेशन कैंपेन के लिए सहायता. सूचना की स्थिति और समस्याओं से जुड़ी जानकारी उपलब्ध नहीं है.
टैग के हिसाब से प्रॉडक्ट फ़िल्टर करना नई सुविधा लॉजिकल सेट एक्सप्रेशन का इस्तेमाल करके, डाइनैमिक तरीके से फ़िल्टर करने की सुविधा जोड़ी गई: यह सुविधा सिर्फ़ उन खातों के लिए उपलब्ध है जिन्हें अनुमति दी गई है.

v23 के मेजर और माइनर वर्शन

Google Ads API v23 में ये नई सुविधाएं, अपडेट, और बड़े बदलाव शामिल हैं.

v23.3 (24-06-2026)

Google Ads API v23.3 में ये नई सुविधाएं और अपडेट जोड़े गए हैं. v23.3 जैसे माइनर वर्शन में, एपीआई में कोई बड़ा बदलाव नहीं होता.

सुविधाएं और अपडेट टाइप ब्यौरा
सामान्य
Asset.synthetic_content_info
Ad.synthetic_content_info
नए फ़ील्ड इसमें सिंथेटिक/एआई से जनरेट किए गए कॉन्टेंट के लिए पुष्टि करने वाले स्टेटमेंट शामिल होते हैं. इन्हें advertiser_attestation (विज्ञापन देने वाले व्यक्ति या कंपनी की ओर से सीधे तौर पर दी गई घोषणाएं) और system_attestation (Google के सिस्टम की ओर से अपने-आप पता लगाई गई या दी गई पुष्टि) में बांटा जाता है.

v25 के लिए, इंटिग्रेशन से जुड़े काम की योजना बनाने में आपकी मदद करने के लिए, विज्ञापन देने वाले व्यक्ति या कंपनी के कानूनी समझौते से जुड़े फ़ील्ड में बदलाव करने वाले इंटरफ़ेस को v22 और इसके बाद के वर्शन के लिए पहले ही उपलब्ध कराया जा रहा है. इन वर्शन में इंटरफ़ेस दिखता है, लेकिन synthetic_content_info.advertiser_attestation.status और synthetic_content_info.advertiser_attestation.source इन वर्शन के लिए नहीं बदलेगा.

अगर इनमें से किसी भी फ़ील्ड के लिए म्यूटेट अनुरोध किया जाता है, तो इनमें से कोई एक गड़बड़ी दिखेगी:

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

ये फ़ील्ड, v25 से पूरी तरह से बदले जा सकेंगे. हमारा सुझाव है कि आप अभी इस इंटरफ़ेस का इस्तेमाल करके, अपने इंटरनल लॉजिक को बनाएं और उसकी जांच करें. इससे, v25 के लॉन्च होने पर आपका सिस्टम, पूरी तरह से लिखने की सुविधाओं के लिए तैयार रहेगा.

कई पक्षों से अनुमति नई सुविधाएं कई पक्षों से अनुमति लेने की सुविधा (एमपीए) की समीक्षा करने की सुविधा जोड़ी गई है:

v23.2 (25-03-2026)

Google Ads API v23.2 में ये नई सुविधाएं और अपडेट जोड़े गए हैं. v23.2 जैसे माइनर वर्शन में, एपीआई में काम न करने वाले बदलाव नहीं होते.

सुविधाएं और अपडेट टाइप ब्यौरा
एसेट
VideoEnhancement नया संसाधन इसमें वीडियो विज्ञापन को बेहतर बनाने से जुड़ी जानकारी होती है. जैसे, यह Google ने जनरेट किया है या विज्ञापन देने वाले व्यक्ति या कंपनी ने उपलब्ध कराया है. ज़्यादा जानने के लिए, वीडियो को बेहतर बनाने की सुविधा के बारे में जानकारी देखें.
AppTopCombinationView नया संसाधन यह सिर्फ़ पढ़ने के लिए उपलब्ध संसाधन है. इससे ऐप्लिकेशन कैंपेन में, सबसे अच्छा परफ़ॉर्म करने वाले ऐसेट कॉम्बिनेशन के बारे में अहम जानकारी मिलती है.
CustomerAsset नई सुविधा BUSINESS_LOGO पर सेट किए गए field_type की मदद से, CustomerAsset को वापस पाने की सुविधा जोड़ी गई.
कैंपेन
AdGroupAd.start_date_time
AdGroupAd.end_date_time
नए फ़ील्ड कैंपेन की तारीखों के लिए, शेड्यूल करने से जुड़ी ज़्यादा जानकारी वाली पाबंदियां लागू करें. यह सुविधा सिर्फ़ कुछ तरह के विज्ञापन ग्रुप के लिए उपलब्ध है.
HotelSettingInfo.disable_hotel_setting नया फ़ील्ड इस कुकी की मदद से, मांग बढ़ाने में मदद करने वाले कैंपेन में होटल फ़ीड को बंद किया जा सकता है.
सामान्य
CustomerClientLinkError नई enum वैल्यू / गड़बड़ियां दो नए गड़बड़ी कोड जोड़े गए: MAX_CUSTOMER_LIMIT_REACHED और ACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS व्यवहार में बदलाव अब इस सुविधा को बंद कर दिया गया है. इसलिए, उपयोगकर्ता सूची की इस कैटगरी का इस्तेमाल करने पर गड़बड़ी का मैसेज दिखेगा.
प्लानिंग
GenerateTrendingInsights
GenerateCreatorInsights
नई सुविधाएं इकाइयों, विषयों, और ऑडियंस के कस्टम AND/OR कॉम्बिनेशन के लिए सहायता जोड़ी गई.
ReachPlanService.GenerateReachForecast नई enum वैल्यू उम्र के हिसाब से टारगेट करने के लिए नई रेंज जोड़ी गई हैं. जैसे, AGE_RANGE_21_44 या AGE_RANGE_21_49.
youtube_select_lineup_targeting नया फ़ील्ड ReachPlanService.ListPlannableProducts में जोड़ा गया. यह youtube_select_lineups की जगह लेगा. फ़िलहाल, दोनों फ़ील्ड में जानकारी मौजूद है.
ReachPlanSurface नई enum वैल्यू IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS को प्लैटफ़ॉर्म के तौर पर जोड़ा गया.
Forecast नया फ़ील्ड ReachPlanService.GenerateReachForecast में, मांग बढ़ाने में मदद करने वाले कैंपेन के लिए, ज़्यादा से ज़्यादा क्लिक (सीपीसी) की सुविधा के लिए clicks जोड़ा गया.
partnership_opportunities नया फ़ील्ड ContentCreatorInsightsService.GenerateCreatorInsights और ContentCreatorInsightsService.GenerateTrendingInsights में जोड़ा गया.
रिपोर्ट
biddable_indirect_install_first_in_app_conversion_micros नया फ़ील्ड Campaign, Customer, और AdGroup संसाधनों में जोड़ा गया.
वीडियो
ShareablePreviewService नई सुविधा इसे YouTube Live की झलक दिखाने की सुविधा के साथ काम करने के लिए बढ़ाया गया है. इसके लिए, preview_type को YOUTUBE_LIVE_PREVIEW पर सेट करें. UNSUPPORTED_AD_TYPE और TOO_MANY_RESOURCES_IN_REQUEST को ShareablePreviewError में जोड़ा गया. यह सुविधा, सिर्फ़ कुछ तरह के विज्ञापनों के लिए उपलब्ध है.

v23.1 (25-02-2026)

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 नई enum वैल्यू 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 नई enum वैल्यू यह उन उपयोगकर्ताओं को ट्रैक करने में मदद करता है जिन्होंने कोई विज्ञापन देखा और बाद में उसी चैनल का कोई वीडियो देखा.
सामान्य
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED नई enum वैल्यू / गड़बड़ी यह तब दिखता है, जब डेमोग्राफ़िक डाइमेंशन में सिर्फ़ 'तय नहीं किया गया' कैटगरी को टारगेट करने की कोशिश की जाती है.
इंसेंटिव
IncentiveErrorEnum नई enum वैल्यू / गड़बड़ियां दो नए गड़बड़ी कोड जोड़े गए: MAX_INCENTIVES_REDEEMED और ACCOUNT_TOO_OLD. ये गड़बड़ियां, 11 मार्च, 2026 को या इसके बाद किए गए अनुरोधों के लिए दिख सकती हैं.
प्लानिंग
GenerateBenchmarksMetrics नई सुविधा BreakdownDefinition का इस्तेमाल करके, तारीख के हिसाब से ब्रेकडाउन देखने की सुविधा जोड़ी गई.
ReachPlanService.GenerateReachForecast नई enum वैल्यू मांग बढ़ाने में मदद करने वाले कैंपेन के लिए, ज़्यादा से ज़्यादा कन्वर्ज़न हासिल करने के लक्ष्य के साथ 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 नई enum वैल्यू VERTICAL_ADS_DATA_FEED को जोड़ा गया है, ताकि वर्टिकल विज्ञापन डेटा फ़ीड को सपोर्ट किया जा सके. जैसे, यात्रा के विज्ञापनों के लिए इकाई टारगेटिंग.
YouTubeVideoUpload
YouTubeVideoUpload नई सेवा / संसाधन YouTube पर वीडियो अपलोड करने और उन्हें मैनेज करने के लिए, YouTubeVideoUpload सेवा जोड़ी गई है. साथ ही, अपलोड करने की स्थिति और मेटाडेटा पाने के लिए, YouTubeVideoUpload संसाधन जोड़ा गया है. यह सुविधा सिर्फ़ REST और Python क्लाइंट लाइब्रेरी के लिए उपलब्ध है.

v23 (28-01-2026)

Google Ads API के v23 वर्शन में, ये नई सुविधाएं, अपडेट, और बड़े बदलाव जोड़े गए हैं. यह एक अहम रिलीज़ है.

निर्देशों के लिए, नए वर्शन पर अपग्रेड करें लेख पढ़ें.

नुकसान पहुंचा सकने वाले बदलाव

प्रारंभिक स्थिति नई स्थिति बदलाव का टाइप लागू करने के लिए दिशा-निर्देश
विज्ञापन
विज्ञापन शेयर करने की अनुमति है AdGroupAdError.AD_SHARING_NOT_ALLOWED व्यवहार में बदलाव अब एक विज्ञापन को कई विज्ञापन ग्रुप के साथ शेयर करने की अनुमति नहीं है. विज्ञापन शेयर करने की कोशिश करने वाले अनुरोधों के लिए, AD_SHARING_NOT_ALLOWED गड़बड़ी का मैसेज दिखेगा.
CallAd और CallAdInfo के साथ काम करता है कोई नहीं कॉन्टेंट हटाना कॉल दिलाने वाले विज्ञापनों के लिए सहायता हटा दी गई है. कॉल ऐसेट के बारे में जानकारी देने वाला सहायता केंद्र लेख पढ़ें.
कैंपेन
Campaign.start_date
Campaign.end_date
Campaign.start_date_time
Campaign.end_date_time
नाम बदलना / बदलना कैंपेन के लिए समय के कॉम्पोनेंट तय करने के लिए, तारीख और समय के नए फ़ील्ड का इस्तेमाल करें. सिर्फ़ तारीख वाले ओरिजनल फ़ील्ड हटा दिए जाते हैं.
विज्ञापन की मांग बढ़ाने में मदद करने वाला विज्ञापन चैनल
DemandGenMultiAssetAdInfo.lead_form_only कोई नहीं कॉन्टेंट हटाना lead_form_only फ़ील्ड को हटा दिया गया है. अपने कोड में मौजूद रेफ़रंस अपडेट करें.
रिपोर्ट
ऐसेट परफ़ॉर्मेंस लेबल की मेट्रिक और इनम को एग्रीगेट करें कोई नहीं कॉन्टेंट हटाना ऐसेट की परफ़ॉर्मेंस लेबल की एग्रीगेट मेट्रिक हटाई गई हैं. सर्च और डिसप्ले कैंपेन के लिए, परफ़ॉर्मेंस लेबल enum अब नहीं दिखाया जाता.

सुविधाएं और अपडेट (बिना किसी रुकावट के)

सुविधाएं और अपडेट टाइप ब्यौरा
विज्ञापन
AdFormatType नई enum वैल्यू नए फ़ॉर्मैट टाइप जोड़े गए: TEXT, VERTICAL_ADS_BOOKING_LINK, और VERTICAL_ADS_PROMOTION.
एसेट
asset_group व्यू नए फ़ील्ड ये मेट्रिक जोड़ी गई हैं: metrics.engagements, metrics.engagement_rate, और metrics.average_cpe.
asset_group_asset व्यू नए फ़ील्ड ये मेट्रिक जोड़ी गई हैं: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views, और metrics.interaction_event_types.
Asset.orientation नया फ़ील्ड इमेज और वीडियो ऐसेट में, रीड-ओनली ओरिएंटेशन फ़ील्ड जोड़ा गया है.
CampaignAsset नई सुविधा field_type को HEADLINE और DESCRIPTION पर सेट करके, कैंपेन की ऐसेट वापस पाने की सुविधा जोड़ी गई.
ServedAssetFieldType नई enum वैल्यू साइटलिंक के तौर पर दिखाई गई ऐसेट के लिए HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE, और DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO जोड़े गए.
BusinessMessageAsset नई सुविधाएं / सहायता अपडेट की गई Business Message ऐसेट:
  • Facebook Messenger और Zalo को सेवा देने वाली कंपनियों के तौर पर जोड़ा गया.
  • FACEBOOK_MESSENGER और ZALO को BusinessMessageProvider में जोड़ा गया.
  • facebook_messenger_info और zalo_info फ़ील्ड जोड़े गए.
  • CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS को AssetError में जोड़ा गया.
बिलिंग
InvoiceService.ListInvoices नए विकल्प अब ListInvoicesRequest में include_granular_level_invoice_details सेट करके, Invoice में ज़्यादा विस्तृत जानकारी दी जा सकती है. जैसे, कैंपेन लेवल पर लागत का ब्रेकडाउन, आइटम के हिसाब से कानूनी शुल्क, और अडजस्टमेंट की जानकारी.
RegulatoryFeeType
UnitOfMeasure
नए enum स्थानीय नियम-कानूनों के हिसाब से शुल्क और मेज़रमेंट की इकाइयों के लिए हेल्पर enum जोड़े गए.
कैंपेन
CampaignError नई enum वैल्यू / गड़बड़ियां DURATION_TOO_LONG_FOR_TOTAL_BUDGET और END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET गड़बड़ी कोड जोड़े गए.
कन्वर्ज़न
ConversionActionCategory नई enum वैल्यू YOUTUBE_FOLLOW_ON_VIEWS जोड़ा गया है, ताकि उन उपयोगकर्ताओं को ट्रैक किया जा सके जो कोई विज्ञापन देखते हैं और बाद में उसी चैनल का कोई वीडियो देखते हैं.
विज्ञापन की मांग बढ़ाने में मदद करने वाला विज्ञापन चैनल
DemandGenVideoResponsiveAdInfo.companion_banner नया फ़ील्ड मांग बढ़ाने में मदद करने वाले कैंपेन के रिस्पॉन्सिव वीडियो विज्ञापनों में, साथ दिखने वाले बैनर विज्ञापनों के लिए सहायता जोड़ी गई.
इंसेंटिव
'अपनी पसंद के हिसाब से इनाम चुनें' (सीवाईओ) सुविधा के लिए सहायता जोड़ी गई:
  • उपयोगकर्ता के लिए उपलब्ध, उसकी पसंद के मुताबिक इंसेंटिव पाने के लिए, FetchIncentive तरीका जोड़ा गया.
  • किसी ग्राहक खाते पर चुने गए इंसेंटिव को लागू करने के लिए, ApplyIncentive तरीका जोड़ा गया.
  • रिडेंप्शन की जानकारी देने के लिए, AppliedIncentive संसाधन जोड़ा गया है. इसे Search और SearchStream का इस्तेमाल करके क्वेरी किया जा सकता है.
  • IncentiveError और AuthenticationError.INVALID_EMAIL_ADDRESS में नए गड़बड़ी कोड जोड़े गए.

गड़बड़ियों को प्रोग्राम के हिसाब से ज़्यादा बारीकी से मैनेज करने के लिए, हम आने वाले समय में IncentivesService में गड़बड़ी के अन्य कोड जोड़ेंगे. हमारा सुझाव है कि आप इन नए गड़बड़ी कोड के लिए, आने वाली सूचनाओं और रिलीज़ नोट पर नज़र रखें. इससे यह पक्का किया जा सकेगा कि आपके ऐप्लिकेशन, गड़बड़ी की इन नई स्थितियों को मैनेज कर सकें.

प्लानिंग
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST नई enum वैल्यू इस कुकी की मदद से, GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport, और GenerateCreatorInsights में मौजूद 'ज़िंदगी के खास पड़ाव' का इस्तेमाल करके ऑडियंस बनाई जा सकती हैं.

लाइफ़ इवेंट, AudienceInsightsService के अन्य तरीकों के साथ काम नहीं करते. जैसे, AudienceInsightsService.GenerateAudienceOverlap और AudienceInsightsService.GenerateTargetingSuggestionMetrics.

ReachPlanService.GenerateConversionRates नए फ़ील्ड / विकल्प जवाब में अब ऐसे प्लैटफ़ॉर्म शामिल हैं जो प्लैटफ़ॉर्म कंट्रोल (जैसे, Gmail, Shorts) के आधार पर कन्वर्ज़न रेट के सुझावों के साथ काम करते हैं. यह सुविधा सिर्फ़ मांग बढ़ाने में मदद करने वाले कैंपेन के लिए उपलब्ध है.
LanguageDistribution नया फ़ील्ड / टाइप इसे YouTubeChannelInsights में जोड़ा गया है, ताकि YouTube चैनल के कॉन्टेंट में भाषा के हिसाब से डिस्ट्रिब्यूशन की जानकारी दी जा सके.
BenchmarksService नई सेवा यह कुकी, YouTube विज्ञापन के डेटा की तुलना इंडस्ट्री के बेंचमार्क से करती है.
AudienceInsightsService.GenerateAudienceDefinition नया तरीका यह जनरेटिव एआई का इस्तेमाल करके, टारगेट ऑडियंस के बारे में दिए गए टेक्स्ट के ब्यौरे को ऑडियंस से मिलते-जुलते एट्रिब्यूट में बदलता है.
YouTubeChannelInsights.relevance_score नया फ़ील्ड इससे यह पता चलता है कि किसी विषय के लिए कोई क्रिएटर कितना काम का है. इसके लिए, व्यू की संख्या को ध्यान में रखा जाता है.
TrendInsightMetrics.trend_change_percent नया फ़ील्ड इससे तुलना की अवधि के दौरान, किसी ट्रेंड की वैल्यू में हुए प्रतिशत बदलाव के बारे में पता चलता है.
सुझाव
GenerateRecommendationsRequest नया फ़ील्ड is_new_customer को जोड़ा गया. CAMPAIGN_BUDGET सुझावों के लिए true पर सेट होने पर, यह नए ग्राहकों के लिए ऑप्टिमाइज़ किए गए मॉडल का इस्तेमाल करता है. यह सिर्फ़ उन ग्राहकों के लिए सुझाव दिया जाता है जिनके पास कोई कैंपेन नहीं है.
रिपोर्ट
AdGroupAdAssetView नई सुविधा / मेट्रिक के लिए सहायता अब RESPONSIVE_DISPLAY_AD के लिए, इंप्रेशन, परफ़ॉर्मेंस, और कन्वर्ज़न मेट्रिक का इस्तेमाल किया जा सकता है.
ad_sub_network_type सेगमेंट नया सेगमेंट इससे किसी विज्ञापन नेटवर्क के अंदर, परफ़ॉर्मेंस का ज़्यादा जानकारी वाला ब्रेकडाउन मिलता है. शुरुआत में, यह सुविधा YouTube पर मांग बढ़ाने में मदद करने वाले कैंपेन (इन-स्ट्रीम, फ़ीड में विज्ञापन, Shorts) के लिए उपलब्ध होगी. इसे ad_network_type के साथ चुना जाना चाहिए.
परफ़ॉर्मेंस मैक्स कैंपेन की रिपोर्टिंग नई सुविधा परफ़ॉर्मेंस मैक्स कैंपेन के लिए, चालू किए गए विज्ञापन नेटवर्क टाइप का ब्रेकडाउन.
UserLocationView
GeographicView
नए सेगमेंट के लिए सहायता कन्वर्ज़न की तारीख के हिसाब से सेगमेंट की गई सहायता मेट्रिक: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date, cross_device_conversions_by_conversion_date, और cross_device_conversions_value_by_conversion_date.
वर्टिकल विज्ञापन के सेगमेंट नए सेगमेंट ये सेगमेंट जोड़े गए हैं: vertical_ads_event_participant_display_names, vertical_ads_hotel_class, vertical_ads_listing, vertical_ads_listing_brand, vertical_ads_listing_city, vertical_ads_listing_country, vertical_ads_listing_region, vertical_ads_partner_account, और vertical_ads_vertical.
PerStoreView
MatchedLocationInterestView
रिपोर्टिंग के नए संसाधन स्टोर की जगह की जानकारी के बारे में क्वेरी करने के लिए PerStoreView जोड़ा गया है. साथ ही, दिलचस्पी वाली जगहों के हिसाब से परफ़ॉर्मेंस मेट्रिक देने के लिए, MatchedLocationInterestView (एआई मैक्स कैंपेन के लिए) जोड़ा गया है.
शॉपिंग
ShoppingPerformanceView नई मेट्रिक के लिए सहायता अब कन्वर्ज़न की तारीख के हिसाब से सेगमेंट की गई इन मेट्रिक के साथ काम करता है: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView नई मेट्रिक के लिए सहायता इनके लिए सहायता जोड़ी गई है: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, और search_rank_lost_absolute_top_impression_share.
ShoppingProduct.product_image_uri नया फ़ील्ड ShoppingProduct में जोड़ा गया.
वर्टिकल विज्ञापन
AdGroup.vertical_ads_format_setting नया फ़ील्ड इससे यह कंट्रोल किया जा सकता है कि यात्रा के फ़ीड का इस्तेमाल करके, Search Network में दिखने वाले विज्ञापनों में कौनसे विज्ञापन फ़ॉर्मैट दिखाए जा सकते हैं.
AdGroupCriterion
SharedCriterion
नए फ़ील्ड / शर्तें सर्च कैंपेन में यात्रा से जुड़े फ़ीड के साथ आइटम ग्रुप को टारगेट करने की अनुमति देने के लिए, AdGroupCriterion में vertical_ads_item_group_rule_list मानदंड टाइप और SharedCriterion में vertical_ads_item_group_rule जोड़ा गया.
वर्टिकल विज्ञापनों के डेटा फ़ीड इंटिग्रेशन नई सुविधा अब वर्टिकल विज्ञापनों के डेटा फ़ीड को, AI Max की मदद से चल रहे सर्च कैंपेन से कनेक्ट किया जा सकता है. इससे टेक्स्ट विज्ञापनों के साथ-साथ, प्रॉपर्टी का प्रमोशन करने वाले विज्ञापन और बुकिंग लिंक वाले यात्रा विज्ञापन दिखाए जा सकते हैं. vertical_ads_format_setting की मदद से फ़ॉर्मैट कंट्रोल करें और vertical_ads_item_group_rule का इस्तेमाल करके नियम तय करें. AdFormatType और वर्टिकल विज्ञापनों के डेटा फ़ीड डाइमेंशन के हिसाब से रिपोर्टिंग को सेगमेंट करें.
वीडियो
AdVideoAssetInfo.ad_video_asset_feature_control नया फ़ील्ड वीडियो विज्ञापन ऐसेट के लिए, सुविधा कंट्रोल करने के विकल्प जोड़े गए.
CampaignCriterionError नई enum वैल्यू / गड़बड़ी INVALID_VIDEO_LINEUP_ID गड़बड़ी का कोड जोड़ा गया.
YouTube पर ऑडियो की क्वालिटी से जुड़ी मेट्रिक नई मेट्रिक YouTube पर ऑडियो विज्ञापनों के लिए, सुनने से जुड़ी मेट्रिक जोड़ी गई हैं. इससे यह पता चलता है कि कोई विज्ञापन सुना गया या नहीं. साथ ही, यह भी पता चलता है कि कितने इंप्रेशन के लिए, सुनने से जुड़ी मेट्रिक को मेज़र किया जा सकता है.

v22 के मेजर और माइनर वर्शन

Google Ads API v22 में ये नई सुविधाएं, अपडेट, और बड़े बदलाव शामिल हैं.

v22.2 (24-06-2026)

Google Ads API v22.2 में ये नई सुविधाएं और अपडेट जोड़े गए हैं. v22.2 जैसे माइनर वर्शन में, नुकसान पहुंचाने वाले बदलाव शामिल नहीं होते.

सुविधाएं और अपडेट टाइप ब्यौरा
सामान्य
Asset.synthetic_content_info
Ad.synthetic_content_info
नए फ़ील्ड इसमें सिंथेटिक/एआई से जनरेट किए गए कॉन्टेंट के लिए पुष्टि करने वाले स्टेटमेंट शामिल होते हैं. इन्हें advertiser_attestation (विज्ञापन देने वाले व्यक्ति या कंपनी की ओर से सीधे तौर पर दी गई घोषणाएं) और system_attestation (Google के सिस्टम की ओर से अपने-आप पता लगाई गई या दी गई पुष्टि) में बांटा जाता है.

v25 के लिए, इंटिग्रेशन से जुड़े काम की योजना बनाने में आपकी मदद करने के लिए, विज्ञापन देने वाले व्यक्ति या कंपनी के कानूनी समझौते से जुड़े फ़ील्ड में बदलाव करने वाले इंटरफ़ेस को v22 और इसके बाद के वर्शन के लिए पहले ही उपलब्ध कराया जा रहा है. इन वर्शन में इंटरफ़ेस दिखता है, लेकिन synthetic_content_info.advertiser_attestation.status और synthetic_content_info.advertiser_attestation.source इन वर्शन के लिए नहीं बदलेगा.

अगर इनमें से किसी भी फ़ील्ड के लिए म्यूटेट अनुरोध किया जाता है, तो इनमें से कोई एक गड़बड़ी दिखेगी:

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

ये फ़ील्ड, v25 से पूरी तरह से बदले जा सकेंगे. हमारा सुझाव है कि आप अभी इस इंटरफ़ेस का इस्तेमाल करके, अपने इंटरनल लॉजिक को बनाएं और उसकी जांच करें. इससे, v25 के लॉन्च होने पर आपका सिस्टम, पूरी तरह से लिखने की सुविधाओं के लिए तैयार रहेगा.

कई पक्षों से अनुमति नई सुविधाएं कई पक्षों से अनुमति लेने की सुविधा (एमपीए) की समीक्षा करने की सुविधा जोड़ी गई है:

v22.1 (25-02-2026)

Google Ads API v22.1 में यह नई सुविधा जोड़ी गई है. v22.1 जैसे माइनर वर्शन में, काम न करने वाले बदलाव शामिल नहीं होते.

सुविधाएं और अपडेट टाइप ब्यौरा
खाते का मैनेजमेंट
Customer.contains_eu_political_advertising नया फ़ील्ड यह फ़ंक्शन, खाता-लेवल पर यह जानकारी देता है कि ईयू को टारगेट करने वाले राजनैतिक विज्ञापन शामिल हैं या नहीं. साथ ही, यह EuPoliticalAdvertisingStatus दिखाता है.
कैंपेन
Campaign.missing_eu_political_advertising_declaration नया फ़ील्ड इसकी मदद से, उन कैंपेन को क्वेरी और फ़िल्टर किया जा सकता है जिनमें यह एलान नहीं किया गया है कि उनमें ईयू को टारगेट करने वाले राजनैतिक विज्ञापन शामिल हैं या नहीं.

v22 (15-10-2025)

Google Ads API v22 में ये नई सुविधाएं, अपडेट, और बड़े बदलाव जोड़े गए हैं. यह एक अहम रिलीज़ है.

निर्देशों के लिए, नए वर्शन पर अपग्रेड करें लेख पढ़ें.

नुकसान पहुंचा सकने वाले बदलाव

प्रारंभिक स्थिति नई स्थिति बदलाव का टाइप लागू करने के लिए दिशा-निर्देश
विज्ञापन की मांग बढ़ाने में मदद करने वाला विज्ञापन चैनल
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros नाम बदलना / स्पेलिंग ठीक करना सुधारे गए फ़ील्ड के नाम का इस्तेमाल करने के लिए, रेफ़रंस के नाम बदलें.
सामान्य
AddBatchJobOperations में कार्रवाइयों की कोई सीमा नहीं है हर अनुरोध में 10,000 कार्रवाइयां करने की सीमा व्यवहार में बदलाव पक्का करें कि किसी एक AddBatchJobOperations अनुरोध में 10,000 से ज़्यादा कार्रवाइयां शामिल न हों.
ListBatchJobResultsRequest में पेज के साइज़ को बिना किसी सूचना के 1,000 पर सेट कर दिया गया है INVALID_PAGE_SIZE गड़बड़ी दिखाता है व्यवहार में बदलाव पक्का करें कि ListBatchJobResultsRequest.page_size की वैल्यू 1,000 या उससे कम हो. अब पेज का साइज़ ज़्यादा होने पर गड़बड़ी होगी.
परफ़ॉर्मेंस मैक्स
ऐसेट परफ़ॉर्मेंस लेबल कोई नहीं कॉन्टेंट हटाना परफ़ॉर्मेंस मैक्स कैंपेन के लिए, ऐसेट परफ़ॉर्मेंस लेबल और उससे जुड़े परफ़ॉर्मेंस लेबल इनम को हटा दिया गया है. इसके हिसाब से इंटिग्रेशन अपडेट करें.
Campaign.url_expansion_opt_out AssetAutomationSetting में FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION का झंडा हटाना / बदलना फ़ाइनल यूआरएल एक्सपैंशन में शामिल किए जाने वाले टेक्स्ट ऐसेट के लिए ऑटोमेशन सेटिंग का इस्तेमाल करें. कैंपेन-लेवल पर यूआरएल एक्सपैंशन की सुविधा से ऑप्ट-आउट करने का फ़ील्ड हटा दिया गया है.
प्लानिंग
views trueview_views हटाना / बदलना ReachPlanService में, views के रेफ़रंस को नए trueview_views फ़ील्ड से बदलें.
वीडियो
average_cpv
video_view_rate
video_views
video_view_rate_in_feed
video_view_rate_in_stream
video_view_rate_shorts
trueview_average_cpv
video_trueview_view_rate
video_trueview_views
video_trueview_view_rate_in_feed
video_trueview_view_rate_in_stream
video_trueview_view_rate_shorts
नाम बदलें TrueView वीडियो व्यू दिखाने वाली नई मेट्रिक के नामों का इस्तेमाल करने के लिए, क्वेरी स्ट्रिंग और इंटिग्रेशन अपडेट करें.

सुविधाएं और अपडेट (बिना किसी रुकावट के)

सुविधाएं और अपडेट टाइप ब्यौरा
एसेट
AssetFieldType.LANDING_PAGE_PREVIEW नई enum वैल्यू इसे नई इमेज ऐसेट फ़ील्ड टाइप के तौर पर जोड़ा गया है.
AssetGenerationService नई सेवा (बीटा वर्शन) जनरेटिव एआई का इस्तेमाल करके, टेक्स्ट और इमेज ऐसेट जनरेट करने की अनुमति देता है:
  • GenerateText: यह फ़ाइनल यूआरएल, प्रॉम्प्ट, कीवर्ड वगैरह के आधार पर टेक्स्ट जनरेट करता है.
  • GenerateImages: यह फ़ाइनल यूआरएल, प्रॉम्प्ट या प्रॉडक्ट की इमेज को फिर से कॉन्टेक्स्ट में रखकर इमेज जनरेट करता है.
  • गड़बड़ियों के कोड, AssetGenerationError से मिलते हैं.
शुरुआत में, यह सुविधा सिर्फ़ क्लोज़्ड बीटा वर्शन में हिस्सा लेने वाले कुछ लोगों के लिए उपलब्ध होगी.
कैंपेन
AppCampaignBiddingStrategyGoalType नई enum वैल्यू ऐप्लिकेशन इंस्टॉल करने का बढ़ावा देने वाले कैंपेन (ACi) के लिए, नए लक्ष्य जोड़े गए हैं, ताकि टारगेट तय किए बिना ऑप्टिमाइज़ किया जा सके:
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: इसका इस्तेमाल, कन्वर्ज़न बढ़ाने के लिए स्टैंडर्ड बिडिंग की रणनीति के साथ करें.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: इसका इस्तेमाल, कन्वर्ज़न वैल्यू बढ़ाने की स्टैंडर्ड रणनीति के साथ करें.
BiddingStrategyType नई सुविधा वॉइस की निश्चित व्यापकता पाने के लिए बिडिंग की रणनीति के टाइप के लिए सहायता जोड़ी गई है.
Campaign.feed_types नया फ़ील्ड इससे किसी कैंपेन से जुड़े फ़ीड के टाइप दिखते हैं. परफ़ॉर्मेंस मैक्स कैंपेन के लिए, इससे कारोबार की वर्टिकल का पता चल सकता है. जैसे, खुदरा कारोबार के लिए MERCHANT_CENTER_FEED.
शेयर किए गए सेट को टारगेट करना नई सुविधा ऐप्लिकेशन कैंपेन और लोकल कैंपेन के लिए, शेयर किए गए नेगेटिव कीवर्ड सेट को मल्टी-चैनल से अटैच करने की अनुमति दी गई.
विज्ञापन की मांग बढ़ाने में मदद करने वाला विज्ञापन चैनल
टारगेट सीपीसी बिडिंग नई सुविधा टारगेट सीपीसी पर क्लिक बढ़ाने के लिए बिडिंग की रणनीति जोड़ी गई: Campaign.target_cpc का इस्तेमाल करके, कैंपेन-लेवल की टारगेट सीपीसी सेट करें. साथ ही, AdGroup.target_cpc_micros का इस्तेमाल करके, विज्ञापन ग्रुप लेवल पर टारगेट सीपीसी को बदलें.
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES नई enum वैल्यू अगर DemandGenMultiAssetAdInfo के लिए यह सुविधा चालू है, तो इससे डिज़ाइन एलिमेंट जुड़ जाते हैं. साथ ही, टेक्स्ट ऐसेट को इमेज ऐसेट में एम्बेड किया जाता है, ताकि अलग-अलग आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) वाली नई इमेज ऐसेट बनाई जा सकें. यह सुविधा डिफ़ॉल्ट रूप से चालू होती है.
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS नई enum वैल्यू अगर यह सुविधा DemandGenMultiAssetAdInfo के लिए चालू है, तो यह इमेज और टेक्स्ट जैसी अन्य ऐसेट का इस्तेमाल करके वीडियो जनरेट करती है. इनका इस्तेमाल, नए DemandGenVideoResponsiveAdInfo इंस्टेंस बनाने के लिए किया जा सकता है. यह सुविधा डिफ़ॉल्ट रूप से चालू होती है.
सामान्य
ListBatchJobResultsRequest पेज के साइज़ का फ़ॉलबैक व्यवहार में बदलाव अगर page_size को सेट नहीं किया गया है या इसकी वैल्यू 0 है, तो अब यह डिफ़ॉल्ट रूप से ज़्यादा से ज़्यादा 1,000 (पहले INVALID_PAGE_SIZE) पर सेट हो जाता है.
QuotaError नई enum वैल्यू / गड़बड़ी PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED जोड़ा गया है. इससे यह पता चलेगा कि पेमेंट्स प्रोफ़ाइल को चालू करने की दर की सीमा कब पार हो गई है.
परफ़ॉर्मेंस मैक्स
ऐसेट ऑटोमेशन की सेटिंग नई enum वैल्यू परफ़ॉर्मेंस मैक्स ऐसेट ऑटोमेशन के नए विकल्प जोड़े गए हैं:
  • GENERATE_IMAGE_ENHANCEMENT: इससे बेहतर इमेज अपने-आप जनरेट होती हैं (अपने-आप क्रॉप होने की सुविधा). यह सुविधा डिफ़ॉल्ट रूप से चालू होती है.
  • GENERATE_IMAGE_EXTRACTION: फ़ाइनल यूआरएल से इमेज ली जाती हैं. यह डिफ़ॉल्ट रूप से, खाते के डाइनैमिक इमेज एक्सटेंशन की सेटिंग पर सेट होता है.
परफ़ॉर्मेंस मैक्स कैंपेन की रिपोर्टिंग के सेगमेंट नए सेगमेंट परफ़ॉर्मेंस मैक्स कैंपेन के लिए खास तौर पर बनाए गए नए सेगमेंट जोड़े गए हैं:
  • ad_using_product_data: इससे पता चलता है कि विज्ञापन में Google Merchant Center के प्रॉडक्ट डेटा का इस्तेमाल किया गया है या नहीं.
  • ad_using_video: इससे पता चलता है कि किसी विज्ञापन में वीडियो ऐसेट का इस्तेमाल किया गया है या नहीं.
प्लानिंग
सीआरएम पार्टनर के डेटा की सूचियां नई सुविधा / enum वैल्यू सीआरएम डेटा सोर्स में THIRD_PARTY_PARTNER_DATA जोड़ा गया है. साथ ही, पार्टनर ऑडियंस की पुष्टि करने से जुड़ी गड़बड़ी के कोड (जैसे, सेवा की शर्तों को स्वीकार करना, लिंक मौजूद न होना वगैरह) जोड़े गए हैं.
लाइव स्ट्रीम करने वाले क्रिएटर की मेट्रिक नया फ़ील्ड YouTubeMetrics.is_active_live_stream_creator जोड़ा गया. यह क्रिएटर इनसाइट की ओर से दिखाया जाता है. इससे पता चलता है कि किसी क्रिएटर ने पिछले 90 दिनों में कोई लाइव स्ट्रीम पब्लिश की है या नहीं.
सीआरएम सोर्स का मेटाडेटा, जिसे प्लान किया जा सकता है नया मैसेज सीआरएम डेटा सोर्स टाइप दिखाने के लिए, ReachPlanService.ListPlannableUserLists से मिले PlannableUserList में PlannableUserListMetadata जोड़ा गया.
ट्रेंड की जानकारी देने वाले टूल में, मिलते-जुलते वीडियो और क्रिएटर्स के लिए सहायता नए फ़ील्ड TrendInsight पर related_videos और related_creators के साथ-साथ, video_properties और publish_date में स्मार्टवॉच की प्रॉपर्टी के लिए सहायता जोड़ी गई.
InsightsFinder में किए गए सुधार नई सुविधा GenerateInsightsFinderReport अब parental_status, income_ranges, और टारगेटिंग के ज़्यादा मुश्किल AND/OR कॉम्बिनेशन के साथ काम करता है.
रिपोर्ट
क्लिक के नए टाइप नई enum वैल्यू CLICK_TO_MESSAGE_THIRD_PARTY_CLICK और CLICK_TO_MESSAGE_LANDING_PAGE_CLICK को जोड़ा गया.
AssetGroupAsset सेगमेंटेशन नए सेगमेंट के लिए सहायता AssetGroupAsset को अब device, conversion_action, conversion_action_name, और conversion_action_category के हिसाब से सेगमेंट किया जा सकता है.
AdGroupAdAssetView में आरएसए नई सुविधा / मेट्रिक के लिए सहायता AdGroupAdAssetView अब RESPONSIVE_SEARCH_AD के लिए, परफ़ॉर्मेंस और कन्वर्ज़न मेट्रिक के साथ पूरी तरह से काम करता है. इससे पहले, सिर्फ़ इंप्रेशन दिखाए जाते थे.
एक्सप्लोरेशन क्वेरी क्लस्टर मेट्रिक के सेगमेंटेशन नए सेगमेंट के लिए सहायता मेट्रिक clicks_unique_query_clusters, conversions_unique_query_clusters, और impressions_unique_query_clusters को अब तारीख के हिसाब से सेगमेंट किया जा सकता है.
TargetingExpansionView रिपोर्टिंग का नया संसाधन मैन्युअल टारगेटिंग के मुकाबले एक्सपैंशन के लिए, रिपोर्ट मेट्रिक में TargetingExpansionView जोड़ा गया है. जैसे, सर्च कैंपेन के लिए एआई मैक्स के लिए बिना कीवर्ड वाला एक्सपैंशन.
शॉपिंग
शॉपिंग कैंपेन के स्कोप से जुड़ी समस्या ठीक करना गड़बड़ी ठीक की गई ShoppingProduct रिसॉर्स में, कैंपेन और विज्ञापन ग्रुप के हिसाब से मेट्रिक के स्कोप की समस्या ठीक की गई.
यूनिफ़ाइड लक्ष्य
ग्राहकों को जोड़े रखने के लक्ष्य नई सुविधा मौजूदा ग्राहकों को फिर से जोड़ने के लिए, ग्राहकों को जोड़े रखने के लक्ष्यों के लिए सहायता जोड़ी गई है. उदाहरण के लिए, TARGET_SPECIFIC या TARGET_ALL के साथ target_option का इस्तेमाल करना.
वीडियो
वीडियो देखे जाने की समयावधि की मेट्रिक नए फ़ील्ड वीडियो देखने के कुल समय और हर इंप्रेशन देखने के कुल समय का औसत बताने वाली मेट्रिक जोड़ी गई हैं: video_watch_time_duration_millis (कुल अवधि) और average_video_watch_time_duration_millis (हर इंप्रेशन देखने के कुल समय का औसत).

v21 के मेजर और माइनर वर्शन

Google Ads API v21 में ये नई सुविधाएं, अपडेट, और बड़े बदलाव शामिल हैं.

v21.2 (24-06-2026)

Google Ads API v21.2 में ये नई सुविधाएं और अपडेट जोड़े गए हैं. v21.2 जैसे माइनर वर्शन में, एपीआई में बड़े बदलाव नहीं होते.

सुविधाएं और अपडेट टाइप ब्यौरा
सामान्य
कई पक्षों से अनुमति नई सुविधाएं कई पक्षों से अनुमति लेने की सुविधा (एमपीए) की समीक्षा करने की सुविधा जोड़ी गई है:

v21.1 (25-02-2026)

Google Ads API v21.1 में ये नई सुविधाएं और अपडेट जोड़े गए हैं. v21.1 जैसे माइनर वर्शन में, एपीआई में कोई बड़ा बदलाव नहीं किया गया है.

सुविधाएं और अपडेट टाइप ब्यौरा
खाते का मैनेजमेंट
Customer.contains_eu_political_advertising नया फ़ील्ड यह फ़ंक्शन, खाता-लेवल पर यह जानकारी देता है कि ईयू को टारगेट करने वाले राजनैतिक विज्ञापन शामिल हैं या नहीं. साथ ही, यह EuPoliticalAdvertisingStatusEnum दिखाता है.
कैंपेन
Campaign.missing_eu_political_advertising_declaration नया फ़ील्ड इसकी मदद से, उन कैंपेन को क्वेरी और फ़िल्टर किया जा सकता है जिनमें यह एलान नहीं किया गया है कि उनमें ईयू को टारगेट करने वाले राजनैतिक विज्ञापन शामिल हैं या नहीं.

v21 (06-08-2025)

Google Ads API v21 में ये नई सुविधाएं, अपडेट, और बड़े बदलाव जोड़े गए हैं. यह एक अहम रिलीज़ है.

निर्देशों के लिए, नए वर्शन पर अपग्रेड करें लेख पढ़ें.

नुकसान पहुंचा सकने वाले बदलाव

प्रारंभिक स्थिति नई स्थिति बदलाव का टाइप लागू करने के लिए दिशा-निर्देश
कैंपेन
CriterionError.INVALID_LISTING_GROUP_HIERARCHY दिखाता है CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION दिखाता है गड़बड़ी के कोड में बदलाव जिन अनुरोधों के लिए, कुछ हद तक गड़बड़ी होने पर भी अनुरोध पूरा करने की सुविधा चालू है उनके लिए, ओरिजनल हैरारकी गड़बड़ी कोड के बजाय नए गड़बड़ी कोड को मैनेज करें.
कन्वर्ज़न
ConversionUploadService में debug_enabled मोड का ऐक्सेस कोई नहीं कॉन्टेंट हटाना debug_enabled फ़ील्ड को हटा दिया गया है. इस पैरामीटर को सेट या क्वेरी न करने के लिए, इसे रेफ़र करने वाले कोड को अपडेट करें.
ईयू में राजनैतिक विज्ञापन दिखाने से जुड़े बदलाव
ईयू में राजनैतिक विज्ञापनों के लिए, कैंपेन के खुद के एलान करने की सुविधा (ज़रूरी नहीं) नए कैंपेन के लिए ज़रूरी contains_eu_political_advertising फ़ील्ड पुष्टि करने का नियम / व्यवहार में बदलाव अगर इस फ़ील्ड को सेट नहीं किया जाता है, तो नए कैंपेन बनाने के लिए किए गए एपीआई कॉल पूरे नहीं हो पाएंगे. साथ ही, FieldError.REQUIRED गड़बड़ी दिखेगी. CONTAINS_EU_POLITICAL_ADVERTISING के तौर पर मार्क किए गए कैंपेन, 22 सितंबर, 2025 से ईयू में नहीं दिखाए जाएंगे.
शर्तों का पालन करने की सहमति दिए बिना, शर्तों में बदलाव किया जा सकता है CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION के साथ अपडेट नहीं हो सका पुष्टि करने का नियम / व्यवहार में बदलाव मौजूदा कैंपेन के लिए, कैंपेन या विज्ञापन ग्रुप लेवल पर आस-पास के इलाके, जगह या जगह के ग्रुप को टारगेट करने की शर्तों को बनाने या अपडेट करने से पहले, खुद से किए गए एलान की स्थिति सेट करें.
ऐसे एक्सपेरिमेंट जिनमें शर्तों का पालन करने की सहमति देने की ज़रूरत नहीं होती ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION के साथ अपडेट नहीं हो सका पुष्टि करने का नियम / व्यवहार में बदलाव पक्का करें कि एक्सपेरिमेंट के कैंपेन के लिए, खुद से किए गए एलान पूरे कर लिए गए हों.
परफ़ॉर्मेंस मैक्स
brand_guidelines_enabled की डिफ़ॉल्ट वैल्यू false होती है डिफ़ॉल्ट रूप से true पर सेट होता है व्यवहार में बदलाव नए परफ़ॉर्मेंस मैक्स कैंपेन के लिए, ब्रैंड के दिशा-निर्देशों की सुविधा डिफ़ॉल्ट रूप से चालू होती है. अगर उन्हें बंद करना है, तो फ़ील्ड को साफ़ तौर पर false पर सेट करें.
प्लानिंग
AudienceInsightsService.GenerateTargetingSuggestionMetrics के लिए, ओरिजनल इनपुट आर्ग्युमेंट का टाइप InsightsAudience टाइप का इनपुट टाइप में बदलाव नए इनपुट टाइप को पास करने के लिए, लागू करने के तरीके को अपडेट करें. यह इनपुट टाइप, उपयोगकर्ता की दिलचस्पी के हिसाब से बनाए गए AND-of-ORs कॉम्बिनेशन के साथ काम करता है. इससे, कस्टम ऑडियंस की परिभाषाओं के लिए संभावित पहुंच की मेट्रिक का इस्तेमाल किया जा सकता है.

सुविधाएं और अपडेट (बिना किसी रुकावट के)

सुविधाएं और अपडेट टाइप ब्यौरा
सर्च कैंपेन के लिए AI Max
Campaign में ai_max_setting.enable_ai_max नया फ़ील्ड इससे एआई मैक्स, खोज के लिए इस्तेमाल किए गए शब्दों की मैचिंग को बढ़ा पाता है. साथ ही, यह टेक्स्ट ऐसेट ऑटोमेशन और ब्रैंड की पिछली सूचियों का इस्तेमाल करता है, जब तक कि इसे बंद न कर दिया जाए. Campaign.ai_max_setting.bundling_required फ़ील्ड से पता चलता है कि उन सेटिंग को लागू करने या उनमें बदलाव करने के लिए, एआई मैक्स को चालू करना ज़रूरी है या नहीं. साथ ही, AdGroup.ai_max_ad_group_setting.disable_search_term_matching से विज्ञापन ग्रुप लेवल पर मैचिंग की सुविधा बंद की जा सकती है. सर्च कैंपेन के लिए एआई मैक्स की मदद से, बेहतर परफ़ॉर्मेंस पाएं लेख पढ़ें.
CampaignError.AI_MAX_MUST_BE_ENABLED नई enum वैल्यू / गड़बड़ी यह गड़बड़ी तब दिखती है, जब एआई मैक्स की सुविधा चालू किए बिना, सर्च कैंपेन में यूआरएल एक्सपैंशन टेक्स्ट ऐसेट ऑटोमेशन की सुविधा के लिए ऑप्ट-इन किया जाता है.
विज्ञापन ग्रुप लेवल पर टारगेट करने की सुविधा नई सुविधा सर्च कैंपेन के लिए एआई मैक्स में, विज्ञापन ग्रुप लेवल पर ब्रैंड की सूचियों, जगहों, और वेबपेजों (यूआरएल के नियम) के लिए सहायता जोड़ी गई है.
ai_max_search_term_ad_combination_view रिपोर्टिंग का नया संसाधन यह रिपोर्ट, खोज के लिए इस्तेमाल किए गए शब्दों, हेडलाइन, और लैंडिंग पेजों के कॉम्बिनेशन की परफ़ॉर्मेंस दिखाती है.
search_term_match_type सेगमेंट नई enum वैल्यू सर्च टर्म मैच टाइप के विकल्प के तौर पर AI_MAX को जोड़ा गया.
एसेट
PromotionAsset नए फ़ील्ड terms_and_conditions_text, terms_and_conditions_uri, और promotion_trigger में से एक विकल्प (promotion_barcode_info, promotion_qr_code_info) जोड़ा गया. प्रमोशन ऐसेट के बारे में जानकारी देखें.
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION नई enum वैल्यू इसे AssetAutomationType में जोड़ा गया है, ताकि सर्च कैंपेन में फ़ाइनल यूआरएल से अपने-आप जनरेट होने वाले टेक्स्ट और लैंडिंग पेज को कंट्रोल किया जा सके.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset नई सेवा / तरीका इसकी मदद से, कैंपेन से अपने-आप जनरेट हुई फ़ाइनल यूआरएल एक्सपैंशन ऐसेट को हटाया जा सकता है.
ServedAssetFieldType.DESCRIPTION_PREFIX नई enum वैल्यू इस कुकी को रिपोर्टिंग की समस्या को ठीक करने के लिए जोड़ा गया था. इस समस्या में, ad_group_ad_asset_combination_view में टाइप को UNKNOWN के तौर पर दिखाया गया था.
कैंपेन
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING नई enum वैल्यू यह तब दिखता है, जब जगह के हिसाब से पाबंदी वाले कैंपेन में जगह के हिसाब से टारगेटिंग की सुविधा नहीं होती. हालांकि, अब अगर कैंपेन को पाबंदी वाली जगह के बाहर टारगेट किया जाता है, तो LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN दिखता है.
तीसरे पक्ष के ऐप्लिकेशन के ऐनलिटिक्स का इंटिग्रेशन नए फ़ील्ड VideoCustomer.third_party_integration_partners और Campaign.third_party_integration_partners के लिए सहायता जोड़ी गई. तीसरे पक्ष के ऐप्लिकेशन के आंकड़ों की मदद से, ऐप्लिकेशन कन्वर्ज़न को ट्रैक करना लेख पढ़ें.
Campaign.advertising_partner_ids नए फ़ील्ड के लिए सहायता अब इस फ़ील्ड को मौजूदा कैंपेन के लिए सेट किया जा सकता है. हालांकि, इसे सेट करने के बाद बदला नहीं जा सकता.
मैनेजर खाते के लेवल पर टारगेटिंग से बाहर रखे गए प्लेसमेंट नई सुविधा इस कुकी की मदद से, विज्ञापन देने वाले लोगों या कंपनियों के अलग-अलग खातों में, प्लेसमेंट की सूचियों को बाहर रखा जा सकता है. इसके लिए, CustomerNegativeCriterion का इस्तेमाल किया जाता है.
टारगेट आरओएएस रणनीतियों में टॉलरेंस कॉन्फ़िगरेशन नए फ़ील्ड MaximizeConversionValue और TargetRoas में, TargetRoas.target_roas_tolerance_percent_millis (सर्च कैंपेन की पोर्टफ़ोलियो रणनीतियों के लिए) के लिए सहायता जोड़ी गई है.
LocationInterestView रिपोर्टिंग का नया संसाधन विज्ञापन ग्रुप के लिए, दिलचस्पी वाली जगह के हिसाब से टारगेटिंग की शर्तों की परफ़ॉर्मेंस की खास जानकारी देता है.
कन्वर्ज़न
conversion_attribution_event_type सेगमेंट नई enum वैल्यू कन्वर्ज़न एट्रिब्यूशन टाइप के विकल्पों में ENGAGED_VIEW जोड़ा गया.
विज्ञापन की मांग बढ़ाने में मदद करने वाला विज्ञापन चैनल
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM नई enum वैल्यू / गड़बड़ी मांग बढ़ाने में मदद करने वाले कैंपेन के लिए, रोज़ के कम से कम बजट को लागू करने की तैयारी के दौरान जोड़ा गया. budgetDailyMinimumErrorDetails का इस्तेमाल करके, जानकारी को दिखाया जाता है.
परफ़ॉर्मेंस मैक्स
campaign_search_term_view रिपोर्टिंग का नया संसाधन यह कैंपेन लेवल पर, खोज के लिए इस्तेमाल हुए शब्दों की मेट्रिक को इकट्ठा करता है. इससे परफ़ॉर्मेंस मैक्स कैंपेन के लिए, खोज के लिए इस्तेमाल हुए शब्दों का विश्लेषण और रिपोर्टिंग की जा सकती है.
प्लानिंग
ReachPlanService.ListPlannableUserInterests नया तरीका इस कुकी की मदद से, generateReachForecast के लिए प्लान की जा सकने वाली अफ़िनिटी और इन-मार्केट दिलचस्पी का पता लगाया जा सकता है.
AdditionalApplicationInfo नया फ़ील्ड इसे ReachPlanService.ListPlannableUserLists में वैकल्पिक इनपुट के तौर पर जोड़ा गया है.
AudienceInsights के एट्रिब्यूट की लिस्टिंग नई सुविधा AudienceInsightsService.ListAudienceInsightsAttributes अब पहली पार्टी के उपयोगकर्ताओं की उपलब्ध सूचियां फ़ेच करता है.
AudienceCompositionInsights टारगेटिंग सीआरएम सूचियां नई सुविधा AudienceInsightsService.GenerateAudienceCompositionInsights अब AudienceInsightsDimension डाइमेंशन के लिए, उपयोगकर्ता सूची के इंडेक्स की जानकारी दिखाता है: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST, और IN_MARKET_USER_INTEREST.
TrendInsightMetrics ऑडियंस की हिस्सेदारी नया फ़ील्ड यह किसी ट्रेंड के लिए ऑडियंस के शेयर को दिखाता है.
KnowledgeGraphAttributeMetadata कैटगरी नए फ़ील्ड यह कुकी, नॉलेज ग्राफ़ की विशेषताओं को मिलती-जुलती कैटगरी के हिसाब से फ़िल्टर करती है.
रिपोर्ट
ऐसेट व्यू की मेट्रिक नई सुविधाएं / मेट्रिक AssetGroupAsset, ChannelAggregateAssetView, और CampaignAggregateAssetView में कई नई मेट्रिक जोड़ी गईं. परफ़ॉर्मेंस मैक्स कैंपेन अब impressions के लिए सही वैल्यू भी रिपोर्ट करते हैं.
चुनिंदा एक्सटेंशन नई सुविधा ChangeStatus में, AssetSet और CampaignAssetSet को एक साथ क्वेरी किया जा सकता है.
search_term_targeting_status नया सेगमेंट कैंपेन के सर्च टर्म व्यू में चुना जा सकने वाला सेगमेंट.
final_url_expansion_asset_view रिपोर्टिंग का नया संसाधन यह फ़ाइनल यूआरएल एक्सपैंशन की ऐसेट की परफ़ॉर्मेंस की जानकारी रिपोर्ट करता है.
AssetGroup वैल्यू अडजस्टमेंट नए फ़ील्ड AssetGroup रिपोर्ट में value_adjustment और all_value_adjustment मेट्रिक के लिए सहायता जोड़ी गई.
landing_page_source नया सेगमेंट यह landing_page_view में लैंडिंग पेज के सोर्स का सेगमेंट उपलब्ध कराता है.
search_term_match_source नया सेगमेंट सर्च टर्म और कैंपेन सर्च टर्म व्यू में चुना जा सकने वाला सेगमेंट.
match_type नया सेगमेंट कीवर्ड व्यू में चुनी जा सकने वाली सेगमेंट कुंजी.
क्वेरी इंटेंट के यूनीक क्लस्टर की रिपोर्टिंग नए फ़ील्ड यूनीक क्वेरी इंटेंट क्लस्टर की रिपोर्ट करने के लिए, clicks_unique_query_clusters, conversions_unique_query_clusters, और impressions_unique_query_clusters को जोड़ा गया.
ClickType.VEHICLE_ASSETS नई enum वैल्यू click_view रिपोर्ट में, खास तौर पर वाहन के विज्ञापन फ़ॉर्मैट से जुड़े क्लिक ट्रैक और रिपोर्ट करें.
स्मार्ट बिडिंग एक्सप्लोरेशन
खोज की रणनीतियों में टॉलरेंस कॉन्फ़िगरेशन नए फ़ील्ड / सेटिंग इसकी मदद से, सर्च कैंपेन में स्मार्ट बिडिंग एक्सप्लोरेशन की सुविधा चालू की जा सकती है. इसके लिए, target_roas_tolerance_percent_millis को 10,000 (10%) और 30,000 (30%) के बीच सेट करें. कन्वर्ज़न बढ़ाने के लिए, target_roas सेटिंग की ज़रूरत होती है. स्मार्ट बिडिंग एक्सप्लोरेशन के बारे में हमारी ब्लॉग पोस्ट और सहायता केंद्र का लेख पढ़ें.
विविधता से जुड़ी रिपोर्टिंग की सुविधा नई सुविधा अब यूनीक क्वेरी इंटेंट क्लस्टर के लिए, इन मेट्रिक के लिए एग्रीगेट की गई डाइवर्सिटी रिपोर्टिंग की सुविधा उपलब्ध है. Google Ads के यूज़र इंटरफ़ेस (यूआई) में, समय के हिसाब से सेगमेंट किया गया व्यू उपलब्ध है:
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
वीडियो
YouTubeVideoListAsset नया संसाधन / फ़ील्ड इस कुकी की मदद से, Asset.youtube_video_list_asset का इस्तेमाल करके, कैंपेन और वीडियो की सूची वाली ऐसेट के बीच लिंक बनाए जा सकते हैं. मिलते-जुलते वीडियो का इस्तेमाल करना लेख पढ़ें.
इनसाइट मेटाडेटा एक्सटेंशन नए फ़ील्ड YouTubeChannelInsights और YouTubeVideoAttributeMetadata में नया मेटाडेटा जोड़ा गया.
इंटरैक्टिव क्लिक टाइप नई enum वैल्यू जोड़े गए क्लिक टाइप: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK, और PRODUCT_ASSETS.
VideoAdInventoryControl.allow_non_skippable_in_stream नया फ़ील्ड इस सेटिंग की मदद से, स्किप किए जा सकने वाले और स्किप न किए जा सकने वाले फ़ॉर्मैट को मिलाकर बनाए गए कैंपेन के लिए, वीडियो रिस्पॉन्सिव विज्ञापनों को स्किप न किए जा सकने वाले इन-स्ट्रीम विज्ञापनों के तौर पर दिखाया जा सकता है.
वीडियो के क्रम से जुड़ी सेटिंग नए फ़ील्ड रीड-ओनली सीक्वेंसिंग कॉन्फ़िगरेशन जोड़े गए: Campaign.VideoCampaignSettings.video_ad_sequence और VideoAdSequenceStepSetting. सिलसिलेवार वीडियो विज्ञापन के बारे में जानकारी देखें.
वीडियो लाइनअप टारगेटिंग मानदंड का नया टाइप / फ़ील्ड CampaignCriterion और AdGroupCriterion में VIDEO_LINEUP मानदंड का टाइप और उससे जुड़ा फ़ील्ड जोड़ा गया. यह सुविधा सिर्फ़ उन खातों के लिए उपलब्ध है जिन्हें अनुमति दी गई है.
'कॉन्टेंट कितना सही है' के हिसाब से प्लेसमेंट के व्यू रिपोर्टिंग के नए संसाधन ज़्यादा जानकारी (detail_content_suitability_placement_view) और ग्रुप (group_content_suitability_placement_view) लेवल, दोनों के लिए 'कॉन्टेंट कितना सही है' रिपोर्ट जोड़ी गई. 'कॉन्टेंट कितना सही है' रिपोर्ट के बारे में जानकारी देखें.

संग्रहित किए गए रिलीज़ नोट

संग्रहित किए गए रिलीज़ नोट देखने के लिए, बंद किए गए वर्शन देखें.