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

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

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

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

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

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

v16 से v17

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

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

page_size को GoogleAdsService.Search पर पास करने पर, RequestError.PAGE_SIZE_NOT_SUPPORTED गड़बड़ी दिखेगी.
Campaign और Ad

DISCOVERY के AdvertisingChannelType वाले कैंपेन में अब 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 product_link के लिए GoogleAdsService खोज या सर्च स्ट्रीम का अनुरोध करते समय, अब सिर्फ़ लिंक किए गए एक प्रॉडक्ट से जुड़े फ़ील्ड चुने जा सकते हैं. लिंक किए गए अलग-अलग प्रॉडक्ट में से कई फ़ील्ड चुनने पर, QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE गड़बड़ी दिखेगी.
रिपोर्ट करना metrics.sk_ad_network_conversion_value फ़ील्ड का नाम बदलकर metrics.sk_ad_network_fine_conversion_value किया गया.

v15 से v16

सेवाओं और उनके कॉम्पोनेंट में बदलाव
AccountLink linked_account में मौजूद data_partner और google_ads लिंक हटा दिए गए हैं. इसके बजाय, ProductLinkService और ProductLinkInvitationService का इस्तेमाल करें.
CampaignLifecycleGoal पहले से मौजूद CampaignLifecycleGoal को अपडेट करते समय, आपको खास शर्तों के साथ create ऑपरेशन जारी करना होगा. अब इसके बजाय, दूसरे रिसॉर्स टाइप की तरह update कार्रवाई जारी की जा सकती है.
रिपोर्ट करते समय गड़बड़ी हुई ऐसे दो मामलों में जिनमें जेनरिक ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT गड़बड़ी दिखने की वजह से अब ज़्यादा खास गड़बड़ी के मैसेज मिलते हैं:
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata score फ़ील्ड को हटा दिया गया है.
KeywordMatchTypeRecommendation अगर कीवर्ड मैच टाइप सेट नहीं है, तो एपीआई recommended_match_type फ़ील्ड के लिए, UNKNOWN के बजाय UNSPECIFIED नतीजे दिखाता है.

v14 से v15 तक

सेवाओं और उनके कॉम्पोनेंट में बदलाव
AssetGroupListingGroupFilter vertical enum फ़ील्ड का नाम बदलकर feed_type कर दिया गया है.
MediaFileService सेवा की अब ज़रूरत नहीं होने की वजह से इसे हटा दिया गया है. ImageAdInfo में हुए बदलाव नीचे देखें.
ImageAdInfo media_file फ़ील्ड को image_asset से बदल दिया गया है.
MerchantCenterLinkService इस सेवा को ProductLinkInvitationService और ProductLinkService से बदल दिया गया है.
Campaign.ShoppingSetting sales_country फ़ील्ड को हटा दिया गया है. यह जानकारी अब feed_label फ़ील्ड में दिखती है.
ProductBiddingCategoryConstant ProductCategoryConstant से बदला गया. एक से ज़्यादा फ़ील्ड के नाम उसी हिसाब से बदले गए हैं. अगले तीन बदलावों को नीचे देखें.
ListingDimensionInfo product_bidding_category फ़ील्ड को product_category से बदला गया.
ListingGroupFilterDimension product_bidding_category फ़ील्ड को product_category से बदला गया.
shopping_performance_view रिपोर्ट ये सेगमेंट फ़ील्ड:
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
को इनसे बदल दिया गया है:
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
Campaign.shopping_setting इस फ़ील्ड का इस्तेमाल करके, सर्च कैंपेन बनाने का विकल्प हटा दिया गया है.
CampaignCriterion.listing_scope इस फ़ील्ड का इस्तेमाल करके, सर्च कैंपेन बनाने का विकल्प हटा दिया गया है.
sk_ad_network_conversions रिपोर्ट metrics.sk_ad_network_conversions को metrics.sk_ad_network_installs से बदल दिया गया है.
OfflineConversionClientSummary offline_conversion_client_summaries फ़ील्ड को Customer से ऐसे टॉप लेवल संसाधन पर ले जाया गया है जिसके लिए अलग से क्वेरी की जा सकती है.

अपनी क्वेरी इससे बदलें:

SELECT customer.offline_conversion_client_summaries
FROM customer
पाने वाला: 
SELECT
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.total_event_count,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.last_upload_date_time,
  ...
FROM offline_conversion_upload_client_summary

चुनने और फ़िल्टर करने के लिए उपलब्ध फ़ील्ड की सूची देखने के लिए, क्वेरी बिल्डर का इस्तेमाल करें.
OfflineConversionUploadAlert नाम बदलकर OfflineConversionAlert किया गया.
OfflineConversionUploadError नाम बदलकर OfflineConversionError किया गया.
AdNetworkType इनम YOUTUBE_SEARCH और YOUTUBE_WATCH को एक ही ईनम में मर्ज कर दिया गया है: YOUTUBE.