LiveBroadcasts

API này hiện hỗ trợ khả năng đánh dấu các buổi phát sóng trực tiếp của bạn là "dành cho trẻ em" và tài nguyên liveBroadcast hiện chứa một thuộc tính xác định trạng thái "dành cho trẻ em" của sự kiện phát sóng trực tiếp đó. Vào ngày 10 tháng 1 năm 2020, chúng tôi cũng đã cập nhật Điều khoản dịch vụ của Dịch vụ API YouTube và Chính sách dành cho nhà phát triển. Để biết thêm thông tin, vui lòng xem nhật ký sửa đổi của Dịch vụ API Phát trực tiếp trên YouTubeĐiều khoản dịch vụ của Dịch vụ API YouTube.

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:

Thuộc tính
kind string
Xác định loại tài nguyên API. Giá trị sẽ là youtube#liveBroadcast.
etag etag
Etag của tài nguyên này.
id string
Mã nhận dạng mà YouTube gán để nhận dạng duy nhất chương trình phát sóng.
snippet object
Đối tượng snippet chứa các thông tin cơ bản về sự kiện, bao gồm cả tiêu đề, nội dung mô tả, thời gian bắt đầu và thời gian kết thúc.
snippet.publishedAt datetime
Ngày và giờ thêm chương trình phát sóng vào lịch phát sóng trực tiếp của YouTube. Giá trị được chỉ định theo định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.channelId string
Mã nhận dạng mà YouTube dùng để xác định riêng biệt kênh xuất bản chương trình phát sóng đó.
snippet.title string
Tiêu đề của chương trình phát sóng. Xin lưu ý rằng nội dung phát sóng trình bày chính xác một video trên YouTube. Bạn có thể thiết lập trường này bằng cách sửa đổi tài nguyên truyền phát hoặc bằng cách đặt trường title của tài nguyên video tương ứng.
snippet.description string
Nội dung mô tả chương trình phát sóng. Giống như với title, bạn có thể thiết lập trường này bằng cách sửa đổi tài nguyên truyền phát hoặc bằng cách đặt trường description của tài nguyên video tương ứng.
snippet.thumbnails object
Bản đồ các hình thu nhỏ liên kết với chương trình phát sóng. Đối với mỗi đối tượng được lồng trong đối tượng này, khoá là tên của hình thu nhỏ, còn giá trị là một đối tượng chứa thông tin khác về hình thu nhỏ.
snippet.thumbnails.(key) object
Các giá trị khoá hợp lệ là:
  • default – Hình thu nhỏ mặc định. Hình thu nhỏ mặc định cho video – hoặc tài nguyên đề cập đến video, chẳng hạn như mục trong danh sách phát hoặc kết quả tìm kiếm – có chiều rộng 120px và chiều cao 90px. Hình thu nhỏ mặc định của kênh có chiều rộng 88px và chiều cao 88px.
  • medium – Phiên bản hình thu nhỏ có độ phân giải cao hơn. Đối với video (hoặc tài nguyên đề cập đến video), hình ảnh này có chiều rộng là 320px và chiều cao là 180px. Đối với kênh, hình ảnh này có chiều rộng 240px và chiều cao 240px.
  • high – Phiên bản hình thu nhỏ có độ phân giải cao. Đối với video (hoặc tài nguyên đề cập đến video), hình ảnh này có chiều rộng là 480px và chiều cao là 360px. Đối với kênh, hình ảnh này có chiều rộng là 800px và chiều cao là 800px.
