Son sürüme yükseltme

Belirli aralıklarla, Google Ads API'nin eski bir ana sürümünden daha yeni bir ana sürüme geçmek isteyebilirsiniz. Bunun nedeni bir sürümün kullanımdan kaldırılması veya yeni bir özelliği kullanmak istemeniz olabilir. Her zaman en yeni sürüme geçmenizi öneririz.

Yükseltme işlemlerinizi planlamak için kullanımdan kaldırma programımıza göz atın. Sürüm oluşturmanın işleyiş şeklini öğrenmek için sürüm oluşturma kılavuzumuza bakın.

Aşağıda, yükseltme işlemine başlamanıza yardımcı olacak bir yapılacaklar listesi verilmiştir:

  1. Ana sürümleri değiştirdiğinizde uç noktanız değişir. En yeni uç noktayı kullanmak için istemci kitaplıklarınızı güncelleyin.
  2. Her sürümde yapılan değişiklikleri görmek için sürüm notlarını gözden geçirin.
  3. Geçiş yaptığınız sürümde odaklanacağınız belirli alanlar için aşağıdaki tablolara göz atın.

İki sürümdeki proto'lar arasındaki farkları temel alan değişikliklere ilişkin kapsamlı bir genel bakış için fark tablosuna bakın.

v15'ten v16'ya

Hizmetlerde ve bileşenlerinde yapılan değişiklikler
AccountLink linked_account içindeki data_partner ve google_ads bağlantıları kaldırıldı. Bunun yerine ProductLinkService ve ProductLinkInvitationService seçeneklerini kullanın.
CampaignLifecycleGoal Mevcut bir CampaignLifecycleGoal öğesini önceden güncellerken belirli gereksinimleri olan bir create işlemi gerçekleştirirdiniz. Artık bunun yerine diğer kaynak türlerinde olduğu gibi bir update işlemi yayınlayabilirsiniz.
Hata bildirimi Genel ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT hatasının döndürüldüğü iki durum artık daha belirli hata mesajlarına neden olmaktadır:
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata score alanı kaldırıldı.
KeywordMatchTypeRecommendation Anahtar kelime eşleme türü ayarlanmazsa API artık recommended_match_type alanı için UNKNOWN yerine UNSPECIFIED değerini döndürür.

v14'ten v15'e

Hizmetlerde ve bileşenlerinde yapılan değişiklikler
AssetGroupListingGroupFilter vertical sıralama alanı, feed_type olarak yeniden adlandırıldı.
MediaFileService Hizmet, artık ihtiyaç duyulmadığından kaldırıldı. Aşağıdaki ImageAdInfo değişikliğine bakın.
ImageAdInfo media_file alanı, image_asset ile değiştirildi.
MerchantCenterLinkService Bu hizmet, ProductLinkInvitationService ve ProductLinkService ile değiştirildi.
Campaign.ShoppingSetting sales_country alanı kaldırıldı. Bilgiler şimdi feed_label alanında döndürülür.
ProductBiddingCategoryConstant ProductCategoryConstant ile değiştirilir. Birden fazla alan buna uygun şekilde yeniden adlandırıldı. Sonraki üç değişikliği aşağıda görebilirsiniz.
ListingDimensionInfo product_bidding_category alanı product_category ile değiştirildi.
ListingGroupFilterDimension product_bidding_category alanı product_category ile değiştirildi.
shopping_performance_view raporu Aşağıdaki segment alanları:
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
şun şununla değiştirildi:
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
Campaign.shopping_setting Bu alanla Arama Ağı kampanyaları oluşturma desteği kaldırıldı.
CampaignCriterion.listing_scope Bu alanla Arama Ağı kampanyaları oluşturma desteği kaldırıldı.
sk_ad_network_conversions raporu metrics.sk_ad_network_conversions, metrics.sk_ad_network_installs ile değiştirildi.
OfflineConversionClientSummary offline_conversion_client_summaries alanı, Customer öğesinden, ayrı olarak sorgulayabileceğiniz üst düzey bir kaynağa taşındı.

Şu sorguyu değiştir:

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

Seçim ve filtreleme için kullanılabilir alanların listesini keşfetmek üzere sorgu oluşturucuyu kullanın.
OfflineConversionUploadAlert OfflineConversionAlert olarak yeniden adlandırıldı.
OfflineConversionUploadError OfflineConversionError olarak yeniden adlandırıldı.
AdNetworkType YOUTUBE_SEARCH ve YOUTUBE_WATCH enum'ları tek bir numaralandırmada birleştirildi: YOUTUBE.