REST Resource: exchanges.orders

แหล่งข้อมูล: คำสั่งซื้อ

ข้อเสนอที่ผู้ซื้อต้องยอมรับโดยไม่มีการเจรจาต่อรอง

การแสดง JSON 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
ช่อง
name

string

ชื่อทรัพยากรที่เกี่ยวข้องสำหรับคำสั่งซื้อ สร้างโดยเซิร์ฟเวอร์ เช่น "exchanges/1234/orders/5678" เอาต์พุตเท่านั้น
displayName

string

ชื่อคำสั่งซื้อที่แสดงต่อผู้ซื้อ สูงสุด 250 อักขระ ไม่บังคับ
partnerId[]

string (int64 format)

รหัสพาร์ทเนอร์ใน Display & Video 360 ของ Google ซึ่งก่อนหน้านี้เรียกว่า DoubleClick Bid Manager(DBM) อนุญาตให้มีรหัสพาร์ทเนอร์เพียงรหัสเดียว ต้องระบุ
publisherEmail

string

อีเมลสำหรับผู้เผยแพร่โฆษณา ต้องมีรูปแบบอีเมลที่ถูกต้อง สูงสุด 250 อักขระ ไม่บังคับ
publisherName

string

ชื่อผู้เผยแพร่เนื้อหา สูงสุด 250 อักขระ ต้องระบุ
budget

object (Budget)

เอาต์พุตเท่านั้น งบประมาณที่ผู้ซื้อตั้งค่า ใช้ได้กับสถานการณ์ดีลทันทีเท่านั้น
status

enum (OrderStatus)

สถานะการสั่งซื้อ สถานะอาจเปลี่ยนแปลงหลังจากที่ผู้ใช้ DV3 ยอมรับ ยกเลิก หรือเก็บถาวรคำสั่งซื้อ นอกจากนี้ยังรองรับการอัปเดตเป็น "ยกเลิกแล้ว" หลังจากสร้างใน API เพื่อส่งสัญญาณว่าคำสั่งซื้อนี้ถูกยกเลิกใน Exchange แล้ว
wseatConfig

object (WSeatConfig)

ไม่บังคับ WSeat Configuration ระบุการกำหนดค่า WSeat ในฝั่งการแลกเปลี่ยน การแลกเปลี่ยนที่ใช้ข้อตกลงแบบหลายที่นั่งคาดว่าจะต้องป้อนข้อมูลในช่องนี้และอัปเดตให้เป็นปัจจุบันอยู่เสมอ
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาเมื่อมีการอัปเดตคำสั่งซื้อหรือผลิตภัณฑ์พื้นฐาน

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่าง: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
buyerInfo

object (BuyerInfo)

เอาต์พุตเท่านั้น ข้อมูลผู้ซื้อ รวมถึงรายละเอียดพาร์ทเนอร์และผู้ลงโฆษณา ใช้ได้กับสถานการณ์ดีลทันทีเท่านั้น

งบประมาณ

ระบุงบประมาณแล้ว

การแสดง JSON 
{
  "budgetType": enum (BudgetType),

  // Union field budget can be only one of the following:
  "impressions": string,
  "money": {
    object (Money)
  }
  // End of list of possible types for union field budget.
}
ช่อง
budgetType

enum (BudgetType)

ประเภทงบประมาณที่ระบุ
ฟิลด์ Union budget รวมได้เฉพาะงบประมาณประเภทเดียวเท่านั้น budget ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
impressions

string (int64 format)

งบประมาณการแสดงผล
money

object (Money)

งบประมาณสกุลเงิน

BudgetType

ประเภทงบประมาณ

Enum
BUDGET_TYPE_UNSPECIFIED งบประมาณที่ไม่ได้ระบุ ใช้เป็นอินพุตไม่ได้
BUDGET_TYPE_CURRENCY งบประมาณสกุลเงิน
BUDGET_TYPE_IMPRESSION งบประมาณการแสดงผล

OrderStatus

สถานะของคำสั่งซื้อ

Enum
ORDER_STATUS_UNSPECIFIED ไม่ได้ระบุสถานะคำสั่งซื้อ ไม่คาดคิด แสดงว่าไม่ทราบสถานะการเจรจาต่อรอง ค่าที่ป้อนไม่ถูกต้อง
PENDING_ACCEPTANCE สถานะคำสั่งซื้อรอการยอมรับ
ACCEPTED สถานะคำสั่งซื้อยอมรับแล้ว
ARCHIVED เก็บสถานะการสั่งซื้อแล้ว
CANCELLED สถานะคำสั่งซื้อถูกยกเลิก
NEGOTIATING สถานะการสั่งซื้ออยู่ระหว่างการเจรจาต่อรอง ใช้ได้กับสถานการณ์ดีลทันทีเท่านั้น

WSeatConfig

การกำหนดค่า WSeat

การแสดง JSON 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
ช่อง
exchangeWseatStatus

enum (WSeatStatus)

ไม่บังคับ สถานะปัจจุบันในฝั่ง Exchange สำหรับการกำหนดค่า WSeat
exchangeWseatIds[]

string (int64 format)

ไม่บังคับ รหัส WSeat ในฝั่ง Exchange
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น DV3 จะอัปเดตฟิลด์นี้โดยอัตโนมัติเมื่อการแลกเปลี่ยนอัปเดต WSeatConfiguration

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่าง: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

WSeatStatus

ตัวเลือกการแจงนับสถานะ WSeat

Enum
W_SEAT_STATUS_UNSPECIFIED WSeatStatus ไม่ได้ระบุ
W_SEAT_STATUS_ENFORCED บังคับใช้ WSeatStatus ระบุว่า Exchange บังคับใช้ WSeatId โดยการส่ง WSeatId ไปยัง DV3 หรือยืนยัน wseatid ในการเสนอราคาตอบ
W_SEAT_STATUS_NOT_ENFORCED ไม่ได้บังคับใช้ WSeatStatus ระบุว่า Exchange ไม่ได้ส่ง wseatid ในคำขอราคาเสนอและไม่ได้ตรวจสอบ wseatid ในคำขอราคาเสนอ

BuyerInfo

ข้อมูลผู้ซื้อสำหรับสถานการณ์ดีลทันที

การแสดง JSON 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
ช่อง
partner

object (PartnerInfo)

เอาต์พุตเท่านั้น ข้อมูลพาร์ทเนอร์
advertisers[]

object (AdvertiserInfo)

เอาต์พุตเท่านั้น ข้อมูลผู้ลงโฆษณา

PartnerInfo

ข้อมูลพาร์ทเนอร์สำหรับสถานการณ์ข้อตกลงทันที

การแสดง JSON 
{
  "title": string
}
ช่อง
title

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของพาร์ทเนอร์ใน Display & Video 360

AdvertiserInfo

ข้อมูลผู้ลงโฆษณาสําหรับสถานการณ์ดีลทันที

การแสดง JSON 
{
  "advertiserId": string,
  "domainUri": string
}
ช่อง
advertiserId

string (int64 format)

เอาต์พุตเท่านั้น รหัสผู้ลงโฆษณาใน Display & Video 360
domainUri

string

เอาต์พุตเท่านั้น URI โดเมนของเว็บไซต์ของผู้ลงโฆษณา

เมธอด

accept

 รับคำสั่งซื้อ

create

 สร้างคำสั่งซื้อ

get

 รับคำสั่งซื้อ

list

 ลำดับของรายการ

patch

 อัปเดตคำสั่งซื้อ