snippet.thumbnails.(key).url string
URL của hình ảnh.
snippet.thumbnails.(key).width unsigned integer
Chiều rộng của hình ảnh.
snippet.thumbnails.(key).height unsigned integer
Chiều cao của hình ảnh.
snippet.scheduledStartTime datetime
Ngày và giờ bắt đầu chương trình phát sóng. Giá trị được chỉ định theo định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). Creator Studio hỗ trợ chức năng tạo chương trình phát sóng mà không cần đặt thời gian bắt đầu. Trong trường hợp này, quá trình phát sóng bắt đầu bất cứ khi nào chủ sở hữu kênh bắt đầu phát trực tiếp. Đối với các thông báo này, giá trị datetime tương ứng với thời gian 0 và không thay đổi được giá trị này thông qua API hoặc trong Creator Studio.
snippet.scheduledEndTime datetime
Ngày và giờ kết thúc chương trình phát sóng theo lịch. Giá trị được chỉ định theo định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). Nếu tài nguyên liveBroadcast không chỉ định giá trị cho thuộc tính này thì chương trình truyền tin được lên lịch tiếp tục vô thời hạn. Tương tự, nếu bạn không chỉ định giá trị cho thuộc tính này thì YouTube sẽ xem sự kiện phát sóng như thể sự kiện sẽ diễn ra vô thời hạn.
snippet.actualStartTime datetime
Ngày và giờ sự kiện phát sóng thực sự bắt đầu. Thông tin này chỉ có sẵn sau khi trạng thái của chương trình phát là live. Giá trị được chỉ định theo định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.actualEndTime datetime
Ngày và giờ mà sự kiện phát sóng thực sự kết thúc. Thông tin này chỉ có sẵn sau khi trạng thái của chương trình phát là complete. Giá trị được chỉ định theo định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.isDefaultBroadcast boolean
Tài sản này sẽ ngừng hoạt động từ hoặc sau ngày 1 tháng 9 năm 2020. Tại thời điểm đó, YouTube sẽ dừng tạo sự kiện phát trực tiếp và thông báo mặc định khi một kênh được bật tính năng phát trực tiếp. Vui lòng xem thông báo về việc ngừng cung cấp để biết thêm chi tiết.
Thuộc tính này cho biết liệu thông báo này có phải là thông báo mặc định hay không.

Cách hoạt động của thông báo mặc định

Khi một kênh YouTube được bật tính năng phát trực tiếp, YouTube sẽ tạo một sự kiện phát trực tiếp mặc định và một thông báo mặc định cho kênh đó. Sự kiện phát trực tiếp xác định cách chủ sở hữu kênh gửi video trực tiếp đến YouTube và chương trình phát sóng là cách người xem có thể xem sự kiện phát trực tiếp mặc định. Chủ sở hữu kênh có thể dùng phương thức liveStreams.listliveBroadcasts.list để xác định những tài nguyên này.

Khi một kênh bắt đầu phát video trực tuyến đến luồng mặc định, video đó sẽ xuất hiện trên chương trình phát sóng mặc định của kênh. Khi sự kiện phát trực tiếp kết thúc, YouTube sẽ chuyển đổi sự kiện phát sóng đã hoàn tất thành video trên YouTube và chỉ định mã video YouTube cho video đó.

Sau khi quá trình chuyển đổi hoàn tất, video này sẽ được đưa vào danh sách các video đã tải lên của kênh. Video không xuất hiện ngay sau khi chương trình phát sóng kết thúc và thời gian trì hoãn có liên quan đến thời lượng thực tế của chương trình phát sóng.
snippet.liveChatId string
Mã nhận dạng cuộc trò chuyện trực tiếp trên YouTube của người phát sóng. Với mã nhận dạng này, bạn có thể sử dụng các phương thức của tài nguyên liveChatMessage để truy xuất, chèn hoặc xoá tin nhắn trò chuyện. Bạn cũng có thể thêm hoặc xoá người kiểm duyệt cuộc trò chuyện, cấm người dùng tham gia cuộc trò chuyện trực tiếp hoặc xoá các lệnh cấm hiện có.
status object
Đối tượng status chứa thông tin về trạng thái của sự kiện.
status.lifeCycleStatus string
Trạng thái của thông báo truyền tin. Bạn có thể cập nhật trạng thái bằng phương thức liveBroadcasts.transition của API.

