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

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

रिलीज़ की खास जानकारी और क्विक लिंक

किसी रिलीज़ में किए गए नुकसान पहुंचा सकने वाले बदलावों, नई सुविधाओं या प्रोटो डिफ़रेंस टेबल पर सीधे जाने के लिए, इस टेबल का इस्तेमाल करें:

वर्शन रिलीज़ की तारीख नुकसान पहुंचा सकने वाले बदलाव सुविधाएं और अपडेट प्रोटो डिफ़रेंस टेबल
v26.2 (नया वर्शन) 2026-11-11 कोई नहीं (माइनर रिलीज़) वर्शन 26.2 की सुविधाएं और अपडेट v25 और v26 प्रोटो के बीच अंतर
v26.1 2026-10-28 कोई नहीं (माइनर रिलीज़) v26.1 की सुविधाएं और अपडेट v25 और v26 प्रोटो के बीच अंतर
v26 2026-10-14 v26 में नुकसान पहुंचा सकने वाले बदलाव v26 की सुविधाएं और अपडेट v25 और v26 प्रोटो के बीच अंतर
v25.2 2026-09-23 कोई नहीं (माइनर रिलीज़) v25.2 की सुविधाएं और अपडेट v24 और v25 प्रोटो के बीच अंतर
v25.1 2026-08-19 कोई नहीं (माइनर रिलीज़) वर्शन 25.1 की सुविधाएं और अपडेट v24 और v25 प्रोटो के बीच अंतर
v25 2026-07-22 v25 में नुकसान पहुंचा सकने वाले बदलाव v25 की सुविधाएं और अपडेट v24 और v25 प्रोटो के बीच अंतर
v24.2 2026-06-24 कोई नहीं (माइनर रिलीज़) v24.2 की सुविधाएं और अपडेट v23 और v24 प्रोटो के बीच अंतर
v24.1 2026-05-13 कोई नहीं (माइनर रिलीज़) v24.1 की सुविधाएं और अपडेट v23 और v24 प्रोटो के बीच अंतर
v24 2026-04-22 v24 में नुकसान पहुंचा सकने वाले बदलाव v24 की सुविधाएं और अपडेट v23 और v24 प्रोटो के बीच अंतर
v23.3 2026-06-24 कोई नहीं (माइनर रिलीज़) वर्शन 23.3 की सुविधाएं और अपडेट v22 और v23 प्रोटो के बीच अंतर
v23.2 2026-03-25 कोई नहीं (माइनर रिलीज़) v23.2 की सुविधाएं और अपडेट v22 और v23 प्रोटो के बीच अंतर
v23.1 2026-02-25 कोई नहीं (माइनर रिलीज़) v23.1 की सुविधाएं और अपडेट v22 और v23 प्रोटो के बीच अंतर
v23 2026-01-28 v23 में नुकसान पहुंचा सकने वाले बदलाव v23 की सुविधाएं और अपडेट v22 और v23 प्रोटो के बीच अंतर

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

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

v26.2 (11-11-2026)

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

सुविधाएं और अपडेट टाइप ब्यौरा
ऐसेट
AssetAutomationType.OVERLAY_TEXT_ON_VIDEOS नई enum वैल्यू

AssetAutomationType ईनम में OVERLAY_TEXT_ON_VIDEOS ईनम वैल्यू जोड़ी गई. यह सेटिंग, वीडियो Asset ऐसेट के ऊपर, उससे जुड़ी टेक्स्ट Asset ऐसेट (जैसे, हेडलाइन) का टेक्स्ट ओवरले करती है. मांग बढ़ाने में मदद करने वाले कैंपेन के रिस्पॉन्सिव वीडियो विज्ञापनों (Ad.demand_gen_video_responsive_ad फ़ील्ड पर DemandGenVideoResponsiveAdInfo) के लिए, इस सेटिंग को AdGroupAd.ad_group_ad_asset_automation_settings फ़ील्ड (AdGroupAdAssetAutomationSetting टाइप का) में कॉन्फ़िगर करें.

v26 में बनाए गए, मांग बढ़ाने में मदद करने वाले नए रिस्पॉन्सिव वीडियो विज्ञापनों के लिए, यह सेटिंग डिफ़ॉल्ट रूप से AssetAutomationStatus.OPTED_IN स्टेटस पर सेट होती है. एपीआई के पिछले वर्शन में, नए विज्ञापनों के लिए यह सेटिंग डिफ़ॉल्ट रूप से AssetAutomationStatus.OPTED_OUT स्टेटस पर सेट होती है. एपीआई के v26 से पहले के वर्शन में इस सेटिंग के बारे में क्वेरी करने पर, एपीआई AssetAutomationType.UNKNOWN की enum वैल्यू दिखाता है. ज़्यादा जानकारी के लिए, विज्ञापन-लेवल पर ऐसेट के ऑटोमेशन की सेटिंग देखें.

कैंपेन
मांग बढ़ाने में मदद करने वाले कैंपेन के लिए, सीज़न के मुताबिक बिड घटाने या बढ़ाने की सुविधा ज़्यादा सहायता

मांग बढ़ाने में मदद करने वाले कैंपेन में BiddingSeasonalityAdjustment संसाधनों को लागू करने के लिए सहायता (बीटा वर्शन में) जोड़ी गई (सीज़न के मुताबिक बिड घटाने या बढ़ाने की सुविधा सेट अप करना देखें):

मांग बढ़ाने में मदद करने वाले कैंपेन के लिए, सीज़न के मुताबिक बिड घटाने या बढ़ाने की सुविधा, YouTube, Display, Gmail, और Maps इन्वेंट्री चैनलों पर लागू होती है. सीज़न के मुताबिक बिड घटाने या बढ़ाने वाले टूल का, डिस्कवर चैनल पर कोई असर नहीं पड़ता.

सामान्य
कई पक्षों से पुष्टि की सुविधा से जुड़ी गड़बड़ी के कोड नई enum वैल्यू और गड़बड़ियां

कई पक्षों से पुष्टि के लिए, गड़बड़ी के ये कोड जोड़े गए हैं:

  • MutateError.MULTI_PARTY_APPROVAL_UNSUPPORTED_RESOURCE_COMBINATION: यह गड़बड़ी तब दिखती है, जब GoogleAdsService.Mutate तरीके का इस्तेमाल करके किए गए अनुरोध में, एक से ज़्यादा पक्षों से अनुमति लेने की ज़रूरत वाली कार्रवाई के साथ-साथ, किसी ऐसे संसाधन पर कार्रवाई की जाती है जो काम नहीं करता.
  • MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST: यह गड़बड़ी, MultiPartyAuthReviewService.ResolveMultiPartyAuthReview तरीके से तब मिलती है, जब किसी ऐसे MultiPartyAuthReview संसाधन को हल किया जाता है जिसके टारगेट संसाधन में समीक्षा बनाने के बाद बदलाव किया गया हो या उसे मिटा दिया गया हो.
रिपोर्ट
ग्राहक-लेवल पर रीच रिपोर्टिंग, विज्ञापन फ़ॉर्मैट, और नेटवर्क को अलग-अलग सेगमेंट में बांटना अपडेट की गई मेट्रिक और सेगमेंट

इन यूनीक रीच और रीच मेट्रिक की स्थिति वाले फ़ील्ड के लिए ज़्यादा सहायता:

इन मेट्रिक को इन संसाधनों और सेगमेंट वाली क्वेरी में चुना जा सकता है:

  • customer रिसॉर्स के साथ, यूनीक रीच की इन मेट्रिक को चुनने की सुविधा जोड़ी गई है. यह सुविधा, campaign रिसॉर्स के साथ पहले से उपलब्ध है.
  • campaign और customer रिसॉर्स पर, Segments.ad_format_type, Segments.ad_sub_format_type, Segments.ad_network_type, और Segments.ad_sub_network_type सेगमेंट के हिसाब से, इन यूनीक रीच मेट्रिक को सेगमेंट करने की सुविधा जोड़ी गई है.
होटल बुकिंग की यात्रा की योजना और वर्टिकल विज्ञापन सेगमेंट के लिए, देश के हिसाब से टारगेट करने, कन्वर्ज़न ब्रेकडाउन, और क्रॉस-डिवाइस कन्वर्ज़न की सुविधा अपडेट की गई मेट्रिक और सेगमेंट

