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),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "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)

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

string

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

string

ชื่อผู้เผยแพร่โฆษณา สูงสุด 250 ตัวอักษร ต้องระบุ
order.budget

object (Budget)

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

enum (OrderStatus)

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

object (WSeatConfig)

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