이전 Search Ads 360 Reporting API의 지원이 종료되며 2024년 6월 30일에 사용 중단됩니다. Search Ads 360 Conversion API는 영향을 받지 않으며 계속 지원됩니다. 모든 보고 개발에서는 새 Search Ads 360 Reporting API를 사용해야 합니다.

2024년 4월부터 보고서를 요청할 때 지원되지 않는 APIVersion 오류가 반환됩니다. 자세한 내용은 여기를 참조하세요.

또한 기존 Search Ads 360 구현을 새 API로 이전하는 것이 좋습니다. 자세한 내용은 새 Search Ads 360 Reporting API 시작하기 및 이전 가이드를 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Reports

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

DoubleClick Search 보고서 이 객체에는 보고서 요청, 일부 보고서 메타데이터(예: 통화 코드), 생성된 보고서 행 또는 보고서 파일이 포함됩니다.

{
  "kind": "doubleclicksearch#report",
  "id": string,
  "isReportReady": boolean,
  "request": {
    "reportScope": {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "adGroupId": long,
      "keywordId": long,
      "adId": long
    },
    "reportType": string,
    "columns": [
      {
        "columnName": string,
        "savedColumnName": string,
        "customDimensionName": string,
        "customMetricName": string,
        "headerText": string,
        "startDate": string,
        "endDate": string,
        "groupByColumn": boolean,
        "platformSource": string,
        "productReportPerspective": string
      }
    ],
    "timeRange": {
      "startDate": string,
      "endDate": string,
      "changedMetricsSinceTimestamp": datetime,
      "changedAttributesSinceTimestamp": datetime
    },
    "filters": [
      {
        "column": {
          "columnName": string,
          "savedColumnName": string,
          "customDimensionName": string,
          "customMetricName": string,
          "headerText": string,
          "startDate": string,
          "endDate": string,
          "groupByColumn": boolean,
          "platformSource": string,
          "productReportPerspective": string
        },
        "operator": string,
        "values": [
          (value)
        ]
      }
    ],
    "orderBy": [
      {
        "column": {
          "columnName": string,
          "savedColumnName": string,
          "customDimensionName": string,
          "customMetricName": string,
          "headerText": string,
          "startDate": string,
          "endDate": string,
          "groupByColumn": boolean,
          "platformSource": string,
          "productReportPerspective": string
        },
        "sortOrder": string
      }
    ],
    "includeDeletedEntities": boolean,
    "includeRemovedEntities": boolean,
    "verifySingleTimeZone": boolean,
    "downloadFormat": string,
    "statisticsCurrency": string,
    "startRow": integer,
    "rowCount": integer,
    "maxRowsPerFile": integer
  },
  "statisticsCurrencyCode": string,
  "statisticsTimeZone": string,
  "rowCount": integer,
  "files": [
    {
      "url": string,
      "byteCount": long
    }
  ],
  "rows": [
    {
      (key): (value)
    }
  ]
}

