출시 노트

이 페이지에는 Google Bid Manager API의 출시 노트가 나와 있습니다.

버전 2

서비스 엔드포인트 업데이트, 서비스 및 메서드 이름 변경 등 API의 구조가 변경되었습니다.

불필요한 필드를 삭제하고 기존 필드를 다시 구성하고 필드 유형을 변경하여 쿼리보고서 리소스를 크게 업데이트했습니다. 여기에는 일반적인 '중첩된 객체' 정의 대신 이름이 지정된 객체를 사용하도록 필드 유형을 변경하는 것이 포함됩니다.

임시 쿼리를 생성 후 자동으로 실행하는 대신 queries.run 메서드를 사용하여 실행해야 합니다.

queries.run 쿼리 매개변수 asynchronoussynchronous로 대체했습니다.

다음 변경을 통해 보고서 검색이 간소화되었습니다.

API에서 반환하는 오류 메시지가 더 구체적이고 처방적인 솔루션을 제공하도록 업데이트되었습니다.

v2 마이그레이션 가이드에 표시된 안내에 따라 v1.1에서 v2로 마이그레이션합니다.

새로운 기능

알려진 문제

없음

버전 1.1

보고서 열 매핑에 대한 일대일 필터

여러 보고서 열에 매핑된 필터가 이제 단일 열에 매핑됩니다.

예를 들어 v1에 FILTER_ADVERTISER 필터를 포함하면 '광고주 ID' 열 외에 '광고주' 열이 포함된 보고서가 생성됩니다. v1.1에서는 모든 보고서 열에 자체 필터가 있습니다. 예를 들어 새 필터 FILTER_ADVERTISER_NAME는 '광고주'에 매핑됩니다. 보고서에 '광고주 ID' 및 '광고주' 열을 모두 가져오려면 FILTER_ADVERTISERFILTER_ADVERTISER_NAME 필터를 각각 Queries.createquery 요청에 포함해야 합니다.

더 구체적으로 createquery 요청은 다음과 같습니다.

{
...
"params": {
  ...
  "groupBys": ["FILTER_ADVERTISER"],
  "metrics": ["METRIC_IMPRESSIONS"],
  ...
}
...
}

위 코드는 v1에서 다음 헤더가 있는 보고서 파일을 생성합니다.

Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions

및 다음 헤더 v1.1:

Advertiser,Impressions

다음은 위 예에서 보고서 항목을 가져오는 데 사용된 v1 코드입니다.

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);

v1.1에서 다음과 같이 수정해야 합니다 (필터 순서 참고).

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);
원래 필터 추가된 필터
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

페이지로 나누기

v1.1에서는 Queries.listqueriesReports.listreports 메서드에 페이지로 나누기가 추가됩니다.

v1.1에서는 이러한 메서드가 반환하는 결과 수가 새로 추가된 매개변수 pageSize (지정하지 않으면 기본적으로 100임)와 같습니다. 응답에는 다음 결과 집합을 검색하는 데 사용할 수 있도록 새로 추가된 nextPageToken 필드가 포함됩니다. 결과가 소진된 경우 이 필드는 비어 있습니다.

다음은 특정 검색어에 속하는 모든 보고서를 검색하는 v1 코드입니다.

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    return reportListResponse.getReports();
  }
}

모든 보고서를 계속 검색하려면 v1.1에서 다음과 같이 수정해야 합니다.

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;
  }
}

자세한 내용은 Queries.listqueriesReports.listreports 메서드 문서를 참고하세요.

알려진 문제

없음

버전 1

API의 초기 버전입니다.

알려진 문제

없음