Method: customers.uploadUserData

지정된 사용자 데이터를 업로드합니다.

발생한 오류 목록: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

HTTP 요청

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadUserData

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

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 사용자 데이터를 업데이트할 고객의 ID입니다.

요청 본문

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

JSON 표현 
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
필드
operations[]

object (UserDataOperation)

필수 항목입니다. 수행할 작업 목록입니다.
통합 필드 metadata. 요청의 메타데이터입니다. metadata은 다음 중 하나여야 합니다.
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

고객 일치 타겟팅 사용자 목록의 데이터 업데이트에 대한 메타데이터입니다.

응답 본문

이 서비스를 통해 업로드한 UserDataService.UploadUserData에 대한 응답 메시지는 Google Ads UI에서 고객 일치 타겟팅 목록의 '세그먼트 회원' 섹션에 표시되지 않습니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
필드
uploadDateTime

string

API에서 요청을 수신한 날짜 시간으로, 'yyyy-mm-dd hh:mm:ss+|-hh:mm' 형식입니다(예: '2019-01-01 12:32:45-08:00').
receivedOperationsCount

integer

API에서 수신한 업로드 데이터 작업 수입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UserDataOperation

UploadUserDataRequest에 대해 수행할 작업입니다.

JSON 표현 
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
필드
통합 필드 operation. UploadUserDataRequest에 대해 수행할 작업입니다. operation은 다음 중 하나여야 합니다.
create

object (UserData)

사용자 목록에 추가될 사용자 데이터 목록입니다.
remove

object (UserData)

사용자 목록에서 삭제할 사용자 데이터 목록입니다.