YouTube Live Streaming API - Errors

Tài liệu này xác định các loại lỗi mà các thao tác YouTube Live Streaming API có thể trả về. Bạn cũng có thể tìm thấy danh sách lỗi cho từng phương thức riêng lẻ trong tài liệu tham khảo về phương thức đó.

fanFundingEvents

Các bảng sau đây xác định những thông báo lỗi mà API trả về để phản hồi các lệnh gọi liên quan đến tài nguyên fanFundingEvents.

fanFundingEvents.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) insufficientPermissions Bạn không có quyền cần thiết để xem các sự kiện Kêu gọi ủng hộ của kênh.
invalidValue (400) fanFundingNotEnabledForChannelId Kênh này chưa bật tính năng Tài trợ của người hâm mộ.

liveBroadcasts

Các bảng sau đây xác định những thông báo lỗi mà API trả về để phản hồi các lệnh gọi liên quan đến tài nguyên liveBroadcasts.

liveBroadcasts.bind

Loại lỗi Thông tin chi tiết về lỗi Mô tả
backendError internalError Đã xảy ra lỗi nội bộ trong quá trình liên kết.
forbidden (403) liveBroadcastBindingNotAllowed Trạng thái hiện tại của chương trình phát sóng trực tiếp không cho phép liên kết với một luồng phát.
insufficientPermissions insufficientLivePermissions Yêu cầu không được phép truy xuất chương trình phát sóng trực tiếp được chỉ định. Để biết thêm thông tin, hãy xem bài viết Triển khai quy trình xác thực OAuth2.
insufficientPermissions liveStreamingNotEnabled Người dùng đã uỷ quyền cho yêu cầu không được phép phát trực tiếp video trên YouTube. Người dùng có thể tìm thêm thông tin tại https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound Chương trình phát sóng do tham số id chỉ định không tồn tại.
notFound (404) liveStreamNotFound Luồng được chỉ định bằng thông số streamId không tồn tại.
rateLimitExceeded userRequestsExceedRateLimit Người dùng đã gửi quá nhiều yêu cầu trong một khung thời gian nhất định.
required (400) idRequired Tham số id bắt buộc phải xác định được chương trình phát sóng cần liên kết.

liveBroadcasts.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) liveBroadcastDeletionNotAllowed Trạng thái hiện tại của chương trình phát sóng trực tiếp không cho phép bạn xoá chương trình đó.
insufficientPermissions insufficientLivePermissions Yêu cầu không được phép xoá chương trình phát sóng trực tiếp đã chỉ định. Để biết thêm thông tin, hãy xem bài viết Triển khai quy trình xác thực OAuth2.
insufficientPermissions liveStreamingNotEnabled Người dùng đã uỷ quyền cho yêu cầu không được phép phát trực tiếp video trên YouTube. Người dùng có thể tìm thêm thông tin tại https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound Thuộc tính id được chỉ định trong tài nguyên liveBroadcast không xác định được chương trình phát sóng.

