- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- LoiSapinInvoiceType
- ใบแจ้งหนี้
- InvoiceType
- BudgetSummary
- ลองใช้งาน
แสดงรายการใบแจ้งหนี้ที่โพสต์สำหรับผู้ลงโฆษณาในเดือนนั้นๆ
ใบแจ้งหนี้ที่สร้างโดยโปรไฟล์การเรียกเก็บเงินที่มีระดับใบแจ้งหนี้ "พาร์ทเนอร์" จะไม่สามารถดึงมาได้ด้วยวิธีนี้
คำขอ HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/invoices
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
advertiserId |
ต้องระบุ รหัสของผู้ลงโฆษณาที่จะแสดงรายการใบแจ้งหนี้ |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
issueMonth |
เดือนที่จะแสดงรายการใบแจ้งหนี้ หากไม่ได้ตั้งค่า คำขอจะดึงข้อมูลใบแจ้งหนี้ของเดือนก่อนหน้า ต้องอยู่ในรูปแบบ ปปปปดด |
loiSapinInvoiceType |
เลือกประเภทใบแจ้งหนี้ที่จะดึงข้อมูลสำหรับผู้ลงโฆษณา Loi Sapin ใช้ได้เฉพาะกับผู้ลงโฆษณา Loi Sapin ไม่เช่นนั้นระบบจะไม่สนใจ |
pageSize |
ขนาดหน้าที่ขอ ต้องอยู่ระหว่าง |
pageToken |
โทเค็นที่ระบุหน้าผลลัพธ์ที่เซิร์ฟเวอร์ควรแสดงผล โดยทั่วไป ค่านี้คือค่าของ |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"invoices": [
{
object ( |
ช่อง | |
---|---|
invoices[] |
รายการใบแจ้งหนี้ รายการนี้จะสูญหายไปหากไม่มีข้อมูล |
nextPageToken |
โทเค็นสำหรับเรียกหน้าถัดไปของผลการค้นหา ส่งค่านี้ในฟิลด์ โทเค็นนี้จะใช้งานไม่ได้หากไม่มี |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/display-video
https://www.googleapis.com/auth/display-video-mediaplanning
โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0
LoiSapinInvoiceType
ประเภทใบแจ้งหนี้ที่เป็นไปได้สำหรับผู้ลงโฆษณา Loi Sapin
Enum | |
---|---|
LOI_SAPIN_INVOICE_TYPE_UNSPECIFIED |
ไม่ได้ระบุค่า |
LOI_SAPIN_INVOICE_TYPE_MEDIA |
ใบแจ้งหนี้พร้อมค่าใช้จ่ายสื่อ |
LOI_SAPIN_INVOICE_TYPE_PLATFORM |
ใบแจ้งหนี้ที่มีค่าธรรมเนียมแพลตฟอร์ม |
ใบแจ้งหนี้
ใบแจ้งหนี้เดียว
การแสดง JSON |
---|
{ "name": string, "invoiceId": string, "displayName": string, "paymentsProfileId": string, "paymentsAccountId": string, "issueDate": { object ( |
ช่อง | |
---|---|
name |
ชื่อทรัพยากรของใบแจ้งหนี้ |
invoiceId |
รหัสที่ไม่ซ้ำกันของใบแจ้งหนี้ |
displayName |
ชื่อที่แสดงของใบแจ้งหนี้ |
paymentsProfileId |
รหัสของโปรไฟล์การชำระเงินที่เป็นของใบแจ้งหนี้ ปรากฏใน PDF ของใบแจ้งหนี้เป็น |
paymentsAccountId |
รหัสบัญชีการชำระเงินที่เป็นเจ้าของใบแจ้งหนี้ ปรากฏใน PDF ของใบแจ้งหนี้เป็น |
issueDate |
วันที่ที่ออกใบแจ้งหนี้ |
dueDate |
วันที่ที่ครบกำหนดชำระใบแจ้งหนี้ |
serviceDateRange |
วันที่เริ่มต้นและวันที่สิ้นสุดของบริการที่ครอบคลุมในใบแจ้งหนี้นี้ |
currencyCode |
สกุลเงินที่ใช้ในใบแจ้งหนี้ในรูปแบบ ISO 4217 |
subtotalAmountMicros |
ยอดรวมย่อยก่อนหักภาษีในหน่วยไมโครของสกุลเงินของใบแจ้งหนี้ เช่น หาก |
totalTaxAmountMicros |
ผลรวมของภาษีทั้งหมดในใบแจ้งหนี้ โดยจะเป็นหน่วยไมโครของสกุลเงินของใบแจ้งหนี้ เช่น หาก |
totalAmountMicros |
จำนวนเงินรวมในใบแจ้งหนี้ในหน่วยไมโครของสกุลเงินของใบแจ้งหนี้ เช่น หาก |
purchaseOrderNumber |
หมายเลขใบสั่งซื้อที่เชื่อมโยงกับใบแจ้งหนี้ |
budgetInvoiceGroupingId |
รหัสการจัดกลุ่มงบประมาณสำหรับใบแจ้งหนี้นี้ ระบบจะตั้งค่าช่องนี้เฉพาะเมื่อระดับใบแจ้งหนี้ของโปรไฟล์การเรียกเก็บเงินที่เกี่ยวข้องตั้งค่าเป็น "รหัสการจัดกลุ่มใบแจ้งหนี้ตามงบประมาณ" |
invoiceType |
ประเภทของเอกสารใบแจ้งหนี้ |
correctedInvoiceId |
รหัสของใบแจ้งหนี้เดิมที่มีการปรับโดยใบแจ้งหนี้นี้ หากมี อาจปรากฏใน PDF ของใบแจ้งหนี้เป็น หากตั้งค่า |
replacedInvoiceIds[] |
รหัสของใบแจ้งหนี้ที่ออกแต่แรกซึ่งถูกยกเลิกโดยใบแจ้งหนี้นี้ หากมี ระบบอาจแสดงใบแจ้งหนี้หลายใบหากรวมใบแจ้งหนี้เหล่านั้นไว้ในใบแจ้งหนี้เดียว อาจปรากฏใน PDF ของใบแจ้งหนี้เป็น หากตั้งค่า |
pdfUrl |
URL สำหรับดาวน์โหลดสำเนาใบแจ้งหนี้ในรูปแบบ PDF URL นี้เป็น URL เฉพาะสำหรับผู้ใช้และต้องมีโทเค็นเพื่อการเข้าถึง OAuth 2.0 ที่ถูกต้องจึงจะเข้าถึงได้ ต้องระบุโทเค็นเพื่อการเข้าถึงในส่วนหัว HTTP ของ
URL จะใช้ได้เป็นเวลา 7 วันหลังจากที่ดึงข้อมูลออบเจ็กต์ใบแจ้งหนี้นี้ หรือจนกว่าจะมีการดึงข้อมูลใบแจ้งหนี้นี้อีกครั้ง |
budgetSummaries[] |
รายการข้อมูลสรุปสำหรับงบประมาณแต่ละรายการที่เกี่ยวข้องกับใบแจ้งหนี้นี้ ระบบจะตั้งค่าช่องนี้เฉพาะในกรณีที่ตั้งค่าระดับรายละเอียดใบแจ้งหนี้ของโปรไฟล์การเรียกเก็บเงินที่เกี่ยวข้องเป็น "PO ระดับงบประมาณ" |
nonBudgetMicros |
จำนวนเงินค่าใช้จ่ายทั้งหมดหรือการปรับค่าใช้จ่ายที่ไม่ได้เชื่อมโยงกับงบประมาณหนึ่งๆ ในหน่วยไมโครของสกุลเงินของใบแจ้งหนี้ เช่น หาก |
InvoiceType
ประเภทของใบแจ้งหนี้ที่เป็นไปได้
Enum | |
---|---|
INVOICE_TYPE_UNSPECIFIED |
ไม่ได้ระบุหรือไม่รู้จักในเวอร์ชันนี้ |
INVOICE_TYPE_CREDIT |
ใบแจ้งหนี้มีจำนวนเงินติดลบ |
INVOICE_TYPE_INVOICE |
ใบแจ้งหนี้มีจํานวนเงินเป็นบวก |
BudgetSummary
ข้อมูลสรุปเกี่ยวกับงบประมาณของแต่ละแคมเปญ
การแสดง JSON |
---|
{
"externalBudgetId": string,
"prismaCpeCode": {
object ( |
ช่อง | |
---|---|
externalBudgetId |
สอดคล้องกับ |
prismaCpeCode |
โค้ดลูกค้า ผลิตภัณฑ์ และค่าประมาณที่เกี่ยวข้องจากเครื่องมือ Mediaocean Prisma ใช้ได้กับงบประมาณแคมเปญที่มี |
preTaxAmountMicros |
ผลรวมของค่าบริการที่เกิดขึ้นภายใต้งบประมาณนี้ก่อนหักภาษี โดยอยู่หน่วยไมโครของสกุลเงินของใบแจ้งหนี้ เช่น หาก |
taxAmountMicros |
จํานวนภาษีที่เรียกเก็บกับค่าใช้จ่ายภายใต้งบประมาณนี้ โดยเป็นหน่วยไมโครของสกุลเงินของใบแจ้งหนี้ เช่น หาก |
totalAmountMicros |
ยอดรวมของค่าบริการที่เกิดขึ้นภายใต้งบประมาณนี้ รวมทั้งภาษีในหน่วยไมโครของสกุลเงินของใบแจ้งหนี้ เช่น หาก |