Method: customers.accountBudgetProposals.mutate

계정 예산 제안서를 생성, 업데이트 또는 삭제합니다. 작업 상태가 반환됩니다.

발생한 오류 목록: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaError RequestErrorStringLengthError

HTTP 요청

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

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

경로 매개변수

매개변수
customerId

string

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

요청 본문

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

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

object (AccountBudgetProposalOperation)

필수 항목입니다. 개인 계정 수준 예산 제안에 대해 수행할 연산입니다.
validateOnly

boolean

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

응답 본문

계정 수준 예산 변경 작업에 대한 응답 메시지입니다.

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

JSON 표현 
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
입력란
result

object (MutateAccountBudgetProposalResult)

변경 결과입니다.

승인 범위

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

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

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

AccountBudgetProposalOperation

새로운 계정 단위 예산의 생성 또는 기존 예산의 수정/종료/삭제를 제안하는 단일 작업입니다.

JSON 표현 
{
  "updateMask": string,

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

string (FieldMask format)

수정할 예산 필드를 결정하는 FieldMask입니다. 예산은 변경될 수 있지만 이러한 수정을 제안하는 제안은 최종적입니다. 따라서 제안서에는 업데이트 작업이 지원되지 않습니다.

예산을 수정하는 제안서에는 '업데이트' 제안서 유형이 포함됩니다. 다른 제안서 유형에 마스크를 지정하면 오류로 간주됩니다.

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

object (AccountBudgetProposal)

만들기 작업: 새 예산을 만들거나, 기존 예산을 수정하거나, 운영 중인 예산을 종료하거나, 향후 시작하도록 예약된 승인된 예산을 삭제하는 새 제안서입니다. 새 제안서에는 리소스 이름이 필요하지 않습니다.
remove

string

삭제 작업: 삭제된 제안서의 리소스 이름은 다음 형식으로 표시됩니다.

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id} 대기 중인 요청은 취소될 수 있습니다.

MutateAccountBudgetProposalResult

계정 예산 제안 변경의 결과입니다.

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

string

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