नए वर्शन में अपग्रेड करना

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

रोकने का शेड्यूल देखें अपग्रेड करें. इसका तरीका जानने के लिए हमारी वर्शन गाइड देखें वर्शन काम करता है.

यहां एक चेकलिस्ट दी गई है, जिससे आपको अपग्रेड करने की प्रोसेस शुरू करने में मदद मिलेगी:

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

इन बदलावों के प्रोटो के बीच के अंतर के आधार पर, बदलावों की ज़्यादा जानकारी पाने के लिए तो अंतर टेबल देखें.

v17 से v18

सेवाओं और उनके कॉम्पोनेंट में बदलाव
GoogleAdsService Search और SearchStream के अनुरोध

अगर आपका अनुरोध बहुत महंगा होने की वजह से थ्रॉटल किया जाता है, तो आपको QuotaError.RESOURCE_EXHAUSTED के बजाय QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION या QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION गड़बड़ी का मैसेज दिखेगा. ज़्यादा जानकारी के लिए, ब्लॉग पोस्ट देखें.
GoogleAdsService SearchGoogleAdsRequest में मौजूद summary_row_setting और return_total_results_count फ़ील्ड, अब नए SearchSettings ऑब्जेक्ट का हिस्सा हैं.
AssetType DISCOVERY_CAROUSEL_CARD की enum वैल्यू का नाम बदलकर, यह कर दिया गया है DEMAND_GEN_CAROUSEL_CARD. यह बदलाव पिछले बदलाव के मुताबिक है का नाम बदलकर, डिस्कवरी कैंपेन का नाम बदला जा सकता है.
AudienceInsightsService.GenerateSuggestedTargetingInsights audience, baseline_audience, और data_month फ़ील्ड को इसमें ले जाया गया है audience_definition फ़ील्ड.
DemandGenCampaignSettings upgraded_targeting फ़ील्ड की डिफ़ॉल्ट वैल्यू अब false के बजाय true है.
LocalServicesLeadConversation phone_call_details.call_recording_url फ़ील्ड अब स्टैटिक कॉल के लिए जानकारी भरी जानी चाहिए.

v16 से v17

सेवाओं और उनके कॉम्पोनेंट में बदलाव
GoogleAdsService Search और SearchStream के अनुरोध

अगर क्वेरी बहुत महंगी है, तो आपके अनुरोध को रोका जा सकता है. अगर ऐसा है, आपको QuotaError.RESOURCE_EXHAUSTED गड़बड़ी दिखेगी. ब्लॉग देखें पोस्ट पर जाएं.
GoogleAdsService Search अनुरोध.

GoogleAdsService.Search के लिए page_size पास करना RequestError.PAGE_SIZE_NOT_SUPPORTED गड़बड़ी मिलेगी.
Campaign और Ad

AdvertisingChannelType वाले कैंपेन DISCOVERY के पास अब का AdvertisingChannelType होगा अगर आपके पास इन फ़ॉर्मैट की फ़ाइल है, तो DEMAND_GEN बटन का इस्तेमाल करें.

इसके अलावा, कुछ विज्ञापनों में रिपोर्टिंग के टाइप और फ़ील्ड के नाम बदल जाएंगे:

  • DISCOVERY_MULTI_ASSET_ADD बन जाएगा DEMAND_GEN_MULTI_ASSET_ADD और इससे जुड़ी रिपोर्टिंग फ़ील्ड ad_group_ad.ad.discovery_multi_asset_ad बन जाएगा ad_group_ad.ad.demand_gen_multi_asset_ad
  • DISCOVERY_CAROUSEL_AD, DEMAND_GEN_CAROUSEL_AD बन जाएगा और उससे जुड़ा रिपोर्टिंग फ़ील्ड ad_group_ad.ad.discovery_carousel_ad, ad_group_ad.ad.demand_gen_carousel_ad बन जाएगा
  • DISCOVERY_VIDEO_RESPONSIVE_AD, DEMAND_GEN_VIDEO_RESPONSIVE_AD बन जाएगा और उससे जुड़ा रिपोर्टिंग फ़ील्ड ad_group_ad.ad.discovery_video_responsive_ad, ad_group_ad.ad.demand_gen_video_responsive_ad बन जाएगा
AdService GetAd एंडपॉइंट को हटा दिया जाएगा. इससे AdService, Google Ads API की अन्य सेवाओं के साथ काम कर पाएगा. हमारी वापस पाने के बारे में गाइड ऑब्जेक्ट सबमिट करें.
CustomerLifecycleGoal और CampaignLifecycleGoal लाइफ़साइकल के लक्ष्यों के लिए सेगमेंट मैनेज करने के तरीके में बदलाव किया गया है. सेगमेंट देखें अपनी ऑडियंस सेक्शन को पूरा करने के लिए, समीक्षा करें.
ProductLink GoogleAdsService खोज या खोज स्ट्रीम चलाते समय product_link के लिए अनुरोध किया है. अब आपके पास सिर्फ़ संबंधित फ़ील्ड चुनने का विकल्प है लिंक किए गए एक प्रॉडक्ट से लिंक किया जा सकता है. लिंक किए गए अलग-अलग प्रॉडक्ट से कई फ़ील्ड चुनने पर, आपको QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE वाली गड़बड़ी दिखेगी.
रिपोर्टिंग metrics.sk_ad_network_conversion_value फ़ील्ड का नाम बदलकर यह किया metrics.sk_ad_network_fine_conversion_value.