Method: customers.analysisQueries.start

저장된 분석 쿼리에 대한 실행을 시작합니다. 지정된 BigQuery 대상 테이블에 결과가 기록됩니다. 반환된 작업 이름을 사용하여 쿼리 완료 상태를 폴링할 수 있습니다.

HTTP 요청

POST https://adsdatahub.googleapis.com/v1/{name=customers/*/analysisQueries/*}:start

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

전체 리소스 이름(예: 'customers/123/analysisqueries/abcd1234')입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "spec": {
    object (QueryExecutionSpec)
  },
  "destTable": string,
  "customerId": string
}
필드
spec

object (QueryExecutionSpec)

쿼리 실행 매개변수를 정의합니다.

destTable

string

'project.dataset.table_name' 형식의 쿼리 결과 대상 BigQuery 테이블 지정된 경우 프로젝트는 고객의 ADH 계정에 대해 명시적으로 허용되어야 합니다. 프로젝트를 지정하지 않으면 제공된 고객의 기본 프로젝트가 사용됩니다. 프로젝트 및 데이터 세트를 모두 지정하지 않으면 기본 프로젝트 및 데이터 세트가 사용됩니다.

customerId

string (int64 format)

선택사항. 쿼리를 실행하는 Ads Data Hub 고객 지정하지 않으면 기본적으로 쿼리를 소유한 고객이 표시됩니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음과 같은 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/adsdatahub