REST Resource: videoAdvertisingOptions

แหล่งข้อมูล: VideoAdvertisingOption

การตั้งค่าโฆษณาสำหรับวิดีโอ การตั้งค่าจะระบุประเภทของโฆษณาที่สามารถแสดงระหว่างวิดีโอ รวมถึงเวลาที่โฆษณาได้รับอนุญาตให้ทำงานระหว่างเล่นวิดีโอ

การแสดง JSON
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
ช่อง
kind

string

ประเภทของทรัพยากร API สำหรับแหล่งข้อมูลนี้ ค่าคือ youtubePartner#videoAdvertisingOption

adFormats[]

string

รายการรูปแบบโฆษณาที่วิดีโอได้รับอนุญาตให้แสดง หมายเหตุ: ตั้งแต่เดือนพฤศจิกายน 2023 เป็นต้นไป คุณจะเปิดใช้/ปิดใช้โฆษณา third_party_ads ได้เท่านั้นในคอลัมน์นี้ ดูข้อมูลเพิ่มเติมได้ที่บทความสนับสนุน การควบคุมรูปแบบโฆษณาต่อไปนี้ใช้งานไม่ได้อีกต่อไปและไม่ควรรวมอยู่ในคำขอ API: instream_standard, display, preroll, postroll

breakPosition[]

string

จุดที่ช่วงพักเกิดขึ้นระหว่างการเล่นวิดีโอ

adBreaks[]

object (AdBreak)

รายการเวลาที่ YouTube สามารถแสดงโฆษณาในสตรีมระหว่างการเล่นวิดีโอ

autoGeneratedBreaks

boolean

เปิดใช้วิดีโอนี้สำหรับช่วงพักโฆษณาตอนกลางที่สร้างขึ้นโดยอัตโนมัติ

id

string

รหัสที่ YouTube ใช้เพื่อระบุวิดีโอที่เกี่ยวข้องกับการตั้งค่าโฆษณาโดยไม่ซ้ำกัน

tpAdServerVideoId

string

ค่าที่ระบุวิดีโอแบบไม่ซ้ำให้กับผู้แสดงโฆษณาอิสระ

tpTargetingUrl

string

URL ฐานสำหรับเซิร์ฟเวอร์โฆษณาของบุคคลที่สามซึ่ง YouTube สามารถดึงโฆษณาในสตรีมสำหรับวิดีโอได้

tpUrlParameters

string

สตริงพารามิเตอร์ที่จะเพิ่มต่อท้ายคำขอที่ส่งไปยังเซิร์ฟเวอร์โฆษณาของบุคคลที่สาม

AdBreak

แหล่งข้อมูล adBreak มีข้อมูลเกี่ยวกับช่วงเวลาที่ YouTube สามารถแสดงโฆษณาในสตรีมระหว่างการเล่นวิดีโอ

การแสดง JSON
{
  "position": string,
  "midrollSeconds": integer
}
ช่อง
position

string

จุดที่ช่วงพักเกิดขึ้นระหว่างการเล่นวิดีโอ

midrollSeconds

integer

เวลาของช่วงพักโฆษณาที่ระบุเป็นจำนวนวินาทีหลังจากเริ่มวิดีโอเมื่อมีการพักเกิดขึ้น

วิธีการ

get

เรียกการตั้งค่าโฆษณาสำหรับวิดีโอที่ระบุ

getEnabledAds

เรียกรายละเอียดเกี่ยวกับประเภทโฆษณาที่ได้รับอนุญาตสำหรับวิดีโอโดยพาร์ทเนอร์หรือผู้ใช้ที่อัปโหลดที่ระบุ

patch

แพตช์การตั้งค่าโฆษณาสำหรับวิดีโอที่ระบุ

update

อัปเดตการตั้งค่าการโฆษณาสำหรับวิดีโอที่ระบุ