होटल बुकिंग की यात्रा की योजना और वर्टिकल विज्ञापनों के इन सेगमेंट के लिए, ज़्यादा रिपोर्टिंग सहायता (वर्टिकल विज्ञापनों की रिपोर्टिंग गाइड में दिए गए सेगमेंट कॉम्बिनेशन के नियमों के मुताबिक):

इन सेगमेंट का इस्तेमाल, इन अतिरिक्त संसाधनों, मेट्रिक, और सेगमेंट के साथ किया जा सकता है:

वर्शन 26.1 (28-10-2026)

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

सुविधाएं और अपडेट टाइप ब्यौरा
ऐसेट
प्रमोशन रिडीम करने की प्रोसेस को बाहरी तौर पर ट्रैक करना नए मैसेज, फ़ील्ड, enum, और गड़बड़ी

किसी प्रमोशन के लिए, बाहरी रिडेंप्शन ट्रैकिंग की जानकारी देने के लिए, ExternalRedeemInfo टाइप का इम्यूटेबल PromotionAsset.external_redeem_info फ़ील्ड जोड़ा गया:

साथ ही, AssetError.PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE गड़बड़ी का कोड जोड़ा गया है. एपीआई यह कोड तब दिखाता है, जब partner_promotion_id फ़ील्ड में ऐसे फ़ॉर्मैट का इस्तेमाल किया जाता है जिसे खाते का प्रमोशन इंटिग्रेशन स्वीकार नहीं करता.

कैंपेन
कैंपेन के बजट के लिए, वॉटरफ़ॉल चैनल को प्राथमिकता देने और बजट की सीमाएं तय करने की सुविधा नई सुविधाएं, संसाधन, सेवा, फ़ील्ड, और एनम

हमने वॉटरफ़ॉल चैनल को प्राथमिकता देने और कैंपेन के बजट पर बजट की सीमाएं तय करने की सुविधा जोड़ी है. इससे आपको यह कंट्रोल करने में मदद मिलती है कि नेटवर्क चैनलों (Google के मालिकाना हक वाली और उसके ज़रिए ऑपरेट की जाने वाली प्रॉपर्टी, सर्च पार्टनर नेटवर्क, और Google Display Network) पर बजट कैसे बांटा जाए. ज़्यादा जानकारी के लिए, चैनल को प्राथमिकता देने और बजट बांटने की सुविधा के बारे में ब्लॉग पोस्ट देखें.

माइग्रेट किए गए, मांग बढ़ाने में मदद करने वाले कैंपेन को चालू करने में गड़बड़ी नया enum और गड़बड़ी DemandGenCampaignError.CANNOT_ACTIVATE_MIGRATED_CAMPAIGN गड़बड़ी कोड के साथ DemandGenCampaignError enum जोड़ा गया. अगर आपने ओरिजनल कैंपेन को हटाए बिना, माइग्रेट किए गए मांग बढ़ाने में मदद करने वाले कैंपेन को चालू करने की कोशिश की, तो एपीआई यह गड़बड़ी दिखाता है. इसके अलावा, अगर उसी ओरिजनल कैंपेन के लिए माइग्रेट किया गया कोई दूसरा कैंपेन चालू है, तो भी यह गड़बड़ी दिखती है.
सामान्य
Local Services की ज़रूरी शर्तें, सेवा, और कैटगरी की जानकारी नई सेवा, मैसेज, और फ़ील्ड

किसी ग्राहक और Google Business Profile लिस्टिंग आईडी (CheckLocalServicesEligibilityRequest) के लिए, Local Services की ज़रूरी शर्तें पूरी करने की जानकारी देखने के लिए, LocalServicesEligibilityService.CheckLocalServicesEligibility तरीके के साथ LocalServicesEligibilityService सेवा जोड़ी गई. CheckLocalServicesEligibilityResponse मैसेज यह दिखाता है:

  • eligible: इससे पता चलता है कि ग्राहक, Local Services का इस्तेमाल कर सकता है या नहीं.
  • eligible_goals (EligibleGoal टाइप का): यह हर ज़रूरी शर्त पूरी करने वाले लीड टाइप (EligibleGoal.lead_type) को, ज़रूरी शर्त पूरी करने वाली सेवा की कैटगरी (EligibleCategory टाइप का EligibleGoal.categories) से मैप करता है. इसमें हर कैटगरी का आईडी (category_id), डिसप्ले नेम (display_name), उपलब्ध जॉब टाइप आईडी (job_types), और कारोबार के कॉलआउट आईडी (callouts) शामिल हैं.
  • suggestion_reasons (SuggestionReason टाइप का): इससे ज़रूरी शर्तें पूरी न होने की वजहों (जैसे, लाइसेंस से जुड़ी समस्याएं) के बारे में कम शब्दों में और पूरी जानकारी देने वाले टेक्स्ट (short_text और long_text) मिलते हैं.
Local Services के लिए, रिडैम्पशन की सुविधा देने वाली बाहरी कंपनी की सेटिंग अपडेट किया गया फ़ील्ड, नए मैसेज, और नए फ़ील्ड Customer.local_services_settings फ़ील्ड को OUTPUT_ONLY से बदलकर, म्यूटेबल किया गया. साथ ही, Local Services खाते के लिए, कूपन रिडीम करने की सुविधा देने वाली बाहरी कंपनी को कॉन्फ़िगर करने के लिए, RedemptionProviderInfo टाइप का LocalServicesSettings.redemption_provider_info फ़ील्ड जोड़ा गया है. इस मैसेज में RedemptionProviderInfo.external_merchant_id फ़ील्ड मौजूद है. यह ExternalPartnerMerchantId टाइप का ज़रूरी फ़ील्ड है. इसमें कारोबारी या कंपनी का आईडी मौजूद होता है. यह आईडी, पूर्णांक (numeric_id) या 1 से 50 वर्णों की स्ट्रिंग (alphanumeric_id) के तौर पर हो सकता है.
सुझाव
नए ग्राहकों के लिए ऑप्टिमाइज़ करने का सुझाव नया सुझाव

नए ग्राहक हासिल करने के लिए, कैंपेन को ऑप्टिमाइज़ करने के मकसद से, RecommendationType.OPTIMIZE_FOR_NEW_CUSTOMERS की एनम वैल्यू और ये फ़ील्ड जोड़े गए हैं. इनमें इंक्रीमेंटल कन्वर्ज़न वैल्यू को खाते की स्थानीय मुद्रा की स्टैंडर्ड यूनिट में दिखाया जाता है, न कि माइक्रोस में:

रिपोर्ट
रीच रिपोर्टिंग की फ़्रीक्वेंसी बकेट और मेट्रिक की स्थिति की जानकारी नई मेट्रिक, मैसेज, और enum

Metrics मैसेज में ये मेट्रिक जोड़ी गई हैं. इससे रीच रिपोर्टिंग के लिए, N+ फ़्रीक्वेंसी बकेट (1+ से 10+ तक) का सेट पूरा हो गया है:

साथ ही, हर यूनीक उपयोगकर्ता मेट्रिक के लिए, राज्य की अतिरिक्त जानकारी देने के लिए, Metrics मैसेज में ये ReachMetricInfo मेट्रिक जोड़ी गई हैं. जैसे, जब निजता या क्वालिटी की वजहों से किसी वैल्यू को छिपाया जाता है, तो ReachMetricState टाइप का ReachMetricInfo.reach_metric_states फ़ील्ड:

होटल बुकिंग की यात्रा की योजना और वर्टिकल विज्ञापन सेगमेंट के लिए, खोज नतीजों में सबसे ऊपर दिखने के अनुपात और खोज नतीजों में क्लिक शेयर की सुविधा अपडेट की गई मेट्रिक और सेगमेंट

Metrics.search_top_impression_share और Metrics.search_click_share मेट्रिक के लिए ज़्यादा सहायता उपलब्ध कराई गई है, ताकि आप उन्हें होटल बुकिंग की यात्रा की योजना और वर्टिकल विज्ञापन के इन सेगमेंट के साथ चुन सकें:

टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना)
परफ़ॉर्मेंस मैक्स कैंपेन में पारिवारिक आमदनी से जुड़े एक्सक्लूज़न ज़्यादा सहायता परफ़ॉर्मेंस मैक्स कैंपेन में, पारिवारिक आमदनी के आधार पर टारगेटिंग से बाहर रखने की सुविधा जोड़ी गई है. income_range फ़ील्ड सेट के साथ नेगेटिव CampaignCriterion रिसॉर्स बनाकर, पारिवारिक आमदनी की सीमाओं को बाहर रखें.

वर्शन 26 (14-10-2026)

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

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

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

प्रारंभिक स्थिति नई स्थिति बदलाव का टाइप लागू करने के लिए सलाह
कैंपेन
LocalServicesPmaxCampaignSettings में country_code फ़ील्ड ज़रूरी नहीं है Local Services के लिए परफ़ॉर्मेंस मैक्स कैंपेन (LocalServicesPmaxCampaignSettings.country_code) बनाते समय यह फ़ील्ड ज़रूरी है व्यवहार में बदलाव Local Services के लिए परफ़ॉर्मेंस मैक्स कैंपेन बनाते समय, पक्का करें कि आपने country_code के साथ-साथ, हाल ही में ज़रूरी किए गए listing_id की जानकारी दी हो.
कन्वर्ज़न
ConversionTrackingSetting (Customer.conversion_tracking_setting) में enhanced_conversions_for_leads_enabled फ़ील्ड कोई नहीं कॉन्टेंट हटाना खाता-लेवल पर बेहतर कन्वर्ज़न ट्रैकिंग की सेटिंग की जांच करने के लिए, Customer.conversion_tracking_setting पर ConversionTrackingSetting.enablement_setting का इस्तेमाल करें.
टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना)
AdGroupBidModifier में होटल के हिसाब से ज़रूरी शर्त वाले फ़ील्ड:
  • hotel_date_selection_type
  • hotel_advance_booking_window
  • hotel_length_of_stay (min_nights और max_nights)
  • hotel_check_in_day
  • hotel_check_in_date_range
AdGroupBidModifier में वर्टिकल-एग्नोस्टिक क्राइटेरिया फ़ील्ड: नाम बदलना / हटाना वर्टिकल-एग्नोस्टिक क्राइटेरिया फ़ील्ड का इस्तेमाल करने के लिए, रेफ़रंस अपडेट करें. ये फ़ील्ड, होटल कैंपेन और यात्रा के लिए सर्च कैंपेन में सिर्फ़ होटल विज्ञापनों के लिए काम करते हैं. क्राइटेरिया आईडी, टारगेटिंग का तरीका, और मौजूदा बिड मॉडिफ़ायर में कोई बदलाव नहीं होता. साथ ही, min_nights और max_nights की वैल्यू, बिना किसी बदलाव के min_days और max_days में ट्रांसफ़र हो जाती हैं. ज़्यादा जानकारी के लिए, बिड मॉडिफ़ायर की मदद से बिड अडजस्ट करना लेख पढ़ें.
HotelDateSelectionType और segments.user_set_dates का टाइप DateSelectionType नाम बदलना / टाइप बदलना user_set_dates बिड मॉडिफ़ायर और segments.user_set_dates के लिए, HotelDateSelectionType के बजाय DateSelectionType का इस्तेमाल करें.
CriterionError में होटल से जुड़ी गड़बड़ी की वजहें:
  • HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY
  • HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE
  • HOTEL_CHECK_IN_DATE_RANGE_REVERSED
CriterionError में, वर्टिकल-एग्नोस्टिक गड़बड़ी की वजहें: नाम बदलें गड़बड़ी को मैनेज करने की प्रोसेस को अपडेट करें, ताकि गड़बड़ी की नई वजहों का पता लगाया जा सके. ये वजहें, वर्टिकल के हिसाब से अलग-अलग नहीं होती हैं.

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

सुविधाएं और अपडेट टाइप ब्यौरा
ऐसेट
LINE और एसएमएस के ज़रिए, कारोबार को मैसेज भेजने की सुविधा देने वाली कंपनियां नए फ़ील्ड और enum वैल्यू BusinessMessageAsset में, मैसेज की सेवा देने वाली कंपनियों के तौर पर LINE और एसएमएस के लिए सहायता जोड़ी गई. इसमें नए फ़ील्ड BusinessMessageAsset.line_info और BusinessMessageAsset.sms_info के साथ-साथ BusinessMessageProvider.LINE और BusinessMessageProvider.SMS भी शामिल हैं.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY नई enum वैल्यू / गड़बड़ी इसे AssetGroupError में जोड़ा गया है, ताकि यह बताया जा सके कि GoogleLocalServicesInfo (AssetGroup.google_local_services_info) में बताई गई कैटगरी, Local Services के परफ़ॉर्मेंस मैक्स कैंपेन के लिए काम नहीं करती.
कैंपेन
Local Services के लिए परफ़ॉर्मेंस मैक्स कैंपेन बनाना नई सुविधाएं, फ़ील्ड, और गड़बड़ी

PmaxCampaignSettings.local_services_enabled को OUTPUT_ONLY से IMMUTABLE पर अपडेट किया गया. इससे बाहरी एपीआई क्लाइंट, Local Services के लिए परफ़ॉर्मेंस मैक्स कैंपेन बनाते समय local_services_enabled = true की जानकारी दे सकते हैं.

हमने LocalServicesPmaxCampaignSettings.listing_id को भी जोड़ा है, ताकि Local Services के परफ़ॉर्मेंस मैक्स कैंपेन से लिंक की गई Google Business Profile लिस्टिंग का आईडी दिखाया जा सके. Local Services के परफ़ॉर्मेंस मैक्स कैंपेन को बनाते समय, इस आईडी को 'ज़रूरी है' के तौर पर मार्क किया जाता है. साथ ही, हमने CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID गड़बड़ी का कोड भी जोड़ा है.

Local Services कैंपेन की पुष्टि से जुड़ी गड़बड़ियां नई enum वैल्यू और गड़बड़ियां Local Services कैंपेन के लिए, पुष्टि करने से जुड़ी नई गड़बड़ियां जोड़ी गई हैं:
Hotel Center खाते के लिंक की पुष्टि करना नई enum वैल्यू / गड़बड़ी CampaignError में CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED गड़बड़ी का कोड जोड़ा गया है. इससे यह पता चलता है कि होटल प्रॉपर्टी ऐसेट सेट (Campaign.hotel_property_asset_set) को यात्रा के लक्ष्यों के लिए परफ़ॉर्मेंस मैक्स कैंपेन से लिंक करने के लिए, एक चालू Hotel Center खाता लिंक होना ज़रूरी है.
मांग बढ़ाने में मदद करने वाले कैंपेन के लिए, हर दिन का कम से कम बजट नया फ़ील्ड CurrencyConstant में demand_gen_info.minimum_budget_per_day_micros फ़ील्ड जोड़ा गया है. इससे, उस मुद्रा में मांग बढ़ाने में मदद करने वाले कैंपेन के लिए, हर दिन के लिए ज़रूरी कम से कम बजट की जानकारी मिलती है. एपीआई की ओर से लागू किए गए कम से कम बजट में बदलाव होने पर, इस फ़ील्ड की वैल्यू अपडेट हो जाती है.
कैंपेन के लिए, विज्ञापन के असर को मेज़र करने का कॉन्फ़िगरेशन नया फ़ील्ड कैंपेन से जुड़े लिफ़्ट मेज़रमेंट कॉन्फ़िगरेशन के संसाधन का नाम दिखाने के लिए, Campaign.lift_measurement_config को जोड़ा गया.
एआई मैक्स वाले एक्सपेरिमेंट की पुष्टि करना नई enum वैल्यू / गड़बड़ी ExperimentArmError में ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED गड़बड़ी का कोड जोड़ा गया. ऐसा तब हुआ, जब किसी ऐसे कैंपेन के लिए ADOPT_AI_MAX एक्सपेरिमेंट बनाने की कोशिश की गई जिसमें एआई मैक्स की सुविधा पहले से चालू है या एक्सपेरिमेंट ग्रुप बनाने से पहले, उसी अनुरोध में यह सुविधा चालू की गई है.
शॉपिंग कैंपेन की लिस्टिंग का टाइप ज़्यादा सहायता शॉपिंग कैंपेन के लिए, Campaign.listing_type की सुविधा को ज़्यादा देशों में उपलब्ध कराया गया.
ईयू में राजनैतिक विज्ञापन दिखाने के लिए, खुद के एलान से जुड़े अपडेट अपडेट किया गया व्यवहार और नए फ़ील्ड

