Thông tin thanh toán là mối liên kết ở cấp tài khoản giữa tài khoản Google Ads và Tài khoản thanh toán (còn gọi là thông tin lập hoá đơn). Thông tin này sẽ xác định người thanh toán cho các chi phí phát sinh từ ngân sách tài khoản của thông tin thanh toán. Mỗi Tài khoản thanh toán tương ứng với một hoá đơn.
Giới thiệu về Tài khoản thanh toán
Mỗi BillingSetup xác định một Tài khoản thanh toán được lập hoá đơn cho các chi phí phát sinh từ ngân sách tài khoản. Tài khoản thanh toán này được liên kết với một Hồ sơ thanh toán chịu trách nhiệm cuối cùng về các khoản phí.
Thông tin thanh toán chứa cả trường payments_account và một nhóm các trường payments_account_info xác định Tài khoản thanh toán đang được sử dụng, bao gồm cả những trường sau:
payments_account_info.payments_account_id: Mã nhận dạng gồm 16 chữ số được định dạng dưới dạng một chuỗi có dấu gạch ngang (ví dụ:"1234-5678-9012-3456") dùng để xác định Tài khoản thanh toán được liên kết với chế độ thiết lập thông tin thanh toán.payments_account_info.payments_account_name: Tên của Tài khoản thanh toán được liên kết với chế độ thiết lập thông tin thanh toán. Tên này sẽ được in trên hoá đơn hằng tháng.payments_account_info.payments_profile_id: Mã nhận dạng gồm 12 chữ số được định dạng dưới dạng một chuỗi có dấu gạch ngang (ví dụ:"1234-5678-9012") dùng để xác định Hồ sơ thanh toán được liên kết với chế độ thiết lập thông tin thanh toán.
Nếu một Tài khoản thanh toán đủ điều kiện sử dụng chế độ thanh toán tổng hợp, thì bạn có thể nhóm nhiều tài khoản Google Ads vào cùng một hoá đơn bằng cách thiết lập thông tin thanh toán của các tài khoản đó để sử dụng cùng một Tài khoản thanh toán cơ bản.
Tạo thông tin thanh toán mới
Bạn có thể liên kết thông tin thanh toán mới với Tài khoản thanh toán hiện có hoặc tài khoản được tạo cùng lúc.
Sử dụng Tài khoản thanh toán hiện có
Để liên kết với một Tài khoản thanh toán hiện có, hãy đặt payments_account thành tên tài nguyên của một Tài khoản thanh toán hợp lệ (ví dụ: customers/{customer_id}/paymentsAccounts/{payments_account_id}). Tuy nhiên, đừng sửa đổi payments_account_info.
Bạn có thể liệt kê các tài khoản Payments hiện có bằng phương thức PaymentsAccountService.ListPaymentsAccounts.
Các đối tượng PaymentsAccount được trả về sẽ tuỳ thuộc vào tài khoản người quản lý mà bạn dùng để xác thực.
Đối với mỗi PaymentsAccount, tên tài nguyên của người quản lý thanh toán nằm trong trường paying_manager_customer.
Sử dụng tài khoản thanh toán mới
Để liên kết với một Tài khoản thanh toán mới, hãy đặt các trường sau trong payments_account_info (không đặt payments_account):
Ví dụ sau đây cho thấy cách tạo thông tin thanh toán mới từ Mã hồ sơ thanh toán hiện có. Như đã nêu trước đó, thao tác này cũng sẽ tạo một Tài khoản thanh toán mới có tên 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);
}
Nếu đây là thông tin thanh toán đầu tiên được thêm vào một tài khoản Google Ads, thì thông tin này sẽ đăng ký cho khách hàng thanh toán bằng Hồ sơ thanh toán được tham chiếu.
Trạng thái thông tin thanh toán
Các phiên bản BillingSetup mới phải được phê duyệt trước khi có hiệu lực. Cho đến lúc đó, status của họ sẽ ở trạng thái PENDING.
BillingSetup có thể có một trong các giá trị status sau đây:
BillingSetupStatus |
Mô tả |
|---|---|
PENDING |
Đang chờ phê duyệt. |
APPROVED_HELD |
Đã phê duyệt, nhưng ngân sách đầu tiên tương ứng chưa được phê duyệt. Điều này chỉ có thể xảy ra đối với những thông tin thanh toán được thiết lập để lập hoá đơn hằng tháng. |
APPROVED |
Quá trình thiết lập đã được phê duyệt. |
CANCELLED |
Người dùng đã huỷ quá trình thiết lập trước khi phê duyệt. |
Truy xuất thông tin thanh toán của một tài khoản
Giống như hầu hết các thực thể khác trong Google Ads API, BillingSetup được tìm nạp bằng cách truy vấn GoogleAdsService.Search hoặc GoogleAdsService.SearchStream bằng cách sử dụng một truy vấn Ngôn ngữ truy vấn Google Ads (GAQL) chỉ định những trường cần trả về:
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
Sau khi nhận được thông tin tham chiếu đến BillingSetup, bạn có thể dùng thông tin đó để tạo AccountBudgetProposal như mô tả trong phần Ngân sách tài khoản.
Huỷ thông tin thanh toán đang chờ xử lý
Bạn có thể huỷ BillingSetup chưa có hiệu lực bằng cách gửi một BillingSetupOperation có trường remove được đặt thành tên tài nguyên của chế độ thiết lập thông tin thanh toán (customers/{customer_id}/billingSetups/{billing_setup_id}). Bạn chỉ có thể huỷ chế độ thiết lập thông tin thanh toán nếu status là PENDING hoặc nếu chế độ này APPROVED bắt đầu vào một thời điểm nào đó trong tương lai.