Method: exchanges.orders.patch

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

คำขอ HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{order.name=exchanges/*/orders/*}

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
order.name

string

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

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "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.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
ช่อง
order.displayName

string

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

string (int64 format)

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

string

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

string

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

object (Budget)

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

enum (OrderStatus)

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

object (WSeatConfig)

ไม่บังคับ WSeat Configuration ระบุการกำหนดค่า WSeat ในฝั่งการแลกเปลี่ยน การแลกเปลี่ยนที่ใช้ข้อตกลงแบบหลายที่นั่งคาดว่าจะต้องป้อนข้อมูลในช่องนี้และอัปเดตให้เป็นปัจจุบันอยู่เสมอ
order.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"
order.buyerInfo

object (BuyerInfo)

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

string (FieldMask format)

มาสก์เพื่อควบคุมช่องที่จะอัปเดต ต้องระบุ

ซึ่งเป็นรายการชื่อฟิลด์แบบสมบูรณ์ในตัวเองที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Order

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/doubleclickbidmanager

ดูข้อมูลเพิ่มเติมได้ที่OAuth 2.0 Overview