Campaign.contains_eu_political_advertising अब उन कैंपेन के लिए ज़रूरी नहीं है जो यूरोपियन यूनियन को टारगेट नहीं करते.

  • अपग्रेड की गई टारगेटिंग वाले DEMAND_GEN कैंपेन के अलावा, अगर कोई कैंपेन अनुरोध पूरा होने के बाद इन सभी शर्तों को पूरा करता है, तो यह फ़ील्ड ज़रूरी नहीं है:
    • इसमें ईयू में मौजूद, जगह के हिसाब से टारगेटिंग का कोई पॉज़िटिव कैंपेन क्राइटेरिया शामिल न हो
    • इसमें पॉज़िटिव प्रॉक्सिमिटी या लोकेशन ग्रुप कैंपेन की कोई शर्त शामिल नहीं है
    • इसमें ईयू से बाहर की कम से कम एक ऐसी जगह को टारगेट किया गया हो जिसे कैंपेन के लिए चुना गया है
  • upgraded_targeting वाले DEMAND_GEN कैंपेन के लिए, यह फ़ील्ड ज़रूरी नहीं है. हालांकि, इसके लिए ज़रूरी है कि अनुरोध पूरा होने के बाद, कैंपेन में मौजूद हर चालू विज्ञापन ग्रुप, इन सभी शर्तों को पूरा करता हो:
    • इसमें ईयू में मौजूद, जगह की जानकारी के लिए विज्ञापन ग्रुप की कोई पॉज़िटिव शर्त शामिल नहीं है
    • इसमें विज्ञापन ग्रुप के लिए, पॉज़िटिव प्रॉक्सिमिटी या लोकेशन ग्रुप की कोई शर्त शामिल नहीं है
    • इसमें कम से कम एक ऐसा पॉज़िटिव लोकेशन विज्ञापन ग्रुप क्राइटेरियन शामिल है जो ईयू से बाहर का है
    यह फ़ील्ड उन कैंपेन के लिए भी ज़रूरी नहीं है जिनमें कोई चालू विज्ञापन ग्रुप नहीं है. अगर किसी अनुरोध से ऐसा विज्ञापन ग्रुप बनता है जो इन शर्तों को पूरा नहीं करता, तो AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION दिखता है.
  • ये बदलाव, नए और मौजूदा, दोनों तरह के कैंपेन पर लागू होंगे. कुछ मामलों में, नया कैंपेन सिर्फ़ तब बनाया जा सकता है, जब उसी अनुरोध में शर्तें जोड़ी गई हों — म्यूटेट को ग्रुप करने के लिए GoogleAdsService.Mutate का इस्तेमाल करें.
  • Campaign.contains_eu_political_advertising में किए गए बदलावों के हिसाब से, Campaign.missing_eu_political_advertising_declaration को अपडेट किया गया.
  • GeoTargetConstant.require_eu_political_advertising_declaration को जोड़ा गया, ताकि यह पता चल सके कि कोई जगह ईयू में है या नहीं.
  • CampaignCriterion.require_eu_political_advertising_declaration और AdGroupCriterion.require_eu_political_advertising_declaration को जोड़ा गया. अगर यह फ़ील्ड, कैंपेन में मौजूद किसी भी कैंपेन-लेवल की शर्त के लिए true है, तो Campaign.contains_eu_political_advertising ज़रूरी है. इसके अलावा, अपग्रेड की गई टारगेटिंग वाले DEMAND_GEN कैंपेन में, विज्ञापन ग्रुप लेवल की किसी भी चालू शर्त के लिए भी यह ज़रूरी है. अगर शर्त का negative फ़ील्ड false है और शर्त ईयू में मौजूद कोई जगह, आस-पास की कोई जगह (चाहे वह ईयू के इलाके से ओवरलैप होती हो या नहीं) या कोई लोकेशन ग्रुप (चाहे वह ईयू के इलाके से ओवरलैप होता हो या नहीं) है, तो फ़ील्ड true दिखाते हैं.
कन्वर्ज़न
बेहतर कन्वर्ज़न ट्रैकिंग की सुविधा का यूनिफ़ाइड कॉन्फ़िगरेशन नए फ़ील्ड और enum खाते के लिए, बेहतर कन्वर्ज़न ट्रैकिंग के यूनिफ़ाइड कॉन्फ़िगरेशन को दिखाने के लिए, ConversionTrackingSetting.enablement_setting और ConversionTrackingSetting.effective_enablement_setting (Customer.conversion_tracking_setting को) जोड़े गए. इसे नए EnhancedConversionsConfig enum का इस्तेमाल करके दिखाया गया है.
ConversionActionCategory.MESSAGE_LEAD नई enum वैल्यू इसे ConversionActionCategory में जोड़ा गया है, ताकि मैसेज या चैट इंटरैक्शन को सपोर्ट किया जा सके. इससे विज्ञापन देने वाले व्यक्ति या कंपनी के ऑफ़र में दिलचस्पी का पता चलता है.
ConversionAttributionEventType.CLICK नई enum वैल्यू विज्ञापन पर क्लिक से मिले कन्वर्ज़न दिखाने के लिए, ConversionAttributionEventType में जोड़ा गया. ये कन्वर्ज़न पहले UNKNOWN की enum वैल्यू में शामिल थे.
सामान्य
Local Services से मिली लीड के बारे में अपडेट नया फ़ील्ड और enum वैल्यू
  • किसी लीड को उससे जुड़े कैंपेन से लिंक करने के लिए, LocalServicesLead रिसॉर्स में LocalServicesLead.campaign फ़ील्ड जोड़ा गया.
  • Local Services के लिए कूपन लीड टाइप की सुविधा देने के लिए, LocalServicesLeadType में COUPON जोड़ा गया.
सुझाव
Search के लिए बजट बढ़ाने का सुझाव नया सुझाव सर्च कैंपेन के लिए रोज़ का बजट बहुत कम होने पर, बजट बढ़ाने के लिए RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation, और ApplyRecommendationOperation.raise_budget_performance_too_low जोड़े गए.
रिपोर्ट
खोज में बढ़त के मेज़रमेंट नई सुविधाएं, संसाधन, सेगमेंट, और मेट्रिक खोज में बढ़त के मेज़रमेंट के लिए सहायता जोड़ी गई:
  • खोज में बढ़त की जांच में कीवर्ड बंडल को दिखाने के लिए, सिर्फ़ पढ़ने के लिए उपलब्ध नया संसाधन SearchLiftKeywordBundle जोड़ा गया.
  • segments.search_lift_keyword_bundle और segments.search_property जैसे नए सेगमेंट जोड़े गए हैं जिन्हें चुना जा सकता है. साथ ही, खोज में बढ़त की 15 नई मेट्रिक जोड़ी गई हैं. जैसे, relative_search_lift, normalized_incremental_searches, search_lift_cost_micros, और search_lift_impressions. इनसे LiftMeasurementConfig की मदद से, खोज में बढ़त का विश्लेषण करने में मदद मिलती है. ये मेट्रिक, Campaign.lift_measurement_config का इस्तेमाल करने वाले कैंपेन से लिंक होती हैं.
  • SearchLiftKeywordBundleStatus, SearchLiftMatchingInfoSource, और SearchLiftSearchProperty enum जोड़े गए.
