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