activities.list
vẫn không trả về bản tin kênh và phương thức activities.insert
không còn được hỗ trợ. Để biết thêm thông tin, vui lòng xem
Trung tâm trợ giúp của YouTube.
Tài nguyên activity
chứa thông tin về hành động mà một kênh hoặc người dùng cụ thể đã thực hiện trên YouTube. Các hành động được báo cáo trong nguồn cấp dữ liệu hoạt động bao gồm xếp hạng video, chia sẻ video, đánh dấu video là yêu thích, tải video lên, v.v. Mỗi tài nguyên activity
xác định loại hành động, kênh liên kết với hành động và(các) tài nguyên liên quan đến hành động, chẳng hạn như video đã được xếp hạng hoặc tải lên.
Phương thức
API hỗ trợ các phương thức sau cho tài nguyên activities
:
- list
- Trả về danh sách các sự kiện hoạt động của kênh khớp với tiêu chí yêu cầu. Ví dụ: bạn có thể truy xuất các sự kiện liên kết với một kênh cụ thể hoặc với kênh riêng của người dùng. Thử ngay.
Phương thức activities.insert
không còn được hỗ trợ nữa.
Trình bày tài nguyên
Cấu trúc JSON dưới đây thể hiện định dạng của tài nguyên activities
:
{ "kind": "youtube#activity", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "type": string, "groupId": string }, "contentDetails": { "upload": { "videoId": string }, "like": { "resourceId": { "kind": string, "videoId": string, } }, "favorite": { "resourceId": { "kind": string, "videoId": string, } }, "comment": { "resourceId": { "kind": string, "videoId": string, "channelId": string, } }, "subscription": { "resourceId": { "kind": string, "channelId": string, } }, "playlistItem": { "resourceId": { "kind": string, "videoId": string, }, "playlistId": string, "playlistItemId": string }, "recommendation": { "resourceId": { "kind": string, "videoId": string, "channelId": string, }, "reason": string, "seedResourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string } }, "social": { "type": string, "resourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string }, "author": string, "referenceUrl": string, "imageUrl": string }, "channelItem": { "resourceId": { } }, } }
Thuộc tính
Bảng sau đây xác định các thuộc tính xuất hiện trong tài nguyên này:
Thuộc tính | |
---|---|
kind |
string Xác định loại tài nguyên API. Giá trị sẽ là youtube#activity . |
etag |
etag Thẻ Etag của tài nguyên này. |
id |
string Mã nhận dạng mà YouTube dùng để xác định riêng hoạt động. |
snippet |
object Đối tượng snippet chứa các thông tin chi tiết cơ bản về hoạt động, bao gồm cả loại hoạt động và mã nhóm. |
snippet.publishedAt |
datetime Ngày và giờ xảy ra hoạt động. Giá trị được chỉ định theo định dạng ISO 8601. |
snippet.channelId |
string Mã nhận dạng mà YouTube dùng để xác định riêng biệt kênh có liên quan đến hoạt động đó. |
snippet.title |
string Tiêu đề của tài nguyên chủ yếu liên quan đến hoạt động. |
snippet.description |
string Nội dung mô tả về tài nguyên chủ yếu liên kết với hoạt động. |
snippet.thumbnails |
object Bản đồ các hình thu nhỏ liên kết với tài nguyên chủ yếu liên quan đến hoạt động. Đối với mỗi đối tượng trong bản đồ, khoá là tên của hình thu nhỏ và giá trị là một đối tượng chứa thông tin khác về hình thu nhỏ. |
snippet.thumbnails.(key) |
object Các giá trị khoá hợp lệ là:
|
snippet.thumbnails.(key).url |
string URL của hình ảnh. |
snippet.thumbnails.(key).width |
unsigned integer Chiều rộng của hình ảnh. |
snippet.thumbnails.(key).height |
unsigned integer Chiều cao của hình ảnh. |
snippet.channelTitle |
string Tiêu đề kênh của kênh chịu trách nhiệm về hoạt động này |
snippet.type |
string Loại hoạt động mà tài nguyên mô tả. Các giá trị hợp lệ cho thuộc tính này là:
|
snippet.groupId |
string Mã nhóm liên kết với hoạt động. Mã nhóm giúp xác định những sự kiện của người dùng được liên kết với cùng một người dùng và tài nguyên. Ví dụ: nếu người dùng xếp hạng video và đánh dấu video đó là mục yêu thích, thì các mục nhập cho những sự kiện đó sẽ có cùng mã nhóm trong nguồn cấp dữ liệu hoạt động của người dùng. Trong giao diện người dùng, bạn có thể tránh tình trạng lặp bằng cách nhóm các sự kiện có cùng giá trị groupId . |
contentDetails |
object Đối tượng contentDetails chứa thông tin về nội dung liên kết với hoạt động. Ví dụ: nếu giá trị snippet.type là videoRated thì nội dung của đối tượng contentDetails sẽ xác định video đã được phân loại. |
contentDetails.upload |
object Đối tượng upload chứa thông tin về video đã tải lên. Thuộc tính này chỉ xuất hiện nếu snippet.type là upload . |
contentDetails.upload.videoId |
string Mã nhận dạng mà YouTube sử dụng để xác định chính xác video mà bạn tải lên. |
contentDetails.like |
object Đối tượng like chứa thông tin về một tài nguyên nhận được điểm xếp hạng tích cực (thích). Thuộc tính này chỉ xuất hiện nếu snippet.type là like . |
contentDetails.like.resourceId |
object Đối tượng resourceId chứa thông tin xác định tài nguyên được xếp hạng. |
contentDetails.like.resourceId.kind |
string Loại tài nguyên API. |
contentDetails.like.resourceId.videoId |
string Mã nhận dạng mà YouTube sử dụng để xác định riêng biệt video, nếu tài nguyên được đánh giá là một video. Thuộc tính này chỉ xuất hiện nếu resourceId.kind là youtube#video . |
contentDetails.favorite |
object Đối tượng favorite chứa thông tin về một video được đánh dấu là video yêu thích. Thuộc tính này chỉ xuất hiện nếu snippet.type là favorite . |
contentDetails.favorite.resourceId |
object Đối tượng resourceId chứa thông tin xác định tài nguyên được đánh dấu là mục yêu thích. |
contentDetails.favorite.resourceId.kind |
string Loại tài nguyên API. |
contentDetails.favorite.resourceId.videoId |
string Mã nhận dạng mà YouTube dùng để xác định riêng biệt video yêu thích. Thuộc tính này chỉ xuất hiện nếu resourceId.kind là youtube#video .Lưu ý: Phương thức activities.list hiện không trả về tài nguyên cho nhận xét mới. |
contentDetails.comment |
object Đối tượng comment chứa thông tin về tài nguyên đã nhận nhận xét. Thuộc tính này chỉ xuất hiện nếu snippet.type là comment . |
contentDetails.comment.resourceId |
object Đối tượng resourceId chứa thông tin xác định tài nguyên liên kết với nhận xét đó. |
contentDetails.comment.resourceId.kind |
string Loại tài nguyên API. |
contentDetails.comment.resourceId.videoId |
string Mã nhận dạng mà YouTube dùng để xác định riêng biệt video có liên kết với một bình luận. Thuộc tính này chỉ xuất hiện nếu resourceId.kind là youtube#video . |
contentDetails.comment.resourceId.channelId |
string Mã nhận dạng mà YouTube dùng để xác định riêng biệt kênh có liên kết với một bình luận. Thuộc tính này chỉ xuất hiện nếu resourceId.kind là youtube#channel . |
contentDetails.subscription |
object Đối tượng subscription chứa thông tin về kênh mà người dùng đã đăng ký. Thuộc tính này chỉ xuất hiện nếu snippet.type là subscription . |
contentDetails.subscription.resourceId |
object Đối tượng resourceId chứa thông tin xác định tài nguyên mà người dùng đã đăng ký. |
contentDetails.subscription.resourceId.kind |
string Loại tài nguyên API. |
contentDetails.subscription.resourceId.channelId |
string Mã nhận dạng mà YouTube dùng để xác định riêng biệt kênh mà người dùng đăng ký theo dõi. Thuộc tính này chỉ xuất hiện nếu resourceId.kind là youtube#channel . |
contentDetails.playlistItem |
object Đối tượng playlistItem chứa thông tin về một mục mới trong danh sách phát. Thuộc tính này chỉ xuất hiện nếu snippet.type là playlistItem . |
contentDetails.playlistItem.resourceId |
object Đối tượng resourceId chứa thông tin xác định tài nguyên đã được thêm vào danh sách phát. |
contentDetails.playlistItem.resourceId.kind |
string Loại tài nguyên API. |
contentDetails.playlistItem.resourceId.videoId |
string Mã nhận dạng mà YouTube dùng để xác định riêng biệt video được thêm vào danh sách phát. Thuộc tính này chỉ xuất hiện nếu resourceId.kind là youtube#video . |
contentDetails.playlistItem.playlistId |
string Giá trị mà YouTube sử dụng để xác định riêng danh sách phát đó. |
contentDetails.playlistItem.playlistItemId |
string Giá trị mà YouTube sử dụng để xác định riêng biệt mục đó trong danh sách phát. |
contentDetails.recommendation |
object Đối tượng recommendation chứa thông tin về một tài nguyên được đề xuất. Thuộc tính này chỉ xuất hiện nếu snippet.type là recommendation . |
contentDetails.recommendation.resourceId |
object Đối tượng resourceId chứa thông tin xác định tài nguyên được đề xuất. |
contentDetails.recommendation.resourceId.kind |
string Loại tài nguyên API. |
contentDetails.recommendation.resourceId.videoId |
string Mã nhận dạng mà YouTube sử dụng để xác định riêng biệt video, nếu tài nguyên đề xuất là một video. Thuộc tính này chỉ xuất hiện nếu resourceId.kind là youtube#video . |
contentDetails.recommendation.resourceId.channelId |
string Mã nhận dạng mà YouTube sử dụng để xác định riêng biệt kênh của bạn, nếu tài nguyên đề xuất là một kênh. Thuộc tính này chỉ xuất hiện nếu resourceId.kind là youtube#channel . |
contentDetails.recommendation.reason |
string Lý do người dùng đề xuất tài nguyên này. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.recommendation.seedResourceId |
object Đối tượng seedResourceId chứa thông tin về tài nguyên đưa ra đề xuất. |
contentDetails.recommendation.seedResourceId.kind |
string Loại tài nguyên API. |
contentDetails.recommendation.seedResourceId.videoId |
string Mã nhận dạng mà YouTube sử dụng để xác định riêng biệt video, nếu video đề xuất là của một video cụ thể. Thuộc tính này chỉ xuất hiện nếu seedResourceId.kind là youtube#video . |
contentDetails.recommendation.seedResourceId.channelId |
string Mã nhận dạng mà YouTube dùng để xác định riêng biệt kênh của bạn, nếu một kênh cụ thể đưa ra đề xuất. Thuộc tính này chỉ xuất hiện nếu seedResourceId.kind là youtube#channel . |
contentDetails.recommendation.seedResourceId.playlistId |
string Mã nhận dạng mà YouTube sử dụng để xác định riêng danh sách phát, nếu danh sách phát được đề xuất dựa trên một danh sách phát cụ thể. Thuộc tính này chỉ xuất hiện nếu seedResourceId.kind là youtube#playlist . |
contentDetails.social |
object Đối tượng social chứa thông tin chi tiết về một bài đăng trên mạng xã hội. Thuộc tính này chỉ xuất hiện nếu snippet.type là social . |
contentDetails.social.type |
string Tên của mạng xã hội. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.social.resourceId |
object Đối tượng resourceId đóng gói thông tin nhận dạng tài nguyên liên kết với bài đăng trên mạng xã hội. |
contentDetails.social.resourceId.kind |
string Loại tài nguyên API. |
contentDetails.social.resourceId.videoId |
string Mã nhận dạng mà YouTube sử dụng để xác định chính xác video xuất hiện trong một bài đăng trên mạng xã hội, nếu bài đăng đó đề cập đến một video. Thuộc tính này sẽ chỉ xuất hiện nếu giá trị của thuộc tính social.resourceId.kind là youtube#video . |
contentDetails.social.resourceId.channelId |
string Mã nhận dạng mà YouTube sử dụng để nhận dạng duy nhất kênh xuất hiện trong bài đăng trên mạng xã hội, nếu bài đăng đó đề cập đến một kênh. Thuộc tính này sẽ chỉ xuất hiện nếu giá trị của thuộc tính social.resourceId.kind là youtube#channel . |
contentDetails.social.resourceId.playlistId |
string Mã nhận dạng mà YouTube dùng để xác định riêng danh sách phát xuất hiện trong một bài đăng trên mạng xã hội, nếu bài đăng đó đề cập đến một danh sách phát. Thuộc tính này sẽ chỉ xuất hiện nếu giá trị của thuộc tính social.resourceId.kind là youtube#playlist . |
contentDetails.social.author |
string Tác giả của bài đăng trên mạng xã hội. |
contentDetails.social.referenceUrl |
string URL của bài đăng trên mạng xã hội. |
contentDetails.social.imageUrl |
string Ảnh tác giả của bài đăng. |
contentDetails.channelItem |
object Đối tượng channelItem chứa thông tin chi tiết về tài nguyên đã được thêm vào một kênh. Thuộc tính này chỉ xuất hiện nếu snippet.type là channelItem . |
contentDetails.channelItem.resourceId |
object Đối tượng resourceId chứa thông tin xác định tài nguyên đã được thêm vào kênh. |