Activities

Tài nguyên activity chứa thông tin về một 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 bản tin hoạt động bao gồm đánh giá video, chia sẻ video, đánh dấu video là video 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 được liên kết với hành động và(các) tài nguyên được liên kết với hành động, chẳng hạn như video được đánh giá hoặc tải lên.

Phương thức

API này 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 trên kênh phù hợp với tiêu chí của 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 của chính người dùng. Thử ngay.

Biểu diễn tài nguyên

Cấu trúc JSON sau đây cho thấy đị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
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 biệt hoạt động.
snippet object
Đối tượng snippet chứa các thông tin cơ bản về hoạt động, bao gồm loại hoạt động và mã nhóm.
snippet.publishedAt datetime
Ngày và giờ diễn ra hoạt động. Giá trị được chỉ định ở định dạng ISO 8601.
snippet.channelId string
Mã nhận dạng mà YouTube dùng để nhận dạng riêng biệt kênh liên kết với 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 đồ hình thu nhỏ được liên kết với tài nguyên chủ yếu được liên kết với 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à:
  • default – Hình thu nhỏ mặc định. Hình thu nhỏ mặc định cho một video (hoặc một tài nguyên đề cập đến video, chẳng hạn như một mục trong danh sách phát hoặc kết quả tìm kiếm) có chiều rộng 120 pixel và chiều cao 90 pixel. Hình thu nhỏ mặc định của kênh có chiều rộng 88 px và chiều cao 88 px.
  • medium – Phiên bản có độ phân giải cao hơn của hình thu nhỏ. Đối với video (hoặc tài nguyên đề cập đến video), hình ảnh này có chiều rộng 320 px và chiều cao 180 px. Đối với kênh, hình ảnh này có chiều rộng 240 px và chiều cao 240 px.
  • high – Phiên bản có độ phân giải cao của hình thu nhỏ. Đối với video (hoặc tài nguyên đề cập đến video), hình ảnh này có chiều rộng 480 pixel và chiều cao 360 pixel. Đối với kênh, hình ảnh này có chiều rộng 800px và chiều cao 800px.
  • standard – Phiên bản hình thu nhỏ có độ phân giải cao hơn cả hình ảnh có độ phân giải high. Hình ảnh này xuất hiện ở một số video và các tài nguyên khác có liên quan đến video, chẳng hạn như các mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này có chiều rộng 640 px và chiều cao 480 px.
  • maxres – Phiên bản có độ phân giải cao nhất của hình thu nhỏ. Kích thước hình ảnh này có ở một số video và các tài nguyên khác có liên quan đến video, chẳng hạn như các mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này có chiều rộng 1280px và chiều cao 720px.
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 đề của kênh chịu trách nhiệm cho 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à:
  • channelItem
  • comment – (hiện chưa được trả lại)
  • favorite
  • like
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • subscription
  • upload
snippet.groupId string
Mã nhóm được liên kết với hoạt động. Mã nhóm xác định những sự kiện 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 một người dùng đánh giá một video và đánh dấu video đó là video yêu thích, thì các mục cho những sự kiện đó sẽ có cùng mã nhóm trong nhật ký hoạt động của người dùng. Trong giao diện người dùng, bạn có thể tránh lặp lại 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 được 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 dùng để xác định riêng biệt video được 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 phân loại.
contentDetails.like.resourceId.kind string
Loại tài nguyên API.
contentDetails.like.resourceId.videoId string
Mã nhận dạng mà YouTube dùng để nhận dạng duy nhất video, nếu tài nguyên được phân loại là 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 bình luận mới.
contentDetails.comment object
Đối tượng comment chứa thông tin về một tài nguyên đã nhận được bình luận. 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 được liên kết với bình luận.
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 duy nhất video 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 duy nhất kênh 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ề một 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 nhận dạng 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 duy nhất kênh mà người dùng đã đăng ký. 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 dùng để xác định duy nhất danh sách phát.
contentDetails.playlistItem.playlistItemId string
Giá trị mà YouTube dùng để nhận dạng duy nhấ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 riêng biệt của video mà YouTube sử dụng, nếu tài nguyên được đề 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 dùng để xác định kênh một cách duy nhất, nếu tài nguyên được đề 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 mà tài nguyên được đề xuất cho người dùng.

Giá trị hợp lệ cho thuộc tính này là:
  • videoFavorited
  • videoLiked
  • videoWatched
contentDetails.recommendation.seedResourceId object
Đối tượng seedResourceId chứa thông tin về tài nguyên gây 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 duy nhất mà YouTube dùng để xác định video, nếu đề xuất là do một video cụ thể tạo ra. 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 kênh một cách riêng biệt, nếu đề xuất là do một kênh cụ thể tạo ra. 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 dùng để xác định riêng biệt danh sách phát, nếu đề xuất là do 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à:
  • facebook
  • googlePlus
  • twitter
  • unspecified
contentDetails.social.resourceId object
Đối tượng resourceId bao bọc thông tin xác định tài nguyên được liên kết với một 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 dùng để xác định duy nhất 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 dùng để xác định duy nhất kênh 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 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 duy nhất danh sách phát xuất hiện nổi bật 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
Hình ả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ề một tài nguyên được thêm vào 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.