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

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

การใช้บัญชี Payments ที่มีอยู่

หากต้องการลิงก์กับบัญชีการชำระเงินที่มีอยู่ ให้ตั้งค่า payments_account ไปยัง รหัสทรัพยากรของบัญชีการชำระเงินที่ถูกต้อง แต่อย่าแก้ไข payments_account_info

คุณสามารถแสดงบัญชีการชำระเงินที่ใช้ได้ด้วย PaymentsAccountService.ListPaymentsAccounts การคืนเงิน PaymentsAccounts ขึ้นอยู่กับบัญชีดูแลจัดการที่คุณใช้ การตรวจสอบสิทธิ์

สำหรับ PaymentsAccount แต่ละรายการ รหัสของการชำระเงิน อยู่ใน paying_manager_customer ด้วย

การใช้บัญชี Payments ใหม่

หากต้องการลิงก์กับบัญชี 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 การตั้งค่าถูกยกเลิกโดยผู้ใช้ก่อนที่จะอนุมัติ

การดึงข้อมูลการตั้งค่าการเรียกเก็บเงินของบัญชี

เช่นเดียวกับเอนทิตีอื่นๆ ส่วนใหญ่ใน Google Ads API มีการดึงข้อมูล BillingSetup โดยการค้นหา GoogleAdsService.SearchStream โดยใช้คำค้นหาภาษาของคำค้นหาของ Google Ads ที่ระบุช่องที่จะแสดง

เมื่อคุณได้รับการอ้างอิงไปยัง BillingSetup แล้ว คุณสามารถใช้เครื่องมือดังกล่าวเพื่อสร้าง AccountBudgetProposal ตามที่อธิบายไว้ใน งบประมาณบัญชี

การยกเลิกการตั้งค่าการเรียกเก็บเงินที่รอดำเนินการ

BillingSetup ที่ยังไม่มีผลสามารถ ถูกยกเลิกโดยใช้การดำเนินการนำออก คุณสามารถยกเลิกการตั้งค่าการเรียกเก็บเงินได้ในกรณีต่อไปนี้เท่านั้น status ของพวกเขา PENDING หรือหากเป็น APPROVED จะเริ่มต้นในอนาคต