Các giá trị hợp lệ cho thuộc tính này là:
  • complete – Chương trình phát sóng đã kết thúc.
  • created – Chương trình phát có các chế độ cài đặt chưa hoàn chỉnh do đó chưa sẵn sàng chuyển đổi sang trạng thái live hoặc testing. Tuy nhiên, chương trình phát sóng đã được tạo và hợp lệ.
  • live – Chương trình phát đang chạy.
  • liveStarting – Chương trình phát sóng đang chuyển sang trạng thái live.
  • ready – Cài đặt chương trình phát sóng đã hoàn tất và chương trình phát có thể chuyển sang trạng thái live hoặc testing.
  • revoked – Một hành động của quản trị viên đã xoá thông báo này.
  • testStarting – Chương trình phát sóng đang chuyển sang trạng thái testing.
  • testing – Chỉ đối tác mới xem được nội dung phát sóng.
status.privacyStatus string
Trạng thái quyền riêng tư của chương trình phát sóng. Lưu ý rằng chương trình phát sóng biểu thị chính xác một video trên YouTube, vì vậy cài đặt bảo mật đồng nhất với các cài đặt được hỗ trợ cho video. Ngoài ra, bạn có thể thiết lập trường này bằng cách sửa đổi tài nguyên truyền tin hoặc thiết lập trường privacyStatus của tài nguyên video tương ứng.

Các giá trị hợp lệ cho thuộc tính này là:
  • private
  • public
  • unlisted
status.recordingStatus string
Trạng thái ghi của chương trình phát sóng.

Các giá trị hợp lệ cho thuộc tính này là:
  • notRecording
  • recorded
  • recording
status.madeForKids boolean
Giá trị này cho biết chương trình phát sóng có được chỉ định là dành cho trẻ em hay không. Giá trị thuộc tính này đang ở chế độ chỉ có thể đọc.
status.selfDeclaredMadeForKids boolean
Trong yêu cầu liveBroadcasts.insert, tài sản này cho phép chủ sở hữu kênh chỉ định nội dung phát sóng là hướng tới trẻ em. Trong yêu cầu liveBroadcasts.list, giá trị thuộc tính chỉ được trả về nếu chủ sở hữu kênh đã uỷ quyền yêu cầu API.
contentDetails object
Đối tượng contentDetails chứa thông tin về nội dung video của sự kiện, chẳng hạn như liệu nội dung có thể xuất hiện trong trình phát video nhúng hay không hoặc có được lưu trữ và do đó có thể xem được sau khi sự kiện kết thúc hay không.
contentDetails.boundStreamId string
Giá trị này xác định duy nhất live stream được liên kết với thông báo truyền tin.
contentDetails.boundStreamLastUpdateTimeMs datetime
Ngày và giờ cập nhật gần đây nhất của sự kiện phát trực tiếp mà boundStreamId tham chiếu.
contentDetails.monitorStream object
Đối tượng monitorStream chứa thông tin về luồng giám sát mà đài phát có thể sử dụng để xem xét nội dung sự kiện trước khi luồng truyền phát đó hiển thị công khai.
contentDetails.monitorStream.enableMonitorStream boolean
Giá trị này xác định liệu luồng giám sát có được bật cho sự kiện phát sóng hay không. Nếu luồng giám sát được bật thì YouTube sẽ phát nội dung sự kiện trên một luồng đặc biệt chỉ dành cho nội dung của đài phát. Đài phát có thể sử dụng sự kiện phát trực tiếp để xem xét nội dung sự kiện cũng như xác định thời điểm tối ưu để chèn các điểm dừng.

Bạn cần đặt giá trị này thành true nếu muốn đặt một giai đoạn testing cho chương trình phát sóng hoặc nếu bạn muốn độ trễ phát sóng đối với sự kiện của mình. Ngoài ra, nếu giá trị của thuộc tính này là true, bạn phải chuyển đổi thông báo truyền tin sang trạng thái testing rồi mới có thể chuyển thông báo đó sang trạng thái live. (Nếu giá trị của thuộc tính là false, thì chương trình phát sóng của bạn không được có giai đoạn testing, do đó bạn có thể chuyển đổi chương trình phát trực tiếp sang trạng thái live.)

