Trang này được dịch bởi Cloud Translation API.

Activities

YouTube đã ngừng sử dụng tính năng bản tin kênh. Phương thức activities.list thực hiện vẫn không trả về các bản tin trên kênh và Phương thức activities.insert là không được hỗ trợ lâu hơn. Để biết thêm chi tiết, 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 trang 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 đượ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 xếp hạng 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 sự kiện hoạt động của kênh phù hợp với tiêu chí yêu cầu. Ví dụ: bạn có thể truy xuất sự kiện liên kết với một kênh cụ thể hoặc 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ợ.

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 sử dụng để xác định riêng biệt hoạt động đó.
`snippet`	`object` Đối tượng `snippet` chứa thông tin 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ờ 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 sử dụng để nhận dạng riêng kênh có 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` Mô tả tài nguyên chủ yếu liên quan đến hoạt động.
`snippet.thumbnails`	`object` Sơ đồ hình ả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 ả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 video – hoặc 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 120px và chiều cao 90px. Hình thu nhỏ mặc định của kênh có chiều rộng 88px và chiều cao 88px. `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 rộng 320px và cao 180px. Đối với kênh, hình ảnh này rộng 240px và cao 240px. `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 rộng 480px và cao 360px. Đối với kênh, hình ảnh này rộng 800px và cao 800px. `standard` – Phiên bản hình thu nhỏ có độ phân giải thậm chí cao hơn so với hình ảnh có độ phân giải `high`. Hình ảnh này có sẵn cho một số video và tài nguyên khác đề cập đến video, 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 rộng 640px và cao 480px. `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 áp dụng cho một số video và các tài nguyên khác đề cập đế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 rộng 1280px và 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 đề 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à: `channelItem` `comment` – (hiện chưa được trả về) `favorite` `like` `playlistItem` `promotedItem` `recommendation` `social` `subscription` `upload` `bulletin` (không dùng nữa)
`snippet.groupId`	`string` Mã nhóm được liên kết với hoạt động. Mã nhóm xác định các 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 người dùng xếp hạng một video và đánh dấu video đó là video 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 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 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 xếp hạng.
`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 riêng biệt video 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 để nhận dạng duy nhất một video, nếu tài nguyên được phân loại 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à 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 sử 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 các nhận xét mới.
`contentDetails.comment`	`object` Đối tượng `comment` chứa thông tin về một tài nguyên đã nhận được 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 sử 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 sử dụng để nhận dạng riêng kênh được liên kết với 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 sử dụng để nhận dạng 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 sử dụng để xác định chính xác 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 biệt danh sách phát.
`contentDetails.playlistItem.playlistItemId`	`string` Giá trị mà YouTube sử dụng để xác định 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 mà YouTube sử dụng để nhận dạng duy nhấ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 để nhận dạng duy nhất kênh, 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 tài nguyên được đề xuất cho người dùng. Các 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 đã tạo 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 nội dung đề 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 sử dụng để nhận dạng duy nhất kênh đó nếu nội dung đề xuất là do một kênh cụ thể gửi. 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 biệt danh sách phát nếu nội dung đề xuất là từ 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. 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` đóng gói thông tin xác định tài nguyên 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 sử dụng để xác định riêng biệt video 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 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 riêng biệ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 sử dụng để xác định riêng biệt 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` Hình ảnh tác giả 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 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.