แหล่งข้อมูล: VideoAdvertisingOption
การตั้งค่าโฆษณาสำหรับวิดีโอ การตั้งค่าจะระบุประเภทของโฆษณาที่สามารถแสดงระหว่างวิดีโอ รวมถึงเวลาที่โฆษณาได้รับอนุญาตให้ทำงานระหว่างเล่นวิดีโอ
การแสดง JSON |
---|
{
"kind": string,
"adFormats": [
string
],
"breakPosition": [
string
],
"adBreaks": [
{
object ( |
ช่อง | |
---|---|
kind |
ประเภทของทรัพยากร API สำหรับแหล่งข้อมูลนี้ ค่าคือ |
adFormats[] |
รายการรูปแบบโฆษณาที่วิดีโอได้รับอนุญาตให้แสดง หมายเหตุ: ตั้งแต่เดือนพฤศจิกายน 2023 เป็นต้นไป คุณจะเปิดใช้/ปิดใช้โฆษณา third_party_ads ได้เท่านั้นในคอลัมน์นี้ ดูข้อมูลเพิ่มเติมได้ที่บทความสนับสนุน การควบคุมรูปแบบโฆษณาต่อไปนี้ใช้งานไม่ได้อีกต่อไปและไม่ควรรวมอยู่ในคำขอ API: |
breakPosition[] |
จุดที่ช่วงพักเกิดขึ้นระหว่างการเล่นวิดีโอ |
adBreaks[] |
รายการเวลาที่ YouTube สามารถแสดงโฆษณาในสตรีมระหว่างการเล่นวิดีโอ |
autoGeneratedBreaks |
เปิดใช้วิดีโอนี้สำหรับช่วงพักโฆษณาตอนกลางที่สร้างขึ้นโดยอัตโนมัติ |
id |
รหัสที่ YouTube ใช้เพื่อระบุวิดีโอที่เกี่ยวข้องกับการตั้งค่าโฆษณาโดยไม่ซ้ำกัน |
tpAdServerVideoId |
ค่าที่ระบุวิดีโอแบบไม่ซ้ำให้กับผู้แสดงโฆษณาอิสระ |
tpTargetingUrl |
URL ฐานสำหรับเซิร์ฟเวอร์โฆษณาของบุคคลที่สามซึ่ง YouTube สามารถดึงโฆษณาในสตรีมสำหรับวิดีโอได้ |
tpUrlParameters |
สตริงพารามิเตอร์ที่จะเพิ่มต่อท้ายคำขอที่ส่งไปยังเซิร์ฟเวอร์โฆษณาของบุคคลที่สาม |
AdBreak
แหล่งข้อมูล adBreak
มีข้อมูลเกี่ยวกับช่วงเวลาที่ YouTube สามารถแสดงโฆษณาในสตรีมระหว่างการเล่นวิดีโอ
การแสดง JSON |
---|
{ "position": string, "midrollSeconds": integer } |
ช่อง | |
---|---|
position |
จุดที่ช่วงพักเกิดขึ้นระหว่างการเล่นวิดีโอ |
midrollSeconds |
เวลาของช่วงพักโฆษณาที่ระบุเป็นจำนวนวินาทีหลังจากเริ่มวิดีโอเมื่อมีการพักเกิดขึ้น |
วิธีการ |
|
---|---|
|
เรียกการตั้งค่าโฆษณาสำหรับวิดีโอที่ระบุ |
|
เรียกรายละเอียดเกี่ยวกับประเภทโฆษณาที่ได้รับอนุญาตสำหรับวิดีโอโดยพาร์ทเนอร์หรือผู้ใช้ที่อัปโหลดที่ระบุ |
|
แพตช์การตั้งค่าโฆษณาสำหรับวิดีโอที่ระบุ |
|
อัปเดตการตั้งค่าการโฆษณาสำหรับวิดีโอที่ระบุ |