Groups

Tài nguyên group đại diện cho một nhóm YouTube Analytics, tức là một tập hợp tùy chỉnh gồm tối đa 500 kênh, video, danh sách phát hoặc tài sản.

Tất cả các mục trong một nhóm phải đại diện cho cùng một loại tài nguyên. Ví dụ: bạn không thể tạo một nhóm chứa 100 video và 100 danh sách phát.

Nhóm Analytics chỉ có thể chứa những tài nguyên mà bạn đã tải lên hoặc xác nhận quyền sở hữu hoặc được liên kết với một kênh mà bạn quản lý. Do đó, chủ sở hữu kênh có thể tạo nhóm video và danh sách phát. Chủ sở hữu nội dung có thể tạo nhóm video, danh sách phát, kênh hoặc tài sản.

Phương pháp

API hỗ trợ các phương thức sau cho tài nguyên groups:

list

Trả về danh sách các nhóm khớp với tham số của yêu cầu API. Ví dụ: bạn có thể truy xuất tất cả các nhóm mà người dùng đã xác thực sở hữu hoặc bạn có thể truy xuất một hoặc nhiều nhóm theo mã nhận dạng duy nhất của họ. Thử ngay.

chèn

Tạo một nhóm YouTube Analytics. Sau khi tạo nhóm, hãy sử dụng phương thức groupItems.insert để thêm mục vào nhóm. Thử ngay.

cập nhật

Sửa đổi siêu dữ liệu cho một nhóm. Hiện tại, tài sản duy nhất có thể cập nhật là tiêu đề của nhóm. (Sử dụng groupItems.insert và groupItems.delete để thêm và xóa các mục nhóm.) Thử ngay.

xóa

Xoá nhóm. Thử ngay.

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

Cấu trúc JSON bên dưới cho thấy định dạng của tài nguyên groups:

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

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#group.
etag	etag Etag của tài nguyên này.
id	string Mã nhận dạng mà YouTube sử dụng để nhận dạng duy nhất nhóm đó.
snippet	object Đối tượng snippet chứa thông tin cơ bản về nhóm, bao gồm cả ngày tạo và tên của nhóm đó.
snippet.publishedAt	datetime Ngày và giờ tạo nhóm. Giá trị này được chỉ định ở định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.title	string Tên nhóm. Giá trị này phải là một chuỗi không trống.
contentDetails	object Đối tượng contentDetails chứa thông tin bổ sung về nhóm, chẳng hạn như số lượng và loại mục trong nhóm đó.
contentDetails.itemCount	unsigned long Số lượng mục trong nhóm.
contentDetails.itemType	string Loại tài nguyên mà nhóm này chứa. Giá trị hợp lệ cho tài sản này là: youtube#channel youtube#playlist youtube#video youtubePartner#asset