Ads Data Hub의
두 가지 새로운 환경에 의해 도입된 최신 기능과 업데이트를 포함하여 문서가 업데이트되었습니다.
광고주, 대행사, 게시자는
마케팅 담당자 사이트를 참고하세요.
공급업체와 파트너는
측정 파트너 사이트를 참고하세요.
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
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2022-09-26(UTC)
[null,null,["최종 업데이트: 2022-09-26(UTC)"],[[["Starts execution of a stored user list query and uploads the results to a specified Google Ads user list."],["Users can track query completion status via the returned operation name."],["The request requires specifying the query execution parameters, Google Ads user list ID, and optionally, the Ads Data Hub customer ID."],["Successful execution returns an Operation object detailing the status and outcome."],["Authorization requires the `https://www.googleapis.com/auth/adsdatahub` scope."]]],["This document details the process of initiating a user list query in Google Ads Data Hub. A POST request is sent to a specific URL containing the user list query's name. The request body includes query execution parameters (`spec`), a Google Ads user list ID (`userListId`), and an optional customer ID (`customerId`). The query results are uploaded to the specified Google Ads user list. Upon success, an Operation object is returned, indicating the query's status. It also requires OAuth authorization with the `https://www.googleapis.com/auth/adsdatahub` scope.\n"]]