Khi update a broadcast, bạn phải đặt thuộc tính này nếu yêu cầu API của bạn bao gồm phần contentDetails trong giá trị thông số part. Tuy nhiên, khi insert a broadcast, thuộc tính này là không bắt buộc và có giá trị mặc định là true.

Lưu ý quan trọng: Bạn không thể cập nhật thuộc tính này sau khi chương trình phát sóng ở trạng thái testing hoặc live.
contentDetails.monitorStream.broadcastStreamDelayMs unsigned integer
Nếu bạn đã đặt thuộc tính enableMonitorStream thành true, thì thuộc tính này sẽ xác định khoảng thời gian trễ phát sóng trực tiếp.

Khi update a broadcast, bạn phải đặt thuộc tính này nếu yêu cầu API của bạn bao gồm phần contentDetails trong giá trị thông số part. Tuy nhiên, khi insert a broadcast, thuộc tính này là không bắt buộc và có giá trị mặc định là 0. Giá trị này cho biết rằng sự kiện phát sóng không có độ trễ phát sóng. Lưu ý: Bạn không thể cập nhật thuộc tính này sau khi chương trình phát sóng ở trạng thái testing hoặc live.
contentDetails.monitorStream.embedHtml string
Mã HTML nhúng một trình phát để phát luồng giám sát.
contentDetails.enableEmbed boolean
Chế độ cài đặt này cho biết liệu video phát sóng có thể phát trong trình phát được nhúng hay không. Nếu bạn chọn lưu trữ video (bằng tài sản enableArchive), chế độ cài đặt này cũng sẽ áp dụng cho video đã lưu trữ.

Khi update a broadcast, bạn phải đặt thuộc tính này nếu yêu cầu API của bạn bao gồm phần contentDetails trong giá trị thông số part. Tuy nhiên, khi insert a broadcast, thuộc tính này là không bắt buộc và có giá trị mặc định là true.

Lưu ý: Bạn không thể cập nhật thuộc tính này sau khi chương trình phát sóng ở trạng thái testing hoặc live.
contentDetails.enableDvr boolean
Chế độ cài đặt này xác định liệu người xem có thể truy cập vào các bộ điều khiển DVR trong khi xem video hay không. Bộ điều khiển DVR cho phép người xem kiểm soát trải nghiệm phát video bằng cách tạm dừng, tua lại hoặc tua nhanh nội dung. Giá trị mặc định cho thuộc tính này là true.

Khi update a broadcast, bạn phải đặt thuộc tính này nếu yêu cầu API của bạn bao gồm phần contentDetails trong giá trị thông số part. Tuy nhiên, khi insert a broadcast, thuộc tính này là không bắt buộc và có giá trị mặc định là true.

Lưu ý quan trọng: Bạn phải đặt giá trị thành true và đặt giá trị của thuộc tính enableArchive thành true nếu bạn muốn cung cấp chế độ phát ngay sau khi sự kiện phát sóng kết thúc. Ngoài ra, bạn không thể cập nhật thuộc tính này khi chương trình phát sóng ở trạng thái testing hoặc live.
contentDetails.recordFromStart boolean
Chế độ cài đặt này cho biết YouTube có tự động bắt đầu ghi lại chương trình phát sóng sau khi trạng thái của sự kiện chuyển thành phát trực tiếp hay không.

Giá trị mặc định của thuộc tính này là true. Bạn chỉ có thể đặt giá trị này thành false nếu kênh phát sóng được phép tắt tính năng ghi lại chương trình phát sóng trực tiếp.

Nếu kênh của bạn không có quyền tắt tính năng ghi lại và bạn cố gắng chèn một thông báo truyền tin có thuộc tính recordFromStart được đặt thành false, thì API sẽ trả về lỗi Forbidden. Ngoài ra, nếu kênh của bạn không có quyền đó và bạn cố gắng cập nhật thông báo truyền tin để đặt thuộc tính recordFromStart thành false, thì API sẽ trả về lỗi modificationNotAllowed.

