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

การตั้งค่าการเรียกเก็บเงินคือลิงก์ระดับบัญชีระหว่างบัญชี Google Ads กับบัญชีการชำระเงิน (หรือที่เรียกว่าการตั้งค่าใบแจ้งหนี้) ซึ่งจะกําหนดว่าใครจะถูกเรียกเก็บเงินสำหรับค่าใช้จ่ายที่เกิดขึ้นจากงบประมาณบัญชีของการตั้งค่าการเรียกเก็บเงิน บัญชีการชําระเงินแต่ละบัญชีจะสอดคล้องกับใบแจ้งหนี้ใบเดียว

เกี่ยวกับบัญชีการชำระเงิน

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 หลักที่ใช้ระบุโปรไฟล์การชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน

หากบัญชี Payments มีสิทธิ์การเรียกเก็บเงินแบบรวม คุณจะจัดกลุ่มบัญชี Google Ads หลายบัญชีไว้ในใบแจ้งหนี้เดียวกันได้โดยการตั้งค่าการเรียกเก็บเงินให้ใช้บัญชี Payments เดียวกัน

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

คุณสามารถลิงก์การตั้งค่าการเรียกเก็บเงินใหม่กับบัญชีการชำระเงินที่มีอยู่หรือบัญชีที่สร้างขึ้นพร้อมกันได้

การใช้บัญชีการชำระเงินที่มีอยู่

หากต้องการลิงก์กับบัญชี Payments ที่มีอยู่ ให้ตั้งค่า payments_account เป็นรหัสทรัพยากรของบัญชี Payments ที่ถูกต้อง แต่อย่าแก้ไข 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 ที่ยังไม่ได้มีผลจะยกเลิกได้โดยใช้การดำเนินการนำออก คุณจะยกเลิกการตั้งค่าการเรียกเก็บเงินได้ก็ต่อเมื่อstatusPENDING หรือAPPROVEDstatusPENDING