Dịch vụ API YouTube – Dịch vụ API Chủ đề
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Lưu ý: Việc tuân thủ Chính sách dành cho nhà phát triển của YouTube có hướng dẫn và ví dụ để giúp bạn đảm bảo rằng ứng dụng API của mình tuân thủ các phần cụ thể trong Điều khoản và Chính sách của Dịch vụ API YouTube. Hướng dẫn này cung cấp thông tin chi tiết về cách YouTube thực thi một số khía cạnh nhất định của Điều khoản dịch vụ API nhưng hướng dẫn này không thay thế bất kỳ tài liệu hiện có nào.
Điều khoản dịch vụ của Dịch vụ API YouTube ("Điều khoản") nêu rõ (trong Mục 14) nêu rõ rằng khi YouTube có ý định thực hiện các thay đổi không tương thích ngược đối với dịch vụ API YouTube, YouTube sẽ thông báo các thay đổi đó và cố gắng tiếp tục duy trì mã phần mềm trong 6 tháng sau khi có thông báo.
Trang này xác định Dịch vụ API Chủ đề được nêu trong mục 14.3 (Điều khoản đặc biệt) của Điều khoản và giải thích cách mục đó trong Điều khoản ảnh hưởng như thế nào đến ngày ngừng sử dụng thực tế. Trước ngày 10 tháng 2 năm 2017, tức là ngày có hiệu lực của Điều khoản hiện tại, các Dịch vụ API Chủ đề phải tuân thủ chính sách ngừng sử dụng một năm theo bộ Điều khoản trước đó. Để tuân thủ chính sách đó, các Dịch vụ API Chủ đề tạm thời phải tuân theo những quy tắc không dùng nữa so với các dịch vụ khác.
Tìm hiểu ngày ngừng sử dụng
Trong trường hợp có thay đổi không tương thích ngược đối với Dịch vụ API Chủ đề, YouTube sẽ thực hiện các biện pháp hợp lý để duy trì mã cho đến ít nhất là ngày 10 tháng 2 năm 2018, tức là một năm sau khi các Điều khoản này có hiệu lực. Đối với các dịch vụ khác, YouTube sẽ cố gắng tiếp tục duy trì mã phần mềm trong 6 tháng kể từ ngày công bố những thay đổi đó.
Miễn trừ
Một số tính năng của Dịch vụ API Chủ đề không phải tuân thủ các quy tắc được định nghĩa trong Mục 14.3 của Điều khoản vì các tính năng đó cũng không phải tuân theo chính sách không dùng nữa được quy định trong bộ Điều khoản trước đó. Những tính năng đó được xác định là trường hợp miễn trừ trong danh sách các dịch vụ theo chủ đề dưới đây.
Khi một tài sản object
được miễn trừ, chính sách đó cũng sẽ áp dụng cho mọi tài sản con của tài sản đó. Ngoài ra, chính sách miễn trừ áp dụng cho khả năng truy xuất, đặt, sửa đổi hoặc xoá các giá trị của tài sản hoặc các tài sản con của tài sản đó cũng như khả năng truy xuất, đặt, sửa đổi hoặc xoá các giá trị của tài sản đó.
Dịch vụ API Chủ đề
Các phần sau đây định nghĩa Dịch vụ API Chủ đề. Để hoàn chỉnh, các phần này cũng xác định các dịch vụ API hoàn toàn không dùng nữa. Những dịch vụ hoàn toàn không được dùng nữa sẽ không thuộc phạm vi điều chỉnh của Điều khoản.
API dữ liệu YouTube, phiên bản 3
- Tài liệu
-
Miễn trừ
- Các thuộc tính tài nguyên
channel
sau:
- Tài nguyên
guideCategory
và các phương thức của tài nguyên đó.
- Tham số
safeSearch
của phương thức search.list
và các giá trị của nó.
- Thuộc tính
status.publishAt
của tài nguyên video
.
API Trình phát IFrame YouTube
API Báo cáo của YouTube
- Tài liệu
-
Miễn trừ
- Phương diện phụ. (Xem định nghĩa về phương diện để xác định xem từng phương diện riêng lẻ có được coi là phương diện chính hay không.)
- Chỉ số phụ. (Xem định nghĩa về chỉ số để xác định xem từng chỉ số riêng lẻ có được coi là chỉ số chính hay không.)
API YouTube Analytics
- Tài liệu
-
Miễn trừ
- Phương diện phụ. (Xem định nghĩa về phương diện để xác định xem từng phương diện riêng lẻ có được coi là phương diện chính hay không.)
- Chỉ số phụ. (Xem định nghĩa về chỉ số để xác định xem từng chỉ số riêng lẻ có được coi là chỉ số chính hay không.)
Dịch vụ API hoàn toàn không dùng nữa
Các dịch vụ API sau đây hoàn toàn không dùng nữa. Chúng tuân theo chính sách về việc ngừng sử dụng được nêu trong Điều khoản gốc và thời hạn ngừng sử dụng đã kết thúc. YouTube không có nghĩa vụ thông báo những thay đổi có thể gây lỗi đối với các dịch vụ này cũng như không có nghĩa vụ tiếp tục hỗ trợ những dịch vụ này:
API dữ liệu YouTube, phiên bản 2
API Trình phát Flash của YouTube
API Trình phát JavaScript của YouTube
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-21 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-21 UTC."],[],["YouTube API services follow a deprecation policy where backward-incompatible changes are announced, and code is maintained for six months. Subject API Services, listed as YouTube Data API v3, IFrame Player API, Reporting API, and Analytics API, have extended maintenance until February 10, 2018, due to prior terms. Exemptions, like specific properties and non-core metrics, exist. Fully deprecated services, such as Data API v2, Flash, and JavaScript Player APIs, are no longer supported.\n"],null,["# YouTube API Services - Subject API Services\n\n**Note:** [Complying with the YouTube Developer Policies](/youtube/terms/developer-policies-guide) provides guidance and examples to help you ensure that your API clients follow specific portions of the YouTube API Services [Terms](/youtube/terms/api-services-terms-of-service) and [Policies](/youtube/terms/developer-policies) (API TOS). The guide offers insight into how YouTube enforces certain aspects of the API TOS, but it does not replace any existing documents.\n\nThe [YouTube API Services Terms of Service](/youtube/terms/api-services-terms-of-service) (the \"Terms\") state (in Section 14) that when YouTube intends to make backward-incompatible changes to YouTube API services, YouTube will announce those changes and try to continue to maintain the software code for six months after the announcement.\n\nThis page identifies the **Subject API Services** referenced in section 14.3 (Special Terms) of the Terms and explains how that section of the Terms affects actual deprecation dates. Prior to February 10, 2017, which is the effective date of the current Terms, the Subject API Services had been subject to a one-year deprecation policy under the previous set of Terms. To honor that policy, the Subject API Services are, temporarily, subject to different deprecation rules than other services.\n\nUnderstanding deprecation dates\n-------------------------------\n\nIn the event of backward-incompatible changes to Subject API Services, YouTube will use reasonable efforts to maintain code until at least February 10, 2018, which is one year after these Terms became effective. For other services, YouTube will try to continue to maintain the software code for six months from the date those changes are announced.\n\n### Exemptions\n\nSome features of Subject API Services are not subject to the rules defined in Section 14.3 of the Terms because those features were also not subject to the deprecation policy defined under the prior set of Terms. Those features are identified as **exemptions** in the list of subject services below.\n\nWhen an exemption applies to an `object` property, it also applies to any of that property's child properties. In addition, the exemption applies to the ability to retrieve, set, modify, or delete values of the property or its child properties as well as to the property values themselves.\n\nSubject API Services\n--------------------\n\nThe following sections define the Subject API Services. For completeness, these sections also identify fully deprecated API services. Those fully deprecated services are not covered under the Terms.\n\n### YouTube Data API, v3\n\n\u003cbr /\u003e\n\n- [Documentation](/youtube/v3)\n- Exemptions\n\n - The following `channel` resource properties:\n - [brandingSettings.channel.profileColor](/youtube/v3/docs/channels#brandingSettings.channel.profileColor)\n - [brandingSettings.hints](/youtube/v3/docs/channels#brandingSettings.hints)\n - [brandingSettings.image.watchIconImageUrl](/youtube/v3/docs/channels#brandingSettings.image.watchIconImageUrl)\n - [brandingSettings.watch](/youtube/v3/docs/channels#brandingSettings.watch)\n - [contentDetails.relatedPlaylists](/youtube/v3/docs/channels#contentDetails.relatedPlaylists)\n - [contentOwnerDetails](/youtube/v3/docs/channels#contentOwnerDetails)\n - [invideoPromotion](/youtube/v3/docs/channels#invideoPromotion)\n - [statistics.commentCount](/youtube/v3/docs/channels#statistics.commentCount)\n - The [guideCategory](/youtube/v3/docs/guideCategories) resource and its methods.\n - The `search.list` method's [safeSearch](/youtube/v3/docs/search/list#safeSearch) parameter and its values.\n - The `video` resource's [status.publishAt](/youtube/v3/docs/videos#status.publishAt) property.\n\n\u003cbr /\u003e\n\n### YouTube IFrame Player API\n\n\u003cbr /\u003e\n\n- [Documentation](/youtube/iframe_api_reference)\n\n\u003cbr /\u003e\n\n### YouTube Reporting API\n\n\u003cbr /\u003e\n\n- [Documentation](/youtube/reporting)\n- Exemptions\n\n - Non-core dimensions. (See the [dimension](/youtube/reporting/v1/reports/dimensions) definitions to determine whether individual dimensions are considered core dimensions.)\n - Non-core metrics. (See the [metric](/youtube/reporting/v1/reports/metrics) definitions to determine whether individual metrics are considered core metrics.)\n\n\u003cbr /\u003e\n\n### YouTube Analytics API\n\n\u003cbr /\u003e\n\n- [Documentation](/youtube/analytics)\n- Exemptions\n\n - Non-core dimensions. (See the [dimension](/youtube/analytics/v1/dimsmets/dims) definitions to determine whether individual dimensions are considered core dimensions.)\n - Non-core metrics. (See the [metric](/youtube/analytics/v1/dimsmets/mets) definitions to determine whether individual metrics are considered core metrics.)\n\n\u003cbr /\u003e\n\nFully deprecated API Services\n-----------------------------\n\nThe following API services are fully deprecated. They were subject to the deprecation policy set forth in the Original Terms and the deprecation period has ended. YouTube is neither obligated to announce breaking changes to these services nor to continue supporting them:\n\n### YouTube Data API, v2\n\n\u003cbr /\u003e\n\n- [Deprecation announcement](http://youtube-eng.blogspot.com/2014/03/committing-to-youtube-data-api-v3_4.html) (March 4, 2014)\n- [Documentation](/youtube/2.0/developers_guide_protocol)\n- Migration path: [YouTube Data API, v3](/youtube/v3/getting-started)\n\n\u003cbr /\u003e\n\n### YouTube Flash Player API\n\n\u003cbr /\u003e\n\n- [Deprecation announcement](http://youtube-eng.blogspot.com/2015/01/youtube-now-defaults-to-html5_27.html) (January 27, 2015)\n- Migration path: [IFrame Player API](/youtube/iframe_api_reference)\n\n\u003cbr /\u003e\n\n### YouTube JavaScript Player API\n\n\u003cbr /\u003e\n\n- [Deprecation announcement](http://youtube-eng.blogspot.com/2015/01/youtube-now-defaults-to-html5_27.html) (January 27, 2015)\n- Migration path: [IFrame Player API](/youtube/iframe_api_reference)\n\n\u003cbr /\u003e"]]