Method: customers.keywordPlanCampaignKeywords.mutate

키워드 계획 캠페인 키워드를 생성, 업데이트 또는 삭제합니다. 작업 상태가 반환됩니다.

발생한 오류 목록: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanAdGroupKeywordError KeywordPlanCampaignKeywordError QuotaError RequestError ResourceCountLimitExceededError

HTTP 요청

POST https://googleads.googleapis.com/v17/customers/{customerId}/keywordPlanCampaignKeywords:mutate

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

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 캠페인 키워드를 수정 중인 고객의 ID입니다.

요청 본문

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

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

object (KeywordPlanCampaignKeywordOperation)

필수 항목입니다. 개별 키워드 계획 캠페인 키워드에 대해 수행할 작업의 목록입니다.

partialFailure

boolean

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

validateOnly

boolean

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

응답 본문

키워드 계획 캠페인 키워드 변형에 대한 응답 메시지입니다.

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

JSON 표현
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateKeywordPlanCampaignKeywordResult)
    }
  ]
}
필드
partialFailureError

object (Status)

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

results[]

object (MutateKeywordPlanCampaignKeywordResult)

변형의 모든 결과입니다.

승인 범위

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

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

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