Son sürüme yükseltme

Düzenli olarak, Google Ads API'nin eski bir ana sürümünden yeni bir ana sürüme yükseltme yapmak 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 kontrol listesi verilmiştir:

1. Ana sürümleri değiştirdiğinizde uç noktanız da değişir. İstemci kitaplıklarınızı en yeni uç noktayı kullanacak şekilde 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. Yükseltme yaptığınız sürümde odaklanılması gereken belirli alanlar için aşağıdaki tablolara göz atın.

İki sürümdeki protolar arasındaki farka dayalı değişikliklere dair kapsamlı bir genel bakış için fark tablosuna bakın.

sürüm 16'dan v17'ye

Hizmetlerde ve bileşenlerinde yapılan değişiklikler
GoogleAdsService Search ve SearchStream istekleri	İsteğiniz çok pahalı olduğu için kısıtlandığında gösterilecek hata, QuotaError.RESOURCE_EXHAUSTED yerine QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION veya QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION olacaktır. Daha fazla bilgi için blog yayınına göz atın.
GoogleAdsService Search isteği.	GoogleAdsService.Search öğesine page_size iletmek RequestError.PAGE_SIZE_NOT_SUPPORTED hatasına neden olur.
Campaign ve Ad	AdvertisingChannelType DISCOVERY olan kampanyalarda artık DEMAND_GEN yerine AdvertisingChannelType olacak. Ayrıca, bazı reklamlarda raporlama için tür ve alan adları değişecektir: DISCOVERY_MULTI_ASSET_ADD, DEMAND_GEN_MULTI_ASSET_ADD ve ilgili raporlama alanı ad_group_ad.ad.discovery_multi_asset_ad ad_group_ad.ad.demand_gen_multi_asset_ad olacak. DISCOVERY_CAROUSEL_AD, DEMAND_GEN_CAROUSEL_AD ve ilgili raporlama alanı ad_group_ad.ad.discovery_carousel_ad ad_group_ad.ad.demand_gen_carousel_ad olacak. DISCOVERY_VIDEO_RESPONSIVE_AD, DEMAND_GEN_VIDEO_RESPONSIVE_AD ve ilgili raporlama alanı ad_group_ad.ad.discovery_video_responsive_ad ad_group_ad.ad.demand_gen_video_responsive_ad olacak.
AdService	GetAd uç noktası kaldırılacak. Bu sayede AdService, Google Ads API'deki diğer hizmetlerle uyumlu hale gelir. Reklamları ve diğer kaynak türlerini getirmenin önerilen yöntemi için nesneleri alma kılavuzumuza bakın.
CustomerLifecycleGoal ve CampaignLifecycleGoal	Yaşam döngüsü hedefleri için segmentleri yönetme şekliniz yeniden düzenlendi. Eksiksiz bir genel bakış için yaşam döngüsü hedefleri belgelerinin kitlelerinizi segmentlere ayırma bölümüne bakın.
ProductLink	product_link için GoogleAdsService arama veya arama akışı isteği çalıştırırken artık yalnızca bir bağlı ürünle ilgili alanları seçebilirsiniz. Farklı bağlı ürünlerden birden fazla alan seçilmesi QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE hatasına neden olur.
Raporlama	metrics.sk_ad_network_conversion_value alanının adı metrics.sk_ad_network_fine_conversion_value olarak değiştirildi.

sürüm 15'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 kullanın.
CampaignLifecycleGoal	Daha önce mevcut bir CampaignLifecycleGoal öğesini güncellerken belirli gereksinimleri olan bir create işlemi yayınlarsınız. Artık 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 ayrıntılı hata mesajlarına yol açmaktadı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.

sürüm 14'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ığı için kaldırıldı. Aşağıdaki ImageAdInfo değişikliğine bakın.
ImageAdInfo	media_file alanı, image_asset ile değiştirildi.
MerchantCenterLinkService	Hizmetin yerini ProductLinkInvitationService ve ProductLinkService aldı.
Campaign.ShoppingSetting	sales_country alanı kaldırıldı. Bilgiler artık feed_label alanında döndürülür.
ProductBiddingCategoryConstant	ProductCategoryConstant ile değiştirilir. Birden fazla alan, uygun şekilde yeniden adlandırıldı. Bundan 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 şu şekilde değiştirilmiştir: 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 tür sorgunuzu değiştirin: SELECT customer.offline_conversion_client_summaries FROM customer Alıcı: 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ılabilen alanların listesini keşfetmek amacıyla sorgu oluşturucu'yu kullanın.
OfflineConversionUploadAlert	OfflineConversionAlert olarak yeniden adlandırıldı.
OfflineConversionUploadError	OfflineConversionError olarak yeniden adlandırıldı.
AdNetworkType	YOUTUBE_SEARCH ve YOUTUBE_WATCH sıralamaları tek bir sıralamada birleştirildi: YOUTUBE.