शॉपिंग कैंपेन के लिए, फ़ाइनल यूआरएल एक्सपैंशन की ऐसेट का व्यू ज़्यादा सहायता शॉपिंग कैंपेन के साथ काम करने के लिए, final_url_expansion_asset_view को बड़ा किया गया. इसमें final_url_expansion_asset_view.ad_group के साथ-साथ, ad_group को एट्रिब्यूट किए गए संसाधन के तौर पर चुना जा सकता है.
वीडियो
YouTube पर जनरेटिव एआई से बनाए गए कॉन्टेंट के बारे में जानकारी देना नए फ़ील्ड और enum YouTube पर अपलोड किए जाने वाले वीडियो के लिए, जनरेटिव कॉन्टेंट के बारे में जानकारी देने की सुविधा जोड़ी गई. VideoContentMetadata टाइप का नया फ़ील्ड YouTubeVideoUpload.video_content_metadata, YouTubeVideoUpload में जोड़ दिया गया है. इसमें YouTubeVideoUploadGenerativeContentDisclosure टाइप के VideoContentMetadata.generative_content_disclosure में, जानकारी ज़ाहिर करने की सेटिंग शामिल हैं.

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

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

v25.2 (23-09-2026)

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

सुविधाएं और अपडेट टाइप ब्यौरा
ऐसेट
AssetGroup के लिए यूआरएल के विकल्प नए फ़ील्ड AssetGroup पर यूआरएल के विकल्पों के लिए सहायता जोड़ी गई है. इससे विज्ञापन देने वाले लोग या कंपनियां, ऐसेट ग्रुप के लेवल पर ट्रैकिंग टेंप्लेट, कस्टम पैरामीटर, और फ़ाइनल यूआरएल के सफ़िक्स तय कर सकती हैं:
  • AssetGroup.tracking_url_template: ट्रैकिंग यूआरएल बनाने के लिए यूआरएल टेंप्लेट.
  • AssetGroup.url_custom_parameters: मैपिंग की एक सूची, जिसका इस्तेमाल tracking_url_template, final_urls या final_mobile_urls में यूआरएल के कस्टम पैरामीटर टैग को बदलने के लिए किया जाता है.
  • AssetGroup.final_url_suffix: यह यूआरएल टेंप्लेट, पैरलल ट्रैकिंग के साथ दिखाए जाने वाले लैंडिंग पेज यूआरएल में पैरामीटर जोड़ने के लिए है.
कैंपेन
वीडियो को अपने-आप क्रॉल करने की सुविधा के बारे में जानकारी नए फ़ील्ड और enum Campaign.AssetAutomationSetting में AutomatedVideoCrawlSetting और AssetAutomationType.AUTOMATED_VIDEO_CRAWL को जोड़ा गया है. इससे परफ़ॉर्मेंस मैक्स कैंपेन के लिए, वीडियो को अपने-आप क्रॉल करने की सेटिंग तय की जा सकती है. AutomatedVideoCrawlSetting.automated_video_crawl_infos में AutomatedVideoCrawlInfo एंट्री की सूची होती है. हर एंट्री, क्रॉल url, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL या YOUTUBE), और enabled के शामिल होने के स्टेटस को कॉन्फ़िगर करती है.
कस्टमर लाइफ़साइकल ऑप्टिमाइज़ेशन के लिए वैल्यू मल्टीप्लायर से जुड़ी गड़बड़ियां नई enum वैल्यू और गड़बड़ियां ग्राहक के लाइफ़साइकल को ऑप्टिमाइज़ करने के लिए, वैल्यू मल्टीप्लायर (value_multiplier और high_lifetime_value_multiplier) को कॉन्फ़िगर करते समय, पुष्टि करने से जुड़ी गड़बड़ी की नई वजहें जोड़ी गई हैं:
SmartCampaignSettingService.GeneratePMaxDraftCampaign नई सुविधा मौजूदा स्मार्ट कैंपेन से परफ़ॉर्मेंस मैक्स कैंपेन का ड्राफ़्ट जनरेट करने के लिए, SmartCampaignSettingService.GeneratePMaxDraftCampaign को जोड़ा गया. इसे CampaignStatus.PAUSED स्टेटस और CampaignCreationStatus.INCOMPLETE क्रिएशन स्टेटस के साथ शुरू किया गया. इसके बारे में ज़्यादा जानने के लिए, स्मार्ट कैंपेन को परफ़ॉर्मेंस मैक्स कैंपेन में बदलना लेख पढ़ें:
कन्वर्ज़न
Firebase विज्ञापन इंप्रेशन नए कन्वर्ज़न ऐक्शन टाइप और कैटगरी FIREBASE_ANDROID_APP_AD_IMPRESSION और FIREBASE_IOS_APP_AD_IMPRESSION कन्वर्ज़न ऐक्शन टाइप को एक्सपोज़ किया गया है. इससे आपको इन कन्वर्ज़न ऐक्शन को वापस पाने और उनमें बदलाव करने की सुविधा मिलती है. इन-ऐप्लिकेशन विज्ञापन से होने वाली कमाई को ट्रैक करने के लिए, ConversionActionCategory में IN_APP_AD_REVENUE कैटगरी को भी दिखाया गया है.
सामान्य
BusinessProfileLocationSyncError नए enum और गड़बड़ियां LOCATION_SYNC टाइप के AssetSet में जगहों की जानकारी सिंक करते समय, Business Profile में जगह की जानकारी सिंक करने में गड़बड़ी की वजहें जोड़ी गई हैं. अब एपीआई, सामान्य UNKNOWN गड़बड़ी दिखाने के बजाय, खास वजहों (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED, और NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT) के साथ BusinessProfileLocationSyncError दिखाता है.
प्लानिंग
BenchmarksService.GenerateBenchmarksMetrics पर्सेंटाइल मेट्रिक नई सुविधाएं

BenchmarksService.GenerateBenchmarksMetrics को अपडेट किया गया, ताकि विज्ञापन देने वाले अन्य लोगों या कंपनियों के मुकाबले, ग्राहक की परफ़ॉर्मेंस को पर्सेंटाइल टियर फ़ॉर्मैट में दिखाने वाली मेट्रिक उपलब्ध कराई जा सकें. मेट्रिक, नए CustomerMetrics.percentile_metrics फ़ील्ड (GenerateBenchmarksMetricsResponse.customer_metrics और BreakdownMetrics.customer_metrics, दोनों पर) में PercentileMetrics में दिखाई जाती हैं. साथ ही, इन्हें BenchmarksCustomerPercentileTier का इस्तेमाल करके दिखाया जाता है.

CustomerMetrics.percentile_metrics में डेटा सिर्फ़ तब दिखता है, जब GenerateBenchmarksMetricsRequest में ये दोनों शर्तें पूरी होती हैं:

ListBenchmarksAvailableDatesResponse.supported_dates में मौजूद, चालू तिमाही की तारीखों के लिए पर्सेंटाइल मेट्रिक की सुविधा जोड़ी गई है. इसे BenchmarksService.ListBenchmarksAvailableDates से वापस किया गया है. ग्राहक की एग्रीगेट मेट्रिक (CustomerMetrics.aggregate_metrics), ग्राहक की रेट मेट्रिक (CustomerMetrics.average_rate_metrics), और ग्राहक की पर्सेंटाइल मेट्रिक (CustomerMetrics.percentile_metrics) supported_dates में मौजूद सभी तारीखों के लिए काम करती हैं. इनमें चालू तिमाही भी शामिल हैं. हालांकि, ग्राहक की शेयर मेट्रिक (CustomerMetrics.share_metrics) और मानदंड के सोर्स की रेट मेट्रिक (average_benchmarks_metrics, जैसे कि "/Apparel/Clothing" विज्ञापनों का average_cpm), चालू तिमाही के लिए काम नहीं करती हैं. साथ ही, इन्हें जवाब से हटा दिया जाता है. हालांकि, अगर अनुरोध किया गया date_range, ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics की छोटी रेंज में आता है, तो ऐसा नहीं किया जाता.

हमने गड़बड़ी का एक कस्टम कोड BenchmarksError.NO_METRICS_FOUND जोड़ा है. इससे पता चलता है कि इनपुट के चुने गए कॉम्बिनेशन के लिए कोई मेट्रिक नहीं मिली. इससे, इस टूल को इस्तेमाल करना आसान हो जाता है.

