BillingSetup

결제 계정과 광고주를 연결하는 결제 설정입니다. 결제 설정은 광고주별로 다릅니다.

JSON 표현 
{
  "resourceName": string,
  "status": enum (BillingSetupStatus),
  "paymentsAccountInfo": {
    object (PaymentsAccountInfo)
  },
  "id": string,
  "paymentsAccount": string,

  // Union field start_time can be only one of the following:
  "startDateTime": string,
  "startTimeType": enum (TimeType)
  // End of list of possible types for union field start_time.

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.
}
필드
resourceName

string

변경할 수 없습니다. 결제 설정의 리소스 이름입니다. BillingSetup 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/billingSetups/{billing_setup_id}
status

enum (BillingSetupStatus)

출력 전용입니다. 결제 설정의 상태입니다.
paymentsAccountInfo

object (PaymentsAccountInfo)

변경할 수 없습니다. 이 결제 설정과 연결된 결제 계정 정보입니다. 결제를 설정할 때 새 결제 계정으로 가입하는 데 사용됩니다(이 경우 paymentsAccount는 설정하면 안 됨). 결제 설정을 가져올 때 이 속성과 paymentsAccount가 채워집니다.
id

string (int64 format)

출력 전용입니다. 결제 설정의 ID입니다.
paymentsAccount

string

변경할 수 없습니다. 이 결제 설정과 연결된 결제 계정의 리소스 이름입니다. 결제 리소스 이름은 다음과 같은 형식입니다.

customers/{customerId}/paymentsAccounts/{paymentsAccountId} 결제를 설정할 때 기존 결제 계정으로 가입하는 데 사용됩니다(이 경우 paymentsAccountInfo를 설정해서는 안 됨). 결제를 설정할 때 이 및 paymentsAccountInfo가 채워집니다.

통합 필드 start_time. 새 결제 설정을 만들 때 설정이 적용됩니다. 고객에게 승인된 설정이 없는 경우 NOW(지금)만 허용되는 시작 시간입니다.

기존 결제 설정을 가져올 때 요청된 시작 시간입니다. 하지만 요청된 시작 시간 이후에 설정이 승인 (상태 확인)된 경우에는 이 시간이 승인 시간입니다. start_time는 다음 중 하나여야 합니다.
startDateTime

string

변경할 수 없습니다. 시작 날짜 시간으로 yyyy-MM-dd 또는 yyyy-MM-dd HH:mm:ss 형식입니다. 미래 시간만 허용됩니다.
startTimeType

enum (TimeType)

변경할 수 없습니다. 유형인 시작 시간입니다. NOW만 허용됩니다.
통합 필드 end_time. 결제 설정이 종료된 시점입니다. 이 값은 FOREVER(영원) 또는 다음에 예약된 결제 설정의 시작 시간입니다. end_time은 다음 중 하나여야 합니다.
endDateTime

string

출력 전용입니다. yyyy-MM-dd 또는 yyyy-MM-dd HH:mm:ss 형식의 종료일 시간입니다.
endTimeType

enum (TimeType)

출력 전용입니다. 종료 시간 유형입니다. 유일하게 허용되는 값은 FOREVER입니다.

BillingSetupStatus

BillingSetup의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
PENDING 결제 설정이 승인 대기 중입니다.
APPROVED_HELD 결제 설정이 승인되었지만 해당하는 첫 번째 예산은 승인되지 않았습니다. 이 오류는 월별 인보이스 발행으로 구성된 결제 설정에서만 발생할 수 있습니다.
APPROVED 결제 설정이 승인되었습니다.
CANCELLED 승인 전에 사용자가 결제 설정을 취소했습니다.

PaymentsAccountInfo

이 결제의 결제 계정 정보 컨테이너입니다.

JSON 표현 
{
  "paymentsAccountId": string,
  "paymentsAccountName": string,
  "paymentsProfileId": string,
  "paymentsProfileName": string,
  "secondaryPaymentsProfileId": string
}
필드
paymentsAccountId

string

출력 전용입니다. 결제 설정과 연결된 결제 계정을 식별하는 데 사용되는 16자리 ID입니다.

이 값은 대시가 포함된 문자열로 전달되어야 합니다(예: '1234-5678-9012-3456').
paymentsAccountName

string

변경할 수 없습니다. 결제 설정과 연결된 결제 계정의 이름입니다.

이를 통해 사용자는 월별 인보이스의 조정에 도움이 되는 의미 있는 결제 계정 이름을 지정할 수 있습니다.

이 이름은 월별 인보이스에 인쇄됩니다.
paymentsProfileId

string

변경할 수 없습니다. 결제 설정과 연결된 결제 프로필을 식별하는 데 사용되는 12자리 ID입니다.

대시가 포함된 문자열로 전달해야 합니다(예: '1234-5678-9012').
paymentsProfileName

string

출력 전용입니다. 결제 설정과 연결된 결제 프로필의 이름입니다.
secondaryPaymentsProfileId

string

출력 전용입니다. 수금 후 결제 계약이 체결된 경우와 같이 흔하지 않은 상황에 있는 보조 결제 프로필 ID입니다.