Khi update a broadcast, bạn phải đặt thuộc tính này nếu yêu cầu API của bạn bao gồm phần contentDetails trong giá trị thông số part. Tuy nhiên, khi insert a broadcast, thuộc tính này là không bắt buộc và có giá trị mặc định là true.

Lưu ý quan trọng: Bạn cũng phải đặt giá trị của thuộc tính enableDvr thành true nếu bạn muốn nội dung phát ngay lập tức sau khi sự kiện phát sóng kết thúc. Nếu bạn đặt giá trị của thuộc tính này thành true nhưng cũng không đặt thuộc tính enableDvr thành true, thì có thể bị trễ khoảng một ngày trước khi video đã lưu trữ có sẵn để phát.

Lưu ý: Bạn không thể cập nhật thuộc tính này sau khi chương trình phát sóng ở trạng thái testing hoặc live.
contentDetails.enableClosedCaptions boolean
Thuộc tính này không được dùng nữa kể từ ngày 17 tháng 12 năm 2015. Thay vào đó, hãy sử dụng thuộc tính contentDetails.closedCaptionsType.

Chế độ cài đặt này cho biết liệu phụ đề HTTP POST có được bật cho chương trình phát sóng này hay không. Đối với các ứng dụng API đang sử dụng thuộc tính này:
  • Việc đặt giá trị thuộc tính thành true tương đương với việc đặt thuộc tính contentDetails.closedCaptionsType thành closedCaptionsHttpPost.
  • Việc đặt giá trị thuộc tính thành false tương đương với việc đặt thuộc tính contentDetails.closedCaptionsType thành closedCaptionsDisabled.
contentDetails.closedCaptionsType string
Lưu ý: Thuộc tính này thay thế thuộc tính contentDetails.enableClosedCaptions.

Thuộc tính này cho biết liệu phụ đề chi tiết có được bật cho chương trình phát sóng của bạn hay không và nếu có, loại phụ đề mà bạn đang cung cấp là gì:
  • closedCaptionsDisabled: Phụ đề bị tắt cho chương trình phát sóng trực tiếp.
  • closedCaptionsHttpPost: Bạn sẽ gửi phụ đề qua HTTP POST tới một URL truyền dẫn liên kết với sự kiện phát trực tiếp của mình.
  • closedCaptionsEmbedded: Phụ đề sẽ được mã hoá trong luồng video bằng các định dạng EIA-608 và/hoặc CEA-708.
contentDetails.projection string
Định dạng chiếu của chương trình phát sóng này. Giá trị mặc định của thuộc tính này là rectangular.

Các giá trị hợp lệ cho thuộc tính này là:
  • 360
  • rectangular
contentDetails.enableLowLatency boolean
Cho biết liệu chương trình phát sóng này có nên được mã hoá để phát trực tiếp có độ trễ thấp hay không. Sự kiện phát trực tiếp có độ trễ thấp có thể giúp giảm thời gian cần thiết để người dùng nhìn thấy video trong lúc xem chương trình phát sóng, mặc dù điều này cũng có thể ảnh hưởng đến độ phân giải của sự kiện đó.
contentDetails.latencyPreference string
Cho biết chế độ cài đặt độ trễ nào cho chương trình phát sóng này. Thuộc tính này có thể được dùng thay cho enableLowLatency, vốn không hỗ trợ ultraLow.

Sự kiện phát trực tiếp có độ trễ thấp có thể làm giảm thời gian cần thiết để người dùng xem video, mặc dù sự kiện đó cũng có thể ảnh hưởng đến độ mượt của video phát.

Sự kiện phát trực tiếp có độ trễ cực thấp giúp giảm đáng kể thời gian phát video, giúp việc tương tác với người xem dễ dàng hơn. Thuộc tính này chỉ có độ phân giải thấp nhất là 1.

  • normal
  • low
  • ultraLow
