이 페이지에는 Google Bid Manager API의 출시 노트가 나와 있습니다.
버전 2
서비스 엔드포인트 업데이트, 서비스 및 메서드 이름 변경 등 API의 구조가 변경되었습니다.
불필요한 필드를 삭제하고 기존 필드를 다시 구성하고 필드 유형을 변경하여 쿼리 및 보고서 리소스를 크게 업데이트했습니다. 여기에는 일반적인 '중첩된 객체' 정의 대신 이름이 지정된 객체를 사용하도록 필드 유형을 변경하는 것이 포함됩니다.
임시 쿼리를 생성 후 자동으로 실행하는 대신 queries.run
메서드를 사용하여 실행해야 합니다.
queries.run
쿼리 매개변수 asynchronous
를 synchronous
로 대체했습니다.
다음 변경을 통해 보고서 검색이 간소화되었습니다.
queries.reports.get
메서드를 추가합니다.queries.reports.list
에orderBy
쿼리 매개변수 추가.queries.run
응답 본문을 빈 객체에서 생성된Report
리소스의 인스턴스로 업데이트합니다.
API에서 반환하는 오류 메시지가 더 구체적이고 처방적인 솔루션을 제공하도록 업데이트되었습니다.
v2 마이그레이션 가이드에 표시된 안내에 따라 v1.1에서 v2로 마이그레이션합니다.
새로운 기능
서비스 엔드포인트가 변경되었습니다.
v1 서비스 엔드포인트 v2 서비스 엔드포인트 https://www.googleapis.com/doubleclickbidmanager
https://doubleclickbidmanager.googleapis.com
서비스 이름이 다음과 같이 변경되었습니다.
v1 서비스 v2 서비스 검색어 검색어 보고서 queries.reports 메서드 이름이 다음과 같이 변경되었습니다.
다음과 같은 메서드가 추가되었습니다.
서비스 메서드 queries.reports get 다음 메서드에는 새 응답 본문이 있습니다.
메서드 새 응답 본문 객체 queries.run 보고서 다음 필드가 삭제되었습니다.
리소스 필드 queries.list
응답 본문kind
queries.reports.list
응답 본문kind
쿼리 kind
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
다음 필드의 객체 유형이 다음과 같이 변경되었습니다.
리소스 필드 객체 유형 쿼리 보고서 RunQueryRequest 다음과 같은 메서드 쿼리 매개변수가 추가되었습니다.
메서드 쿼리 매개변수 queries.list orderBy queries.reports.list orderBy queries.run 동기식 다음 메서드 쿼리 매개변수가 삭제되었습니다.
메서드 쿼리 매개변수 queries.create 비동기 queries.run 비동기 다음 필터 값이 추가되었습니다.
필터 값 FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION 다음 필터 값이 삭제되었습니다.
필터 값 FILTER_TRUEVIEW_IAR_REGION 다음 측정항목 값이 추가되었습니다.
측정항목 값 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
알려진 문제
없음
버전 1.1
보고서 열 매핑에 대한 일대일 필터
여러 보고서 열에 매핑된 필터가 이제 단일 열에 매핑됩니다.
예를 들어 v1에 FILTER_ADVERTISER
필터를 포함하면 '광고주 ID' 열 외에 '광고주' 열이 포함된 보고서가 생성됩니다. v1.1에서는 모든 보고서 열에 자체 필터가 있습니다. 예를 들어 새 필터 FILTER_ADVERTISER_NAME
는 '광고주'에 매핑됩니다. 보고서에 '광고주 ID' 및 '광고주' 열을 모두 가져오려면 FILTER_ADVERTISER
및 FILTER_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.listqueries
및 Reports.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.listqueries
및 Reports.listreports
메서드 문서를 참고하세요.
알려진 문제
없음
버전 1
API의 초기 버전입니다.
알려진 문제
없음