การตั้งค่าการเรียกเก็บเงินคือลิงก์ระดับบัญชีระหว่างบัญชี Google Ads กับบัญชีการชำระเงิน (หรือที่เรียกว่าการตั้งค่าใบแจ้งหนี้) ซึ่งจะกําหนดว่าใครจะถูกเรียกเก็บเงินสำหรับค่าใช้จ่ายที่เกิดขึ้นจากงบประมาณบัญชีของการตั้งค่าการเรียกเก็บเงิน บัญชีการชําระเงินแต่ละบัญชีจะสอดคล้องกับใบแจ้งหนี้ใบเดียว
เกี่ยวกับบัญชีการชำระเงิน
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 หลักที่ใช้ระบุโปรไฟล์การชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน
หากบัญชี Payments มีสิทธิ์การเรียกเก็บเงินแบบรวม คุณจะจัดกลุ่มบัญชี Google Ads หลายบัญชีไว้ในใบแจ้งหนี้เดียวกันได้โดยการตั้งค่าการเรียกเก็บเงินให้ใช้บัญชี Payments เดียวกัน
การสร้างการตั้งค่าการเรียกเก็บเงินใหม่
คุณสามารถลิงก์การตั้งค่าการเรียกเก็บเงินใหม่กับบัญชีการชำระเงินที่มีอยู่หรือบัญชีที่สร้างขึ้นพร้อมกันได้
การใช้บัญชีการชำระเงินที่มีอยู่
หากต้องการลิงก์กับบัญชี Payments ที่มีอยู่ ให้ตั้งค่า payments_account
เป็นรหัสทรัพยากรของบัญชี Payments ที่ถูกต้อง แต่อย่าแก้ไข
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
status
PENDING