เวิร์กโฟลว์ API

คู่มือนี้อธิบายเวิร์กโฟลว์ API ทั่วไปสำหรับการสร้าง ดึงข้อมูล และอัปเดตแพ็กเกจการประมูลใน Display &Video 360

รับรายการแพ็กเกจการประมูล

เรียกใช้ LIST API รองรับการกรองตาม external_deal_id

สร้างแพ็กเกจการประมูลใหม่

  1. external_deal_id ต้องไม่ซ้ำกัน เรียกใช้ LIST ด้วย external_deal_id เพื่อดูว่ามีการใช้รหัสนี้อยู่แล้วหรือไม่
  2. เรียกใช้ Create API ระบบจะกำหนดชื่อที่ไม่ซ้ำกันให้ และคุณสามารถใช้ชื่อนี้เพื่อรับแพ็กเกจที่สร้างขึ้น
  3. เรียกใช้ Get API เพื่อดูรายละเอียดของแพ็กเกจการประมูลที่สร้างขึ้น
  4. เลือกอัปโหลด โลโก้ สำหรับแพ็กเกจที่สร้างขึ้น

อัปเดตแพ็กเกจการประมูล

  1. หากไม่ได้จัดเก็บชื่อแพ็กเกจการประมูลที่สร้างขึ้น ให้เรียกใช้ LIST API ที่กรองตาม external_deal_id เพื่อรับแพ็กเกจการประมูลที่ต้องการ อัปเดต
  2. อัปเดตช่องตามผลลัพธ์จาก LIST API
  3. เรียกใช้ Patch API เพื่ออัปเดตแพ็กเกจการประมูล ต้องระบุ updateMask ซึ่งจะระบุช่องที่ต้องการให้ใช้การอัปเดต คุณจะตั้งค่าใน updateMask ได้เฉพาะช่องที่ อนุญาตให้อัปเดตเท่านั้น

กระบวนการเบต้า

ความแตกต่างเพียงอย่างเดียวระหว่างเวอร์ชันเบต้ากับเวอร์ชัน GA คือในระหว่างเวอร์ชันเบต้า แพ็กเกจการประมูลที่สร้างขึ้นต้องมีสถานะเป็น DISCOVERY_OBJECT_STATUS_PAUSED และอัปเดตสถานะไม่ได้ แพ็กเกจที่มีสถานะเป็น PAUSED จะไม่แสดงใน UI ของ DV360 ซึ่งจะช่วยให้ Exchange ทดสอบการผสานรวม API ได้โดยไม่ต้องแสดงแพ็กเกจทดสอบ

โดยทั่วไปแล้ว ผู้ใช้จะสร้างแพ็กเกจ "จริง" ทั้งหมดในเวอร์ชันเบต้าเป็น PAUSED แล้วจึงเปิดใช้งานในเวอร์ชัน GA

Quota

แพ็กเกจที่ใช้งานอยู่ 2,000 รายการต่อ Exchange

แพ็กเกจที่หยุดชั่วคราว 2,000 รายการต่อ Exchange