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