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

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