계정 연결을 만들거나 삭제합니다. V5부터 AccountLinkService.MutateAccountLink를 통해 만들기가 지원되지 않습니다. 대신 AccountLinkService.CreateAccountLink를 사용하세요.
발생한 오류 목록: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError
HTTP 요청
POST https://googleads.googleapis.com/v15/customers/{customerId}/accountLinks:mutate
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
customerId |
필수 항목입니다. 수정되는 고객의 ID입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"operation": {
object ( |
필드 | |
---|---|
operation |
필수 항목입니다. 링크에서 수행할 연산입니다. |
partialFailure |
true인 경우 성공한 작업이 수행되고 잘못된 작업은 오류를 반환합니다. false인 경우 모든 작업이 유효한 경우에만 하나의 트랜잭션에서 모든 작업이 수행됩니다. 기본값은 false입니다. |
validateOnly |
true인 경우 요청의 유효성이 검사되지만 실행되지는 않습니다. 결과는 아닌 오류만 반환됩니다. |
응답 본문
계정 링크 변경에 대한 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "result": { object ( |
필드 | |
---|---|
result |
변경의 결과입니다. |
partialFailureError |
부분 실패 모드의 작업 실패와 관련된 오류입니다. InvalidFailure = true이고 작업 내에서 모든 오류가 발생하는 경우에만 반환됩니다. 작업 외부에서 오류 (예: 인증 오류)가 발생하면 RPC 수준 오류가 반환됩니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.
AccountLinkOperation
계정 연결에 대한 단일 업데이트입니다.
JSON 표현 |
---|
{ "updateMask": string, // Union field |
필드 | |
---|---|
updateMask |
업데이트 시 수정되는 리소스 필드를 결정하는 FieldMask입니다. 필드의 정규화된 이름을 쉼표로 구분한 목록입니다. 예: |
통합 필드 operation . 수행할 연산입니다. operation 은 다음 중 하나여야 합니다. |
|
update |
업데이트 작업: 계정 링크에 유효한 리소스 이름이 있어야 합니다. |
remove |
삭제 작업: 삭제할 계정 링크의 리소스 이름이 다음 형식으로 필요합니다.
|
MutateAccountLinkResult
계정 링크 변경의 결과입니다.
JSON 표현 |
---|
{ "resourceName": string } |
필드 | |
---|---|
resourceName |
작업이 성공하면 반환됩니다. |