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:
- 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.
- Her sürümde yapılan değişiklikleri görmek için sürüm notlarını gözden geçirin.
- 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, |
GoogleAdsService
Search isteği. |
|
Campaign ve Ad |
Ayrıca, bazı reklamlarda raporlama için tür ve alan adları değişecektir:
|
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:
|
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ı:
|
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 customerAlı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 .
|