결제 설정은 Google Ads 계정과 결제 계정 (인보이스 설정이라고도 함) 간의 계정 수준 연결로서, 결제 설정의 계정 예산으로 인해 발생하는 비용을 누가 청구할지 효과적으로 결정합니다. 각 결제 계정은 하나의 인보이스에 해당합니다.
결제 계정 정보
각 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입니다.
하나의 결제 계정이 통합 결제의 대상이 되는 경우, 동일한 기본 결제 계정을 사용하도록 결제 설정을 설정하여 여러 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의 다른 대부분의 항목과 마찬가지로, 반환할 필드를 지정하는 Google Ads 쿼리 언어 쿼리를 사용해 GoogleAdsService.SearchStream
를 쿼리하여 BillingSetup
를 가져옵니다.
BillingSetup
에 대한 참조를 가져오면
계정 예산에 설명된 대로
이를 사용하여 AccountBudgetProposal
를
생성할 수 있습니다.
대기 중인 결제 설정 취소하기
아직 적용되지 않은 BillingSetup
는 삭제 작업을 사용하여 취소할 수 있습니다. 결제 설정은 status
가 PENDING
이거나 나중에 시작할 APPROVED
인 경우에만 취소할 수 있습니다.