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 cho 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 này 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ể sử 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ã 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 đã 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 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 Google đó.
forbidden (403) authenticatedUserAccountSuspended Tài khoản YouTube của người dùng được xác thực bị tạm ngưng. Trong trường hợp người dùng đã xác thực đang 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 Google đó.
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 đến một kênh, nhưng không thực hiện. 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 hành động thay mặt cho chủ sở hữu nội dung được chỉ định.
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 này 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 được 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 YouTube. Bạn nên xoá thông số mine, xác thực dưới dạng người dùng YouTube bằng cách xoá thông số onBehalfOfContentOwner hoặc đóng vai trò là một trong các kênh của đối tác bằng cách cung cấp thông 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ã vùng 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 thông 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 như vậy có thể sử dụng nhiều tính năng phụ thuộc vào việc người dùng cho phép, chẳng hạn như xếp hạng 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 xảy ra 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ụ. Nếu 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 giải thích lỗi cho API phiên bản 2.1, nhưng ý nghĩa của lỗi này vẫn áp dụng.

hoạt động

YouTube đã ngừng sử dụng tính năng thông báo của kênh. Phương thức activities.insert không còn được hỗ trợ nữa.

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 activities. 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 về yêu cầu.

activities.list

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) homeParameterDeprecated API này không cung cấp dữ liệu hoạt động trên trang chủ của người dùng. 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 chưa đượ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 đã xác thực hiện tại.
unauthorized (401) authorizationRequired Yêu cầu sử dụng thông 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ề các lỗi được liệt kê trong phần Các lỗi thường gặp về yêu cầu.

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 này không đủ để xoá bản lồng tiếng. Yêu cầu có thể chưa được uỷ quyền đúng cách.
notFound (404) captionNotFound Không tìm thấy bản phụ đề. Kiểm tra giá trị của tham số id của yêu cầu để đảm bảo 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 này không đủ để tải bản lồng tiếng 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 của kênh 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 kênh phụ đề được yêu cầu không phải là failed.
notFound (404) captionNotFound Không tìm thấy bản phụ đề. Kiểm tra giá trị của tham số id của 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 kênh phụ đề.
conflict (409) captionExists Video được chỉ định đã có một kênh phụ đề với snippet.language và snippet.name đã cho. Một video có thể có nhiều bản lồng tiếng cho cùng một ngôn ngữ, nhưng mỗi bản lồng tiếng phải có tên riêng.

Có nhiều cách để khắc phục 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 quan đến yêu cầu này không đủ để tải bản lồng tiếng 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 không thể tạo kênh. 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 không 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 bản lồng tiếng 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 kênh phụ đề được chỉ định. Lỗi này xảy ra nếu thông số videoId xác định một video thực tế, nhưng thông số id xác định mã bản nhạc phụ đề không tồn tại hoặc mã bản nhạc đượ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 của yêu cầu để đảm bảo rằng các giá trị đó là 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 này không tải tệp phụ đề đã cập nhật lên. Bạn phải có 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 này không đủ để cập nhật bản lồng tiếng. Yêu cầu có thể chưa được uỷ quyền đúng cách.
notFound (404) captionNotFound Không tìm thấy kênh phụ đề đã chỉ định. Kiểm tra giá trị của tham số id của 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ề các lỗi được liệt kê trong phần Các lỗi thường gặp về yêu cầu.

channelBanners.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) bannerAlbumFull Đĩa nhạc 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ố ả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 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 về yêu cầu.

channelSections.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) notEditable Không thể xoá phần kênh này.
forbidden (403) channelSectionForbidden 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.
invalidValue (400) idInvalid Thuộc tính id chỉ định mã 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 a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) notEditable Không thể tạo phần kênh này.
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 nguyên tắc trong tài liệu về tài nguyên a href="/youtube/v3/docs/channelSections#resource">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 nguyên tắc trong tài liệu về tài nguyên a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Một trong các giá trị trong danh sách targeting.regions 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 nguyên tắc trong tài liệu về tài nguyên a href="/youtube/v3/docs/channelSections#resource">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 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 không có kênh nào đượ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 này vì kênh đã có số lượng phần kênh tối đa.
invalidValue (400) maxChannelsExceeded Yêu cầu không thành công vì cố gắng đưa 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 đưa 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 đúng một danh sách phát.
invalidValue (400) ownChannelInChannels Bạn không thể đưa kênh của 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 ở chế độ 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ì đã chỉ định cá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 mong đợi cho loại phần kênh này.
invalidValue (400) snippetNeeded Bạn phải chỉ định 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 đề của mục bằng cách chỉ định 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 một hoặc nhiều 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ã 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 mục 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 nguyên tắc trong tài liệu về tài nguyên a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) notEditable Bạn không thể chỉnh sửa phần kênh này.
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 nguyên tắc trong tài liệu về tài nguyên a href="/youtube/v3/docs/channelSections#resource">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 nguyên tắc trong tài liệu về tài nguyên a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Một trong các giá trị trong danh sách targeting.regions 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 nguyên tắc trong tài liệu về tài nguyên a href="/youtube/v3/docs/channelSections#resource">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 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 không có kênh nào được dự kiến 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ã 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 đưa 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 đưa 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 đúng một danh sách phát.
invalidValue (400) ownChannelInChannels Bạn không thể đưa kênh của 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 ở chế độ 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ì đã chỉ định cá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 mong đợi cho loại phần kênh này.
invalidValue (400) snippetNeeded Bạn phải chỉ định 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 đề của mục bằng cách chỉ định 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.

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

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 do tham số id chỉ định 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. Sử dụng phương thức guideCategories.list để truy xuất danh sách các giá trị hợp lệ.
notFound (404) channelNotFound Không tìm thấy kênh được chỉ định trong thông 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 chế độ cài đặt hiện có cho kênh và cập nhật giá trị thuộc tính theo nguyên tắc 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. 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 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ệ. 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 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. 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 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 độ lệch thời gian không hợp lệ để xác định thời điểm hiển thị mục được quảng bá trong trình phát video. 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 hiển thị mục được quảng bá 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 được xác thực. 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 kênh.
badRequest (400) tooManyPromotedItems Số lượng mục được quảng bá được phép đã vượt quá trong phần invideoPromotion.
forbidden (403) channelForbidden Kênh được chỉ định trong thông 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 mã nhận dạng kênh là chính xác.
forbidden (403) websiteLinkNotAllowed URL trang web được chỉ định không được phép.
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ó lựa chọn về thương hiệu.
notFound (404) channelNotFound Không tìm thấy kênh được chỉ định trong thông số id.
notFound (404) unknownChannelId Không tìm thấy mã 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ục được quảng bá.
required (400) requiredItemIdType Siêu dữ liệu 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 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 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 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 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 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 yêu cầu phải chỉ định 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 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ề các lỗi được liệt kê trong phần Các lỗi thường gặp về yêu cầu.

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ý đượ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 rằng dữ liệu đầ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 phần nội dung yêu cầu để đảm bảo tài nguyên đó 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 đã 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 thông 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 giá trị của tham số id của yêu cầu để đảm bảo rằng giá trị đó 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. Đảm bảo tài nguyên chỉ định giá trị cho cả thuộc tính snippet.channelId và snippet.videoId. Bình luận về một video 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 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 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 rằng dữ liệu đầ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 phần nội dung yêu cầu để đảm bảo tài nguyên đó hợp lệ.
forbidden (403) forbidden Không thể tạo chuỗi 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 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 bình luận.
notFound (404) channelNotFound Không tìm thấy kênh đã 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 đã 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

Phương thức comments.markAsSpam không còn được hỗ trợ nữa.

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

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 nhận xét đã 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. Kiểm tra giá trị của các tham số id và parentId của 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 rằng dữ liệu đầ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 cho một hoặc nhiều bình luận do bạn 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 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 của yêu cầu để đảm bảo rằng các giá trị đó là 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 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 bình luận để trả lời bình luận cấp cao nhất do thuộc tính snippet.parentId xác định. 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 tin nhắn hay không.
badRequest (400) parentCommentIsPrivate Bình luận chính được chỉ định là riêng tư. API này không hỗ trợ tính năng trả lời bình luận riêng tư.
badRequest (400) parentIdMissing Chú thích đang được chèn phải được liên kết với một chú thích mẹ. Tuy nhiên, tài nguyên comment trong phần 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ý đượ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 rằng dữ liệu đầ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 phần nội dung yêu cầu để đảm bảo tài nguyên đó 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 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 bình luận.
notFound (404) parentCommentNotFound Không tìm thấy nhận xét mẹ được chỉ định. Kiểm tra giá trị của thuộc tính snippet.parentId trong phần nội dung yêu cầu để đảm bảo giá trị đó 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 thấy dữ liệu đầu vào của yêu cầu không hợp lệ.
forbidden (403) forbidden Không thể xoá 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 nhận xét được chỉ định. Kiểm tra giá trị của tham số id của 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 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ý đượ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 rằng dữ liệu đầ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 phần nội dung yêu cầu để đảm bảo tài nguyên đó 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 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 bình luận.
notFound (404) commentNotFound Không tìm thấy nhận xét được chỉ định. Kiểm tra giá trị của thuộc tính id trong phần nội dung yêu cầu để đảm bảo giá trị đó 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 về 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.
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 chế độ khác với chế độ đã chỉ định.
badRequest (400) invalidPageToken Giá trị tham số pageToken là không hợp lệ. Lỗi này xảy ra nếu mã thông báo trang 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 được 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ị thông số filterByMemberChannelId chỉ định nhiều 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ề các lỗi được liệt kê trong phần Các lỗi thường gặp về yêu cầu.

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.

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

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 danh sách phát được xác định bằng thông 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á một 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ố gắng thêm vào danh sách phát đã có trong danh sách phát đó.
forbidden (403) playlistContainsMaximumNumberOfVideos Danh sách phát đã chứa 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 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ệ. Có thể là do trường contentDetails.note dài hơn 280 ký tự.
invalidValue (400) invalidPlaylistItemPosition Yêu cầu này cố gắng đặt vị trí của mục 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ã nhận dạng 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 đang được thêm vào danh sách phát – chẳng hạn như youtube#video.
invalidValue (400) manualSortRequired Yêu cầu này 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 tuỳ 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 đã có trong một danh sách phát theo bộ khác.
invalidValue (400) playlistOperationUnsupported API không hỗ trợ tính 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 thông 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 giá trị đó 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 thông số playlistId của yêu cầu.
notFound (404) videoNotFound Không tìm thấy video được xác định bằng thông 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 này 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 này 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 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ã nhận dạng 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 đang đượ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 thuộc tính snippet hợp lệ.
invalidValue (400) manualSortRequired Yêu cầu này 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 tuỳ 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 này không hỗ trợ việc 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 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 thông 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 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 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 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 về 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 thông số id của yêu cầu.
invalidValue (400) playlistOperationUnsupported API không hỗ trợ tính năng xoá danh sách phát đã chỉ định. Ví dụ: bạn không thể xoá danh sách phát chứa các 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 thông 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 thông số channelId.
notFound (404) playlistNotFound Không tìm thấy danh sách phát được xác định bằng thông số id của yêu cầu.
invalidValue (400) playlistOperationUnsupported API không hỗ trợ việc 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 được xác thự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 Bạn 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 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 danh sách phát không hợp lệ.
required (400) playlistTitleRequired Yêu cầu phải chỉ định tiêu đề 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 được xác thự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.
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ợ việc 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 đã tải lên.
notFound (404) playlistNotFound Không tìm thấy danh sách phát được xác định bằng thông số id của yêu cầu.
required (400) playlistTitleRequired Yêu cầu phải chỉ định tiêu đề danh sách phát.

mục đăng ký

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 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 về 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ố xoá. Kiểm tra giá trị của tham số id của yêu cầu để đảm bảo 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 Lượt đăng ký mà bạn đang cố tạo đã tồn tại.
badRequest (400) subscriptionForbidden Bạn đã đạt đến số lượng gói thuê bao 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 Không hỗ trợ việc đăng ký kênh của chính bạn.
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 do thuộc tính snippet.resourceId của yêu cầu chỉ định.
notFound (404) subscriberNotFound Không tìm thấy người đăng ký được xác định bằng 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 đang được đă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 gói thuê bao 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 bằng 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ề các lỗi được liệt kê trong phần Các lỗi thường gặp về yêu cầu.

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 được 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 được xác thực không có quyền tải lên và đặt hình thu nhỏ video tuỳ 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 của yêu cầu để đảm bảo giá trị đó chính xác.
tooManyRequests (429) uploadRateLimitExceeded Gần đây, kênh đã tải quá nhiều hình thu nhỏ lên. 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 về yêu cầu.

videoAbuseReportReasons.list

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.

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

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 thông 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 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ề các lỗi được liệt kê trong phần Các lỗi thường gặp về yêu cầu.

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 về video đã bản địa hoá 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ã 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 phát hành 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 chi tiết về bản ghi không hợp lệ.
badRequest (400) invalidTags Siêu dữ liệu yêu cầu chỉ định từ khoá video không hợp lệ.
badRequest (400) invalidTitle Siêu dữ liệu yêu cầu chỉ định 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ứ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 Người dùng đã vượt quá số lượng video được phép tải lên.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting Yêu cầu này cố gắng đặ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 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 Biểu đồ video mà bạn yêu cầu không được hỗ trợ hoặc không có sẵn.
forbidden (403) forbidden Yêu cầu không được cấp quyền truy cập vào tệp video hoặc thông tin xử lý. Các phần fileDetails, processingDetails và suggestions chỉ dành cho chủ sở hữu video đó.
forbidden (403) forbidden Yêu cầu không thể truy cập thông tin về điểm xếp hạng của người dùng. Lỗi này có thể xảy ra do 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ố truy xuất. Kiểm tra giá trị của tham số id của 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ố gắng xoá. Kiểm tra giá trị của tham số id của 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 về video đã bản địa hoá 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ã 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 chế độ cài đặt quyền riêng tư không hợp lệ cho thông báo truyền tin 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 phát hành 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 chi tiết về bản ghi không hợp lệ.
badRequest (400) invalidTags Siêu dữ liệu yêu cầu chỉ định từ khoá video không hợp lệ.
badRequest (400) invalidTitle Siêu dữ liệu yêu cầu chỉ định tiêu đề video không hợp lệ hoặc trống.
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.
forbidden (403) forbidden 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 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 được 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 cố gắng đặ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 chế độ cài đặt quyền riêng tư không hợp lệ cho video.
notFound (404) videoNotFound Chúng tôi không tìm thấy video mà bạn đang cố cập nhật. Kiểm tra giá trị của trường id trong phần 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 họ 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ể xếp hạng video thuê.
forbidden (403) forbidden Bạn 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á. Kiểm tra giá trị của tham số id của 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 Chúng tôi không tìm thấy video mà bạn đang cố 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 về 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 đã chỉ định. Yêu cầu có thể không đượ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ể không đượ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ệ.