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

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

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

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)

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

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

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

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 เพื่อเริ่มในอนาคต

ก่อนหน้า
ภาพรวมการเรียกเก็บเงิน
ถัดไป
งบประมาณบัญชี