liveBroadcasts.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
insufficientPermissions insufficientLivePermissions Yêu cầu không được phép tạo chương trình phát sóng trực tiếp.
insufficientPermissions livePermissionBlocked Người dùng đã uỷ quyền cho yêu cầu này hiện không thể phát trực tiếp video trên YouTube. Thông tin giải thích lý do người dùng không thể phát trực tiếp video có thể có trong phần cài đặt kênh của người dùng tại https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled Người dùng đã uỷ quyền cho yêu cầu không được phép phát trực tiếp video trên YouTube. Người dùng có thể tìm thêm thông tin tại https://www.youtube.com/features.
invalidValue (400) invalidAutoStart Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính contentDetails.enableAutoStart. Không phải chương trình phát sóng nào cũng hỗ trợ chế độ cài đặt này.
invalidValue (400) invalidAutoStop Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính contentDetails.enableAutoStop. Bạn không thể sửa đổi chế độ cài đặt enableAutoStop cho một thông báo truyền tin liên tục.
invalidValue (400) invalidDescription Tài nguyên liveBroadcast không chỉ định giá trị hợp lệ cho thuộc tính snippet.description. Giá trị của thuộc tính có thể chứa tối đa 5.000 ký tự.
invalidValue (400) invalidEmbedSetting Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính contentDetails.enable_embed. Bạn không thể nhúng chương trình phát sóng này.
invalidValue (400) invalidLatencyPreferenceOptions Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính contentDetails.latencyPreference. Không phải chế độ cài đặt nào cũng được hỗ trợ với lựa chọn ưu tiên về độ trễ này.
invalidValue (400) invalidPrivacyStatus Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính status.privacy_status.
invalidValue (400) invalidProjection Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính contentDetails.projection. Bạn không thể đặt chế độ chiếu của một chương trình phát sóng mặc định thành 360.
invalidValue (400) invalidScheduledEndTime Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính snippet.scheduledEndTime. Thời gian kết thúc theo lịch phải sau thời gian bắt đầu theo lịch.
invalidValue (400) invalidScheduledStartTime Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính snippet.scheduledStartTime. Giờ bắt đầu theo lịch phải là giờ trong tương lai và đủ gần với ngày hiện tại để có thể lên lịch phát sóng một cách đáng tin cậy vào thời điểm đó.
invalidValue (400) invalidTitle Tài nguyên liveBroadcast không chỉ định giá trị hợp lệ cho thuộc tính snippet.title. Giá trị của thuộc tính phải dài từ 1 đến 100 ký tự.
limitExceeded userBroadcastsExceedLimit Người dùng đã tạo quá nhiều sự kiện phát trực tiếp hoặc phát sóng theo lịch và phải dừng hoặc xoá một số sự kiện.
rateLimitExceeded userRequestsExceedRateLimit Người dùng đã gửi quá nhiều yêu cầu trong một khung thời gian nhất định.
required (400) privacyStatusRequired Tài nguyên liveBroadcast phải chỉ định trạng thái riêng tư. Xem các giá trị privacyStatus hợp lệ.
required (400) scheduledEndTimeRequired Tài nguyên liveBroadcast phải chỉ định thuộc tính snippet.scheduledEndTime.
required (400) scheduledStartTimeRequired Tài nguyên liveBroadcast phải chỉ định thuộc tính snippet.scheduledStartTime.
required (400) titleRequired Tài nguyên liveBroadcast phải chỉ định thuộc tính snippet.title.

liveBroadcasts.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
insufficientPermissions insufficientLivePermissions Yêu cầu không được phép truy xuất chương trình phát sóng trực tiếp.
insufficientPermissions liveStreamingNotEnabled Người dùng đã uỷ quyền cho yêu cầu không được phép phát trực tiếp video trên YouTube. Người dùng có thể tìm thêm thông tin tại https://www.youtube.com/features.

liveBroadcasts.transition

Loại lỗi Thông tin chi tiết về lỗi Mô tả
backendError errorExecutingTransition Đã xảy ra lỗi khi thay đổi trạng thái của chương trình phát sóng.
forbidden (403) errorStreamInactive Bạn không được phép thực hiện quá trình chuyển đổi được yêu cầu khi luồng liên kết với chương trình phát sóng không hoạt động.
forbidden (403) invalidTransition Chương trình phát sóng trực tiếp không thể chuyển từ trạng thái hiện tại sang trạng thái được yêu cầu.
forbidden (403) redundantTransition Chương trình phát sóng trực tiếp đã ở trạng thái được yêu cầu hoặc đang xử lý để chuyển sang trạng thái được yêu cầu.
insufficientPermissions insufficientLivePermissions Yêu cầu không được phép chuyển đổi sự kiện phát trực tiếp.
insufficientPermissions livePermissionBlocked Người dùng đã uỷ quyền cho yêu cầu này hiện không thể phát trực tiếp video trên YouTube. Thông tin giải thích lý do người dùng không thể phát trực tiếp video có thể có trong phần cài đặt kênh của người dùng tại https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled Người dùng đã uỷ quyền cho yêu cầu không được phép phát trực tiếp video trên YouTube. Người dùng có thể tìm thêm thông tin tại https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound Chương trình phát sóng do tham số id chỉ định không tồn tại.
rateLimitExceeded (403) userRequestsExceedRateLimit Người dùng đã gửi quá nhiều yêu cầu trong một khung thời gian nhất định.
required (400) idRequired Tham số id bắt buộc phải xác định chương trình phát sóng mà bạn muốn chuyển đổi trạng thái.
required (400) statusRequired Yêu cầu API phải chỉ định một giá trị cho tham số status.

