Bu sayfada, Google Bid Manager API'nin sürüm notları yer almaktadır.
En son API sürümü: v2
22 Eylül 2025
Bilinen sorunlar
Filter enum değerinin, daha önce Display & Video 360 Yardım Merkezi'nde duyurulduğu gibi düşük kullanım nedeniyle desteği sonlandırılıyor.
v2
Aşağıdaki
Filterskullanımdan kaldırıldı:FilterdeğerleriFILTER_DFP_ORDER_IDFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDERFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER
1 Mart 2025
Bilinen sorunlar
Display & Video 360 Yardım Merkezi'nde daha önce duyurulduğu gibi YouTube TrueView envanter kullanılabilirliği raporu ve ilgili boyutlar kullanımdan kaldırılacak.
v2
Aşağıdaki enum değerlerinin desteği sonlandırıldı:
Enum Değerler ReportTypeINVENTORY_AVAILABILITYAşağıdaki filtrelerin desteği sonlandırıldı:
Filtre değerleri FILTER_DETAILED_DEMOGRAPHICSFILTER_DETAILED_DEMOGRAPHICS_IDFILTER_HOUSEHOLD_INCOMEFILTER_LIFE_EVENTFILTER_REMARKETING_LISTFILTER_TRUEVIEW_IAR_AGEFILTER_TRUEVIEW_IAR_CATEGORYFILTER_TRUEVIEW_IAR_CITYFILTER_TRUEVIEW_IAR_COUNTRYFILTER_TRUEVIEW_IAR_COUNTRY_NAMEFILTER_TRUEVIEW_IAR_GENDERFILTER_TRUEVIEW_IAR_INTERESTFILTER_TRUEVIEW_IAR_LANGUAGEFILTER_TRUEVIEW_IAR_PARENTAL_STATUSFILTER_TRUEVIEW_IAR_REGION_NAMEFILTER_TRUEVIEW_IAR_REMARKETING_LISTFILTER_TRUEVIEW_IAR_TIME_OF_DAYFILTER_TRUEVIEW_IAR_YOUTUBE_CHANNELFILTER_TRUEVIEW_IAR_YOUTUBE_VIDEOFILTER_TRUEVIEW_IAR_ZIPCODEFILTER_YOUTUBE_CHANNELFILTER_YOUTUBE_VIDEOAşağıdaki metriklerin desteği sonlandırıldı:
Metrik değerleri METRIC_POTENTIAL_VIEWSMETRIC_TEA_TRUEVIEW_IMPRESSIONSMETRIC_TEA_TRUEVIEW_UNIQUE_COOKIES
20 Kasım 2024
Yeni özellikler
FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID başlatılır. Bu sayede, aşağıdaki ön ekleri içeren metrikler için daha düşük güven eşiğine sahip veriler dahil edilebilir:
METRIC_UNIQUE_REACH_METRIC_VIRTUAL_PEOPLE_DUPLICATE_METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_METRIC_VIRTUAL_PEOPLE_OVERLAP_
Bu filtre kullanılırken ilgili metriklerden biri eklenmelidir.
Bu filtreyi içermeyen sorgular, kullanıma sunulduktan sonra varsayılan olarak yalnızca yüksek güvene sahip verileri içeren önceki varsayılan davranışa dönecektir. 4 Şubat 2025'ten itibaren bu filtreyi içermeyen sorgular varsayılan olarak daha düşük güven düzeyine sahip verileri içerecek.
v2
Aşağıdaki filtreler eklendi:
Filtre Türü Kullanılabilir değerler FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID0: Daha düşük güven düzeyine sahip verileri dahil edin. (4 Şubat 2025'ten sonra varsayılan)1: Yalnızca yüksek güven düzeyine sahip verileri dahil edin. (4 Şubat 2025'ten önceki varsayılan)
1 Ekim 2024
Yeni özellikler
Yok.
Bilinen sorunlar
v2
Anonim envanter modelleme (AIM) raporlama boyutunun desteği sonlandırılıyor
FILTER_ANONYMOUS_INVENTORY_MODELING boyutu gün batımıdır.
Query
içinde kullanımdan kaldırılan değerleri kullanarak params.groupBy
kaynak oluşturma veya çalıştırma işlemi 400 hatası döndürür.
DHV/YİM (Yasal İşletim Maliyetleri) ve Toplam Medya Maliyeti metrikleri, YOUTUBE raporlarıyla uyumsuz hale getirildi.
Aşağıdaki metrik değerleri artık YOUTUBE raporlarında kullanılamaz:
METRIC_TOTAL_MEDIACOST_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPC_USDMETRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPV_USDMETRIC_TOTAL_MEDIACOST_ECPA_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPA_PARTNERMETRIC_TOTAL_MEDIACOST_ECPA_USDMETRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPCV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPCV_USDMETRIC_TOTAL_MEDIACOST_ECPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPC_USDMETRIC_TOTAL_MEDIACOST_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_ECPM_USDMETRIC_TOTAL_MEDIACOST_PARTNERMETRIC_TOTAL_MEDIACOST_USDMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USDMETRIC_FEE32_ADVERTISERMETRIC_FEE32_PARTNERMETRIC_FEE32_USD
YOUTUBE Query kaynakları oluşturma veya çalıştırma ve params.metrics içinde alakalı bir metrik değeriyle params.type 400 hatası döndürür.
1 Mayıs 2024
Yeni özellikler
Yok.
Bilinen sorunlar
v2
Tam Yol ve Yol İlişkilendirme raporlarının desteğinin sonlandırılması
Tam Yol ve Yol İlişkilendirme raporlarının desteği sonlandırıldı. Bu tür Query ve Report kaynakların alınması veya oluşturulması hataya neden olur.
Aşağıdaki ReportType değerleri kullanımdan kaldırılıyor:
FULL_PATHPATH_ATTRIBUTION
Options nesnesinin
pathQueryOptions alanı da kullanımdan kaldırılıyor.
28 Şubat 2024
Yeni özellikler
Yok.
Bilinen sorunlar
v2
Cihazlar arası dönüşüm metriği değerlerinin desteğinin sonlandırılması
Cihazlar arası dönüşüm metriklerinin desteği sonlandırıldı. Aşağıdaki Bid Manager API metrik değerleri dahildir:
METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENTMETRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENTMETRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT
6 Temmuz 2022
Yeni özellikler
Bid Manager API v2 yayınlandı.
Hizmet uç noktasının güncellenmesi, hizmetlerin ve yöntemlerin yeniden adlandırılması gibi API'de yapısal değişiklikler yapıldı.
Gereksiz alanları kaldırarak, mevcut alanları yeniden düzenleyerek ve alan türlerini değiştirerek Sorgu ve Rapor kaynakları önemli ölçüde güncellendi. Buna, genel bir "iç içe yerleştirilmiş nesne" tanımı yerine adlandırılmış nesneleri kullanmak için alan türlerini değiştirmek de dahildir.
Oluşturulduktan sonra otomatik olarak çalıştırılmak yerine queries.run yöntemi kullanılarak geçici sorguların çalıştırılması gerekir.
queries.run sorgu parametresi asynchronous ile değiştirildi.
synchronous
Aşağıdaki değişikliklerle rapor almayı basitleştiriyoruz:
queries.reports.getyönteminin eklenmesi.orderBysorgu parametresininqueries.reports.listadresine eklenmesi.queries.runyanıt gövdesinin boş bir nesneden oluşturulanReportkaynağının bir örneğine güncellenmesi.
API tarafından döndürülen hata mesajları daha spesifik olacak ve daha fazla çözüm önerisi sunacak şekilde güncellendi.
v1.1'den v2'ye geçmek için v2 Taşıma Kılavuzu'nda verilen talimatları uygulayın.
v2
Hizmet uç noktası değiştirildi:
v1 hizmet uç noktası v2 hizmet uç noktası https://www.googleapis.com/doubleclickbidmanagerhttps://doubleclickbidmanager.googleapis.comHizmetlerin adları aşağıdaki gibi değiştirildi:
v1 hizmeti v2 hizmeti Sorgular sorgular Raporlar queries.reports Yöntemler aşağıdaki gibi yeniden adlandırıldı:
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler queries.reports get Aşağıdaki yöntemlerin yeni bir yanıt gövdesi var:
Yöntem Yeni yanıt gövdesi nesnesi queries.run Bildirin Aşağıdaki alanlar kaldırıldı:
Kaynak Alanlar queries.listYanıt Metnitür
queries.reports.listYanıt Metnitür
Sorgu tür
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
Aşağıdaki alanların nesne türü değiştirildi:
Kaynak Alanlar Nesne Türü Sorgu Bildirin RunQueryRequest Aşağıdaki yöntem sorgu parametreleri eklendi:
Yöntem Sorgu Parametreleri queries.list orderBy queries.reports.list orderBy queries.run synchronous Aşağıdaki yöntem sorgusu parametreleri kaldırıldı:
Yöntem Sorgu Parametreleri queries.create eşzamansız queries.run eşzamansız Aşağıdaki filtre değerleri eklendi:
Filtre değeri FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION Aşağıdaki filtre değerleri kaldırıldı:
Filtre değeri FILTER_TRUEVIEW_IAR_REGION Aşağıdaki metrik değerleri eklendi:
Metrik değeri METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH
Bilinen sorunlar
Yok.
Önceki sürümler
Desteği sonlandırılan sürümler için önceki Bid Manager API sürümleri hakkında bilgi edinmek üzere arşivlenmiş sürüm notlarımıza göz atın.