क्रिएटर के बारे में अहम जानकारी पाने के लिए, YouTube चैनल के हैंडल नई सुविधा ContentCreatorInsightsService.GenerateCreatorInsights को अपडेट किया गया, ताकि YouTubeChannels.youtube_channel_handles का इस्तेमाल करके, YouTube चैनल के हैंडल खोजे जा सकें. मान्य चैनल हैंडल, @ से शुरू होने चाहिए, जैसे कि @channel_handle. यह विकल्प, YouTube चैनल आईडी से खोजने के विकल्प जैसा ही है. जवाब में, अनुरोध किए गए YouTube क्रिएटर्स के बारे में अहम जानकारी शामिल होती है.
सुझाव
सीपीए और आरओएएस बिड के सुझाव नए सुझाव सर्च कैंपेन के लिए बिड बहुत कम होने पर, टारगेट सीपीए को बढ़ाने या टारगेट आरओएएस को कम करने के लिए, Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) और Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW) के साथ-साथ ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low और ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low को जोड़ा गया है:
रिपोर्ट
होटल में ठहरने की योजना के डाइमेंशन वाले सेगमेंट नए सेगमेंट Segments में होटल और यात्रा की बुकिंग की योजना के डाइमेंशन सेगमेंट जोड़े गए हैं. इन्हें campaign, ad_group, और customer के साथ चुना जा सकता है:
  • Segments.advance_booking_window: यात्रा की योजना के लिए, पहले से बुकिंग करने की विंडो. इसे दिनों में दिखाया जाता है.
  • Segments.length_of_booking: यात्रा की योजना के लिए, बुकिंग की अवधि दिनों में.
  • Segments.start_date: बुकिंग शुरू होने की तारीख. इसे yyyy-MM-dd के तौर पर फ़ॉर्मैट किया गया है.
  • Segments.start_day_of_week: बुकिंग के लिए, हफ़्ते का शुरुआती दिन (DayOfWeek).
  • Segments.user_set_dates: इससे पता चलता है कि उपयोगकर्ता की चुनी गई तारीखें चुनी गई थीं या नहीं (HotelDateSelectionType).
वर्टिकल विज्ञापनों की मेट्रिक नई मेट्रिक होटल और यात्रा से जुड़े वर्टिकल विज्ञापनों की रिपोर्टिंग के लिए, Metrics में ये मेट्रिक जोड़ी गई हैं. इन्हें campaign, ad_group, और customer के साथ चुना जा सकता है:
  • Metrics.vertical_ads_average_booking_value_micros: होटल बुकिंग के लिए, ठहरने की कुल अवधि के दौरान, हर दिन के किराये का क्लिक-वेटेड औसत. यह माइक्रो में होता है. इसमें टैक्स और शुल्क शामिल होते हैं.
  • Metrics.vertical_ads_potential_impressions: क्वेरी के संदर्भ में उपलब्ध, व्यू-कैप वाले कुल अनुमानित इंप्रेशन.
  • Metrics.vertical_ads_price_difference_percentage: विज्ञापन देने वाले व्यक्ति या कंपनी के ऑफ़र किए गए किराये और उसी प्रॉपर्टी के लिए, विज्ञापन देने वाले किसी अन्य व्यक्ति या कंपनी के ऑफ़र किए गए सबसे कम किराये के बीच का अंतर.
वर्टिकल विज्ञापनों के सेगमेंट नए सेगमेंट होटल और यात्रा वर्टिकल विज्ञापनों की रिपोर्टिंग के लिए, Segments में ये सेगमेंट जोड़े गए हैं. इन्हें campaign, ad_group, और customer की मदद से चुना जा सकता है:
  • Segments.vertical_ads_price_tier: नीलामी में हिस्सा लेने वाले प्रतिस्पर्धियों की तुलना में, विज्ञापन देने वाले व्यक्ति या कंपनी का प्राइस टियर (HotelPriceBucket).
  • Segments.vertical_ads_rate_rule_id: विज्ञापन देने वाले व्यक्ति या कंपनी के रेट रूल से जुड़ा रेट रूल आईडी.
  • Segments.vertical_ads_rate_type: होटल की बुकिंग के लिए, किराये का टाइप (HotelRateType).

v25.1 (19-08-2026)

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

सुविधाएं और अपडेट टाइप ब्यौरा
ऐसेट
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER
नई enum वैल्यू टेक्स्ट डिसक्लेमर वाली एसेट के लिए सहायता जोड़ी गई.
कैंपेन
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time
नए फ़ील्ड एआई मैक्स पर अपने-आप होने वाले माइग्रेशन को ट्रैक करें.
कन्वर्ज़न
ब्रैंड पर विज्ञापन के असर का मेज़रमेंट नई सुविधाएं इन अपडेट के साथ, ब्रैंड पर विज्ञापन के असर के मेज़रमेंट के लिए सहायता जोड़ी गई है:
कन्वर्ज़न लिफ़्ट मेज़रमेंट नई सुविधाएं इन अपडेट के साथ, कन्वर्ज़न लिफ़्ट मेज़रमेंट के लिए सहायता जोड़ी गई है:
  • लिफ़्ट स्टडी को दिखाने वाला, रीड-ओनली मोड वाला नया संसाधन LiftMeasurementConfig जोड़ा गया.
  • लिफ़्ट के नतीजों को सेगमेंट और फ़िल्टर करने के लिए, चुने जा सकने वाले नए सेगमेंट जोड़े गए.
  • कन्वर्ज़न लिफ़्ट की 24 नई मेट्रिक और विनर स्कोर मेट्रिक जोड़ी गई हैं. इनसे लिफ़्ट की परफ़ॉर्मेंस का ज़्यादा बारीकी से विश्लेषण किया जा सकता है.
  • कैंपेन की जानकारी और कन्वर्ज़न लक्ष्यों को वापस पाने की सुविधा जोड़ी गई.
  • एक नया वैकल्पिक फ़ील्ड Experiment.lift_measurement_config जोड़ा गया.
  • ConversionLiftIncludedConversionActionTypes enum जोड़ा गया.
LiftMeasurementFlight नया संसाधन रीड-ओनली मोड वाला एक नया संसाधन, जो विज्ञापन के असर को मेज़र करने के कॉन्फ़िगरेशन के लिए, फ़्लाइट की जानकारी दिखाता है. इसमें मेज़र की गई फ़्लाइट के शुरू और खत्म होने की तारीखें (start_date और end_date) शामिल हैं.
सामान्य
SmartCampaignError नई enum वैल्यू परफ़ॉर्मेंस मैक्स कैंपेन के लिए, ऐसेट जनरेट करने से जुड़ी पाबंदियों के लिए गड़बड़ी के नए कोड जोड़े गए हैं:
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION नई enum वैल्यू / गड़बड़ी यह गड़बड़ी तब दिखती है, जब TEST ऐक्सेस लेवल वाला कोई Google Cloud प्रोजेक्ट, टेस्ट खाते के अलावा किसी अन्य खाते से अनुरोध करने की कोशिश करता है.
प्लानिंग
ब्रैंड के बारे में लोगों की राय से जुड़ी अहम जानकारी नई सुविधाएं ContentCreatorInsightsService में, ब्रैंड के बारे में लोगों की राय से जुड़ी अहम जानकारी पाने की सुविधा जोड़ी गई है:
BenchmarksService को बेहतर बनाने की सुविधा नई सुविधाएं बेंचमार्क विश्लेषण के स्कोप के लिए, फ़िल्टर के तौर पर कैटगरी की सुविधा जोड़ी गई है. कारोबार के लिए ज़रूरी अन्य मेट्रिक भी उपलब्ध हैं:
  • BenchmarksService.GenerateBenchmarksMetrics और category_filter का इस्तेमाल करके, प्रॉडक्ट और सेवा की एक या उससे ज़्यादा कैटगरी में विज्ञापन दिखाने वाले सभी विज्ञापन देने वालों के लिए, मानदंड तय करने का विकल्प जोड़ा गया है.
  • ग्राहक के विज्ञापन की ज़्यादा मेट्रिक दिखाएं. जैसे, ग्राहक की कुल लागत और व्यू. साथ ही, share_of_voice जैसी मेट्रिक शेयर करें. मेट्रिक, AggregateMetrics और ShareMetrics का इस्तेमाल करके दिखाई जाती हैं.
  • इस्तेमाल की जा सकने वाली कैटगरी की सूची को BenchmarksService.ListBenchmarksSources का इस्तेमाल करके, CATEGORY सोर्स टाइप के साथ वापस पाया जा सकता है.
