Method: customers.userListQueries.start

저장된 사용자 목록 쿼리에 관한 실행을 시작합니다. 지정된 Google Ads 사용자 목록에 업로드된 결과입니다. 반환된 작업 이름을 사용하여 쿼리 완료 상태를 폴링할 수 있습니다.

HTTP 요청

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

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

경로 매개변수

매개변수
name

string

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

요청 본문

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

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

object (QueryExecutionSpec)

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

userListId

string (int64 format)

Google Ads 사용자 목록 ID입니다. 쿼리를 실행하는 Ads Data Hub 고객이 사용자 목록을 관리해야 합니다.

customerId

string (int64 format)

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

응답 본문

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

승인 범위

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

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