contentDetails.enableAutoStart boolean
Cho biết liệu chương trình phát này có tự động bắt đầu khi bạn bắt đầu phát video trực tuyến trên giới hạn live stream hay không.
contentDetails.enableAutoStop boolean
Cho biết liệu quá trình phát sóng này có tự động dừng sau khoảng một phút sau khi chủ sở hữu kênh dừng phát trực tuyến video trên luồng video ràng buộc hay không.
statistics object
Đối tượng statistics chứa số liệu thống kê liên quan đến một chương trình phát sóng trực tiếp. Giá trị cho các số liệu thống kê này có thể thay đổi trong khi phát sóng và chỉ có thể truy xuất được khi chương trình đó đang phát trực tiếp.
statistics.totalChatCount unsigned long
Tổng số tin nhắn trò chuyện trực tiếp được liên kết với sự kiện phát sóng. Tài sản và giá trị của tài sản sẽ xuất hiện nếu người dùng nhìn thấy sự kiện phát sóng, đã bật tính năng trò chuyện trực tiếp và có ít nhất một tin nhắn. Xin lưu ý rằng thuộc tính này sẽ không chỉ định giá trị sau khi sự kiện phát sóng kết thúc. Vì vậy, tài sản này sẽ không xác định số lượng tin nhắn trò chuyện của một video lưu trữ của một chương trình phát sóng trực tiếp đã kết thúc.
monetizationDetails object
Đối tượng monetizationDetails chứa thông tin về thông tin chi tiết về hoạt động kiếm tiền của sự kiện phát trực tiếp, chẳng hạn như liệu trình tự động hoá quảng cáo có đang bật hay không hoặc việc chèn quảng cáo trong video có bị trễ hay không.

monetizationDetails.cuepointSchedule object
Đối tượng cuepointSchedule chỉ định chế độ cài đặt tự động hoá quảng cáo cho thông báo truyền tin.
monetizationDetails.cuepointSchedule.enabled boolean
Giá trị này xác định liệu quảng cáo có được tự động chèn vào chương trình phát sóng hay không. Nếu giá trị là true, YouTube sẽ tự động chèn quảng cáo trong video vào sự kiện phát sóng. Lịch chạy quảng cáo sẽ được xác định theo giá trị của các trường khác trong đối tượng monetizationDetails.cuepointSchedule.
monetizationDetails.cuepointSchedule.pauseAdsUntil datetime
Giá trị này quy định rằng YouTube không được chèn quảng cáo trong video vào chương trình phát sóng cho đến ngày giờ đã chỉ định. Giá trị được chỉ định theo định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). Giá trị phải được đặt thành một ngày giờ trong tương lai để tạm dừng quảng cáo; bạn cũng có thể đặt giá trị của trường thành một ngày giờ gần trong tương lai để huỷ tạm dừng quảng cáo khi thời gian trôi qua.
monetizationDetails.cuepointSchedule.scheduleStrategy string
Giá trị này xác định chiến lược mà YouTube nên áp dụng để lên lịch cho các điểm dừng. Các giá trị hợp lệ là:
  • CONCURRENT: Các điểm dừng được lên lịch cùng một lúc cho tất cả người xem
  • NON_CONCURRENT: Các điểm dừng được lên lịch cho những thời điểm khác nhau cho những người xem khác nhau. Cách tiếp cận này giúp quảng cáo xuất hiện với tốc độ cao hơn, cho phép người xem nhận được điểm dừng khi đủ điều kiện.
monetizationDetails.cuepointSchedule.repeatIntervalSecs unsigned integer
Giá trị này chỉ định khoảng thời gian tính bằng giây giữa các lần tự động chèn quảng cáo trong một chương trình phát sóng. Ví dụ: nếu giá trị là 300, YouTube có thể chèn các điểm dừng quảng cáo trong video cách nhau 5 phút.

Hãy lưu ý rằng giá trị này chỉ định khoảng thời gian tính từ thời điểm bắt đầu của các điểm dừng liên tiếp. Điều này nghĩa là khoảng thời gian không được đo từ điểm cuối của một điểm dừng đến điểm bắt đầu của điểm tiếp theo.