การตั้งค่าการเรียกเก็บเงินคือลิงก์ระดับบัญชีระหว่างบัญชี 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_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
ให้เริ่มในอนาคต