Method: customers.accountLinks.mutate

계정 연결을 만들거나 삭제합니다. V5부터 AccountLinkService.MutateAccountLink를 통한 생성이 지원되지 않습니다. 대신 AccountLinkService.CreateAccountLink를 사용하세요.

발생한 오류 목록: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

HTTP 요청

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

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

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 수정되는 고객의 ID입니다.

요청 본문

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

JSON 표현 
{
  "operation": {
    object (AccountLinkOperation)
  },
  "partialFailure": boolean,
  "validateOnly": boolean
}
입력란
operation

object (AccountLinkOperation)

필수 항목입니다. 링크에서 수행할 작업입니다.
partialFailure

boolean

true인 경우 작업이 성공적으로 수행되고 잘못된 작업은 오류를 반환합니다. false인 경우 모든 작업이 모두 유효한 경우에만 하나의 트랜잭션에서 모든 작업이 수행됩니다. 기본값은 false입니다.
validateOnly

boolean

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

응답 본문

계정 링크 변경의 응답 메시지입니다.

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

JSON 표현 
{
  "result": {
    object (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
입력란
result

object (MutateAccountLinkResult)

변경 결과입니다.
partialFailureError

object (Status)

부분 실패 모드의 작업 실패와 관련된 오류입니다. PartialFailure = true이고 모든 오류가 연산 내에서 발생한 경우에만 반환됩니다. 작업 외부에서 오류가 발생하면 (예: 인증 오류) RPC 수준 오류가 반환됩니다.

승인 범위

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

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

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

AccountLinkOperation

계정 연결에 대한 단일 업데이트

JSON 표현 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (AccountLink)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
입력란
updateMask

string (FieldMask format)

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

필드의 정규화된 이름을 쉼표로 구분한 목록입니다. 예: "user.displayName,photo"
통합 필드 operation. 수행할 연산입니다. operation은 다음 중 하나여야 합니다.
update

object (AccountLink)

업데이트 작업: 계정 링크에 유효한 리소스 이름이 있어야 합니다.
remove

string

삭제 작업: 삭제할 계정 링크의 리소스 이름이 다음과 같은 형식이어야 합니다.

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

계정 링크 변경의 결과입니다.

JSON 표현 
{
  "resourceName": string
}
입력란
resourceName

string

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