Bu sayfada, Google Bid Manager API'si için sürüm notları sunulmaktadır.
Sürüm 2
Hizmet uç noktasını güncelleme, hizmetleri ve yöntemleri yeniden adlandırma gibi API'de yapısal değişiklikler yaptılar.
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ış nesneler kullanmak için alan türlerini değiştirmek dahildir.
Oluşturulduktan sonra otomatik olarak çalıştırılmak yerine, queries.run
yöntemi kullanılarak anlık sorguların çalıştırılması gerekir.
queries.run
sorgu parametresi asynchronous
, synchronous
ile değiştirildi.
Aşağıdaki değişikliklerle basitleştirilmiş rapor alma:
queries.reports.get
yönteminin eklenmesi.queries.reports.list
etiketine birorderBy
sorgu parametresinin eklenmesi.- Boş bir nesne olan
queries.run
yanıt gövdesinin, oluşturulanReport
kaynağının bir örneğine güncellenmesi.
API tarafından döndürülen hata mesajları, daha spesifik olacak ve daha kesin çözümler sağlayacak şekilde güncellendi.
v1.1'den v2'ye geçiş yapmak için v2 Taşıma Kılavuzu'nda sunulan talimatları uygulayın.
Yeni özellikler
Hizmet uç noktası değiştirildi:
v1 hizmet uç noktası v2 hizmet uç noktası https://www.googleapis.com/doubleclickbidmanager
https://doubleclickbidmanager.googleapis.com
Hizmetler aşağıdaki şekilde yeniden adlandırıldı:
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 al Aşağıdaki yöntemler için yeni bir yanıt gövdesi var:
Yöntem Yeni yanıt gövde nesnesi queries.run Bildir Aşağıdaki alanlar kaldırıldı:
Kaynak Alanlar queries.list
Yanıt Gövdesitür
queries.reports.list
Yanıt Gövdesitür
Sorgu tür
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
Aşağıdaki alanların nesne türü şu şekilde değiştirildi:
Kaynak Alanlar Nesne Türü Sorgu Bildir RunQueryRequest Aşağıdaki yöntem sorgu parametreleri eklendi:
Yöntem Sorgu Parametreleri queries.list orderBy queries.reports.list orderBy queries.run eşzamanlı Aşağıdaki yöntem sorgu 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.
Sürüm 1.1
Sütun eşlemeyi raporlamak için bire bir filtre
Birden fazla rapor sütunuyla eşlenen filtreler artık tek sütunlarla eşlenir.
Örneğin, v1'de FILTER_ADVERTISER
filtresi dahil edilirse "Reklamveren Kimliği"nin yanı sıra "Reklamveren" sütunları da oluşturulur. Sürüm 1.1'de, tüm rapor
sütunlarının kendi filtreleri vardır. Örneğin, yeni FILTER_ADVERTISER_NAME
filtresi "Reklamveren" ile eşlenir. Raporlarda hem "Reklamveren Kimliği" hem de "Reklamveren" sütunlarını almak için sırasıyla FILTER_ADVERTISER
ve FILTER_ADVERTISER_NAME
filtrelerinin her ikisi de Queries.createquery
isteklerine dahil edilmelidir.
Daha somut bir şekilde ifade etmek gerekirse createquery
isteği:
{
...
"params": {
...
"groupBys": ["FILTER_ADVERTISER"],
"metrics": ["METRIC_IMPRESSIONS"],
...
}
...
}
v1'de aşağıdaki başlıklara sahip bir rapor dosyası oluşturur:
Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions
ve v1.1'de aşağıdaki üstbilgiler:
Advertiser,Impressions
Yukarıdaki örnekte rapor sütunlarını almak için kullanılan aşağıdaki v1 kodu:
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
1.1 sürümünde aşağıdakine benzer şekilde değiştirilmesi gerekir (not filtre sıralaması):
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER_NAME");
groupBys.add("FILTER_ADVERTISER");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_STATUS");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_CODE");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
Orijinal filtre | Eklenen filtreler |
---|---|
FILTER_ADVERTISER |
FILTER_ADVERTISER_NAME FILTER_ADVERTISER_INTEGRATION_CODE FILTER_ADVERTISER_INTEGRATION_STATUS |
FILTER_AD_POSITION |
FILTER_AD_POSITION_NAME |
FILTER_CARRIER |
FILTER_CARRIER_NAME |
FILTER_CHANNEL_ID |
FILTER_CHANNEL_NAME |
FILTER_CITY |
FILTER_CITY_NAME |
FILTER_COMPANION_CREATIVE_ID |
FILTER_COMPANION_CREATIVE_NAME |
FILTER_DMA |
FILTER_DMA_NAME |
FILTER_INSERTION_ORDER |
FILTER_INSERTION_ORDER_NAME |
FILTER_PARTNER |
FILTER_PARTNER_NAME FILTER_PARTNER_STATUS |
FILTER_REGION |
FILTER_REGION_NAME |
FILTER_TRUEVIEW_DMA |
FILTER_TRUEVIEW_DMA_NAME |
FILTER_TRUEVIEW_IAR_REGION |
FILTER_TRUEVIEW_IAR_REGION_NAME |
FILTER_USER_LIST_FIRST_PARTY |
FILTER_USER_LIST_FIRST_PARTY_NAME |
FILTER_USER_LIST_THIRD_PARTY |
FILTER_USER_LIST_THIRD_PARTY_NAME |
Sayfalara ayırma
1.1 sürümü, Queries.listqueries
ve Reports.listreports
yöntemlerine sayfalara ayırma ekler.
Sürüm 1.1'de, bu yöntemlerin döndürdüğü sonuçların sayısı yeni eklenen pageSize
parametresine eşittir (belirtilmezse varsayılan olarak 100
parametresi kullanılır). Yanıtlar, bir sonraki sonuç grubunu almak için kullanılabilecek yeni eklenmiş bir nextPageToken
alanı içerir. Sonuçlar tükendiyse bu alan boş bırakılır.
Belirli bir sorguya ait tüm raporları almak için aşağıdaki v1 kodu:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
return reportListResponse.getReports();
}
}
tüm raporları almaya devam etmek için v1.1'de aşağıdakine benzer şekilde değiştirilmesi gerekir:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
List<Report> reports = new ArrayList<>(reportListResponse.getReports());
while (reportListResponse.getNextPageToken() != null
&& reportListResponse.getNextPageToken().length() > 0) {
// Get next set of results, aka page.
reportListResponse =
service
.reports()
.listreports(queryId)
.setPageToken(reportListResponse.getNextPageToken())
.execute();
reports.addAll(reportListResponse.getReports());
}
return reports;
}
}
Daha ayrıntılı bilgi için Queries.listqueries
ve Reports.listreports
yöntemiyle ilgili belgelere göz atın.
Bilinen sorunlar
Yok.
Sürüm 1
Bu, API'nin ilk sürümüdür.
Bilinen sorunlar
Yok.