liveBroadcasts.update

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) closedCaptionsTypeModificationNotAllowed Bạn chỉ có thể sửa đổi giá trị contentDetails.closedCaptionsType khi chương trình phát sóng ở trạng thái created hoặc ready.
forbidden (403) enableAutoStartModificationNotAllowed Bạn chỉ có thể sửa đổi giá trị contentDetails.enableAutoStart khi luồng đang không hoạt động và chương trình phát sóng ở trạng thái created hoặc ready.
forbidden (403) enableClosedCaptionsModificationNotAllowed Bạn chỉ có thể sửa đổi giá trị contentDetails.enableClosedCaptions khi trạng thái của chương trình phát sóng là created hoặc ready.
forbidden (403) enableDvrModificationNotAllowed Bạn chỉ có thể sửa đổi giá trị contentDetails.enableDvr khi trạng thái của chương trình phát sóng là created hoặc ready.
forbidden (403) enableMonitorStreamModificationNotAllowed Bạn chỉ có thể sửa đổi giá trị contentDetails.monitorStream.enableMonitorStream khi trạng thái của chương trình phát sóng là created hoặc ready.
forbidden (403) recordFromStartModificationNotAllowed Bạn chỉ có thể sửa đổi giá trị contentDetails.recordFromStart khi trạng thái của chương trình phát sóng là created hoặc ready.
insufficientPermissions insufficientLivePermissions Yêu cầu không được phép cập nhật chương trình phát sóng trực tiếp được chỉ định. Để biết thêm thông tin, hãy xem bài viết Triển khai quy trình xác thực OAuth2.
insufficientPermissions liveStreamingNotEnabled Người dùng đã uỷ quyền cho yêu cầu không được phép phát trực tiếp video trên YouTube. Người dùng có thể tìm thêm thông tin tại https://www.youtube.com/features.
invalidValue (400) invalidAutoStart Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính contentDetails.enableAutoStart. Bạn không thể sửa đổi chế độ cài đặt enableAutoStart cho một thông báo truyền tin liên tục.
invalidValue (400) invalidAutoStop Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính contentDetails.enableAutoStop. Bạn không thể sửa đổi chế độ cài đặt enableAutoStop cho một thông báo truyền tin liên tục.
invalidValue (400) invalidDescription Tài nguyên liveBroadcast không chỉ định giá trị hợp lệ cho thuộc tính snippet.description. snippet.description có thể chứa tối đa 5.000 ký tự.
invalidValue (400) invalidEmbedSetting Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính contentDetails.enable_embed. Bạn không thể nhúng chương trình phát sóng này.
invalidValue (400) invalidEnableClosedCaptions Trong tài nguyên liveBroadcast, giá trị của thuộc tính contentDetails.enableClosedCaptions không tương thích với giá trị của chế độ cài đặt contentDetails.closedCaptionType. Sửa đổi tài nguyên để chỉ bao gồm một trong hai thuộc tính, rồi gửi lại yêu cầu.
invalidValue (400) invalidLatencyPreferenceOptions Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính contentDetails.latencyPreference. Không phải chế độ cài đặt nào cũng được hỗ trợ với lựa chọn ưu tiên về độ trễ này.
invalidValue (400) invalidPrivacyStatus Tài nguyên liveBroadcast không chỉ định trạng thái quyền riêng tư hợp lệ. Xem các giá trị privacyStatus hợp lệ.
invalidValue (400) invalidProjection Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính contentDetails.projection. Bạn không thể đặt chế độ chiếu của một chương trình phát sóng liên tục thành 360.
invalidValue (400) invalidScheduledEndTime Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính snippet.scheduledEndTime. Thời gian kết thúc theo lịch phải sau thời gian bắt đầu theo lịch.
invalidValue (400) invalidScheduledStartTime Tài nguyên liveBroadcast chứa một giá trị không hợp lệ cho thuộc tính snippet.scheduledStartTime. Thời gian bắt đầu theo lịch phải là thời gian trong tương lai.
invalidValue (400) invalidTitle Tài nguyên liveBroadcast không chỉ định giá trị hợp lệ cho thuộc tính snippet.title. snippet.title phải dài từ 1 đến 100 ký tự.
notFound (404) liveBroadcastNotFound Thuộc tính id được chỉ định trong tài nguyên liveBroadcast không xác định được chương trình phát sóng.
required (400) broadcastStreamDelayMsRequired Tài nguyên liveBroadcast không chỉ định thuộc tính contentDetails.monitorStream.broadcastStreamDelayMs.
required (400) enableMonitorStreamRequired Tài nguyên liveBroadcast không chỉ định thuộc tính contentDetails.monitorStream.enableMonitorStream.
required (400) idRequired Tài nguyên liveBroadcast phải bao gồm và chỉ định một giá trị cho thuộc tính id.
required (400) privacyStatusRequired Tài nguyên liveBroadcast không chỉ định trạng thái riêng tư. Hãy xem để biết các giá trị privacyStatus hợp lệ.
required (400) scheduledEndTimeRequired Tài nguyên liveBroadcast không chỉ định thuộc tính snippet.scheduledEndTime.
required (400) scheduledStartTimeRequired Tài nguyên liveBroadcast không chỉ định thuộc tính snippet.scheduledStartTime.
required (400) titleRequired Tài nguyên liveBroadcast không chỉ định thuộc tính snippet.title.

