Method: customers.customInterests.mutate

맞춤 관심분야를 만들거나 업데이트합니다. 작업 상태가 반환됩니다.

발생한 오류 목록: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

HTTP 요청

POST https://googleads.googleapis.com/v16/customers/{customerId}/customInterests:mutate

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

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 맞춤 관심분야가 수정 중인 고객의 ID입니다.

요청 본문

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

JSON 표현 
{
  "operations": [
    {
      object (CustomInterestOperation)
    }
  ],
  "validateOnly": boolean
}
필드
operations[]

object (CustomInterestOperation)

필수 항목입니다. 개별 맞춤 관심분야에 수행할 연산 목록입니다.
validateOnly

boolean

true인 경우 요청의 유효성만 확인하고 요청을 실행하지는 않습니다. 오류만 반환되고 결과는 반환되지 않습니다.

응답 본문

맞춤 관심분야 CHANGE에 대한 응답 메시지입니다.

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

JSON 표현 
{
  "results": [
    {
      object (MutateCustomInterestResult)
    }
  ]
}
필드
results[]

object (MutateCustomInterestResult)

변형에 대한 모든 결과입니다.

승인 범위

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

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

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

CustomInterestOperation

맞춤 관심분야에 대한 단일 작업(만들기, 업데이트)입니다.

JSON 표현 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomInterest)
  },
  "update": {
    object (CustomInterest)
  }
  // End of list of possible types for union field operation.
}
필드
updateMask

string (FieldMask format)

업데이트에서 수정되는 리소스 필드를 결정하는 FieldMask입니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"
통합 필드 operation. 변경 작업 operation은 다음 중 하나여야 합니다.
create

object (CustomInterest)

만들기 작업: 새 맞춤 관심분야에는 리소스 이름이 없습니다.
update

object (CustomInterest)

업데이트 작업: 맞춤 관심분야에는 유효한 리소스 이름이 있어야 합니다.

MutateCustomInterestResult

맞춤 관심분야 Variant의 결과입니다.

JSON 표현 
{
  "resourceName": string
}
필드
resourceName

string

작업에 성공하면 반환됩니다.