Method: customers.billingSetups.mutate

결제 설정을 만들거나 기존 결제 설정을 취소합니다.

발생한 오류 목록: AuthenticationError AuthorizationError BillingSetupError DateError FieldError HeaderError InternalError MutateError QuotaError RequestError

HTTP 요청

POST https://googleads.googleapis.com/v14/customers/{customerId}/billingSetups:mutate

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

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 결제 설정 변경 작업을 적용할 고객의 ID입니다.

요청 본문

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

JSON 표현 
{
  "operation": {
    object (BillingSetupOperation)
  }
}
필드
operation

object (BillingSetupOperation)

필수 항목입니다. 수행할 연산입니다.

응답 본문

결제 설정 작업에 대한 응답 메시지입니다.

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

JSON 표현 
{
  "result": {
    object (MutateBillingSetupResult)
  }
}
필드
result

object (MutateBillingSetupResult)

변경 요청의 영향을 받은 리소스를 식별하는 결과입니다.

승인 범위

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

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

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

BillingSetupOperation

결제 설정에 대한 단일 작업으로, 기존 결제 설정의 취소를 설명합니다.

JSON 표현 
{

  // Union field operation can be only one of the following:
  "create": {
    object (BillingSetup)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
필드
통합 필드 operation. 이 작업 중 하나만 설정할 수 있습니다. '업데이트' 작업은 지원되지 않습니다. operation은 다음 중 하나여야 합니다.
create

object (BillingSetup)

결제 설정을 만듭니다. 새 결제 설정에 필요한 리소스 이름이 없습니다.
remove

string

삭제할 결제 설정의 리소스 이름입니다. 대기 중 상태가 아니거나 예약된 시작 시간이 미래인 경우가 아니면 설정을 삭제할 수 없습니다. 리소스 이름은 customers/{customerId}/billingSetups/{billing_id}과 같습니다.

MutateBillingSetupResult

단일 결제 설정 변경의 결과입니다.

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

string

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