liveBroadcasts.cuepoint

Loại lỗi Thông tin chi tiết về lỗi Mô tả
insufficientPermissions (403) insufficientLivePermissions Yêu cầu không được phép chèn điểm đánh dấu trong chương trình phát sóng trực tiếp.
insufficientPermissions (403) liveStreamingNotEnabled Người dùng đã uỷ quyền cho yêu cầu không được phép phát trực tiếp video trên YouTube. Người dùng có thể tìm thêm thông tin tại https://support.google.com/youtube/answer/2474026 và https://www.youtube.com/features.
rateLimitExceeded (403) userRequestsExceedRateLimit Người dùng đã gửi quá nhiều yêu cầu trong một khung thời gian nhất định.
required (400) idRequired Tham số id bắt buộc phải xác định chương trình phát sóng mà bạn muốn chèn một điểm đánh dấu.
required (400) cueTypeRequired Bạn phải chỉ định trường cueType bắt buộc trong phần nội dung yêu cầu API.
notFound (404) liveBroadcastNotFound Chương trình phát sóng do tham số id chỉ định không tồn tại.
invalidValue (400) conflictingTimeFields Bạn chỉ có thể chỉ định một trong hai giá trị insertionOffsetTimeMs và walltimeMs. Việc đặt cả hai giá trị sẽ gây ra lỗi. Nếu bạn không đặt giá trị nào, YouTube sẽ sử dụng thời gian insertionOffsetTimeMs mặc định (0), tức là điểm đánh dấu sẽ được chèn sớm nhất có thể.
invalidValue (400) invalidInsertionOffsetTimeMs Tài nguyên cuepoint đã chỉ định một giá trị không hợp lệ cho thuộc tính insertionOffsetTimeMs. Giá trị phải là 0 hoặc một số nguyên dương.
invalidValue (400) invalidWalltimeMs Tài nguyên cuepoint đã chỉ định một giá trị không hợp lệ cho thuộc tính walltimeMs. Giá trị phải là một số nguyên biểu thị dấu thời gian của kỷ nguyên.
backendError (5xx) serviceUnavailable Dịch vụ này hiện không hoạt động. Hãy thử lại yêu cầu của bạn sau vài phút.

liveChatBans

Các bảng sau đây xác định những thông báo lỗi mà API trả về để phản hồi các lệnh gọi liên quan đến tài nguyên liveChatBans.

liveChatBans.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Không thể xoá lệnh cấm đã chỉ định. Lỗi này có thể xảy ra nếu yêu cầu được một người kiểm duyệt uỷ quyền và người này đang cố gắng gỡ lệnh cấm đối với một người kiểm duyệt khác.
forbidden (403) insufficientPermissions Bạn không có các quyền cần thiết để xoá lệnh cấm đã chỉ định.
invalidValue (400) invalidLiveChatBanId Tham số id chỉ định một giá trị không hợp lệ.
notFound (404) liveChatBanNotFound Không tìm thấy lệnh cấm được chỉ định.

