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

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