การตั้งค่าการเรียกเก็บเงินคือการลิงก์ระดับบัญชีระหว่างบัญชี Google Ads กับบัญชีการชำระเงิน (หรือที่เรียกว่าการตั้งค่าใบแจ้งหนี้) ซึ่งกำหนดค่าใช้จ่ายที่เกิดขึ้นจากงบประมาณบัญชีของการตั้งค่าการเรียกเก็บเงินได้อย่างมีประสิทธิภาพ บัญชีการชำระเงินแต่ละบัญชีจะสอดคล้องกับใบแจ้งหนี้ 1 ใบ
เกี่ยวกับบัญชีการชำระเงิน
BillingSetup
แต่ละบัญชีจะระบุบัญชีการชำระเงินที่มีการออกใบแจ้งหนี้สำหรับค่าใช้จ่ายที่เกิดขึ้นจากงบประมาณบัญชี บัญชีการชำระเงินนี้เชื่อมโยงกับโปรไฟล์การชำระเงินที่เป็นผู้รับผิดชอบการเรียกเก็บเงินในท้ายที่สุด
การตั้งค่าการเรียกเก็บเงินมีทั้งช่อง payments_account
และกลุ่มของ payments_account_info
ที่ระบุว่ามีการใช้บัญชีการชำระเงินอยู่ ดังนี้
payments_account_info.payments_account_id
: รหัส 16 หลักที่ใช้ระบุบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงินpayments_account_info.payments_account_name
: ชื่อบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน ชื่อนี้จะพิมพ์อยู่ในใบแจ้งหนี้รายเดือนpayments_account_info.payments_profile_id
: รหัส 12 หลักที่ใช้ระบุโปรไฟล์การชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน
หากบัญชีการชำระเงินมีสิทธิ์ใช้การเรียกเก็บเงินรวม คุณจะจัดกลุ่มบัญชี Google Ads หลายบัญชีในใบแจ้งหนี้เดียวกันได้โดยการตั้งค่าการตั้งค่าการเรียกเก็บเงินให้ใช้บัญชีการชำระเงินที่เกี่ยวข้องบัญชีเดียวกัน
การสร้างการตั้งค่าการเรียกเก็บเงินใหม่
คุณสามารถลิงก์การตั้งค่าการเรียกเก็บเงินใหม่กับบัญชีการชำระเงินที่มีอยู่หรือบัญชีที่สร้างขึ้นพร้อมกันก็ได้
การใช้บัญชี Payments ที่มีอยู่
หากต้องการลิงก์กับบัญชีการชำระเงินที่มีอยู่ ให้ตั้งค่า payments_account
เป็นรหัสทรัพยากรของบัญชีการชำระเงินที่ถูกต้อง แต่อย่าแก้ไข payments_account_info
คุณแสดงบัญชีการชำระเงินที่ใช้ได้โดยใช้PaymentsAccountService.ListPaymentsAccounts
วิธีการ PaymentsAccounts
ที่แสดงผลขึ้นอยู่กับบัญชีดูแลจัดการที่คุณใช้ตรวจสอบสิทธิ์
สำหรับ PaymentsAccount
แต่ละรายการ รหัสของผู้จัดการการชำระเงินจะอยู่ในช่อง paying_manager_customer
การใช้บัญชีการชำระเงินใหม่
หากต้องการลิงก์กับบัญชีการชำระเงินใหม่ ให้ตั้งค่าช่องต่อไปนี้ใน
payments_account_info
(อย่าตั้งค่า payments_account
)
ตัวอย่างด้านล่างแสดงวิธีสร้างการตั้งค่าการเรียกเก็บเงินใหม่จากรหัสโปรไฟล์การชำระเงินที่มีอยู่ ตามที่ระบุไว้ด้านบนจะเป็นการสร้างบัญชี
การชำระเงินใหม่ที่มีชื่อว่า 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
ด้วยการค้นหาใน GoogleAdsService.SearchStream
โดยใช้คำค้นหาจากภาษาของคำค้นหาของ Google Ads ซึ่งระบุช่องที่จะแสดงผล
เมื่อได้รับข้อมูลอ้างอิงสำหรับ BillingSetup
แล้ว คุณจะใช้ข้อมูลดังกล่าวเพื่อสร้าง AccountBudgetProposal
ได้ตามที่อธิบายไว้ในงบประมาณบัญชี
การยกเลิกการตั้งค่าการเรียกเก็บเงินที่รอดำเนินการ
คุณจะยกเลิก BillingSetup
ที่ยังไม่มีผลบังคับใช้ได้โดยใช้การดำเนินการนำออก คุณจะยกเลิกการตั้งค่าการเรียกเก็บเงินได้ก็ต่อเมื่อ status
คือ PENDING
หรือ APPROVED
เพื่อเริ่มการยืนยันในภายหลัง