Sürüm notları

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:

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

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.