REST Resource: videoAdvertisingOptions

แหล่งข้อมูล: ตัวเลือกการโฆษณาด้วยวิดีโอ

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

การแสดง 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

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