Thiết lập thanh toán

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 Google Payments tài khoản (còn được gọi là hoá đơn) thiết lập). Điều này giúp bạn đạt được hiệu quả cao xác định người được lập hoá đơn cho các chi phí phát sinh từ tài khoản của thông tin thanh toán này ngân sách. 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 chi phí phát sinh từ ngân sách tài khoản. Khoản thanh toán này được liên kết với một thẻ Thanh toán hồ sơ mà cuối cùng là chịu trách nhiệm về các khoản phí.

Thông tin thanh toán chứa cả payments_account và một nhóm payments_account_info xác định Tài khoản thanh toán đang được sử dụng, bao gồm các trường sau:

Nếu một tài khoản Thanh toán đủ điều kiện sử dụng phương thức hợp nhất , sau đó chọn nhiều tùy chọn thanh toán Google Bạn có thể nhóm các tài khoản Google Ads trong cùng một hoá đơn bằng cách thiết lập thông tin thanh toán để sử dụng cùng một tài khoản Thanh toán cơ bản.

Đang 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 các tài khoản thanh toán hiện có hoặc các tài khoản đã tạo .

Sử dụng một 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 đến mã tài nguyên của một Tài khoản thanh toán hợp lệ. Tuy nhiên, không sửa đổi payments_account_info.

Bạn có thể liệt kê các tài khoản thanh toán hiện có bằng PaymentsAccountService.ListPaymentsAccounts . Chiến lược phát hành đĩa đơn PaymentsAccounts được trả về phụ thuộc vào tài khoản người quản lý mà bạn sử dụng xác thực.

Mã nhận dạng thanh toán của mỗi PaymentsAccount người quản lý ở trong 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ụ bên dưới trình bày cách tạo thông tin thanh toán mới từ thông tin thanh toán hiện có Mã hồ sơ thanh toán. Như đã chỉ ra ở trên, thao tác này cũng sẽ tạo ra một Tài khoản thanh toán có tên 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);
}

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 thanh toán này sẽ đăng ký thanh toán cho khách hàng một cách hiệu quả bằng các khoản Thanh toán được tham chiếu hồ sơ.

Trạng thái thiết lập thanh toán

Các thực thể BillingSetup mới sẽ tuân theo trước khi các chính sách này có hiệu lực. Cho đến lúc đó, status đang ở trong một PENDING trạng thái.

BillingSetup có thể thuộc một trong các trạng thái sau đây: status:

Trạng thái thiết lập thanh toán Mô tả
PENDING Đang chờ phê duyệt.
APPROVED_HELD Đã được 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 thông tin thanh toán đã thiết lập để sử dụng phương thức lập hoá đơn hằng tháng.
APPROVED 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 tài khoản

Giống như hầu hết các thực thể khác trong API Google Ads, một BillingSetup sẽ được tìm nạp bằng cách truy vấn GoogleAdsService.SearchStream bằng cách sử dụng truy vấn Ngôn ngữ truy vấn của Google Ads để chỉ định những trường cần trả về.

Sau khi bạn có được tham chiếu đến BillingSetup, bạn có thể dùng công cụ này để tạo AccountBudgetProposal như được mô tả trong Ngân sách tài khoản.

Huỷ thông tin thanh toán đang chờ xử lý

BillingSetup chưa có hiệu lực có thể bị huỷ bằng thao tác xoá. Bạn chỉ có thể huỷ thông tin thanh toán nếu status của họ là PENDING hoặc nếu chúng APPROVED để bắt đầu vào một thời điểm trong tương lai.