BillingSetup

การตั้งค่าการเรียกเก็บเงินซึ่งเชื่อมโยงบัญชีการชำระเงินกับผู้ลงโฆษณา การตั้งค่าการเรียกเก็บเงินมีไว้สำหรับผู้ลงโฆษณารายเดียวเท่านั้น

การแสดง JSON 
{
  "resourceName": string,
  "status": enum (BillingSetupStatus),
  "paymentsAccountInfo": {
    object (PaymentsAccountInfo)
  },
  "id": string,
  "paymentsAccount": string,

  // Union field start_time can be only one of the following:
  "startDateTime": string,
  "startTimeType": enum (TimeType)
  // End of list of possible types for union field start_time.

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.
}
ช่อง
resourceName

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของการตั้งค่าการเรียกเก็บเงิน ชื่อทรัพยากร BillingSetup จะมีรูปแบบดังนี้

customers/{customerId}/billingSetups/{billing_setup_id}
status

enum (BillingSetupStatus)

เอาต์พุตเท่านั้น สถานะของการตั้งค่าการเรียกเก็บเงิน
paymentsAccountInfo

object (PaymentsAccountInfo)

เปลี่ยนแปลงไม่ได้ ข้อมูลบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงินนี้ เมื่อตั้งค่าการเรียกเก็บเงิน ระบบจะใช้วิธีดังกล่าวในการลงชื่อสมัครใช้ด้วยบัญชีการชำระเงินใหม่ (และไม่ควรตั้งค่า paymentsAccount) เมื่อตั้งค่าการเรียกเก็บเงิน ระบบจะกรอกข้อมูลนี้และบัญชี paymentsAccount
id

string (int64 format)

เอาต์พุตเท่านั้น รหัสของการตั้งค่าการเรียกเก็บเงิน
paymentsAccount

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงินนี้ ชื่อทรัพยากรการชำระเงินมีรูปแบบดังนี้

customers/{customerId}/paymentsAccounts/{paymentsAccountId} เมื่อตั้งค่าการเรียกเก็บเงิน ระบบจะใช้รายการนี้ในการลงชื่อสมัครใช้ด้วยบัญชีการชำระเงินที่มีอยู่ (และไม่ควรตั้งค่า paymentsAccountInfo) เมื่อตั้งค่าการเรียกเก็บเงิน ระบบจะกรอกข้อมูลนี้และ paymentsAccountInfo

ฟิลด์การรวม start_time เมื่อสร้างการตั้งค่าการเรียกเก็บเงินใหม่ การตั้งค่านี้ควรจะมีผล "ตอนนี้" คือเวลาเริ่มต้นเดียวที่ยอมรับได้หากลูกค้าไม่มีการตั้งค่าที่ได้รับอนุมัติ

เมื่อดึงข้อมูลการตั้งค่าการเรียกเก็บเงินที่มีอยู่ นี่คือเวลาเริ่มต้นที่ขอ แต่หากการตั้งค่าได้รับอนุมัติ (ดูสถานะ) หลังเวลาเริ่มต้นที่ขอ ก็จะเป็นเวลาอนุมัติ start_time ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
startDateTime

string

เปลี่ยนแปลงไม่ได้ วันที่และเวลาเริ่มต้นในรูปแบบ yyyy-MM-dd หรือ yyyy-MM-dd HH:mm:ss อนุญาตเฉพาะเวลาในอนาคตเท่านั้น
startTimeType

enum (TimeType)

เปลี่ยนแปลงไม่ได้ เวลาเริ่มต้นเป็นประเภท อนุญาตเฉพาะ NOW เท่านั้น
ฟิลด์การรวม end_time เมื่อสิ้นสุด / สิ้นสุดการตั้งค่าการเรียกเก็บเงิน ค่านี้เป็น "ตลอดไป" หรือเวลาเริ่มต้นของการตั้งค่าการเรียกเก็บเงินครั้งถัดไป end_time ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
endDateTime

string

เอาต์พุตเท่านั้น วันที่และเวลาสิ้นสุดในรูปแบบ yyyy-MM-dd หรือ yyyy-MM-dd HH:mm:ss
endTimeType

enum (TimeType)

เอาต์พุตเท่านั้น เวลาสิ้นสุดในรูปแบบ ค่าเดียวที่เป็นไปได้คือ FOREVER

BillingSetupStatus

สถานะที่เป็นไปได้ของการตั้งค่าการเรียกเก็บเงิน

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

PaymentsAccountInfo

คอนเทนเนอร์ของข้อมูลบัญชีการชำระเงินสำหรับการเรียกเก็บเงินนี้

การแสดง JSON 
{
  "paymentsAccountId": string,
  "paymentsAccountName": string,
  "paymentsProfileId": string,
  "paymentsProfileName": string,
  "secondaryPaymentsProfileId": string
}
ช่อง
paymentsAccountId

string

เอาต์พุตเท่านั้น รหัส 16 หลักที่ใช้ระบุบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน

ต้องส่งเป็นสตริงที่มีขีดกลาง เช่น "1234-5678-9012-3456"
paymentsAccountName

string

เปลี่ยนแปลงไม่ได้ ชื่อบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน

วิธีนี้ช่วยให้ผู้ใช้ระบุชื่อที่มีความหมายของบัญชีการชำระเงินเพื่อช่วยในการปรับยอดใบแจ้งหนี้รายเดือนได้

ชื่อนี้จะถูกพิมพ์ลงในใบแจ้งหนี้รายเดือน
paymentsProfileId

string

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

โดยต้องส่งเป็นสตริงที่มีขีดกลาง เช่น "1234-5678-9012"
paymentsProfileName

string

เอาต์พุตเท่านั้น ชื่อโปรไฟล์การชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน
secondaryPaymentsProfileId

string

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