결제 설정

결제 설정은 Google Ads 계정과 결제 계정 (인보이스 설정이라고도 함) 간의 계정 수준 링크로, 결제 설정의 계정 예산으로 발생한 비용에 대해 청구되는 사용자를 효과적으로 결정합니다. 각 결제 계정은 하나의 인보이스에 해당합니다.

지급 계정 정보

각 BillingSetup은 계정 예산으로 발생한 비용에 대한 인보이스가 발급되는 결제 계정을 식별합니다. 이 결제 계정은 궁극적으로 요금을 책임지는 결제 프로필과 연결되어 있습니다.

결제 설정에는 payments_account 필드와 사용 중인 결제 계정을 식별하는 payments_account_info 필드 그룹이 모두 포함됩니다. 여기에는 다음이 포함됩니다.

결제 계정이 통합 결제를 사용할 수 있는 경우 결제 설정을 동일한 기본 결제 계정을 사용하도록 설정하여 여러 Google Ads 계정을 동일한 인보이스로 그룹화할 수 있습니다.

새 결제 설정 만들기

새 결제 설정을 기존 결제 계정 또는 동시에 생성된 계정에 연결할 수 있습니다.

기존 결제 계정 사용

기존 결제 계정과 연결하려면 payments_account을 유효한 결제 계정의 리소스 이름 (예: customers/{customer_id}/paymentsAccounts/{payments_account_id})으로 설정합니다. 하지만 payments_account_info은 수정하지 마세요.

PaymentsAccountService.ListPaymentsAccounts 메서드를 사용하여 사용 가능한 결제 계정을 나열할 수 있습니다. 반환되는 PaymentsAccount 객체는 인증에 사용하는 관리자 계정에 따라 달라집니다.

각 PaymentsAccount의 경우 결제 관리자의 리소스 이름이 paying_manager_customer 필드에 있습니다.

새 결제 계정 사용

새 결제 계정과 연결하려면 payments_account_info에서 다음 필드를 설정하세요 (payments_account은 설정하지 마세요).

다음 예시에서는 기존 결제 프로필 ID에서 새 결제 설정을 만드는 방법을 보여줍니다. 앞서 언급한 것처럼 이렇게 하면 My New Payments Account라는 이름의 새 결제 계정도 생성됩니다.

BillingSetup billingSetup =
    BillingSetup.newBuilder()
        .setPaymentsAccountInfo(
            PaymentsAccountInfo.newBuilder()
                .setPaymentsAccountName("My New Payments Account")
                .setPaymentsProfileId("1234-5678-9012")
                .build())
        .setStartTimeType(TimeTypeEnum.TimeType.NOW)
        .build();

BillingSetupOperation operation =
    BillingSetupOperation.newBuilder().setCreate(billingSetup).build();

try (BillingSetupServiceClient billingSetupServiceClient =
    googleAdsClient.getBillingSetupServiceClient()) {
  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(
          Long.toString(customerId), operation);
}

Google Ads 계정에 추가되는 첫 번째 결제 설정인 경우 참조된 결제 프로필을 사용하여 고객이 결제에 가입하게 됩니다.

결제 설정 상태

새 BillingSetup 인스턴스는 적용되기 전에 승인을 받아야 합니다. 그때까지 status는 PENDING 상태입니다.

BillingSetup은 다음 status 값 중 하나를 가질 수 있습니다.

BillingSetupStatus 설명
PENDING 승인 대기중
APPROVED_HELD 승인되었지만 해당 첫 번째 예산이 승인되지 않았습니다. 이 오류는 월별 인보이스로 구성된 결제 설정에만 발생할 수 있습니다.
APPROVED 설정이 승인되었습니다.
CANCELLED 승인 전에 사용자가 설정을 취소했습니다.

계정의 결제 설정을 가져옵니다.

Google Ads API의 다른 대부분의 항목과 마찬가지로 BillingSetup는 반환할 필드를 지정하는 Google Ads 쿼리 언어(GAQL) 쿼리를 사용하여 GoogleAdsService.Search 또는 GoogleAdsService.SearchStream를 쿼리하여 가져옵니다.

SELECT
  billing_setup.resource_name,
  billing_setup.id,
  billing_setup.status,
  billing_setup.payments_account,
  billing_setup.payments_account_info.payments_account_id,
  billing_setup.payments_account_info.payments_account_name,
  billing_setup.payments_account_info.payments_profile_id,
  billing_setup.payments_account_info.payments_profile_name,
  billing_setup.start_date_time,
  billing_setup.end_date_time,
  billing_setup.end_time_type
FROM billing_setup

BillingSetup에 대한 참조를 획득하면 계정 예산에 설명된 대로 이를 사용하여 AccountBudgetProposal을 만들 수 있습니다.

대기 중인 결제 설정 취소하기

아직 적용되지 않은 BillingSetup는 remove 필드가 결제 설정 (customers/{customer_id}/billingSetups/{billing_setup_id})의 리소스 이름으로 설정된 BillingSetupOperation를 전송하여 취소할 수 있습니다. 결제 설정은 status이 PENDING이거나 향후에 시작되도록 APPROVED된 경우에만 취소할 수 있습니다.

이전
결제 개요
다음
계정 예산