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 của phương thức đó.

Lỗi chung

Các bảng sau đây xác định những 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 từ 2 thông số trở lên 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ã 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 đợi.
forbidden (403) accountDelegationForbidden Người dùng đã xác thực không thể hành động thay 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 được xác thực đang thay mặt cho một Tài khoản Google khác, thì lỗi này sẽ đề cập đến Tài khoản Google đó.
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 được xác thực đang thay mặt cho một Tài khoản Google khác, thì lỗi này sẽ đề 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 thành một kênh, nhưng không phân giải đượ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 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ó đủ chức năng.
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 đượ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ột mã ngôn ngữ hợp lệ.
badRequest (400) invalidMine Không hỗ trợ yêu cầu sử dụng tham số mine.
badRequest (400) invalidMine Bạn không thể dùng tham số mine trong các yêu cầu mà người dùng được 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 đóng vai trò 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ã 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 đợi.
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 cho 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 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ề YouTube API 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 này 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ề các lỗi được liệt kê trong phần Các lỗi thường gặp trong yêu cầu.

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 không được 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 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 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 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 trong 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 quan đến 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 của 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 phụ đề được yêu cầu không phải là failed.
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.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ó một tệp phụ đề với snippet.language và snippet.name được cung cấp. Một video có thể có nhiều phụ đề cho cùng một ngôn ngữ, nhưng mỗi phụ đề phải có một tên riêng.

Có nhiều cách để khắc phục lỗi này. Bạn có thể xoá phụ đề hiện có rồi chèn phụ đề mới hoặc thay đổi tên của phụ đề 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 tệp 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 bản nhạc không được tạo. 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 mã nhận dạng phụ đề không tồn tại hoặc mã nhận dạng phụ đề đượ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 tham số này 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ụ đề mới 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 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. 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.

channelBanners

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 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 trong 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 có ảnh bìa 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 có 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 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ã 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 tìm cách 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 đối tượng localizations cho tài nguyên đó một cách thành công.
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 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 chèn phải chứa một đố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 đúng một danh sách phát.
invalidValue (400) ownChannelInChannels Bạn không thể thêm 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 đang ở 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 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 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 đề của 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 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ã nhận dạng 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 đối tượng localizations cho tài nguyên đó một cách thành công.
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 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 một đối tượng contentDetails cho loại phần kênh này.
invalidValue (400) idInvalid Thuộc tính id chỉ định 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 đúng một danh sách phát.
invalidValue (400) ownChannelInChannels Bạn không thể thêm 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 đang ở 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 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 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 đề của 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 tìm cách 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 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 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 trong 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.
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 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 một 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 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ệ. 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 mặt hàng đượ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ã 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 một độ 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. 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 đượ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ặt hàng được quảng bá được phép đã vượt quá 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 mã nhận dạng kênh là chính xác.
forbidden (403) websiteLinkNotAllowed Bạn không được phép sử dụng URL trang web đã chỉ định.
notFound (404) channelNotFound Không tìm thấy kênh do tham số id chỉ định 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 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ặt hàng đượ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 của 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 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 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ặt hàng đượ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ặt hàng đượ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ột mã video để xác định mặt hàng được quảng bá.
required (400) requiredWebsiteUrl Siêu dữ liệu yêu cầu phải chỉ định một URL 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 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 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 trong 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ý 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 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 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 các giá trị của tham số id trong yêu cầu để đảm bảo rằng 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.

commentThreads.insert

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) channelOrVideoIdMissing Mỗi chuỗi bình luận phải được liên kết với một kênh hoặc video. Hãy đảm bảo rằng tài nguyên chỉ định các giá trị cho cả 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. Bạn phải nêu nhận xét.
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ý 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 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 tạo được 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 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 một bình luận hoặc chuỗi bình luận.
notFound (404) channelNotFound Không tìm thấy kênh bạn chỉ định. Kiểm tra giá trị của thuộc tính snippet.channelId để đảm bảo rằng 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 rằng giá trị đó chính xác.

comments

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 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 trong 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 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. 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 tham số này 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ý 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ệ.
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 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 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. Bạn phải nêu nhận xét.
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 chính được chỉ định là bình luận riêng tư. API này không hỗ trợ việc trả lời bình luận riêng tư.
badRequest (400) parentIdMissing Bình luận đượ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 Bạn 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 một bình luận hoặc chuỗi bình luận.
notFound (404) parentCommentNotFound Không tìm thấy bình luận mẹ đượ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ị đó 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ý 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ệ.
forbidden (403) forbidden Không thể xoá 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 bình luận được chỉ định. 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.

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ý 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 một bình luận hoặc chuỗi bình luận.
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ị đó chính xác.

thành viên

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 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.
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ế độ đã 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 đượ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ị tham số filterByMemberChannelId chỉ định hơn 100 kênh.

membershipsLevels

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 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.

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 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 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 trong 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 phép xoá mục cụ thể trong danh sách phát.
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ố 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 đã 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 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ã 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 đượ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 chế độ 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ể, trước tiên, bạn cần cập nhật chế độ 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 trên 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ợ 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 Chúng tôi 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ị đó 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 được 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ợ khả năng liệt kê video trong danh sách phát được chỉ định. Ví dụ: bạn không thể liệt kê một video trong 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 trong danh sách phát được 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ã 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 đượ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 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 chế độ 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ể, trước tiên, bạn cần cập nhật chế độ 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 trên 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 này không hỗ trợ chức 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 thông 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 này 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 đượ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 hướng dẫn 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 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 này không hỗ trợ tính năng cập nhật danh sách phát được 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 tiêu đề danh sách phát.

mục đă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 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 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 danh sách kênh đã đăng ký vì tài khoản của người đăng ký đã đóng.
forbidden (403) accountSuspended Không thể truy xuất danh sách kênh đã đă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 bằng yêu cầu.

hình thu nhỏ

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 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 trong 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 có 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ỏ tuỳ chỉnh cho video.
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 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 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 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 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 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 trong 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 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ề các lỗi được liệt kê trong phần Các lỗi thường gặp trong 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 đang cố gắng thêm thông tin chi tiết đã bản địa hoá về 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ệ. 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 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ột mức phân loại không hợp lệ cho trò chơi điện tử.
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 mà họ có thể tải lên.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting Yêu cầu này cố gắng đặt một giấy phép không hợp lệ cho video.
forbidden (403) forbiddenPrivacySetting Yêu cầu 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 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 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 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ố gắng truy xuất. 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.

videos.delete

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) forbidden Bạn không thể xoá video mà bạn đang cố gắng 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 trong yêu cầu để đảm bảo rằng 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á về 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ệ. 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 thông báo 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 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 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 một giấy phép không hợp lệ cho video.
forbidden (403) forbiddenPrivacySetting Yêu cầu 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ố gắng cập nhật. Kiểm tra giá trị của trường id trong nội dung yêu cầu để đảm bảo rằng 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 đợi cho tham số rating.
badRequest (400) videoPurchaseRequired Chỉ những người dùng thuê video mới có thể đánh giá video đó.
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 trong yêu cầu để đảm bảo rằng 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ủa 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ố gắng báo cáo hành vi sai trái.

hình mờ

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 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 có 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 Bạn không thể xoá 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ệ.