지정된 사용자 데이터를 업로드합니다.
발생한 오류 목록: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError
HTTP 요청
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadUserData
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
customerId |
필수 항목입니다. 사용자 데이터를 업데이트할 고객의 ID입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "operations": [ { object ( |
필드 | |
---|---|
operations[] |
필수 항목입니다. 수행할 작업 목록입니다. |
통합 필드 metadata . 요청의 메타데이터입니다. metadata 은 다음 중 하나여야 합니다. |
|
customerMatchUserListMetadata |
고객 일치 타겟팅 사용자 목록의 데이터 업데이트에 대한 메타데이터입니다. |
응답 본문
이 서비스를 통해 업로드한 UserDataService.UploadUserData
에 대한 응답 메시지는 Google Ads UI에서 고객 일치 타겟팅 목록의 '세그먼트 회원' 섹션에 표시되지 않습니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "uploadDateTime": string, "receivedOperationsCount": integer } |
필드 | |
---|---|
uploadDateTime |
API에서 요청을 수신한 날짜 시간으로, 'yyyy-mm-dd hh:mm:ss+|-hh:mm' 형식입니다(예: '2019-01-01 12:32:45-08:00'). |
receivedOperationsCount |
API에서 수신한 업로드 데이터 작업 수입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.
UserDataOperation
UploadUserDataRequest에 대해 수행할 작업입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 operation . UploadUserDataRequest에 대해 수행할 작업입니다. operation 은 다음 중 하나여야 합니다. |
|
create |
사용자 목록에 추가될 사용자 데이터 목록입니다. |
remove |
사용자 목록에서 삭제할 사용자 데이터 목록입니다. |