LiveBroadcasts

ทรัพยากร liveBroadcast แสดงถึงกิจกรรมที่จะสตรีมบน YouTube โดยใช้วิดีโอสด

เมธอด

API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร liveBroadcasts

list

แสดงรายการการออกอากาศ YouTube ที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย

แทรก

สร้างการออกอากาศ ลองใช้เลย

update

อัปเดตการออกอากาศ เช่น คุณอาจแก้ไขการตั้งค่าการออกอากาศที่กําหนดไว้ในออบเจ็กต์ contentDetails ของliveBroadcast ทรัพยากร ลองใช้เลย

ลบ

ลบการออกอากาศ ลองใช้เลย

bind

เชื่อมโยงการออกอากาศ YouTube กับสตรีมหรือนำการเชื่อมโยงที่มีอยู่ระหว่างการออกอากาศกับสตรีมออก การออกอากาศจะเชื่อมโยงกับสตรีมวิดีโอได้เพียงรายการเดียว แต่สตรีมวิดีโอจะเชื่อมโยงกับการออกอากาศได้มากกว่า 1 รายการ ลองใช้เลย

transition

เปลี่ยนสถานะของการออกอากาศสดบน YouTube และเริ่มกระบวนการที่เกี่ยวข้องกับสถานะใหม่ ตัวอย่างเช่น เมื่อคุณเปลี่ยนสถานะของการออกอากาศเป็น testing ทาง YouTube จะเริ่มส่งวิดีโอไปยังสตรีมการตรวจสอบของการออกอากาศนั้น ก่อนเรียกใช้เมธอดนี้ คุณควรตรวจสอบว่าค่าของพร็อพเพอร์ตี้ status.streamStatus สำหรับสตรีมที่เชื่อมโยงกับการออกอากาศคือ active ลองใช้เลย

cuepoint

แทรกจุดเริ่มต้นลงในการถ่ายทอดสด จุดเริ่มต้นอาจทริกเกอร์ช่วงพักโฆษณา

การนําเสนอทรัพยากร

โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร liveBroadcasts

{
  "kind": "youtube#liveBroadcast",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "isDefaultBroadcast": boolean,
    "liveChatId": string
  },
  "status": {
    "lifeCycleStatus": string,
    "privacyStatus": string,
    "recordingStatus": string,
    "madeForKids": string,
    "selfDeclaredMadeForKids": string,
  },
  "contentDetails": {
    "boundStreamId": string,
    "boundStreamLastUpdateTimeMs": datetime,
    "monitorStream": {
      "enableMonitorStream": boolean,
      "broadcastStreamDelayMs": unsigned integer,
      "embedHtml": string
    },
    "enableEmbed": boolean,
    "enableDvr": boolean,
    "recordFromStart": boolean,
    "enableClosedCaptions": boolean,
    "closedCaptionsType": string,
    "projection": string,
    "enableLowLatency": boolean,
    "latencyPreference": boolean,
    "enableAutoStart": boolean,
    "enableAutoStop": boolean
  },
  "statistics": {
    "totalChatCount": unsigned long
  },
  "monetizationDetails": {
      "cuepointSchedule": {
        "enabled": boolean,
        "pauseAdsUntil": datetime,
        "scheduleStrategy": string,
        "repeatIntervalSecs": unsigned integer,
      }
    }
  }
}

พร็อพเพอร์ตี้

ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้