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

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

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

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

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

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

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 दिखाता है.

वर्शन 14 से 15 वर्शन

सेवाओं और उनके कॉम्पोनेंट में बदलाव
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 Enum YOUTUBE_SEARCH और YOUTUBE_WATCH को एक ही Enum में मर्ज कर दिया गया है: YOUTUBE.