LiveBroadcasts

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

Phương thức

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

list

Trả về danh sách các chương trình phát sóng trên YouTube khớp với các tham số yêu cầu của API. Thử ngay.

chèn

Tạo một thông báo truyền tin. Thử ngay.

update

Cập nhật thông báo truyền tin. 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á thông báo truyền tin. Thử ngay.

liên kết

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

transition

Thay đổi trạng thái của một sự kiện phát trực tiếp trên YouTube và bắt đầu mọi quy trình liên quan đến trạng thái mới. Ví dụ: khi bạn chuyển trạng thái của chương trình phát sóng sang testing, YouTube sẽ bắt đầu truyền video đến luồng giám sát của chương trình phát sóng đó. 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 liên kết với thông báo truyền tin là active. Thử ngay.

điểm đánh dấu

Chèn điểm tín hiệu vào sự kiện phát trực tiếp. Điểm tín hiệu có thể kích hoạt một điểm chèn quảng cáo.

Biểu thị 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: