การตั้งค่าการเรียกเก็บเงินซึ่งเชื่อมโยงบัญชีการชำระเงินและผู้ลงโฆษณา การตั้งค่าการเรียกเก็บเงินมีไว้สำหรับผู้ลงโฆษณารายเดียวเท่านั้น
การแสดง JSON |
---|
{ "resourceName": string, "status": enum ( |
ช่อง | |
---|---|
resourceName |
เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของการตั้งค่าการเรียกเก็บเงิน ชื่อทรัพยากร BillingSetup มีรูปแบบดังนี้
|
status |
เอาต์พุตเท่านั้น สถานะของการตั้งค่าการเรียกเก็บเงิน |
paymentsAccountInfo |
เปลี่ยนแปลงไม่ได้ ข้อมูลบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงินนี้ เมื่อตั้งค่าการเรียกเก็บเงิน ระบบจะใช้บัญชีนี้เพื่อลงชื่อสมัครใช้ด้วยบัญชีการชำระเงินใหม่ (และไม่ควรตั้งค่า paymentsAccount) เมื่อตั้งค่าการเรียกเก็บเงิน ระบบจะป้อนข้อมูลนี้และบัญชี paymentsAccount |
id |
เอาต์พุตเท่านั้น รหัสของการตั้งค่าการเรียกเก็บเงิน |
paymentsAccount |
เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงินนี้ ชื่อทรัพยากรการชำระเงินมีรูปแบบดังนี้
|
ฟิลด์สหภาพ เมื่อดึงข้อมูลการตั้งค่าการเรียกเก็บเงินที่มีอยู่ นี่คือเวลาเริ่มต้นที่ขอ อย่างไรก็ตาม หากการตั้งค่าได้รับอนุมัติ (ดูสถานะ) หลังจากเวลาเริ่มต้นที่ขอ ค่านี้จะเป็นเวลาอนุมัติ |
|
startDateTime |
เปลี่ยนแปลงไม่ได้ วันที่และเวลาเริ่มต้นในรูปแบบ yyyy-MM-dd หรือ yyyy-MM-dd HH:mm:ss อนุญาตเฉพาะเวลาในอนาคตเท่านั้น |
startTimeType |
เปลี่ยนแปลงไม่ได้ เวลาเริ่มต้นในฐานะประเภท อนุญาตเฉพาะ NOW เท่านั้น |
ฟิลด์สหภาพ end_time เมื่อสิ้นสุด / สิ้นสุดการตั้งค่าการเรียกเก็บเงิน ค่านี้เป็นเวลา "ตลอดไป" หรือเวลาเริ่มต้นของการตั้งค่าการเรียกเก็บเงินที่กำหนดเวลาไว้ครั้งถัดไป end_time ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
endDateTime |
เอาต์พุตเท่านั้น วันที่และเวลาสิ้นสุดในรูปแบบ yyyy-MM-dd หรือ yyyy-MM-dd HH:mm:ss |
endTimeType |
เอาต์พุตเท่านั้น เวลาสิ้นสุดในรูปแบบ ค่าเดียวที่เป็นไปได้คือ FOREVER |
BillingSetupStatus
สถานะที่เป็นไปได้ของการตั้งค่าการเรียกเก็บเงิน
Enum | |
---|---|
UNSPECIFIED |
ไม่ได้ระบุ |
UNKNOWN |
ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้ |
PENDING |
การตั้งค่าการเรียกเก็บเงินกำลังรอการอนุมัติ |
APPROVED_HELD |
การตั้งค่าการเรียกเก็บเงินได้รับอนุมัติแล้ว แต่งบประมาณแรกที่เกี่ยวข้องไม่ได้รับอนุมัติ กรณีนี้จะเกิดขึ้นกับการตั้งค่าการเรียกเก็บเงินที่กําหนดค่าสําหรับการแจ้งหนี้รายเดือนเท่านั้น |
APPROVED |
อนุมัติการตั้งค่าการเรียกเก็บเงินแล้ว |
CANCELLED |
ผู้ใช้ยกเลิกการตั้งค่าการเรียกเก็บเงินก่อนที่จะได้รับอนุมัติ |
PaymentsAccountInfo
คอนเทนเนอร์ข้อมูลบัญชีการชำระเงินสำหรับการเรียกเก็บเงินนี้
การแสดง JSON |
---|
{ "paymentsAccountId": string, "paymentsAccountName": string, "paymentsProfileId": string, "paymentsProfileName": string, "secondaryPaymentsProfileId": string } |
ช่อง | |
---|---|
paymentsAccountId |
เอาต์พุตเท่านั้น รหัส 16 หลักที่ใช้ระบุบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน ต้องส่งค่านี้เป็นสตริงที่มีขีดกลาง เช่น "1234-5678-9012-3456" |
paymentsAccountName |
เปลี่ยนแปลงไม่ได้ ชื่อบัญชีการชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน วิธีนี้ช่วยให้ผู้ใช้ระบุชื่อที่มีความหมายของบัญชีการชำระเงินเพื่อช่วยในการปรับยอดใบแจ้งหนี้รายเดือนได้ ชื่อนี้จะอยู่ในใบแจ้งหนี้รายเดือน |
paymentsProfileId |
เปลี่ยนแปลงไม่ได้ รหัส 12 หลักที่ใช้ระบุโปรไฟล์การชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน ต้องส่งค่านี้เป็นสตริงที่มีขีดกลางยาว เช่น "1234-5678-9012" |
paymentsProfileName |
เอาต์พุตเท่านั้น ชื่อโปรไฟล์การชำระเงินที่เชื่อมโยงกับการตั้งค่าการเรียกเก็บเงิน |
secondaryPaymentsProfileId |
เอาต์พุตเท่านั้น รหัสโปรไฟล์การชําระเงินสํารองในสถานการณ์ที่ไม่ปกติ เช่น เมื่อมีการจัดทำข้อตกลงความรับผิดตามลำดับ |