여러 보고서를 한 번에 반환합니다. 모든 보고서는 동일한 항목에 대한 것이어야 합니다.
HTTP 요청
POST https://analyticsdata.googleapis.com/v1alpha:batchRunReports
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 | |
---|---|
{ "entity": { object ( |
입력란 | |
---|---|
entity |
이벤트가 추적되는 속성입니다. 이 항목은 배치에 지정되어야 합니다. RunReportRequest 내의 항목은 지정되지 않거나 이 항목과 일관될 수 있습니다. |
requests[] |
개별 요청. 각 요청에는 별도의 보고서 응답이 있습니다. 각 일괄 요청에는 최대 5개의 요청이 허용됩니다. |
응답 본문
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
여러 보고서가 포함된 일괄 응답입니다.
JSON 표현 | |
---|---|
{
"reports": [
{
object ( |
입력란 | |
---|---|
reports[] |
개별 응답. 각 응답에는 별도의 보고서 요청이 있습니다. |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunReportRequest
보고서 생성 요청입니다.
JSON 표현 | |
---|---|
{ "entity": { object ( |
입력란 | |
---|---|
entity |
이벤트가 추적되는 속성입니다. 일괄 요청 내에서 이 항목은 지정되지 않거나 일괄 수준 항목과 일치해야 합니다. |
dimensions[] |
요청 및 표시된 측정기준입니다. |
metrics[] |
요청 및 표시되는 측정항목입니다. |
dateRanges[] |
읽을 데이터의 기간입니다. 여러 기간이 요청되면 각 응답 행에 0 기반 기간 색인이 포함됩니다. 두 기간이 겹치는 경우, 중복되는 날의 이벤트 데이터가 두 기간의 응답 행에 포함됩니다. 동질 집단 요청에서 이 |
offset |
시작 행의 행 수입니다. 첫 번째 행은 0행으로 계산됩니다. |
limit |
반환할 행 수입니다. |
metricAggregations[] |
측정항목 집계. 집계된 측정항목 값은dimensionValues가 'RESERVED_(MetricAggregation)'으로 설정된 행에 표시됩니다. |
dimensionFilter |
측정기준의 필터 절입니다. 이 필터에 사용할 측정기준을 요청해야 합니다. 이 필터에 측정항목을 사용할 수 없습니다. |
metricFilter |
측정항목의 필터 절입니다. SQL 포함 절과 유사하게 집계 후 단계에 적용됩니다. 이 필터에 사용할 측정항목을 요청해야 합니다. 이 필터에 측정기준을 사용할 수 없습니다. |
orderBys[] |
응답에서 행이 정렬되는 방식을 지정합니다. |
currencyCode |
ISO4217 형식의 통화 코드입니다(예: 'AED', 'USD', 'JPY'). 필드가 비어 있으면 보고서에서 항목의 기본 통화가 사용됩니다. |
cohortSpec |
이 요청과 관련된 동질 집단 그룹입니다. 요청에 동질 집단 그룹이 있는 경우 '동질 집단' 측정기준이 있어야 합니다. |
keepEmptyRows |
false이거나 지정되지 않은 경우 모든 측정항목이 0인 각 행이 반환되지 않습니다. true인 경우 필터에 의해 별도로 삭제되지 않은 행이 반환됩니다. |
returnPropertyQuota |
이 애널리틱스 속성 할당량의 현재 상태를 반환할지 여부를 지정합니다. 할당량은 PropertyQuota에 반환됩니다. |