LiveBroadcasts

Tài nguyên liveBroadcast đại diện cho một sự kiện sẽ được phát trực tiếp trên YouTube.

Phương thức

API hỗ trợ các phương thức sau cho tài nguyên liveBroadcasts:

list

Trả về danh sách các thông báo trên YouTube khớp với các tham số yêu cầu của API. Thử ngay.

chèn

Tạo chương trình phát sóng. Thử ngay.

cập nhật

Cập nhật chương trình phát sóng. Ví dụ: bạn có thể sửa đổi chế độ cài đặt thông báo truyền tin được xác định trong đối tượng contentDetails của tài nguyên liveBroadcast. Thử ngay.

xóa

Xoá chương trình phát sóng. Thử ngay.

ràng buộc

Liên kết một sự kiện phát sóng trên YouTube với một sự kiện phát trực tiếp hoặc xoá mối liên kết hiện có giữa một chương trình phát sóng và một chương trình phát trực tiếp. Một chương trình phát sóng chỉ có thể được liên kết với một chương trình phát video dù một chương trình phát video có thể được liên kết với nhiều chương trình phát. Thử ngay.

transition

Thay đổi trạng thái của một chương trình phát sóng trực tiếp trên YouTube và bắt đầu bất kỳ quy trình nào liên quan đến trạng thái mới. Ví dụ: khi bạn chuyển đổi trạng thái của một chương trình phát thành testing, YouTube sẽ bắt đầu truyền video đến luồng giám sát của chương trình phát đó. Trước khi gọi phương thức này, bạn nên xác nhận rằng giá trị của thuộc tính status.streamStatus cho luồng được liên kết với nội dung truyền tin là active. Thử ngay.

điểm dừng

Chèn một điểm dừng vào một chương trình phát sóng trực tiếp. Điểm dừng có thể kích hoạt một điểm chèn quảng cáo.

Biểu diễn tài nguyên

Cấu trúc JSON sau đây cho thấy định dạng của tài nguyên 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,
    }
  }
}

Thuộc tính

Bảng sau đây xác định các thuộc tính xuất hiện trong tài nguyên này: