YouTube Data API - Errors

Tài liệu này xác định các loại lỗi mà các thao tác YouTube Data 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 đó.

Lỗi chung

Các bảng sau đây xác định thông báo lỗi API không dành riêng cho một phương thức API cụ thể.

Core API errors

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Cấm truy cập. Yêu cầu có thể chưa được uỷ quyền đúng cách.
quotaExceeded (403) quotaExceeded Không thể hoàn tất yêu cầu vì bạn đã vượt quá hạn mức.

Common request errors

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) incompatibleParameters Yêu cầu chỉ định hai hoặc nhiều tham số không thể dùng trong cùng một yêu cầu.
badRequest (400) invalidFilters Yêu cầu chỉ định một tham số bộ lọc không hợp lệ.
badRequest (400) invalidPageToken Yêu cầu chỉ định một mã thông báo trang không hợp lệ.
badRequest (400) missingRequiredParameter Yêu cầu thiếu một tham số bắt buộc.
badRequest (400) unexpectedParameter Yêu cầu chỉ định một tham số không mong muốn.
forbidden (403) accountDelegationForbidden Người dùng đã xác thực không thể hành động thay mặt cho Tài khoản Google được chỉ định.
forbidden (403) authenticatedUserAccountClosed Tài khoản YouTube của người dùng đã xác thực bị đóng. Trong trường hợp người dùng đã xác thực đang hành động thay mặt cho một Tài khoản Google khác, thì lỗi này đề cập đến tài khoản đó.
forbidden (403) authenticatedUserAccountSuspended Tài khoản YouTube của người dùng đã xác thực bị tạm ngưng. Trong trường hợp người dùng đã xác thực đang hành động thay mặt cho một Tài khoản Google khác, thì lỗi này đề cập đến tài khoản đó.
forbidden (403) authenticatedUserNotChannel Đối với yêu cầu này, người dùng đã xác thực phải phân giải thành một kênh, nhưng không thực hiện được. Nếu yêu cầu của bạn được xác thực và sử dụng tham số uỷ quyền onBehalfOfContentOwner, thì bạn cũng nên đặt tham số onBehalfOfContentOwnerChannel.
forbidden (403) channelClosed Kênh được xác định trong yêu cầu đã bị đóng.
forbidden (403) channelNotFound Không tìm thấy kênh được xác định trong yêu cầu.
forbidden (403) channelSuspended Kênh được xác định trong yêu cầu đã bị tạm ngưng.
forbidden (403) cmsUserAccountNotFound Người dùng CMS không được phép thay mặt chủ sở hữu nội dung được chỉ định để thực hiện hành động.
forbidden (403) insufficientCapabilities Người dùng CMS không có đủ quyền.
forbidden (403) insufficientPermissions Mã thông báo OAuth 2.0 được cung cấp cho yêu cầu chỉ định các phạm vi không đủ để truy cập vào dữ liệu được yêu cầu.
notFound (404) contentOwnerAccountNotFound Không tìm thấy tài khoản chủ sở hữu nội dung mà bạn chỉ định.

Request context errors

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) invalidLanguage Giá trị tham số hl không chỉ định mã ngôn ngữ hợp lệ.
badRequest (400) invalidMine Yêu cầu sử dụng tham số mine không được hỗ trợ.
badRequest (400) invalidMine Bạn không thể sử dụng tham số mine trong các yêu cầu mà người dùng đã xác thực là đối tác của YouTube. Bạn nên xoá tham số mine, xác thực với tư cách là người dùng YouTube bằng cách xoá tham số onBehalfOfContentOwner hoặc hành động với tư cách là một trong các kênh của đối tác bằng cách cung cấp tham số onBehalfOfContentOwnerChannel nếu có cho phương thức được gọi.
badRequest (400) invalidPart Tham số part của yêu cầu chỉ định một số phần không thể ghi cùng một lúc.
badRequest (400) invalidRegionCode Tham số regionCode chỉ định một mã khu vực không hợp lệ.
badRequest (400) unexpectedPart Tham số part của yêu cầu chỉ định một giá trị không mong muốn.
badRequest (400) unknownPart Tham số part của yêu cầu chỉ định một giá trị không xác định.
badRequest (400) unsupportedLanguageCode Giá trị tham số hl không chỉ định mã ngôn ngữ được hỗ trợ.
badRequest (400) unsupportedRegionCode Tham số regionCode chỉ định một mã vùng không được hỗ trợ.
unauthorized (401) authorizationRequired Yêu cầu sử dụng tham số mine nhưng không được uỷ quyền đúng cách.
unauthorized (401) youtubeSignupRequired Lỗi này cho biết người dùng có một Tài khoản Google chưa được liên kết, tức là người dùng có Tài khoản Google nhưng không có kênh YouTube. Những người dùng này có thể sử dụng nhiều tính năng phụ thuộc vào việc uỷ quyền của người dùng, chẳng hạn như đánh giá video hoặc thêm video vào danh sách phát watch_later. Tuy nhiên, ví dụ: người dùng cần có kênh YouTube để có thể tải video lên. Người dùng có tài khoản Gmail hoặc thiết bị Android chắc chắn sẽ có Tài khoản Google, nhưng có thể chưa liên kết Tài khoản Google đó với một kênh YouTube.

Lỗi này thường xuất hiện nếu bạn cố gắng sử dụng quy trình Tài khoản dịch vụ OAuth 2.0. YouTube không hỗ trợ Tài khoản dịch vụ và nếu bạn cố gắng xác thực bằng Tài khoản dịch vụ, bạn sẽ gặp lỗi này.

Bài đăng trên blog về API YouTube giới thiệu tính năng hỗ trợ Tài khoản Google cũng thảo luận chi tiết hơn về lỗi youtubeSignupRequired. Mặc dù bài đăng trên blog này giải thích lỗi cho API phiên bản 2.1, nhưng ý nghĩa của lỗi vẫn áp dụng được.

hoạt động

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 activities. Các phương thức này cũng có thể trả về lỗi được liệt kê trong phần Lỗi yêu cầu thường gặp.

activities.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) homeParameterDeprecated Dữ liệu hoạt động trên trang chủ của người dùng không có sẵn thông qua API này. Lỗi này có thể xảy ra nếu bạn đặt tham số home thành true trong một yêu cầu trái phép.
forbidden (403) forbidden Yêu cầu không được uỷ quyền đúng cách.
notFound (404) channelNotFound Không tìm thấy mã nhận dạng kênh được xác định bằng tham số channelId của yêu cầu.
notFound (404) homeChannelNotFound Không tìm thấy nguồn cấp dữ liệu trang chủ YouTube cho người dùng hiện đang được xác thực.
unauthorized (401) authorizationRequired Yêu cầu sử dụng tham số home nhưng không được uỷ quyền đúng cách.

phụ đề

Các bảng sau đây xác định 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 captions. Các phương thức này cũng có thể trả về lỗi được liệt kê trong phần Lỗi yêu cầu thường gặp.

captions.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Các quyền liên kết với yêu cầu không đủ để xoá tệp phụ đề. Yêu cầu có thể chưa được uỷ quyền đúng cách.
notFound (404) captionNotFound Không tìm thấy tệp phụ đề. Kiểm tra giá trị của tham số id trong yêu cầu để đảm bảo rằng giá trị đó chính xác.

captions.download

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Các quyền liên quan đến yêu cầu không đủ để tải tệp phụ đề xuống. Yêu cầu có thể chưa được uỷ quyền đúng cách.
invalidValue (400) couldNotConvert Không thể chuyển đổi dữ liệu tệp phụ đề sang ngôn ngữ và/hoặc định dạng được yêu cầu. Đảm bảo rằng các giá trị tfmt và tlang được yêu cầu là hợp lệ và snippet.status của tệp phụ đề được yêu cầu không phải là failed.
notFound (404) captionNotFound Không tìm thấy tệp phụ đề. Hãy kiểm tra giá trị của tham số id trong yêu cầu để đảm bảo giá trị đó chính xác.

captions.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) contentRequired Yêu cầu không chứa nội dung của tệp phụ đề.
conflict (409) captionExists Video được chỉ định đã có tệp phụ đề có snippet.language và snippet.name đã cho. Một video có thể có nhiều bản âm thanh cho cùng một ngôn ngữ, nhưng mỗi bản âm thanh phải có tên riêng.

Có nhiều cách để giải quyết lỗi này. Bạn có thể xoá bản nhạc hiện có rồi chèn một bản nhạc mới hoặc thay đổi tên của bản nhạc mới trước khi chèn.
forbidden (403) forbidden Các quyền liên kết với yêu cầu không đủ để tải bản phụ đề lên. Yêu cầu có thể chưa được uỷ quyền đúng cách.
invalidValue (400) invalidMetadata Yêu cầu chứa các giá trị siêu dữ liệu không hợp lệ, khiến hệ thống không thể tạo bản nhạc. Xác nhận rằng yêu cầu chỉ định các giá trị hợp lệ cho thuộc tính snippet.language, snippet.name và snippet.videoId. Bạn cũng có thể thêm thuộc tính snippet.isDraft, nhưng đây không phải là thuộc tính bắt buộc.
notFound (404) videoNotFound Không tìm thấy video được xác định bằng tham số videoId.
invalidValue (400) nameTooLong snippet.name được chỉ định trong yêu cầu quá dài. Độ dài tối đa được hỗ trợ là 150 ký tự.

captions.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Không thể truy xuất một hoặc nhiều tệp phụ đề vì các quyền liên quan đến yêu cầu không đủ để truy xuất các tài nguyên được yêu cầu. Yêu cầu có thể chưa được uỷ quyền đúng cách.
notFound (404) captionNotFound Không tìm thấy một hoặc nhiều tệp phụ đề được chỉ định. Lỗi này xảy ra nếu tham số videoId xác định một video thực tế, nhưng tham số id xác định tệp phụ đề không tồn tại hoặc mã theo dõi được liên kết với các video khác. Kiểm tra giá trị của các tham số id và videoId trong yêu cầu để đảm bảo rằng các giá trị đó chính xác.
notFound (404) videoNotFound Không tìm thấy video được xác định bằng tham số videoId.

captions.update

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) contentRequired Yêu cầu không tải tệp phụ đề đã cập nhật lên. Bạn phải cung cấp nội dung thực tế của bản nhạc nếu đặt tham số sync thành true.
forbidden (403) forbidden Các quyền liên kết với yêu cầu không đủ để cập nhật tệp phụ đề. Yêu cầu có thể chưa được uỷ quyền đúng cách.
notFound (404) captionNotFound Không tìm thấy tệp phụ đề được chỉ định. Hãy kiểm tra giá trị của tham số id trong yêu cầu để đảm bảo giá trị đó chính xác.

channelBanners

Các bảng sau đây xác định 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 channelBanners. Các phương thức này cũng có thể trả về lỗi được liệt kê trong phần Lỗi yêu cầu thường gặp.

channelBanners.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) bannerAlbumFull Album Hình ảnh kênh YouTube của bạn có quá nhiều hình ảnh. Vui lòng truy cập vào http://photos.google.com, chuyển đến trang album rồi xoá một số hình ảnh khỏi album đó.
badRequest (400) mediaBodyRequired Yêu cầu không bao gồm nội dung hình ảnh.

channelSections

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 channelSections. Các phương thức này cũng có thể trả về các lỗi được liệt kê trong phần Các lỗi thường gặp trong yêu cầu.

channelSections.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) notEditable Bạn không thể xoá phần kênh này.
forbidden (403) channelSectionForbidden Yêu cầu này không được xác thực đúng cách hoặc không được hỗ trợ cho kênh này.
invalidValue (400) idInvalid Thuộc tính id chỉ định một mã nhận dạng phần kênh không hợp lệ.
invalidValue (400) idRequired Thuộc tính id phải chỉ định một giá trị xác định phần kênh đang bị xoá.
notFound (404) channelNotFound Không tìm thấy kênh.
notFound (404) channelSectionNotFound Không tìm thấy phần kênh mà bạn đang cố cập nhật.

channelSections.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) defaultLanguageNotSetError Bạn phải đặt thuộc tính snippet.defaultLanguage của tài nguyên channelSection để chèn hoặc cập nhật thành công đối tượng localizations cho tài nguyên đó.
badRequest (400) invalidLanguage Một trong các khoá ngôn ngữ của đối tượng localizations không xác thực được. Sử dụng phương thức channelSections.list để truy xuất các giá trị hợp lệ và cập nhật các giá trị đó theo nguyên tắc trong tài liệu về tài nguyên channelSections.
badRequest (400) notEditable Không thể tạo phần này trên kênh.
badRequest (400) styleRequired Tài nguyên channelSection phải chỉ định một giá trị cho trường snippet.style.
badRequest (400) targetInvalidCountry Một trong các giá trị trong danh sách targeting.countries không được xác thực. Sử dụng phương thức channelSections.list để truy xuất các giá trị hợp lệ và cập nhật các giá trị đó theo hướng dẫn trong tài liệu về tài nguyên channelSections.
badRequest (400) targetInvalidLanguage Một trong các giá trị trong danh sách targeting.languages không xác thực được. Sử dụng phương thức channelSections.list để truy xuất các giá trị hợp lệ và cập nhật các giá trị đó theo hướng dẫn trong tài liệu về tài nguyên channelSections.
badRequest (400) targetInvalidRegion Một trong các giá trị trong danh sách targeting.regions không xác thực được. Sử dụng phương thức channelSections.list để truy xuất các giá trị hợp lệ và cập nhật các giá trị đó theo hướng dẫn trong tài liệu về tài nguyên channelSections.
badRequest (400) typeRequired Tài nguyên channelSection phải chỉ định một giá trị cho trường snippet.type.
forbidden (403) channelSectionForbidden Yêu cầu này không được xác thực đúng cách hoặc không được hỗ trợ cho kênh này.
invalidValue (400) channelNotActive Ít nhất một trong các kênh được chỉ định không hoạt động.
invalidValue (400) channelsDuplicated Yêu cầu không thành công vì chỉ định các kênh trùng lặp.
invalidValue (400) channelsNeeded Nếu thuộc tính snippet.type có giá trị là multipleChannels, thì bạn phải chỉ định thuộc tính contentDetails.channels[] và phải chỉ định ít nhất một kênh.
invalidValue (400) channelsNotExpected Tài nguyên được cung cấp cùng với yêu cầu đã chỉ định một giá trị cho thuộc tính contentDetails.channels[], nhưng các kênh không được dự kiến cho loại phần kênh này.
invalidValue (400) contentDetailsNeeded Tài nguyên bạn đang chèn phải chứa đối tượng contentDetails cho loại phần kênh này.
invalidValue (400) inValidPosition Thuộc tính snippet.position chứa một giá trị không hợp lệ.
invalidValue (400) maxChannelSectionExceeded Không thể hoàn tất yêu cầu vì kênh đã có số lượng tối đa các phần trên kênh.
invalidValue (400) maxChannelsExceeded Yêu cầu không thành công vì đã cố gắng thêm quá nhiều kênh vào phần kênh.
invalidValue (400) maxPlaylistExceeded Yêu cầu không thành công vì cố gắng thêm quá nhiều danh sách phát vào phần kênh.
invalidValue (400) onePlaylistNeeded Nếu thuộc tính snippet.type có giá trị là singlePlaylist, thì thuộc tính contentDetails.playlists[] phải chỉ định chính xác một danh sách phát.
invalidValue (400) ownChannelInChannels Bạn không thể thêm kênh của chính mình vào một phần kênh xuất hiện trên kênh đó.
invalidValue (400) playlistIsPrivate Một hoặc nhiều danh sách phát được chỉ định là danh sách phát riêng tư nên không thể đưa vào phần kênh.
invalidValue (400) playlistsDuplicated Yêu cầu không thành công vì có danh sách phát trùng lặp.
invalidValue (400) playlistsNeeded Nếu thuộc tính snippet.type có giá trị là singlePlaylist hoặc multiplePlaylists, thì bạn phải chỉ định thuộc tính contentDetails.playlists[].
invalidValue (400) playlistsNotExpected Tài nguyên được cung cấp cùng với yêu cầu đã chỉ định một giá trị cho thuộc tính contentDetails.playlists[], nhưng danh sách phát không được dự kiến cho loại phần kênh này.
invalidValue (400) snippetNeeded Bạn phải chỉ định một snippet để tạo phần kênh.
invalidValue (400) titleLengthExceeded Giá trị của thuộc tính snippet.title quá dài.
invalidValue (400) titleRequired Nếu thuộc tính snippet.type có giá trị là multiplePlaylists hoặc multipleChannels, thì bạn phải đặt tiêu đề cho phần bằng cách chỉ định một giá trị cho thuộc tính snippet.title.
notFound (404) channelNotFound Không tìm thấy một hoặc nhiều kênh được chỉ định.
notFound (404) playlistNotFound Không tìm thấy ít nhất một danh sách phát được chỉ định.

channelSections.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) channelSectionForbidden Người yêu cầu không được phép truy cập vào các phần kênh được yêu cầu.
invalidValue (400) idInvalid Yêu cầu chỉ định một mã phần kênh không hợp lệ.
invalidValue (400) invalidCriteria Không thể hoàn tất yêu cầu vì tiêu chí lọc không hợp lệ.
notFound (404) channelNotFound Không tìm thấy kênh liên quan đến yêu cầu.
notFound (404) channelSectionNotFound Không tìm thấy phần kênh liên quan đến yêu cầu.

channelSections.update

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) defaultLanguageNotSetError Bạn phải đặt thuộc tính snippet.defaultLanguage của tài nguyên channelSection để chèn hoặc cập nhật thành công đối tượng localizations cho tài nguyên đó.
badRequest (400) invalidLanguage Một trong các khoá ngôn ngữ của đối tượng localizations không xác thực được. Sử dụng phương thức channelSections.list để truy xuất các giá trị hợp lệ và cập nhật các giá trị đó theo hướng dẫn trong tài liệu về tài nguyên channelSections.
badRequest (400) notEditable Bạn không thể chỉnh sửa phần này của kênh.
badRequest (400) styleRequired Tài nguyên channelSection phải chỉ định một giá trị cho trường snippet.style.
badRequest (400) targetInvalidCountry Một trong các giá trị trong danh sách targeting.countries không xác thực được. Sử dụng phương thức channelSections.list để truy xuất các giá trị hợp lệ và cập nhật các giá trị đó theo hướng dẫn trong tài liệu về tài nguyên channelSections.
badRequest (400) targetInvalidLanguage Một trong các giá trị trong danh sách targeting.languages không được xác thực. Sử dụng phương thức channelSections.list để truy xuất các giá trị hợp lệ và cập nhật các giá trị đó theo hướng dẫn trong tài liệu về tài nguyên channelSections.
badRequest (400) targetInvalidRegion Một trong các giá trị trong danh sách targeting.regions không xác thực được. Sử dụng phương thức channelSections.list để truy xuất các giá trị hợp lệ và cập nhật các giá trị đó theo hướng dẫn trong tài liệu về tài nguyên channelSections.
badRequest (400) typeRequired Tài nguyên channelSection phải chỉ định một giá trị cho trường snippet.type.
forbidden (403) channelSectionForbidden Yêu cầu này không được xác thực đúng cách hoặc không được hỗ trợ cho kênh này.
invalidValue (400) channelNotActive Ít nhất một trong các kênh được chỉ định không hoạt động.
invalidValue (400) channelsDuplicated Yêu cầu không thành công vì chỉ định các kênh trùng lặp.
invalidValue (400) channelsNeeded Nếu thuộc tính snippet.type có giá trị là multipleChannels, thì bạn phải chỉ định thuộc tính contentDetails.channels[] và phải chỉ định ít nhất một kênh.
invalidValue (400) channelsNotExpected Tài nguyên được cung cấp cùng với yêu cầu đã chỉ định một giá trị cho thuộc tính contentDetails.channels[], nhưng các kênh không được mong đợi cho loại phần kênh này.
invalidValue (400) contentDetailsNeeded Tài nguyên mà bạn đang cập nhật phải chứa đối tượng contentDetails cho loại phần kênh này.
invalidValue (400) idInvalid Thuộc tính id chỉ định một mã nhận dạng phần kênh không hợp lệ.
invalidValue (400) idRequired Thuộc tính id phải chỉ định một giá trị xác định phần kênh đang được cập nhật.
invalidValue (400) inValidPosition Thuộc tính snippet.position chứa một giá trị không hợp lệ.
invalidValue (400) maxChannelsExceeded Yêu cầu không thành công vì đã cố gắng thêm quá nhiều kênh vào phần kênh.
invalidValue (400) maxPlaylistExceeded Yêu cầu không thành công vì cố gắng thêm quá nhiều danh sách phát vào phần kênh.
invalidValue (400) onePlaylistNeeded Nếu thuộc tính snippet.type có giá trị là singlePlaylist, thì thuộc tính contentDetails.playlists[] phải chỉ định chính xác một danh sách phát.
invalidValue (400) ownChannelInChannels Bạn không thể thêm kênh của chính mình vào một phần kênh xuất hiện trên kênh đó.
invalidValue (400) playlistIsPrivate Một hoặc nhiều danh sách phát được chỉ định là danh sách phát riêng tư nên không thể đưa vào phần kênh.
invalidValue (400) playlistsDuplicated Yêu cầu không thành công vì có danh sách phát trùng lặp.
invalidValue (400) playlistsNeeded Nếu thuộc tính snippet.type có giá trị là singlePlaylist hoặc multiplePlaylists, thì bạn phải chỉ định thuộc tính contentDetails.playlists[].
invalidValue (400) playlistsNotExpected Tài nguyên được cung cấp cùng với yêu cầu đã chỉ định một giá trị cho thuộc tính contentDetails.playlists[], nhưng danh sách phát không được dự kiến cho loại phần kênh này.
invalidValue (400) snippetNeeded Bạn phải chỉ định một snippet để cập nhật phần kênh.
invalidValue (400) titleLengthExceeded Giá trị của thuộc tính snippet.title quá dài.
invalidValue (400) titleRequired Nếu thuộc tính snippet.type có giá trị là multiplePlaylists hoặc multipleChannels, thì bạn phải đặt tiêu đề cho phần bằng cách chỉ định một giá trị cho thuộc tính snippet.title.
notFound (404) channelNotFound Không tìm thấy một hoặc nhiều kênh được chỉ định.
notFound (404) channelSectionNotFound Không tìm thấy phần kênh mà bạn đang cố cập nhật.
notFound (404) playlistNotFound Không tìm thấy một hoặc nhiều danh sách phát được chỉ định.

kênh

Các bảng sau đây xác định 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 channels. Các phương thức này cũng có thể trả về lỗi được liệt kê trong phần Lỗi yêu cầu thường gặp.

channels.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) invalidCriteria Bạn có thể chỉ định tối đa một trong các bộ lọc sau:id, mySubscribers, categoryId, mine, managedByMe, forUsername. Trong trường hợp xác thực chủ sở hữu nội dung bằng tham số onBehalfOfContentOwner, bạn chỉ có thể chỉ định id hoặc managedByMe.
forbidden (403) channelForbidden Kênh được chỉ định bằng tham số id không hỗ trợ yêu cầu hoặc yêu cầu không được uỷ quyền đúng cách.
notFound (404) categoryNotFound Không tìm thấy danh mục được xác định bằng tham số categoryId.
notFound (404) channelNotFound Không tìm thấy kênh được chỉ định trong tham số id.

channels.update

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) brandingValidationError Một trong các giá trị trong đối tượng brandingSettings không xác thực được. Sử dụng phương thức channels.list để truy xuất các chế độ cài đặt hiện có cho kênh và cập nhật các giá trị thuộc tính theo hướng dẫn trong tài liệu về tài nguyên channels.
badRequest (400) channelTitleUpdateForbidden Khi cập nhật brandingSettings part của kênh, bạn phải đặt giá trị của thuộc tính brandingSettings.channel.title thành tiêu đề hiện tại của kênh hoặc bỏ qua thuộc tính này. API sẽ trả về lỗi nếu bạn thay đổi giá trị của thuộc tính.
badRequest (400) defaultLanguageNotSetError Bạn phải đặt defaultLanguage để cập nhật localizations.
badRequest (400) invalidBrandingOption Một trong các chế độ cài đặt thương hiệu mà bạn chỉ định không tồn tại. Hãy sử dụng phương thức channels.list để truy xuất các giá trị hợp lệ và nhớ cập nhật các giá trị đó theo nguyên tắc trong tài liệu về tài nguyên channels.
badRequest (400) invalidCustomMessage Siêu dữ liệu yêu cầu chỉ định một thông báo tuỳ chỉnh không hợp lệ. Hãy kiểm tra giá trị của thuộc tính invideoPromotion.items[].customMessage trong tài nguyên mà yêu cầu đã gửi.
badRequest (400) invalidDuration Siêu dữ liệu của yêu cầu chỉ định thời lượng không hợp lệ trong phần invideoPromotion.
badRequest (400) invalidDuration Siêu dữ liệu yêu cầu chỉ định một loại vị trí không hợp lệ để xác định cách đặt vị trí của mục được quảng bá trong trình phát video. Hãy kiểm tra giá trị của thuộc tính invideoPromotion.position.type trong tài nguyên mà yêu cầu đã gửi.
badRequest (400) invalidRecentlyUploadedBy Siêu dữ liệu của yêu cầu chỉ định một mã nhận dạng kênh không hợp lệ. Kiểm tra giá trị của thuộc tính invideoPromotion.items[].id.recentlyUploadedBy trong tài nguyên mà yêu cầu đã gửi.
badRequest (400) invalidTimingOffset Siêu dữ liệu yêu cầu chỉ định độ lệch thời gian không hợp lệ trong phần invideoPromotion.
badRequest (400) invalidTimingOffset Siêu dữ liệu yêu cầu chỉ định khoảng thời gian bù không hợp lệ để xác định thời điểm mặt hàng được quảng bá sẽ xuất hiện trong trình phát video. Hãy kiểm tra giá trị của thuộc tính invideoPromotion.timing.offsetMs trong tài nguyên mà yêu cầu đã gửi.
badRequest (400) invalidTimingType Siêu dữ liệu yêu cầu chỉ định một phương thức tính thời gian không hợp lệ để xác định thời điểm mục được quảng bá sẽ xuất hiện trong trình phát video. Kiểm tra giá trị của thuộc tính invideoPromotion.timing.type trong tài nguyên mà yêu cầu đã gửi.
badRequest (400) localizationValidationError Một trong các giá trị trong đối tượng bản địa hoá không xác thực được. Hãy sử dụng phương thức channels.list để truy xuất các giá trị hợp lệ và nhớ cập nhật các giá trị đó theo hướng dẫn trong tài liệu về tài nguyên kênh.
badRequest (400) tooManyPromotedItems Đã vượt quá số lượng mục được phép quảng bá trong phần invideoPromotion.
forbidden (403) channelForbidden Kênh được chỉ định trong tham số id không hỗ trợ yêu cầu hoặc yêu cầu không được uỷ quyền đúng cách.
forbidden (403) promotedVideoNotAllowed Không tìm thấy kênh mà yêu cầu API đang cố gắng cập nhật. Kiểm tra giá trị của thuộc tính id trong tài nguyên channel mà yêu cầu đã gửi để đảm bảo rằng mã nhận dạng kênh là chính xác.
forbidden (403) websiteLinkNotAllowed Không được phép sử dụng URL của trang web đã chỉ định.
notFound (404) channelNotFound Không tìm thấy kênh được chỉ định bằng tham số id hoặc kênh đó không có các lựa chọn xây dựng thương hiệu.
notFound (404) channelNotFound Không tìm thấy kênh được chỉ định trong tham số id.
notFound (404) unknownChannelId Không tìm thấy mã nhận dạng kênh được chỉ định.
notFound (404) unknownChannelId Không tìm thấy mã nhận dạng kênh recentlyUploadedBy được chỉ định.
notFound (404) unknownVideoId Không tìm thấy mã video được chỉ định làm mặt hàng được quảng bá.
required (400) requiredItemIdType Siêu dữ liệu của yêu cầu phải chỉ định một loại mục trong phần invideoPromotion.
required (400) requiredItemId Siêu dữ liệu yêu cầu phải chỉ định một mục trong phần invideoPromotion.
required (400) requiredTimingOffset Siêu dữ liệu của yêu cầu phải chỉ định độ lệch thời gian mặc định để YouTube có thể xác định thời điểm hiển thị mặt hàng được quảng bá. Đặt giá trị của thuộc tính invideoPromotion.defaultTiming.offsetMs trong tài nguyên mà yêu cầu gửi.
required (400) requiredTimingOffset Siêu dữ liệu của yêu cầu phải chỉ định độ lệch thời gian để YouTube có thể xác định thời điểm hiển thị mặt hàng được quảng bá. Đặt giá trị của thuộc tính invideoPromotion.timing.offsetMs trong tài nguyên mà yêu cầu gửi.
required (400) requiredTimingType Siêu dữ liệu của yêu cầu phải chỉ định một phương thức tính thời gian để YouTube có thể xác định thời điểm hiển thị mục được quảng bá. Đặt giá trị của thuộc tính invideoPromotion.defaultTiming.type trong tài nguyên mà yêu cầu gửi.
required (400) requiredTimingType Siêu dữ liệu của yêu cầu phải chỉ định một phương thức tính thời gian để YouTube có thể xác định thời điểm hiển thị mục được quảng bá. Đặt giá trị của thuộc tính invideoPromotion.timing.type trong tài nguyên mà yêu cầu gửi.
required (400) requiredTiming Siêu dữ liệu của yêu cầu phải chỉ định thời gian cho từng mục trong phần invideoPromotion.
required (400) requiredVideoId Siêu dữ liệu của yêu cầu phải chỉ định một mã video để xác định mục được quảng bá.
required (400) requiredWebsiteUrl Siêu dữ liệu yêu cầu phải chỉ định một URL của trang web trong phần invideoPromotion. Đặt giá trị của thuộc tính invideoPromotion.items[].id.websiteUrl trong tài nguyên mà yêu cầu gửi.

commentThreads

Các bảng sau đây xác định 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 commentThreads. Các phương thức này cũng có thể trả về lỗi được liệt kê trong phần Lỗi yêu cầu thường gặp.

commentThreads.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) operationNotSupported Yêu cầu API không hợp lệ hoặc có định dạng không chính xác. Do đó, máy chủ API không thể hiểu được yêu cầu.
badRequest (400) processingFailure Máy chủ API không xử lý thành công yêu cầu. Mặc dù đây có thể là lỗi tạm thời, nhưng thường cho biết thông tin đầu vào của yêu cầu không hợp lệ. Kiểm tra cấu trúc của tài nguyên commentThread trong nội dung yêu cầu để đảm bảo rằng cấu trúc đó hợp lệ.
forbidden (403) commentsDisabled Video được xác định bằng tham số videoId đã tắt tính năng bình luận.
forbidden (403) forbidden Không thể truy xuất một hoặc nhiều chuỗi bình luận được yêu cầu do không có đủ quyền. Yêu cầu có thể chưa được uỷ quyền đúng cách.
notFound (404) channelNotFound Không tìm thấy kênh được xác định bằng tham số allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound Không tìm thấy một hoặc nhiều chuỗi bình luận được chỉ định. Kiểm tra các giá trị của tham số id trong yêu cầu để đảm bảo rằng tham số này là chính xác.
notFound (404) videoNotFound Không tìm thấy video được xác định bằng tham số videoId.

commentThreads.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) channelOrVideoIdMissing Mỗi chuỗi nhận xét phải được liên kết với một kênh hoặc video. Hãy đảm bảo tài nguyên chỉ định giá trị cho cả hai thuộc tính snippet.channelId và snippet.videoId. Bình luận về một video sẽ xuất hiện trên trang xem video.
badRequest (400) commentTextRequired Tài nguyên comment đang được chèn phải chỉ định một giá trị cho thuộc tính snippet.topLevelComment.snippet.textOriginal. Không được để trống phần bình luận.
badRequest (400) commentTextTooLong Tài nguyên comment đang được chèn chứa quá nhiều ký tự trong thuộc tính snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Siêu dữ liệu của yêu cầu không hợp lệ.
badRequest (400) processingFailure Máy chủ API không xử lý được yêu cầu. Mặc dù đây có thể là lỗi tạm thời, nhưng thường cho biết đầu vào của yêu cầu không hợp lệ. Kiểm tra cấu trúc của tài nguyên commentThread trong nội dung yêu cầu để đảm bảo rằng cấu trúc đó hợp lệ.
forbidden (403) forbidden Không thể tạo chuỗi nhận xét do không có đủ quyền. Yêu cầu có thể chưa được uỷ quyền đúng cách.
forbidden (403) ineligibleAccount Tài khoản YouTube dùng để uỷ quyền cho yêu cầu API phải được hợp nhất với Tài khoản Google của người dùng để chèn bình luận hoặc chuỗi nhận xét.
notFound (404) channelNotFound Không tìm thấy kênh được chỉ định. Kiểm tra giá trị của thuộc tính snippet.channelId để đảm bảo giá trị đó chính xác.
notFound (404) videoNotFound Không tìm thấy video được chỉ định. Kiểm tra giá trị của thuộc tính snippet.videoId để đảm bảo giá trị đó chính xác.

comments

Các bảng sau đây xác định 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 comments. Các phương thức này cũng có thể trả về lỗi được liệt kê trong phần Lỗi yêu cầu thường gặp.

comments.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) operationNotSupported Yêu cầu API không hợp lệ hoặc có định dạng không chính xác. Do đó, máy chủ API không thể hiểu được yêu cầu.
forbidden (403) forbidden Không thể truy xuất một hoặc nhiều bình luận được yêu cầu do không có đủ quyền. Yêu cầu có thể chưa được uỷ quyền đúng cách.
notFound (404) commentNotFound Không tìm thấy một hoặc nhiều bình luận được chỉ định. Hãy kiểm tra giá trị của các tham số id và parentId trong yêu cầu để đảm bảo rằng các giá trị đó là chính xác.

comments.setModerationStatus

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) banWithoutReject Bạn chỉ có thể sử dụng tham số banAuthor nếu giá trị tham số moderationStatus là rejected.
badRequest (400) operationNotSupported Yêu cầu API không hợp lệ hoặc có định dạng không chính xác. Do đó, máy chủ API không thể hiểu được yêu cầu.
badRequest (400) processingFailure Máy chủ API không xử lý được yêu cầu. Mặc dù đây có thể là lỗi tạm thời, nhưng thường cho biết thông tin đầu vào của yêu cầu không hợp lệ.
forbidden (403) forbidden Không thể đặt trạng thái kiểm duyệt của một hoặc nhiều bình luận do không có đủ quyền. Yêu cầu có thể chưa được uỷ quyền đúng cách.
notFound (404) commentNotFound Không tìm thấy một hoặc nhiều nhận xét mà yêu cầu đang cố gắng cập nhật. Kiểm tra các giá trị của tham số id trong yêu cầu để đảm bảo rằng các giá trị đó chính xác.

comments.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) commentTextRequired Tài nguyên comment đang được chèn phải chỉ định một giá trị cho thuộc tính snippet.textOriginal. Không được để trống phần bình luận.
badRequest (400) commentTextTooLong Tài nguyên comment đang được chèn chứa quá nhiều ký tự trong thuộc tính snippet.textOriginal.
badRequest (400) invalidCommentMetadata Siêu dữ liệu yêu cầu không hợp lệ.
badRequest (400) operationNotSupported Người dùng API không thể chèn một bình luận để trả lời bình luận cấp cao nhất được xác định bằng thuộc tính snippet.parentId. Trong tài nguyên commentThread, thuộc tính snippet.canReply cho biết liệu người xem hiện tại có thể trả lời chuỗi bình luận hay không.
badRequest (400) parentCommentIsPrivate Bình luận gốc được chỉ định là bình luận riêng tư. API không hỗ trợ việc trả lời nhận xét riêng tư.
badRequest (400) parentIdMissing Bình luận đang được chèn phải được liên kết với một bình luận gốc. Tuy nhiên, tài nguyên comment trong nội dung của yêu cầu API không chỉ định giá trị cho thuộc tính snippet.parentId.
badRequest (400) processingFailure Máy chủ API không xử lý thành công yêu cầu. Mặc dù đây có thể là lỗi tạm thời, nhưng thường cho biết đầu vào của yêu cầu không hợp lệ. Kiểm tra cấu trúc của tài nguyên comment trong nội dung yêu cầu để đảm bảo rằng cấu trúc đó hợp lệ.
forbidden (403) forbidden Không thể tạo bình luận do không có đủ quyền. Yêu cầu có thể chưa được uỷ quyền đúng cách.
forbidden (403) ineligibleAccount Tài khoản YouTube dùng để uỷ quyền cho yêu cầu API phải được hợp nhất với Tài khoản Google của người dùng để chèn bình luận hoặc chuỗi nhận xét.
notFound (404) parentCommentNotFound Không tìm thấy bình luận gốc được chỉ định. Kiểm tra giá trị của thuộc tính snippet.parentId trong nội dung yêu cầu để đảm bảo rằng giá trị đó là chính xác.

comments.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) processingFailure Máy chủ API không xử lý được yêu cầu. Mặc dù đây có thể là lỗi tạm thời, nhưng thường cho biết thông tin đầu vào của yêu cầu không hợp lệ.
forbidden (403) forbidden Không xoá được bình luận này do không có đủ quyền. Yêu cầu có thể chưa được uỷ quyền đúng cách.
notFound (404) commentNotFound Không tìm thấy bình luận được chỉ định. Hãy kiểm tra giá trị của tham số id trong yêu cầu để đảm bảo giá trị đó chính xác.

comments.update

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) commentTextTooLong Tài nguyên comment đang được cập nhật chứa quá nhiều ký tự trong thuộc tính snippet.textOriginal.
badRequest (400) invalidCommentMetadata Siêu dữ liệu của yêu cầu không hợp lệ.
badRequest (400) operationNotSupported Yêu cầu API không hợp lệ hoặc có định dạng không chính xác. Do đó, máy chủ API không thể hiểu được yêu cầu.
badRequest (400) processingFailure Máy chủ API không xử lý thành công yêu cầu. Mặc dù đây có thể là lỗi tạm thời, nhưng thường cho biết đầu vào của yêu cầu không hợp lệ. Kiểm tra cấu trúc của tài nguyên comment trong nội dung yêu cầu để đảm bảo rằng cấu trúc đó hợp lệ.
forbidden (403) forbidden Không cập nhật được bình luận do không có đủ quyền. Yêu cầu có thể chưa được uỷ quyền đúng cách.
forbidden (403) ineligibleAccount Tài khoản YouTube dùng để uỷ quyền cho Yêu cầu API phải được hợp nhất với Tài khoản Google của người dùng để cập nhật bình luận hoặc chuỗi nhận xét.
notFound (404) commentNotFound Không tìm thấy bình luận được chỉ định. Kiểm tra giá trị của thuộc tính id trong nội dung yêu cầu để đảm bảo rằng giá trị đó là chính xác.

thành viên

Các bảng sau đây xác định 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 members. Các phương thức này cũng có thể trả về các lỗi được liệt kê trong phần Các lỗi thường gặp trong yêu cầu.

members.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) channelMembershipsNotEnabled Kênh của nhà sáng tạo uỷ quyền cho yêu cầu này chưa bật tính năng hội viên của kênh.
badRequest (400) invalidMode Giá trị tham số mode không hợp lệ. Lỗi này có thể xảy ra nếu tham số pageToken chỉ định một mã thông báo được truy xuất bằng một chế độ khác với chế độ được chỉ định.
badRequest (400) invalidPageToken Giá trị tham số pageToken không hợp lệ. Lỗi này xảy ra nếu mã thông báo trang được dùng trong yêu cầu đã hết hạn.
badRequest (400) invalidHasAccessToLevel Giá trị tham số hasAccessToLevel không hợp lệ. Không có cấp độ nào có id đã chỉ định.
badRequest (400) invalidFilterByMemberChannelId Giá trị tham số filterByMemberChannelId không hợp lệ. Lỗi này xảy ra nếu giá trị tham số filterByMemberChannelId chỉ định hơn 100 kênh.

membershipsLevels

Các bảng sau đây xác định 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 members. Các phương thức này cũng có thể trả về lỗi được liệt kê trong phần Lỗi yêu cầu thường gặp.

membershipsLevels.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) channelMembershipsNotEnabled Kênh của nhà sáng tạo uỷ quyền cho yêu cầu này chưa bật tính năng hội viên của kênh.

playlistItems

Các bảng sau đây xác định 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 playlistItems. Các phương thức này cũng có thể trả về lỗi được liệt kê trong phần Lỗi yêu cầu thường gặp.

playlistItems.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) playlistItemsNotAccessible Yêu cầu không được uỷ quyền đúng cách để xoá mục danh sách phát đã chỉ định.
notFound (404) playlistItemNotFound Không tìm thấy mục trong danh sách phát được xác định bằng tham số id của yêu cầu.
invalidValue (400) playlistOperationUnsupported API không hỗ trợ tính năng xoá video khỏi danh sách phát đã chỉ định. Ví dụ: bạn không thể xoá video khỏi danh sách phát video đã tải lên.

playlistItems.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
duplicate videoAlreadyInPlaylist Video mà bạn đang cố thêm vào danh sách phát đã có trong danh sách phát đó.
forbidden (403) playlistContainsMaximumNumberOfVideos Danh sách phát đã có số lượng mục tối đa được phép.
forbidden (403) playlistItemsNotAccessible Yêu cầu không được uỷ quyền đúng cách để chèn mục trong danh sách phát đã chỉ định.
invalidValue (400) invalidContentDetails Thuộc tính contentDetails trong yêu cầu không hợp lệ. Một lý do có thể là trường contentDetails.note dài hơn 280 ký tự.
invalidValue (400) invalidPlaylistItemPosition Yêu cầu cố gắng đặt vị trí của mục trong danh sách phát thành một giá trị không hợp lệ hoặc không được hỗ trợ. Kiểm tra giá trị của thuộc tính position trong snippet của tài nguyên.
invalidValue (400) invalidResourceType type được chỉ định cho mã tài nguyên không được hỗ trợ cho thao tác này. Mã nhận dạng tài nguyên xác định mục được thêm vào danh sách phát, chẳng hạn như youtube#video.
invalidValue (400) manualSortRequired Yêu cầu cố gắng đặt vị trí của mục trong danh sách phát, nhưng danh sách phát không sử dụng tính năng sắp xếp thủ công. (Ví dụ: các mục trong danh sách phát có thể được sắp xếp theo ngày hoặc mức độ phổ biến.) Bạn có thể khắc phục lỗi này bằng cách xoá phần tử snippet.position khỏi tài nguyên mà yêu cầu đang chèn. Nếu muốn mục trong danh sách phát có một vị trí cụ thể trong danh sách, trước tiên, bạn cần cập nhật lựa chọn Sắp xếp của danh sách phát thành Thủ công trong phần cài đặt của danh sách phát. Bạn có thể điều chỉnh chế độ cài đặt này trong Trình quản lý video của YouTube.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist Video mà bạn đang cố gắng thêm vào danh sách phát theo bộ đã có trong một danh sách phát theo bộ khác.
invalidValue (400) playlistOperationUnsupported API không hỗ trợ khả năng chèn video vào danh sách phát được chỉ định. Ví dụ: Bạn không thể chèn video vào danh sách phát video đã tải lên.
notFound (404) playlistNotFound Không tìm thấy danh sách phát được xác định bằng tham số playlistId của yêu cầu.
notFound (404) videoNotFound Không tìm thấy video mà bạn đang cố gắng thêm vào danh sách phát. Kiểm tra giá trị của thuộc tính videoId để đảm bảo rằng giá trị đó là chính xác.
required (400) channelIdRequired Yêu cầu không chỉ định giá trị cho thuộc tính channelId bắt buộc.
required (400) playlistIdRequired Yêu cầu không chỉ định giá trị cho thuộc tính playlistId bắt buộc.
required (400) resourceIdRequired Yêu cầu phải chứa một tài nguyên, trong đó đối tượng snippet chỉ định một resourceId.

playlistItems.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) playlistItemsNotAccessible Yêu cầu không được uỷ quyền đúng cách để truy xuất danh sách phát đã chỉ định.
notFound (404) playlistNotFound Không tìm thấy danh sách phát được xác định bằng tham số playlistId của yêu cầu.
notFound (404) videoNotFound Không tìm thấy video được xác định bằng tham số videoId của yêu cầu.
required (400) playlistIdRequired Yêu cầu đăng ký không chỉ định giá trị cho thuộc tính playlistId bắt buộc.
invalidValue (400) playlistOperationUnsupported API không hỗ trợ tính năng liệt kê video trong danh sách phát được chỉ định. Ví dụ: bạn không thể thêm video vào danh sách phát xem sau.

playlistItems.update

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) playlistItemsNotAccessible Yêu cầu không được uỷ quyền đúng cách để cập nhật mục danh sách phát đã chỉ định.
invalidValue (400) invalidPlaylistItemPosition Yêu cầu này cố gắng đặt vị trí của mục trong danh sách phát thành một giá trị không hợp lệ hoặc không được hỗ trợ. Kiểm tra giá trị của thuộc tính position trong snippet của tài nguyên.
invalidValue (400) invalidResourceType type được chỉ định cho mã tài nguyên không được hỗ trợ cho thao tác này. Mã nhận dạng tài nguyên xác định mục được thêm vào danh sách phát, chẳng hạn như youtube#video.
invalidValue (400) invalidSnippet Yêu cầu không chỉ định một thuộc tính snippet hợp lệ.
invalidValue (400) manualSortRequired Yêu cầu cố gắng đặt vị trí của mục trong danh sách phát, nhưng danh sách phát không sử dụng tính năng sắp xếp thủ công. (Ví dụ: các mục trong danh sách phát có thể được sắp xếp theo ngày hoặc mức độ phổ biến.) Bạn có thể giải quyết lỗi này bằng cách xoá phần tử snippet.position khỏi tài nguyên mà yêu cầu đang chèn. Nếu muốn mục trong danh sách phát có một vị trí cụ thể trong danh sách, trước tiên, bạn cần cập nhật lựa chọn Sắp xếp của danh sách phát thành Thủ công trong phần cài đặt của danh sách phát. Bạn có thể điều chỉnh chế độ cài đặt này trong Trình quản lý video của YouTube.
invalidValue (400) playlistOperationUnsupported API không hỗ trợ khả năng cập nhật video trong danh sách phát đã chỉ định. Ví dụ: bạn không thể cập nhật video trong danh sách phát video đã tải lên.
notFound (404) playlistItemNotFound Không tìm thấy mục trong danh sách phát được xác định bằng thuộc tính id của yêu cầu.
notFound (404) playlistNotFound Không tìm thấy danh sách phát được xác định bằng tham số playlistId của yêu cầu.
required (400) channelIdRequired Yêu cầu không chỉ định giá trị cho thuộc tính channelId bắt buộc.
required (400) playlistIdRequired Yêu cầu không chỉ định giá trị cho thuộc tính playlistId bắt buộc.
required (400) playlistItemIdRequired Tài nguyên mục trong danh sách phát được chỉ định trong yêu cầu phải sử dụng thuộc tính id để xác định mục trong danh sách phát đang được cập nhật.

danh sách phát

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 playlists. Các phương thức này cũng có thể trả về các lỗi được liệt kê trong phần Các lỗi thường gặp trong yêu cầu.

playlists.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) playlistForbidden Thao tác này bị cấm hoặc yêu cầu không được uỷ quyền đúng cách.
notFound (404) playlistNotFound Không tìm thấy danh sách phát được xác định bằng tham số id của yêu cầu.
invalidValue (400) playlistOperationUnsupported API không hỗ trợ khả năng xoá danh sách phát đã chỉ định. Ví dụ: Bạn không thể xoá danh sách phát video đã tải lên.

playlists.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) channelClosed Kênh được chỉ định trong tham số channelId đã bị đóng.
forbidden (403) channelSuspended Kênh được chỉ định trong tham số channelId đã bị tạm ngưng.
forbidden (403) playlistForbidden Danh sách phát được xác định bằng tham số id của yêu cầu không hỗ trợ yêu cầu hoặc yêu cầu không được uỷ quyền đúng cách.
notFound (404) channelNotFound Không tìm thấy kênh được chỉ định trong tham số channelId.
notFound (404) playlistNotFound Không tìm thấy danh sách phát được xác định bằng tham số id của yêu cầu.
invalidValue (400) playlistOperationUnsupported API không hỗ trợ khả năng liệt kê danh sách phát đã chỉ định. Ví dụ: bạn không thể liệt kê danh sách phát xem sau.

playlists.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) defaultLanguageNotSetError Bạn phải đặt defaultLanguage để cập nhật localizations.
badRequest (400) localizationValidationError Một trong các giá trị trong đối tượng bản địa hoá không xác thực được. Sử dụng phương thức playlists.list để truy xuất các giá trị hợp lệ và nhớ cập nhật các giá trị đó theo nguyên tắc trong tài liệu về tài nguyên danh sách phát.
badRequest (400) maxPlaylistExceeded Không thể tạo danh sách phát vì kênh đã có số lượng danh sách phát tối đa được cho phép.
forbidden (403) playlistForbidden Thao tác này bị cấm hoặc yêu cầu không được uỷ quyền đúng cách.
invalidValue (400) invalidPlaylistSnippet Yêu cầu cung cấp một đoạn mã danh sách phát không hợp lệ.
required (400) playlistTitleRequired Yêu cầu phải chỉ định tên danh sách phát.

playlists.update

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) defaultLanguageNotSetError Bạn phải đặt defaultLanguage để cập nhật localizations.
badRequest (400) localizationValidationError Một trong các giá trị trong đối tượng bản địa hoá không xác thực được. Hãy sử dụng phương thức playlists.list để truy xuất các giá trị hợp lệ và nhớ cập nhật các giá trị đó theo hướng dẫn trong tài liệu về tài nguyên danh sách phát.
forbidden (403) playlistForbidden Thao tác này bị cấm hoặc yêu cầu không được uỷ quyền đúng cách.
invalidValue (400) invalidPlaylistSnippet Yêu cầu cung cấp một đoạn danh sách phát không hợp lệ.
invalidValue (400) playlistOperationUnsupported API không hỗ trợ khả năng cập nhật danh sách phát đã chỉ định. Ví dụ: bạn không thể cập nhật các thuộc tính của danh sách phát video mà bạn đã tải lên.
notFound (404) playlistNotFound Không tìm thấy danh sách phát được xác định bằng tham số id của yêu cầu.
required (400) playlistTitleRequired Yêu cầu phải chỉ định tên danh sách phát.

lượt đăng ký

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 subscriptions. Các phương thức này cũng có thể trả về các lỗi được liệt kê trong phần Các lỗi thường gặp trong yêu cầu.

subscriptions.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) subscriptionForbidden Yêu cầu không được xác thực đúng cách hoặc không được hỗ trợ cho kênh này.
notFound (404) subscriptionNotFound Không tìm thấy gói thuê bao mà bạn đang cố gắng xoá. Kiểm tra giá trị của tham số id trong yêu cầu để đảm bảo rằng giá trị đó chính xác.

subscriptions.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) subscriptionDuplicate Gói thuê bao mà bạn đang cố gắng tạo đã tồn tại.
badRequest (400) subscriptionForbidden Bạn đã đạt đến số lượng kênh đăng ký tối đa.
badRequest (400) subscriptionForbidden Có quá nhiều đăng ký gần đây. Vui lòng thử lại sau một vài giờ.
badRequest (400) subscriptionForbidden Bạn không thể đăng ký kênh của chính mình.
forbidden (403) subscriptionForbidden Yêu cầu không được xác thực đúng cách hoặc không được hỗ trợ cho kênh này.
notFound (404) publisherNotFound Không tìm thấy tài nguyên được chỉ định trong thuộc tính snippet.resourceId của yêu cầu.
notFound (404) subscriberNotFound Không tìm thấy người đăng ký được xác định trong yêu cầu.
required (400) publisherRequired Tài nguyên gói thuê bao được chỉ định trong yêu cầu phải sử dụng thuộc tính snippet.resourceId để xác định kênh mà người dùng đang đăng ký.

subscriptions.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) accountClosed Không thể truy xuất gói thuê bao vì tài khoản của người đăng ký đã bị đóng.
forbidden (403) accountSuspended Không thể truy xuất thông tin về các kênh mà người dùng đã đăng ký vì tài khoản của người đăng ký đã bị tạm ngưng.
forbidden (403) subscriptionForbidden Người yêu cầu không được phép truy cập vào các gói thuê bao được yêu cầu.
notFound (404) subscriberNotFound Không tìm thấy người đăng ký được xác định trong yêu cầu.

hình thu nhỏ

Các bảng sau đây xác định 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 thumbnails. Các phương thức này cũng có thể trả về lỗi được liệt kê trong phần Lỗi yêu cầu thường gặp.

thumbnails.set

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) invalidImage Nội dung hình ảnh bạn cung cấp không hợp lệ.
badRequest (400) mediaBodyRequired Yêu cầu không bao gồm nội dung hình ảnh.
forbidden (403) forbidden Không thể đặt hình thu nhỏ cho video đã chỉ định. Yêu cầu có thể chưa được uỷ quyền đúng cách.
forbidden (403) forbidden Người dùng đã xác thực không có quyền tải lên và đặt hình thu nhỏ video tùy chỉnh.
notFound (404) videoNotFound Không tìm thấy video mà bạn đang cố gắng chèn hình thu nhỏ. Kiểm tra giá trị của tham số videoId trong yêu cầu để đảm bảo rằng giá trị đó chính xác.
tooManyRequests (429) uploadRateLimitExceeded Gần đây, kênh đã tải lên quá nhiều hình thu nhỏ. Vui lòng thử lại yêu cầu sau.

videoAbuseReportReasons

Các bảng sau đây xác định 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 videoAbuseReportReasons. Các phương thức này cũng có thể trả về các lỗi được liệt kê trong phần Các lỗi thường gặp trong yêu cầu.

videoAbuseReportReasons.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Bị cấm truy cập. Yêu cầu có thể chưa được uỷ quyền đúng cách.

videoCategories

Các bảng sau đây xác định 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 videoCategories. Các phương thức này cũng có thể trả về lỗi được liệt kê trong phần Lỗi yêu cầu thường gặp.

videoCategories.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
notFound (404) videoCategoryNotFound Không tìm thấy danh mục video được xác định bằng tham số id. Sử dụng phương thức videoCategories.list để truy xuất danh sách các giá trị hợp lệ.

video

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 videos. Các phương thức này cũng có thể trả về lỗi được liệt kê trong phần Lỗi yêu cầu thường gặp.

videos.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) defaultLanguageNotSet Yêu cầu này đang cố gắng thêm thông tin chi tiết đã bản địa hoá của video mà không chỉ định ngôn ngữ mặc định của thông tin chi tiết của video.
badRequest (400) invalidCategoryId Thuộc tính snippet.categoryId chỉ định một mã danh mục không hợp lệ. Sử dụng phương thức videoCategories.list để truy xuất các danh mục được hỗ trợ.
badRequest (400) invalidDescription Siêu dữ liệu yêu cầu chỉ định nội dung mô tả video không hợp lệ.
badRequest (400) invalidFilename Tên tệp video được chỉ định trong tiêu đề Slug không hợp lệ.
badRequest (400) invalidPublishAt Siêu dữ liệu yêu cầu chỉ định thời gian xuất bản theo lịch không hợp lệ.
badRequest (400) invalidRecordingDetails Đối tượng recordingDetails trong siêu dữ liệu yêu cầu chỉ định thông tin ghi hình không hợp lệ.
badRequest (400) invalidTags Siêu dữ liệu của yêu cầu chỉ định từ khoá video không hợp lệ.
badRequest (400) invalidTitle Siêu dữ liệu của yêu cầu chỉ định một tiêu đề video không hợp lệ hoặc trống.
badRequest (400) invalidVideoGameRating Siêu dữ liệu yêu cầu chỉ định một mức phân loại trò chơi điện tử không hợp lệ.
badRequest (400) invalidVideoMetadata Siêu dữ liệu yêu cầu không hợp lệ. Lỗi này xảy ra nếu yêu cầu cập nhật phần snippet của tài nguyên video nhưng không đặt giá trị cho cả thuộc tính snippet.title và snippet.categoryId.
badRequest (400) mediaBodyRequired Yêu cầu không bao gồm nội dung video.
badRequest (400) uploadLimitExceeded Kênh đã đạt đến giới hạn tải video lên hằng ngày. Đây là một quy định hạn chế của nền tảng YouTube và hoàn toàn tách biệt với hạn mức API của dự án trên đám mây Google Cloud.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting Yêu cầu này tìm cách đặt một giấy phép không hợp lệ cho video.
forbidden (403) forbiddenPrivacySetting Yêu cầu này cố gắng đặt một chế độ cài đặt quyền riêng tư không hợp lệ cho video.

videos.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) videoChartNotFound Bảng xếp hạng video được yêu cầu không được hỗ trợ hoặc không có sẵn.
forbidden (403) forbidden Yêu cầu này không được uỷ quyền đúng cách để truy cập vào tệp video hoặc thông tin xử lý. Chỉ chủ sở hữu video mới có thể xem các phần fileDetails, processingDetails và suggestions.
forbidden (403) forbidden Yêu cầu không thể truy cập vào thông tin về điểm xếp hạng từ người dùng. Lỗi này có thể xảy ra vì yêu cầu không được uỷ quyền đúng cách để sử dụng tham số myRating.
notFound (404) videoNotFound Không tìm thấy video mà bạn đang cố gắng truy xuất. Hãy kiểm tra giá trị của tham số id trong yêu cầu để đảm bảo giá trị đó chính xác.

videos.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Không thể xoá video mà bạn đang cố xoá. Yêu cầu có thể chưa được uỷ quyền đúng cách.
notFound (404) videoNotFound Không tìm thấy video mà bạn đang cố xoá. Hãy kiểm tra giá trị của tham số id trong yêu cầu để đảm bảo giá trị đó chính xác.

videos.update

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) defaultLanguageNotSet Yêu cầu API đang cố gắng thêm thông tin chi tiết đã bản địa hoá của video mà không chỉ định ngôn ngữ mặc định của thông tin chi tiết về video.
badRequest (400) invalidCategoryId Thuộc tính snippet.categoryId chỉ định một mã danh mục không hợp lệ. Sử dụng phương thức videoCategories.list để truy xuất các danh mục được hỗ trợ.
badRequest (400) invalidDefaultBroadcastPrivacySetting Yêu cầu này cố gắng đặt một chế độ cài đặt quyền riêng tư không hợp lệ cho chương trình phát sóng mặc định.
badRequest (400) invalidDescription Siêu dữ liệu yêu cầu chỉ định nội dung mô tả video không hợp lệ.
badRequest (400) invalidPublishAt Siêu dữ liệu yêu cầu chỉ định thời gian xuất bản theo lịch không hợp lệ.
badRequest (400) invalidRecordingDetails Đối tượng recordingDetails trong siêu dữ liệu yêu cầu chỉ định thông tin ghi hình không hợp lệ.
badRequest (400) invalidTags Siêu dữ liệu của yêu cầu chỉ định từ khoá video không hợp lệ.
badRequest (400) invalidTitle Siêu dữ liệu của yêu cầu chỉ định một tiêu đề video không hợp lệ hoặc trống.
badRequest (400) invalidVideoMetadata Siêu dữ liệu của yêu cầu không hợp lệ. Lỗi này xảy ra nếu yêu cầu cập nhật phần snippet của tài nguyên video nhưng không đặt giá trị cho cả thuộc tính snippet.title và snippet.categoryId.
forbidden (403) forbidden Bị cấm truy cập. Yêu cầu có thể chưa được uỷ quyền đúng cách.
forbidden (403) forbiddenEmbedSetting Yêu cầu này cố gắng đặt một chế độ cài đặt nhúng không hợp lệ cho video. Một số kênh có thể không được phép cung cấp trình phát nhúng cho sự kiện phát trực tiếp. Hãy truy cập vào Trung tâm trợ giúp của YouTube để biết thêm thông tin.
forbidden (403) forbiddenLicenseSetting Yêu cầu này tìm cách đặt một giấy phép không hợp lệ cho video.
forbidden (403) forbiddenPrivacySetting Yêu cầu này cố gắng đặt một chế độ cài đặt quyền riêng tư không hợp lệ cho video.
notFound (404) videoNotFound Không tìm thấy video mà bạn đang cố cập nhật. Hãy kiểm tra giá trị của trường id trong nội dung yêu cầu để đảm bảo giá trị đó chính xác.

videos.rate

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) emailNotVerified Người dùng phải xác minh địa chỉ email của mình trước khi đánh giá.
badRequest (400) invalidRating Yêu cầu chứa một giá trị không mong muốn cho tham số rating.
badRequest (400) videoPurchaseRequired Chỉ những người dùng đã thuê video mới có thể đánh giá video thuê.
forbidden (403) forbidden Không thể đánh giá video mà bạn đang cố gắng đánh giá. Yêu cầu có thể chưa được uỷ quyền đúng cách.
forbidden (403) videoRatingDisabled Chủ sở hữu của video mà bạn đang cố gắng đánh giá đã tắt tính năng đánh giá cho video đó.
notFound (404) videoNotFound Không tìm thấy video mà bạn đang cố gắng đánh giá. Hãy kiểm tra giá trị của tham số id trong yêu cầu để đảm bảo giá trị đó chính xác.

videos.reportAbuse

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) invalidAbuseReason Yêu cầu chứa một giá trị không mong muốn cho trường reason_id hoặc tổ hợp các trường reason_id và secondary_reason_id.
badRequest (400) rateLimitExceeded Người dùng đã gửi quá nhiều yêu cầu trong một khung thời gian nhất định.
forbidden (403) forbidden
notFound (404) videoNotFound Không tìm thấy video mà bạn muốn báo cáo vi phạm.

hình mờ

Các bảng sau đây xác định 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 watermarks. Các phương thức này cũng có thể trả về các lỗi được liệt kê trong phần Các lỗi thường gặp trong yêu cầu.

watermarks.set

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) imageFormatUnsupported Hình ảnh bạn cung cấp có định dạng không được hỗ trợ.
badRequest (400) imageTooTall Hình ảnh bạn cung cấp quá cao.
badRequest (400) imageTooWide Hình ảnh bạn cung cấp quá rộng.
badRequest (400) mediaBodyRequired Yêu cầu không bao gồm nội dung hình ảnh.
forbidden (403) forbidden Không thể đặt hình mờ cho kênh được chỉ định. Yêu cầu có thể chưa được uỷ quyền đúng cách hoặc tham số channelId được đặt thành một giá trị không hợp lệ.

watermarks.unset

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Không thể huỷ đặt hình mờ cho kênh đã chỉ định. Yêu cầu có thể chưa được uỷ quyền đúng cách hoặc tham số channelId được đặt thành một giá trị không hợp lệ.