속성 이름	값	설명
`files[]`	`list`	비동기 보고서 전용입니다. 보고서가 성공적으로 완료되면 생성되는 보고서 파일의 목록이 포함됩니다.
`files[].byteCount`	`long`	이 보고서 파일의 크기(바이트)
`files[].url`	`string`	이 URL을 사용하여 보고서 파일을 다운로드합니다.
`id`	`string`	비동기 보고서 전용입니다. 보고서의 ID입니다.
`isReportReady`	`boolean`	비동기 보고서 전용입니다. 보고서가 정상적으로 완료되고 보고서 파일을 다운로드할 준비가 된 경우에만 true입니다.
`kind`	`string`	보고서 리소스로 식별합니다. 값은 고정 문자열 `doubleclicksearch#report`입니다.
`request`	`nested object`	보고서를 생성한 요청입니다. 원래 요청에 지정되지 않은 선택적 필드는 기본값으로 채워집니다.
`request.columns[]`	`list`	보고서에 포함할 열입니다. 여기에는 DoubleClick Search 열과 저장된 열이 모두 포함됩니다. DoubleClick Search 열의 경우 `columnName` 매개변수만 필요합니다. 저장된 열의 경우 `savedColumnName` 매개변수만 필요합니다. 동일한 스탠자에 `columnName`와 `savedColumnName`를 모두 설정할 수 없습니다. 요청당 최대 열 수는 300개입니다.
`request.columns[].columnName`	`string`	보고서에 포함할 DoubleClick Search 열의 이름입니다.
`request.columns[].customDimensionName`	`string`	맞춤 측정기준에 따라 보고서를 분류합니다. 보고서의 범위는 광고주 이하로 지정되어야 하며 맞춤 측정기준은 이미 DoubleClick Search에 설정되어 있어야 합니다. DoubleClick Search에 표시되는 맞춤 측정기준 이름은 대소문자를 구분합니다. 전환 보고서에 사용된 경우 특정 전환에 대해 지정된 맞춤 측정기준의 값을 반환합니다(설정된 경우). 이 열은 전환 보고서를 분류하지 않습니다.
`request.columns[].customMetricName`	`string`	보고서에 포함할 맞춤 측정항목의 이름입니다. 보고서의 범위는 광고주 이하로 지정되어야 하며 맞춤 측정항목은 DoubleClick Search에 이미 설정되어 있어야 합니다. DoubleClick Search에 표시되는 맞춤 측정항목 이름은 대소문자를 구분합니다.
`request.columns[].endDate`	`string`	YYYY-MM-DD 형식의 포용하는 날입니다. 값이 제공되면 이 열에 대한 보고서의 전체 기간보다 우선 적용됩니다. `startDate`와 함께 제공해야 합니다.
`request.columns[].groupByColumn`	`boolean`	동기식 보고서 전용입니다. 이 열을 기준으로 그룹화하려면 `true`로 설정하세요. 기본값은 `false`입니다.
`request.columns[].headerText`	`string`	보고서 출력에서 이 열을 식별하는 데 사용되는 텍스트입니다. 지정하지 않으면 기본값은 `columnName` 또는 `savedColumnName`입니다. 이는 DoubleClick Search 열과 이름이 동일한 저장된 열 간의 충돌을 방지하는 데 사용할 수 있습니다.
`request.columns[].platformSource`	`string`	맞춤 측정기준에 데이터를 제공하는 데 사용되는 플랫폼입니다. 사용 가능한 값은 '플러드라이트'입니다.
`request.columns[].productReportPerspective`	`string`	특정 유형의 제품 활동에 관한 측정항목만 반환합니다. 허용되는 값은 다음과 같습니다. '`sold`': 판매된 제품의 측정항목만 반환합니다. '`advertised`': 쇼핑 캠페인에서 광고되었으며 판매되었거나 판매되지 않았을 수 있는 제품의 측정항목만 반환합니다.
`request.columns[].savedColumnName`	`string`	보고서에 포함할 저장된 열의 이름입니다. 보고서의 범위는 광고주 이하로 지정되어야 하며, 저장된 열은 DoubleClick Search UI에서 이미 만들어져 있어야 합니다.
`request.columns[].startDate`	`string`	YYYY-MM-DD 형식의 날짜를 포함합니다. 값이 제공되면 이 열에 대한 보고서의 전체 기간보다 우선 적용됩니다. `endDate`와 함께 제공해야 합니다.
`request.downloadFormat`	`string`	보고서가 반환되어야 하는 형식입니다. 현재 `csv` 또는 `tsv`가 지원됩니다.
`request.filters[]`	`list`	보고서에 적용할 필터의 목록입니다. 요청당 최대 필터 수는 300개입니다.
`request.filters[].column`	`nested object`	필터링할 열입니다. DoubleClick Search 열 또는 저장된 열일 수 있습니다.
`request.filters[].column.columnName`	`string`	보고서에 포함할 DoubleClick Search 열의 이름입니다.
`request.filters[].column.customDimensionName`	`string`	맞춤 측정기준에 따라 보고서를 분류합니다. 보고서의 범위는 광고주 이하로 지정되어야 하며 맞춤 측정기준은 이미 DoubleClick Search에 설정되어 있어야 합니다. DoubleClick Search에 표시되는 맞춤 측정기준 이름은 대소문자를 구분합니다. 전환 보고서에 사용된 경우 특정 전환에 대해 지정된 맞춤 측정기준의 값을 반환합니다(설정된 경우). 이 열은 전환 보고서를 분류하지 않습니다.
`request.filters[].column.customMetricName`	`string`	보고서에 포함할 맞춤 측정항목의 이름입니다. 보고서의 범위는 광고주 이하로 지정되어야 하며 맞춤 측정항목은 DoubleClick Search에 이미 설정되어 있어야 합니다. DoubleClick Search에 표시되는 맞춤 측정항목 이름은 대소문자를 구분합니다.
`request.filters[].column.endDate`	`string`	YYYY-MM-DD 형식의 포용하는 날입니다. 값이 제공되면 이 열에 대한 보고서의 전체 기간보다 우선 적용됩니다. `startDate`와 함께 제공해야 합니다.
`request.filters[].column.groupByColumn`	`boolean`	동기식 보고서 전용입니다. 이 열을 기준으로 그룹화하려면 `true`로 설정하세요. 기본값은 `false`입니다.
`request.filters[].column.headerText`	`string`	보고서 출력에서 이 열을 식별하는 데 사용되는 텍스트입니다. 지정하지 않으면 기본값은 `columnName` 또는 `savedColumnName`입니다. 이는 DoubleClick Search 열과 이름이 동일한 저장된 열 간의 충돌을 방지하는 데 사용할 수 있습니다.
`request.filters[].column.platformSource`	`string`	맞춤 측정기준에 데이터를 제공하는 데 사용되는 플랫폼입니다. 사용 가능한 값은 '플러드라이트'입니다.
`request.filters[].column.productReportPerspective`	`string`	특정 유형의 제품 활동에 관한 측정항목만 반환합니다. 허용되는 값은 다음과 같습니다. '`sold`': 판매된 제품의 측정항목만 반환합니다. '`advertised`': 쇼핑 캠페인에서 광고되었으며 판매되었거나 판매되지 않았을 수 있는 제품의 측정항목만 반환합니다.
`request.filters[].column.savedColumnName`	`string`	보고서에 포함할 저장된 열의 이름입니다. 보고서의 범위는 광고주 이하로 지정되어야 하며, 저장된 열은 DoubleClick Search UI에서 이미 만들어져 있어야 합니다.
`request.filters[].column.startDate`	`string`	YYYY-MM-DD 형식의 날짜를 포함합니다. 값이 제공되면 이 열에 대한 보고서의 전체 기간보다 우선 적용됩니다. `endDate`와 함께 제공해야 합니다.
`request.filters[].operator`	`string`	필터에 사용할 연산자입니다. 사용 가능한 연산자 목록은 필터 참조를 확인하세요.
`request.filters[].values[]`	`list`	열 값을 필터링할 값의 목록입니다. 요청당 필터 값의 최대 개수는 300개입니다.
`request.includeDeletedEntities`	`boolean`	삭제된 항목을 보고서에 포함해야 하는지 결정합니다. 기본값은 `false`입니다. 지원 중단되었습니다. 대신 `includeRemovedEntities`를 사용하세요.
`request.includeRemovedEntities`	`boolean`	삭제된 항목을 보고서에 포함해야 하는지 결정합니다. 기본값은 `false`입니다.
`request.maxRowsPerFile`	`integer`	비동기 보고서 전용입니다. 보고서 파일당 최대 행 수입니다. 대용량 보고서는 이 필드를 기준으로 여러 파일로 나뉩니다. 사용 가능한 값: `1000000`~`100000000`.
`request.orderBy[]`	`list`	동기식 보고서 전용입니다. 보고서 행에서 수행할 정렬을 정의하는 열과 경로의 목록입니다. 요청당 최대 주문 수는 300개입니다.
`request.orderBy[].column`	`nested object`	정렬을 수행할 열입니다. 이는 DoubleClick Search에서 정의한 열 또는 저장된 열일 수 있습니다.
`request.orderBy[].column.columnName`	`string`	보고서에 포함할 DoubleClick Search 열의 이름입니다.
`request.orderBy[].column.customDimensionName`	`string`	맞춤 측정기준에 따라 보고서를 분류합니다. 보고서의 범위는 광고주 이하로 지정되어야 하며 맞춤 측정기준은 이미 DoubleClick Search에 설정되어 있어야 합니다. DoubleClick Search에 표시되는 맞춤 측정기준 이름은 대소문자를 구분합니다. 전환 보고서에 사용된 경우 특정 전환에 대해 지정된 맞춤 측정기준의 값을 반환합니다(설정된 경우). 이 열은 전환 보고서를 분류하지 않습니다.
`request.orderBy[].column.customMetricName`	`string`	보고서에 포함할 맞춤 측정항목의 이름입니다. 보고서의 범위는 광고주 이하로 지정되어야 하며 맞춤 측정항목은 DoubleClick Search에 이미 설정되어 있어야 합니다. DoubleClick Search에 표시되는 맞춤 측정항목 이름은 대소문자를 구분합니다.
`request.orderBy[].column.endDate`	`string`	YYYY-MM-DD 형식의 포용하는 날입니다. 값이 제공되면 이 열에 대한 보고서의 전체 기간보다 우선 적용됩니다. `startDate`와 함께 제공해야 합니다.
`request.orderBy[].column.groupByColumn`	`boolean`	동기식 보고서 전용입니다. 이 열을 기준으로 그룹화하려면 `true`로 설정하세요. 기본값은 `false`입니다.
`request.orderBy[].column.headerText`	`string`	보고서 출력에서 이 열을 식별하는 데 사용되는 텍스트입니다. 지정하지 않으면 기본값은 `columnName` 또는 `savedColumnName`입니다. 이는 DoubleClick Search 열과 이름이 동일한 저장된 열 간의 충돌을 방지하는 데 사용할 수 있습니다.
`request.orderBy[].column.platformSource`	`string`	맞춤 측정기준에 데이터를 제공하는 데 사용되는 플랫폼입니다. 사용 가능한 값은 '플러드라이트'입니다.
`request.orderBy[].column.productReportPerspective`	`string`	특정 유형의 제품 활동에 관한 측정항목만 반환합니다. 허용되는 값은 다음과 같습니다. '`sold`': 판매된 제품의 측정항목만 반환합니다. '`advertised`': 쇼핑 캠페인에서 광고되었으며 판매되었거나 판매되지 않았을 수 있는 제품의 측정항목만 반환합니다.
`request.orderBy[].column.savedColumnName`	`string`	보고서에 포함할 저장된 열의 이름입니다. 보고서의 범위는 광고주 이하로 지정되어야 하며, 저장된 열은 DoubleClick Search UI에서 이미 만들어져 있어야 합니다.
`request.orderBy[].column.startDate`	`string`	YYYY-MM-DD 형식의 날짜를 포함합니다. 값이 제공되면 이 열에 대한 보고서의 전체 기간보다 우선 적용됩니다. `endDate`와 함께 제공해야 합니다.
`request.orderBy[].sortOrder`	`string`	정렬 방향(`ascending` 또는 `descending`)입니다.
`request.reportScope`	`object`	reportScope는 보고서에 반환되는 항목의 하위 집합을 결정하는 데 사용되는 ID 집합입니다. 대행사를 통해 원하는 가장 낮은 범위 수준에서 ID의 전체 계보가 필요합니다.
`request.reportScope.adGroupId`	`long`	DS 광고그룹 ID
`request.reportScope.adId`	`long`	DS 광고 ID
`request.reportScope.advertiserId`	`long`	DS 광고주 ID
`request.reportScope.agencyId`	`long`	DS 대행사 ID를 찾습니다.
`request.reportScope.campaignId`	`long`	DS 캠페인 ID입니다.
`request.reportScope.engineAccountId`	`long`	DS 엔진 계정 ID
`request.reportScope.keywordId`	`long`	DS 키워드 ID입니다.
`request.reportType`	`string`	보고서에 반환되는 행의 유형을 결정합니다. 예를 들어 `reportType: keyword`를 지정하면 보고서의 각 행에 키워드에 대한 데이터가 포함됩니다. 각 유형에서 사용할 수 있는 항목은 보고서 유형 참고 자료에서 확인하세요.
`request.rowCount`	`integer`	동기식 보고서 전용입니다. 반환할 최대 행 수입니다. 추가 행이 삭제됩니다 사용 가능한 값: `0`~`10000`. 기본값은 `10000`입니다.
`request.startRow`	`integer`	동기식 보고서 전용입니다. 반환할 첫 번째 행의 0부터 시작하는 색인입니다. 사용 가능한 값: `0`~`50000`. 기본값은 `0`입니다.
`request.statisticsCurrency`	`string`	금액이 반환될 통화를 지정합니다. 가능한 값은 `usd`, `agency` (보고서 범위가 대행사 이하로 지정된 경우 유효함), `advertiser` (보고서의 범위가 * 광고주 이하로 지정된 경우 유효함) 또는 `account` (보고서 범위가 엔진 계정 이하로 지정된 경우 유효함)입니다.
`request.timeRange`	`object`	보고서에서 측정항목을 요청하는 경우 이 인수는 측정항목을 특정 기간으로 제한하는 데 사용됩니다.
`request.timeRange.changedAttributesSinceTimestamp`	`datetime`	RFC 형식의 포괄적인 UTC 타임스탬프입니다. 예: `2013-07-16T10:16:23.555Z`. 변경된 속성 보고서의 작동 방식에 대한 추가 참조를 확인하세요.
`request.timeRange.changedMetricsSinceTimestamp`	`datetime`	RFC 형식의 포괄적인 UTC 타임스탬프입니다. 예: `2013-07-16T10:16:23.555Z`. 변경된 측정항목 보고서의 작동 방식에 관한 추가 참조를 확인하세요.
`request.timeRange.endDate`	`string`	YYYY-MM-DD 형식의 날짜를 포함합니다.
`request.timeRange.startDate`	`string`	YYYY-MM-DD 형식의 날짜를 포함합니다.
`request.verifySingleTimeZone`	`boolean`	`true`인 경우 요청된 모든 통계 데이터의 출처가 단일 시간대인 경우에만 보고서가 생성됩니다. 기본값은 `false`입니다.
`rowCount`	`integer`	보고서에서 생성된 보고서 행 수입니다. 헤더는 포함되지 않습니다.
`rows[]`	`list`	동기식 보고서 전용입니다. 생성된 보고서 행입니다.
`rows[].(key)`	`any value`	이 행에 표시되는 열을 나타냅니다. 즉, 각 키는 이 행에 비어 있지 않은 셀이 있는 열에 해당합니다.
`statisticsCurrencyCode`	`string`	사용자가 설정한 값 (예: 키워드 입찰가 설정) 및 측정항목 (예: 비용 및 수익)을 비롯하여 보고서에서 생성된 모든 금전적 가치의 통화 코드입니다. 보고서의 통화 코드는 보고서 요청의 `statisticsCurrency` 필드에 따라 결정됩니다.
`statisticsTimeZone`	`string`	보고서의 모든 통계의 출처가 동일한 시간대인 경우 이 시간대입니다. 그렇지 않으면 필드가 설정되지 않습니다.

메서드

생성: 보고서를 즉시 생성하고 반환합니다.
get: 보고서 요청 상태에 대한 설문조사입니다.
getFile: UTF-8로 인코딩된 보고서 파일을 다운로드합니다.
getIdMappingFile: 이전 Search Ads 360과 새 Search Ads 360 간의 ID 매핑이 포함된 CSV 파일 (UTF-8로 인코딩됨)을 다운로드합니다. 요청된 광고주의 경우 파일에는 이전 Search Ads 360과 새 Search Ads 360 모두에 존재하는 모든 하위 항목 (예: 엔진 계정, 캠페인, 광고 그룹 등)이 포함됩니다.
요청: 신고 시스템에 신고 요청을 삽입합니다.