liveChatBans.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) insufficientPermissions Bạn không có các quyền cần thiết để cấm người dùng tham gia một cuộc trò chuyện trực tiếp cụ thể.
forbidden (403) liveChatBanInsertionNotAllowed Không thể tạo lệnh cấm được chỉ định. Lỗi này có thể xảy ra nếu yêu cầu tìm cách cấm chủ sở hữu cuộc trò chuyện hoặc một người kiểm duyệt khác.
invalidValue (400) invalidChannelId Không tìm thấy mã kênh bạn đã nhập.
invalidValue (400) invalidLiveChatId Giá trị snippet.liveChatId được chỉ định trong yêu cầu là không hợp lệ. Kiểm tra tài nguyên liveBroadcast được liên kết để đảm bảo rằng bạn có giá trị chính xác.
notFound (404) liveChatNotFound Không tìm thấy cuộc trò chuyện trực tiếp được chỉ định. Kiểm tra tài nguyên liveBroadcast được liên kết để đảm bảo rằng bạn đang đặt thuộc tính snippet.liveChatId thành giá trị chính xác.
notFound (404) liveChatUserNotFound Không tìm thấy người dùng trò chuyện trực tiếp mà bạn đang cố gắng cấm.
required (400) bannedUserChannelIdRequired Tài nguyên liveChatBan được gửi trong nội dung yêu cầu phải chỉ định một giá trị cho thuộc tính snippet.bannedUserDetails.channelId.
required (400) liveChatIdRequired Tài nguyên liveChatBan được gửi trong nội dung yêu cầu phải chỉ định một giá trị cho thuộc tính snippet.liveChatId.

liveChatMessages

Các bảng sau đây xác định những thông báo lỗi mà API trả về để phản hồi các lệnh gọi liên quan đến tài nguyên liveChatMessages.

liveChatMessages.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Bạn không có quyền cần thiết để xoá thư đã chỉ định.
forbidden (403) modificationNotAllowed Không thể xoá tài nguyên liveChatMessage đã chỉ định. Tham số id có thể xác định một tin nhắn do người kiểm duyệt hoặc người dùng khác tạo ra mà tin nhắn của họ không thể bị xoá.
notFound (404) liveChatMessageNotFound Không tìm thấy tin nhắn mà bạn đang cố gắng xoá. Kiểm tra giá trị của tham số id để đảm bảo rằng giá trị này chính xác.

liveChatMessages.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Bạn không có quyền cần thiết để tạo thông báo được chỉ định.
forbidden (403) liveChatDisabled Chủ sở hữu đã tắt chế độ trò chuyện trực tiếp được chỉ định, tức là bạn không thể thêm tin nhắn vào cuộc trò chuyện.
forbidden (403) liveChatEnded Cuộc trò chuyện trực tiếp được chỉ định không còn diễn ra nữa.
invalidValue (400) messageTextInvalid Văn bản tin nhắn (snippet.textMessageDetails.messageText) không hợp lệ.
notFound (404) liveChatNotFound Không tồn tại cuộc trò chuyện trực tiếp được xác định trong yêu cầu API. Lỗi này xảy ra nếu chủ sở hữu đã xoá cuộc trò chuyện.
rateLimitExceeded rateLimitExceeded Người dùng đã đăng quá nhiều tin nhắn trò chuyện trong một khoảng thời gian nhất định.
required (400) liveChatIdRequired Tài nguyên liveChatMessage phải bao gồm và chỉ định một giá trị cho thuộc tính snippet.liveChatId.
required (400) messageTextRequired Tài nguyên liveChatMessage phải bao gồm và chỉ định một giá trị cho thuộc tính snippet.textMessageDetails.messageText.
required (400) typeRequired Tài nguyên liveChatMessage phải bao gồm và chỉ định một giá trị cho thuộc tính snippet.type. Đặt giá trị tham số thành text

liveChatMessages.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Bạn không có các quyền cần thiết để truy xuất tin nhắn cho cuộc trò chuyện trực tiếp được chỉ định.
forbidden (403) liveChatDisabled Sự kiện phát sóng được chỉ định chưa được bật tính năng trò chuyện trực tiếp.
forbidden (403) liveChatEnded Cuộc trò chuyện trực tiếp được chỉ định không còn diễn ra nữa.
notFound (404) liveChatNotFound Không tìm thấy cuộc trò chuyện trực tiếp mà bạn đang cố gắng truy xuất. Kiểm tra giá trị của tham số liveChatId trong yêu cầu để đảm bảo rằng giá trị đó chính xác.
rateLimitExceeded rateLimitExceeded Yêu cầu được gửi quá nhanh sau yêu cầu trước đó. Lỗi này xảy ra khi các yêu cầu API để truy xuất thông báo được gửi thường xuyên hơn tốc độ làm mới của YouTube, điều này gây lãng phí băng thông một cách không cần thiết.

liveCuepoints

Các bảng sau đây xác định những thông báo lỗi mà API trả về để phản hồi các lệnh gọi liên quan đến tài nguyên liveCuepoints.

liveCuepoints.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
invalidValue (400) conflictingTimeFields Bạn chỉ có thể chỉ định một trong hai giá trị offsetTimeMs và walltime.

liveChatMessages.streamlist

Loại lỗi Thông tin chi tiết về lỗi Mô tả
INVALID_ARGUMENT (3) LIVE_CHAT_ENDED Bạn không thể truy xuất tin nhắn của cuộc trò chuyện trực tiếp đã kết thúc.
PERMISSION_DENIED (7) forbidden Bạn không có các quyền cần thiết để truy xuất tin nhắn cho cuộc trò chuyện trực tiếp được chỉ định.
PERMISSION_DENIED (7) liveChatDisabled Sự kiện phát sóng được chỉ định chưa được bật tính năng trò chuyện trực tiếp.
PERMISSION_DENIED (7) liveChatEnded Cuộc trò chuyện trực tiếp được chỉ định không còn diễn ra nữa.
NOT_FOUND (5) liveChatNotFound Không tìm thấy cuộc trò chuyện trực tiếp mà bạn đang cố gắng truy xuất. Kiểm tra giá trị của tham số liveChatId trong yêu cầu để đảm bảo rằng giá trị đó chính xác.
RESOURCE_EXHAUSTED (8) rateLimitExceeded Yêu cầu được gửi quá nhanh sau yêu cầu trước đó. Lỗi này xảy ra khi các yêu cầu API để truy xuất thông báo được gửi thường xuyên hơn tốc độ làm mới của YouTube, điều này gây lãng phí băng thông một cách không cần thiết.

liveCuepoints

Các bảng sau đây xác định những thông báo lỗi mà API trả về để phản hồi các lệnh gọi liên quan đến tài nguyên liveCuepoints.

liveCuepoints.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
invalidValue (400) conflictingTimeFields Bạn chỉ có thể chỉ định một trong hai giá trị offsetTimeMs và walltime.

liveStreams

Các bảng sau đây xác định những thông báo lỗi mà API trả về để phản hồi các lệnh gọi liên quan đến tài nguyên liveStreams.

liveStreams.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) liveStreamDeletionNotAllowed Bạn không thể xoá sự kiện phát trực tiếp đã chỉ định vì sự kiện đó được liên kết với một chương trình phát sóng chưa kết thúc.
insufficientPermissions insufficientLivePermissions Yêu cầu không được phép xoá sự kiện phát trực tiếp đã chỉ định. Để biết thêm thông tin, hãy xem bài viết Triển khai quy trình xác thực OAuth 2.0.
insufficientPermissions liveStreamingNotEnabled Người dùng đã uỷ quyền cho yêu cầu không được phép phát trực tiếp video trên YouTube. Để biết thêm thông tin, hãy xem bài viết Điều kiện sử dụng tính năng.
notFound (404) liveStreamNotFound Sự kiện phát trực tiếp được chỉ định không tồn tại.

