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

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

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

BillingSetup แต่ละรายการจะระบุบัญชีการชำระเงินที่ได้รับใบแจ้งหนี้สำหรับค่าใช้จ่ายที่เกิดขึ้นตามงบประมาณบัญชี บัญชีการชำระเงินนี้เชื่อมโยงกับโปรไฟล์การชำระเงินซึ่งเป็นผู้รับผิดชอบค่าใช้จ่ายในท้ายที่สุด

การตั้งค่าการเรียกเก็บเงินประกอบด้วยทั้งฟิลด์ payments_account และกลุ่มฟิลด์ payments_account_info ที่ระบุบัญชีการชำระเงินที่ใช้อยู่ ซึ่งรวมถึงรายการต่อไปนี้

• payments_account_info.payments_account_id: รหัส 16 หลักที่จัดรูปแบบเป็นสตริงที่คั่นด้วยขีดกลาง (เช่น "1234-5678-9012-3456") ซึ่งใช้เพื่อระบุบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน
• payments_account_info.payments_account_name: ชื่อของบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน ชื่อนี้จะพิมพ์อยู่ในใบแจ้งหนี้รายเดือน
• payments_account_info.payments_profile_id: รหัส 12 หลักที่จัดรูปแบบเป็นสตริงที่คั่นด้วยขีดกลาง (เช่น "1234-5678-9012") ซึ่งใช้เพื่อระบุโปรไฟล์การชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน

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

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

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

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

หากต้องการลิงก์กับบัญชีการชำระเงินที่มีอยู่ ให้ตั้งค่า payments_account เป็นชื่อทรัพยากรของบัญชีการชำระเงินที่ถูกต้อง (เช่น customers/{customer_id}/paymentsAccounts/{payments_account_id}) แต่อย่าแก้ไข payments_account_info

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

สำหรับ PaymentsAccount แต่ละรายการ ชื่อทรัพยากรของบัญชีดูแลจัดการการเรียกเก็บเงินจะอยู่ในช่อง paying_manager_customer

ใช้บัญชีการชำระเงินใหม่

หากต้องการลิงก์กับบัญชีการชำระเงินใหม่ ให้ตั้งค่าช่องต่อไปนี้ใน payments_account_info (อย่าตั้งค่า payments_account)

• payments_account_name
• payments_profile_id

หมายเหตุ: ระบบจะป้อนข้อมูลทั้ง payments_account และ payments_account_info ในการเรียกข้อมูลการตั้งค่าการเรียกเก็บเงินครั้งต่อๆ ไป

ตัวอย่างต่อไปนี้แสดงวิธีสร้างการตั้งค่าการเรียกเก็บเงินใหม่จากรหัสโปรไฟล์การชำระเงินที่มีอยู่ ตามที่ระบุไว้ก่อนหน้านี้ การดำเนินการนี้จะสร้างบัญชีการชำระเงินใหม่ที่มีชื่อว่า My New Payments Account ด้วย

BillingSetup billingSetup =
    BillingSetup.newBuilder()
        .setPaymentsAccountInfo(
            PaymentsAccountInfo.newBuilder()
                .setPaymentsAccountName("My New Payments Account")
                .setPaymentsProfileId("1234-5678-9012")
                .build())
        .setStartTimeType(TimeTypeEnum.TimeType.NOW)
        .build();

BillingSetupOperation operation =
    BillingSetupOperation.newBuilder().setCreate(billingSetup).build();

try (BillingSetupServiceClient billingSetupServiceClient =
    googleAdsClient.getBillingSetupServiceClient()) {
  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(
          Long.toString(customerId), operation);
}

หากนี่เป็นการตั้งค่าการเรียกเก็บเงินรายการแรกที่เพิ่มลงในบัญชี Google Ads การดำเนินการนี้จะลงชื่อสมัครใช้การเรียกเก็บเงินให้ลูกค้าโดยใช้โปรไฟล์การชำระเงินที่อ้างอิง

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

อินสแตนซ์ BillingSetup ใหม่ต้องได้รับการอนุมัติก่อนจึงจะมีผล ก่อนหน้านั้น status จะอยู่ในสถานะPENDING

BillingSetup อาจมีค่า status ค่าใดค่าหนึ่งต่อไปนี้

BillingSetupStatus	คำอธิบาย
PENDING	รอการอนุมัติ
APPROVED_HELD	ได้รับอนุมัติแล้ว แต่งบประมาณแรกที่เกี่ยวข้องยังไม่ได้รับอนุมัติ ซึ่งกรณีนี้จะเกิดขึ้นกับการตั้งค่าการเรียกเก็บเงินที่กำหนดค่าไว้สำหรับการแจ้งหนี้รายเดือนเท่านั้น
APPROVED	การตั้งค่าได้รับอนุมัติแล้ว
CANCELLED	ผู้ใช้ยกเลิกการตั้งค่าก่อนการอนุมัติ

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

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

SELECT
  billing_setup.resource_name,
  billing_setup.id,
  billing_setup.status,
  billing_setup.payments_account,
  billing_setup.payments_account_info.payments_account_id,
  billing_setup.payments_account_info.payments_account_name,
  billing_setup.payments_account_info.payments_profile_id,
  billing_setup.payments_account_info.payments_profile_name,
  billing_setup.start_date_time,
  billing_setup.end_date_time,
  billing_setup.end_time_type
FROM billing_setup

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

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

คุณสามารถยกเลิก BillingSetup ที่ยังไม่มีผลได้โดยส่ง BillingSetupOperation ที่มีช่อง remove ตั้งค่าเป็นชื่อทรัพยากรของการตั้งค่าการเรียกเก็บเงิน (customers/{customer_id}/billingSetups/{billing_setup_id}) คุณจะยกเลิกการตั้งค่าการเรียกเก็บเงินได้ก็ต่อเมื่อ status เป็น PENDING หรือหากAPPROVEDให้เริ่มในอนาคต