माता-पिता/अभिभावक हैं या नहीं, इसके आधार पर टारगेटिंग नई सुविधा रीच प्लानिंग में, माता-पिता/अभिभावक होने के आधार पर टारगेटिंग करने की सुविधा जोड़ी गई. 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 (22-07-2026)

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

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

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

प्रारंभिक स्थिति नई स्थिति बदलाव का टाइप लागू करने के लिए सलाह
कैंपेन
CustomerLifecycleOptimizationValueSettings में स्टैंडअलोन फ़ील्ड additional_value और additional_high_lifetime_value ये क्रमशः value_adjustment और high_lifetime_value_adjustment oneofs के हिस्से हैं. साथ ही, इनमें नए value_multiplier और high_lifetime_value_multiplier फ़ील्ड भी शामिल हैं स्ट्रक्चरल बदलाव इन फ़ील्ड के रेफ़रंस अपडेट करें, क्योंकि ये अब oneofs का हिस्सा हैं.
लेगसी CustomerLifecycleGoal और CampaignLifecycleGoal संसाधन, उनसे जुड़ी सेवाएं CustomerLifecycleGoalService और CampaignLifecycleGoalService, और लेगसी सेटिंग/enum (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) कोई नहीं कॉन्टेंट हटाना नए यूनिफ़ाइड लक्ष्यों के स्कीमा का इस्तेमाल करें:
सामान्य
इंसेंटिव सर्विस के अनुरोध और जवाब के मैसेज में नेस्ट किए गए enum फ़ील्ड:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
स्टैंडअलोन ईनम फ़ील्ड: नाम बदलना / हटाना लेगसी type फ़ील्ड के बजाय, नए स्टैंडअलोन enum फ़ील्ड का इस्तेमाल करें.
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 का इस्तेमाल करें.
रिपोर्ट
GenerateBenchmarksMetricsResponse में customer_metrics फ़ील्ड और Metrics टाइप के BreakdownMetrics CustomerMetrics टाइप का फ़ील्ड टाइप में बदलाव / व्यवहार में बदलाव अपने इंटिग्रेशन अपडेट करें, ताकि नए CustomerMetrics टाइप का इस्तेमाल किया जा सके. इसमें सिर्फ़ ग्राहक के विज्ञापन की परफ़ॉर्मेंस दिखाने वाली मेट्रिक शामिल होती हैं.

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

सुविधाएं और अपडेट टाइप ब्यौरा
विज्ञापन
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS नई enum वैल्यू / व्यवहार DemandGenMultiAssetAds के लिए उपलब्ध है. यह नीति चालू होने पर, बिना ऐनिमेशन वाली इमेज का इस्तेमाल करके, ऐनिमेशन वाली इमेज जनरेट की जाती हैं. एपीआई के इस वर्शन से, नए DemandGenMultiAssetAds डिफ़ॉल्ट रूप से ऑप्ट इन हो जाते हैं.
अप्राकृतिक कॉन्टेंट की जानकारी में बदलाव करने की सुविधा व्यवहार में बदलाव Asset.synthetic_content_info और Ad.synthetic_content_info को अब v25, v24, और v23 में पूरी तरह से बदला जा सकता है.
कैंपेन
लॉयल्टी प्रोग्राम के तहत ग्राहकों को जोड़े रखने का लक्ष्य नई सुविधाएं / सेटिंग लॉयल्टी प्रोग्राम के सदस्यों को जोड़े रखने के लक्ष्य के लिए सहायता जोड़ी गई है. इससे विज्ञापन देने वाले लोग या कंपनियां, लॉयल्टी प्रोग्राम के सदस्यों को जोड़े रखने के लिए कैंपेन ऑप्टिमाइज़ कर सकती हैं.
  • GoalType enum में LOYALTY_RETENTION को जोड़ा गया.
  • कैंपेन के हिसाब से, लॉयल्टी प्रोग्राम के सदस्यों को बनाए रखने की सेटिंग कॉन्फ़िगर करने के लिए, CampaignGoalConfig.campaign_loyalty_retention_settings को जोड़ा गया. इसमें बिड घटाने या बढ़ाने की सेटिंग और पीएलए फ़ॉर्मैट में सदस्यों को मिलने वाले फ़ायदे दिखाना शामिल है.
  • खाता-लेवल पर, लॉयल्टी प्रोग्राम के तहत ग्राहकों को जोड़े रखने के लक्ष्य की सेटिंग कॉन्फ़िगर करने के लिए, Goal.loyalty_retention_goal_settings को जोड़ा गया.
  • गड़बड़ी के नए कोड जोड़े गए:
नए ग्राहक हासिल करने का लक्ष्य नई सुविधाएं / सेटिंग Google Ads API में, नए ग्राहक हासिल करने के लक्ष्य से जुड़ी सुविधा को अपडेट किया गया है, ताकि नए यूनिफ़ाइड लक्ष्य स्कीमा को दिखाया जा सके:
कन्वर्ज़न
YouTube पर तीसरे पक्ष के कन्वर्ज़न एट्रिब्यूशन के बारे में जानकारी नए फ़ील्ड थर्ड पार्टी पार्टनर की मदद से, YouTube कन्वर्ज़न एट्रिब्यूशन की पुष्टि करने की सुविधा जोड़ी गई है: ज़्यादा जानने के लिए, सहायता केंद्र में मौजूद लेख पढ़ें.
सामान्य
ContactDetails.phone_number_extension नया फ़ील्ड LocalServicesLead संसाधन में जोड़ा गया.
IncentiveError नई enum वैल्यू और गड़बड़ियां इंसेंटिव रिडीम न हो पाने की गड़बड़ियों के लिए, नए गड़बड़ी के कोड जोड़े गए हैं:
  • 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 (अनुरोध में दिया गया बिलिंग देश का कोड, ग्राहक के खाते में मौजूद देश के कोड से मैच नहीं करता)
प्लानिंग
ट्रेंडिंग इनसाइट में YouTube चैनल की जानकारी नए फ़ील्ड खोज के रुझान की अहम जानकारी खोजते समय, मिलते-जुलते वीडियो के YouTube चैनल की ज़्यादा जानकारी के लिए सहायता जोड़ी गई. YouTubeVideoAttributeMetadata में नए फ़ील्ड channel_id, channel_name, और channel_url जोड़े गए.
YouTubeChannelInsights.data_sharing_consent_given नया फ़ील्ड YouTubeChannelInsights में जोड़ा गया. ऐसा तब होता है, जब किसी क्रिएटर ने सार्वजनिक नहीं किया गया डेटा शेयर करने की सहमति दी हो. अगर ऐसा है, तो ये फ़ील्ड अपने-आप भर जाते हैं:
रिपोर्ट
ad_sub_format_type नया सेगमेंट इससे YouTube पर स्किप न किए जा सकने वाले इन-स्ट्रीम विज्ञापनों की अवधि के हिसाब से जानकारी मिलती है:
  • INSTREAM_NON_SKIPPABLE_STANDARD (स्टैंडर्ड अवधि वाला, स्किप न किया जा सकने वाला इन-स्ट्रीम विज्ञापन)
  • INSTREAM_NON_SKIPPABLE_MAX30_SEC (स्किप न किया जा सकने वाला इन-स्ट्रीम विज्ञापन, जो 30.99 सेकंड से ज़्यादा का न हो)
  • INSTREAM_NON_SKIPPABLE_MAX60_SEC (स्किप न किया जा सकने वाला इन-स्ट्रीम विज्ञापन, जो 60.99 सेकंड से ज़्यादा का न हो)
