การตั้งค่าการเรียกเก็บเงิน

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