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

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

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)

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

string

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

enum (TimeType)

เอาต์พุตเท่านั้น เวลาสิ้นสุดเป็นประเภท ค่าที่ใช้ได้เพียงค่าเดียวคือ FOREVER

BillingSetupStatus

สถานะที่เป็นไปได้ของ BillingSetup

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

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