इस सेगमेंट को हमेशा ad_format_type के साथ ही चुना जाना चाहिए. इसे AdGroup, AdGroupAd, Campaign, Customer, Video, और VideoEnhancement के साथ चुना जा सकता है.
वीडियो के लिए सोशल मीडिया मेट्रिक नए फ़ील्ड / मेट्रिक विज्ञापन देने वाले लोगों या कंपनियों को YouTube पर Shorts में दिखने वाले विज्ञापनों के लिए, उपयोगकर्ता की दिलचस्पी (टिप्पणियां, पसंद, और शेयर) को ट्रैक करने में मदद करने के लिए, वीडियो के हिसाब से सोशल मेट्रिक जोड़ी गई हैं: ये AdGroup, AdGroupAd, Asset, Campaign, Customer, और Video में उपलब्ध हैं.

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
नए फ़ील्ड Local Services के परफ़ॉर्मेंस मैक्स कैंपेन की पहचान करने में मदद करना.
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 वैल्यू ये उन कन्वर्ज़न को दिखाते हैं जो तब होते हैं, जब कोई उपयोगकर्ता Local Services के विज्ञापन पर क्लिक करता है और विज्ञापन देने वाले व्यक्ति या कंपनी को कॉल करता है, मैसेज भेजता है या बुकिंग करता है.
प्रयोग
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_attestation (विज्ञापन देने वाले व्यक्ति या कंपनी की ओर से सीधे तौर पर दिए गए एलान) और system_attestation (सिस्टम की ओर से अपने-आप पहचाने गए या दिए गए अटेस्टेशन) में बांटा जाता है.

इस सुविधा को 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 नया फ़ील्ड अगर इसकी वैल्यू true है, तो शॉपिंग विज्ञापनों के लिए, ब्रैंड को बाहर रखने की सेटिंग को नज़रअंदाज़ कर दिया जाता है. यह सुविधा सिर्फ़ शॉपिंग कैंपेन के लिए उपलब्ध है.
टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना)
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: ऐसेट ऑप्टिमाइज़ करने वाले एक्सपेरिमेंट के लिए, एक्सपेरिमेंट ग्रुप में मौजूद ऐसेट ग्रुप की सूची.
  • 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 वगैरह) जोड़ी गई हैं.
कन्वर्ज़न में हुए बदलाव की मेट्रिक नए फ़ील्ड पॉइंट एस्टिमेट, मार्जिन ऑफ़ एरर, और p-वैल्यू फ़ील्ड का इस्तेमाल करके, 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 के लॉन्च होने पर, आपका सिस्टम पूरी तरह से तैयार हो जाएगा.

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

वर्शन 23.2 (25-03-2026)

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

सुविधाएं और अपडेट टाइप ब्यौरा
ऐसेट
VideoEnhancement नया संसाधन इसमें वीडियो विज्ञापन को बेहतर बनाने से जुड़ी जानकारी होती है. जैसे, यह Google ने जनरेट किया है या विज्ञापन देने वाले व्यक्ति या कंपनी ने उपलब्ध कराया है. ज़्यादा जानने के लिए, वीडियो को बेहतर बनाने की सुविधा के बारे में जानकारी देखें.
AppTopCombinationView नया संसाधन ऐप्लिकेशन कैंपेन में सबसे अच्छा परफ़ॉर्म करने वाली ऐसेट के कॉम्बिनेशन के बारे में अहम जानकारी देने वाला रीड-ओनली रिसॉर्स.
CustomerAsset नई सुविधा CustomerAsset को वापस पाने की सुविधा जोड़ी गई. इसके लिए, field_type को BUSINESS_LOGO पर सेट करना होगा.
कैंपेन
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 नई सुविधा preview_type को YOUTUBE_LIVE_PREVIEW पर सेट करके, YouTube लाइव की झलक दिखाने की सुविधा जोड़ी गई. 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 को जोड़ा गया. जैसे, Google Travel विज्ञापन की इकाई को टारगेटिंग करना.
YouTubeVideoUpload
YouTubeVideoUpload नई सेवा / संसाधन YouTube पर वीडियो अपलोड और मैनेज करने के लिए, YouTubeVideoUpload सेवा जोड़ी गई. साथ ही, अपलोड की स्थिति और मेटाडेटा फ़ेच करने के लिए, YouTubeVideoUpload संसाधन जोड़ा गया. यह सुविधा सिर्फ़ REST और Python क्लाइंट लाइब्रेरी के लिए उपलब्ध है.

v23 (28-01-2026)

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

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

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

प्रारंभिक स्थिति नई स्थिति बदलाव का टाइप लागू करने के लिए सलाह
विज्ञापन
विज्ञापन शेयर करने की अनुमति है 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 फ़ील्ड को हटा दिया गया है. अपने कोड में रेफ़रंस अपडेट करें.
रिपोर्ट
एसेट की परफ़ॉर्मेंस के लेबल की मेट्रिक और एनम को एग्रीगेट करना कोई नहीं कॉन्टेंट हटाना एसेट की परफ़ॉर्मेंस के लेबल की एग्रीगेट मेट्रिक हटाई गईं. Search और Display के लिए, परफ़ॉर्मेंस लेबल 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 नई सुविधाएं / सहायता कारोबार की अपडेट की गई मैसेज ऐसेट:
  • सेवा देने वाली कंपनियों के तौर पर, 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 नया फ़ील्ड मांग बढ़ाने में मदद करने वाले कैंपेन के रिस्पॉन्सिव वीडियो विज्ञापनों में, वीडियो विज्ञापन के साथ दिखने वाले बैनर विज्ञापनों के लिए सहायता जोड़ी गई है.
इंसेंटिव
Choose Your Own (CYO) इंसेंटिव की सुविधा जोड़ी गई:
  • किसी उपयोगकर्ता के लिए उपलब्ध, उसकी दिलचस्पी के हिसाब से बनाए गए इंसेंटिव की जानकारी पाने के लिए, 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 नया फ़ील्ड / टाइप YouTube चैनल के कॉन्टेंट में भाषा के डिस्ट्रिब्यूशन की जानकारी देने के लिए, YouTubeChannelInsights में जोड़ा गया.
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 नया फ़ील्ड इससे यह कंट्रोल किया जा सकता है कि यात्रा के फ़ीड का इस्तेमाल करके, सर्च कैंपेन में कौनसे विज्ञापन फ़ॉर्मैट दिखाए जा सकते हैं.
AdGroupCriterion
SharedCriterion
नए फ़ील्ड / शर्तें vertical_ads_item_group_rule_list शर्त टाइप को AdGroupCriterion में और vertical_ads_item_group_rule को SharedCriterion में जोड़ा गया, ताकि यात्रा के फ़ीड वाले सर्च कैंपेन में, सामान के ग्रुप को टारगेट किया जा सके.
वर्टिकल विज्ञापनों के लिए डेटा फ़ीड का इंटिग्रेशन नई सुविधा अब एआई मैक्स का इस्तेमाल करने वाले सर्च कैंपेन से, वर्टिकल विज्ञापनों के डेटा फ़ीड को कनेक्ट किया जा सकता है. इससे टेक्स्ट विज्ञापनों के साथ-साथ, प्रॉपर्टी का प्रमोशन करने वाले और बुकिंग लिंक वाले यात्रा विज्ञापन दिखाए जा सकते हैं. vertical_ads_format_setting की मदद से फ़ॉर्मैट कंट्रोल करें और vertical_ads_item_group_rule का इस्तेमाल करके नियम तय करें. AdFormatType और वर्टिकल विज्ञापनों के डेटा फ़ीड डाइमेंशन के हिसाब से रिपोर्टिंग को सेगमेंट करें.
वीडियो
AdVideoAssetInfo.ad_video_asset_feature_control नया फ़ील्ड वीडियो विज्ञापन की ऐसेट के लिए, सुविधा को कंट्रोल करने के विकल्प जोड़े गए.
CampaignCriterionError नई enum वैल्यू / गड़बड़ी गड़बड़ी का कोड INVALID_VIDEO_LINEUP_ID जोड़ा गया.
YouTube पर विज्ञापन की आवाज़ सुनाई देने से जुड़ी मेट्रिक नई मेट्रिक YouTube पर ऑडियो विज्ञापनों के लिए, ऑडियो सुनने से जुड़ी मेट्रिक जोड़ी गई हैं. इनसे यह पता चलता है कि विज्ञापन सुनाई दे रहा था या नहीं. साथ ही, यह भी पता चलता है कि कितने इंप्रेशन पर ऑडियो सुनने से जुड़ी मेट्रिक को मेज़र किया जा सकता है.

प्रॉडक्ट की जानकारी वाले पुराने दस्तावेज़

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