Method: adPlays.createWithExternalIds

สร้างการเล่นโฆษณาด้วยรหัสภายนอก

  • แสดงการเล่นโฆษณาที่สร้างขึ้นใหม่หากประสบความสำเร็จ
  • จะแสดงรหัสข้อผิดพลาด INVALID_ARGUMENT หากระบุรหัสภายนอกของหน่วยโฆษณา รหัสภายนอกของคำสั่งซื้อ รหัสภายนอกบรรทัด หรือรหัสภายนอกของไฟล์เนื้อหาครีเอทีฟโฆษณาไม่ถูกต้อง
  • ส่งคืนรหัสข้อผิดพลาด INVALID_ARGUMENT หากมีการเล่นโฆษณาสำหรับหน่วยโฆษณา ลำดับ บรรทัด และครีเอทีฟโฆษณาเดียวกันที่มีเวลาเริ่มต้นเดียวกันอยู่แล้ว
  • ส่งคืนรหัสข้อผิดพลาด NOT_FOUND หากไม่พบรหัสภายนอกของหน่วยโฆษณา รหัสภายนอกของคำสั่งซื้อ รหัสภายนอกบรรทัด หรือรหัสภายนอกของไฟล์เนื้อหาโฆษณา

คำขอ HTTP

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

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

เนื้อหาของคำขอ

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

การแสดง JSON 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
ช่อง
lineExternalId

string

ต้องระบุ รหัสภายนอกของบรรทัดที่เล่นโฆษณานี้ รูปแบบ: 123
orderExternalId

string

ต้องระบุ รหัสภายนอกของลำดับการเล่นโฆษณานี้ รูปแบบ: 456
adUnitExternalId

string

ต้องระบุ รหัสภายนอกของหน่วยโฆษณาที่เล่นโฆษณานี้ รูปแบบ: 789
creativeAssetExternalId

string

ต้องระบุ รหัสภายนอกของครีเอทีฟโฆษณาที่โฆษณานี้เล่น รูปแบบ: 3210
startTime

string (Timestamp format)

ต้องระบุ เวลาที่โฆษณาเริ่มเล่น (นับรวมด้วย) ควรเป็นเวลาในอดีตและภายใน 3 วันที่ผ่านมา

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
endTime

string (Timestamp format)

ต้องระบุ เวลาที่การเล่นโฆษณาสิ้นสุดลง (ไม่รวม) ควรเป็นเวลาที่ผ่านมาและหลังจากเวลาเริ่มต้น

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
recordTime

string (Timestamp format)

ไม่บังคับ เวลาที่บันทึกการเล่นโฆษณานี้ ควรเป็นเวลาที่ผ่านมาและหลังเวลาสิ้นสุด

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
impressions

number

ต้องระบุ จำนวนการแสดงผลทั้งหมด

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

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

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

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

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0