liveStreams.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
insufficientPermissions insufficientLivePermissions Yêu cầu không được phép tạo sự kiện phát trực tiếp được chỉ định.
insufficientPermissions livePermissionBlocked Người dùng đã uỷ quyền cho yêu cầu này hiện không thể phát trực tiếp video trên YouTube. Thông tin giải thích lý do người dùng không thể phát trực tiếp video có thể có trong phần cài đặt kênh của người dùng tại https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled Người dùng đã uỷ quyền cho yêu cầu không được phép phát trực tiếp video trên YouTube. Người dùng có thể tìm thêm thông tin tại https://www.youtube.com/features.
invalidValue (400) invalidDescription Giá trị của thuộc tính snippet.description trong tài nguyên liveStream có thể chứa tối đa 10.000 ký tự.
invalidValue (400) invalidFormat Giá trị của thuộc tính cdn.format trong tài nguyên liveStream không hợp lệ.
invalidValue (400) invalidFrameRate Giá trị của thuộc tính cdn.frameRate trong tài nguyên liveStream không hợp lệ.
invalidValue (400) invalidIngestionType Giá trị của thuộc tính cdn.ingestionType trong tài nguyên liveStream không hợp lệ.
invalidValue (400) invalidResolution Giá trị của thuộc tính cdn.resolution trong tài nguyên liveStream không hợp lệ.
invalidValue (400) invalidTitle Giá trị của thuộc tính snippet.title trong tài nguyên liveStream phải dài từ 1 đến 128 ký tự.
rateLimitExceeded userRequestsExceedRateLimit Người dùng đã gửi quá nhiều yêu cầu trong một khung thời gian nhất định.
required (400) cdnRequired Tài nguyên liveStream phải chứa đối tượng cdn.
required (400) frameRateRequired API sẽ trả về lỗi này nếu bạn chỉ định một giá trị cho thuộc tính cdn.resolution nhưng không chỉ định cho thuộc tính cdn.frameRate.
required (400) ingestionTypeRequired Tài nguyên liveStream phải chỉ định một giá trị cho thuộc tính cdn.ingestionType.
required (400) resolutionRequired API sẽ trả về lỗi này nếu bạn chỉ định một giá trị cho thuộc tính cdn.frameRate nhưng không chỉ định cho thuộc tính cdn.resolution.
required (400) titleRequired Tài nguyên liveStream phải chỉ định một giá trị cho thuộc tính snippet.title.

liveStreams.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
insufficientPermissions insufficientLivePermissions Yêu cầu không được phép truy xuất sự kiện phát trực tiếp được chỉ định.
insufficientPermissions liveStreamingNotEnabled Người dùng đã uỷ quyền cho yêu cầu không được phép phát trực tiếp video trên YouTube. Người dùng có thể tìm thêm thông tin tại https://www.youtube.com/features.

liveStreams.update

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) liveStreamModificationNotAllowed Bạn không thể sửa đổi sự kiện phát trực tiếp đã chỉ định ở trạng thái hiện tại. Để biết thêm thông tin, hãy xem phần Vòng đời của một chương trình phát sóng.
forbidden (403) liveStreamModificationNotAllowed API này không cho phép bạn thay đổi giá trị của các trường cdn.format, cdn.frameRate, cdn.ingestionType hoặc cdn.resolution sau khi luồng được tạo.
forbidden (403) liveStreamModificationNotAllowed API này không cho phép bạn thay đổi một luồng có thể dùng lại thành luồng không thể dùng lại hoặc ngược lại. Để biết thêm thông tin, hãy xem bài viết Tìm hiểu về chương trình phát sóng và luồng phát trực tiếp.
insufficientPermissions insufficientLivePermissions Yêu cầu không được phép cập nhật luồng phát trực tiếp được chỉ định. Để biết thêm thông tin, hãy xem bài viết Triển khai quy trình xác thực OAuth2.
insufficientPermissions liveStreamingNotEnabled Người dùng đã uỷ quyền cho yêu cầu không được phép phát trực tiếp video trên YouTube. Người dùng có thể tìm thêm thông tin tại https://www.youtube.com/features.
invalidValue (400) invalidDescription Giá trị của thuộc tính snippet.description trong tài nguyên liveStream có thể chứa tối đa 10.000 ký tự.
invalidValue (400) invalidTitle Giá trị của thuộc tính snippet.title trong tài nguyên liveStream phải có độ dài từ 1 đến 128 ký tự.
notFound (404) liveStreamNotFound Sự kiện phát trực tiếp được chỉ định không tồn tại.
required (400) idRequired Tài nguyên liveStream phải chỉ định một giá trị cho thuộc tính id.
required (400) ingestionTypeRequired Tài nguyên liveStream phải chỉ định một giá trị cho thuộc tính cdn.ingestionType.
required (400) titleRequired Tài nguyên liveStream phải chỉ định một giá trị cho thuộc tính snippet.title.

người tài trợ

Các bảng sau đây xác định những thông báo lỗi mà API trả về để phản hồi các lệnh gọi liên quan đến tài nguyên sponsors.

sponsors.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) insufficientPermissions Bạn không có các quyền cần thiết để xem danh sách nhà tài trợ của kênh.
invalidValue (400) invalidValueInRequest Yêu cầu chứa một giá trị không hợp lệ.
invalidValue (400) sponsorshipNotEnabledForChannelId Kênh chưa bật tính năng tài trợ.