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 เป็นต้นไป คุณจะเปิด/ปิดใช้ thirdParty ได้เพียงอย่างเดียวในคอลัมน์นี้ ดูข้อมูลเพิ่มเติมได้ที่บทความสนับสนุน การควบคุมรูปแบบโฆษณาต่อไปนี้ไม่พร้อมใช้งานอีกต่อไปและไม่ควรรวมอยู่ในคําขอ API: instream_standard, display, preroll, postroll
breakPosition[]

string

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

object (AdBreak)

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

boolean

เปิดใช้วิดีโอนี้สำหรับช่วงพักโฆษณาตอนกลางที่สร้างขึ้นโดยอัตโนมัติ หากตั้งค่า autoGeneratedBreaks เป็น "จริง" ในวิดีโอที่มีการกําหนด adBreaks แล้ว ระบบจะระบุตําแหน่งในการแสดงโฆษณาเพิ่มเติมจากช่องโฆษณาที่คุณวางไว้
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

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