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. 새 결제 설정을 만들 때는 이 시점에 설정이 적용됩니다. 고객에게 승인된 설정이 없는 경우 시작 시간으로만 '지금'이 허용됩니다.

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

string

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

enum (TimeType)

변경할 수 없습니다. 유형인 시작 시간입니다. NOW만 허용됩니다.
통합 필드 end_time. 결제 설정이 종료 / 종료되는 시점 '영구' 또는 예약된 다음 결제 설정의 시작 시간입니다. 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가 표시됩니다.