결제 설정은 Google Ads 계정과 결제 계정 간의 계정 수준 링크 (인보이스 설정이라고도 함)로, 결제 설정의 계정 예산으로 발생한 비용에 대해 누가 청구를 받게 될지 효과적으로 결정합니다. 각 결제 계정은 단일 인보이스에 해당합니다.
Payments 계정 정보
각 BillingSetup
는 계정 예산으로 발생한 비용에 대해 인보이스가 발행되는 결제 계정을 식별합니다. 이 결제 계정은 궁극적으로 청구를 담당하는 결제 프로필과 연결됩니다.
결제 설정에는 payments_account
필드와 결제 계정이 사용 중임을 나타내는 payments_account_info
필드 그룹(다음 포함)이 모두 포함됩니다.
payments_account_info.payments_account_id
: 결제 설정과 연결된 결제 계정을 식별하는 데 사용되는 16자리 ID입니다.payments_account_info.payments_account_name
: 결제 설정과 연결된 결제 계정의 이름입니다. 이 이름은 월별 인보이스에 인쇄됩니다.payments_account_info.payments_profile_id
: 결제 설정과 연결된 결제 프로필을 식별하는 데 사용되는 12자리 ID입니다.
Payments 계정이 통합 결제를 사용할 수 있는 경우 결제 설정을 동일한 기본 Payments 계정을 사용하도록 설정하여 여러 Google Ads 계정을 동일한 인보이스에 그룹화할 수 있습니다.
새 결제 설정 만들기
새 결제 설정을 기존 결제 계정 또는 동시에 만든 계정에 연결할 수 있습니다.
기존 결제 계정 사용
기존 결제 계정과 연결하려면 payments_account
를 유효한 결제 계정의 리소스 ID로 설정합니다. 그러나 payments_account_info
는 수정하면 안 됩니다.
PaymentsAccountService.ListPaymentsAccounts
메서드를 사용하여 사용 가능한 결제 계정을 나열할 수 있습니다. 반환된 PaymentsAccounts
는 인증에 사용하는 관리자 계정에 따라 다릅니다.
각 PaymentsAccount
의 경우 결제 관리자의 ID가 paying_manager_customer
필드에 있습니다.
새 결제 계정 사용
새 결제 계정과 연결하려면 payments_account_info
에서 다음 필드를 설정합니다(payments_account
는 설정하지 마세요).
아래 예에서는 기존 결제 프로필 ID에서 새 결제 설정을 만드는 방법을 보여줍니다. 위에서 설명한 대로 My New Payments Account
라는 새 결제 계정도 생성됩니다.
BillingSetup bsetup = BillingSetup.newBuilder()
.setPaymentsAccountInfo(PaymentsAccountInfo.newBuilder()
.setPaymentsAccountName("My New Payments Account")
.setPaymentsProfileId("1234-5678-9012")
.build())
.setStartTimeType(TimeType.NOW)
.build();
BillingSetupOperation op = BillingSetupOperation.newBuilder().setCreate(bsetup).build();
try (BillingSetupServiceClient billingSetupServiceClient = googleAdsClient
.getBillingSetupServiceClient()) {
MutateBillingSetupResponse response =
billingSetupServiceClient.mutateBillingSetup(Long.toString(customerId), op);
}
Google Ads 계정에 처음으로 결제 설정을 추가하는 경우 참조된 결제 프로필을 사용하여 고객을 결제에 가입시킵니다.
결제 설정 상태
새 BillingSetup
인스턴스는 적용되기 전에 승인을 받아야 합니다. 그때까지는 status
가 PENDING
상태입니다.
BillingSetup
는 다음 status
중 하나일 수 있습니다.
결제 설정 상태 | 설명 |
---|---|
PENDING |
승인 대기중 |
APPROVED_HELD |
승인되었지만 해당하는 첫 번째 예산은 승인되지 않았습니다. 이 오류는 월별 인보이스 발행으로 구성된 결제 설정에서만 발생할 수 있습니다. |
APPROVED |
설정이 승인되었습니다. |
CANCELLED |
승인 전에 사용자가 설정을 취소했습니다. |
계정의 결제 설정 검색
Google Ads API의 다른 대부분의 항목과 마찬가지로 BillingSetup
는 반환할 필드를 지정하는 Google Ads 쿼리 언어 쿼리를 사용하여 GoogleAdsService.SearchStream
를 쿼리하여 가져옵니다.
BillingSetup
참조를 가져오면 계정 예산에 설명된 대로 AccountBudgetProposal
를 만들 수 있습니다.
대기 중인 결제 설정 취소하기
아직 적용되지 않은 BillingSetup
는 삭제 작업을 사용하여 취소할 수 있습니다. 결제 설정은 status
이 PENDING
이거나 향후 언젠가 시작될 예정인 경우에만 취소할 수 있습니다.APPROVED