Tài nguyên group
đại diện cho một nhóm trong YouTube Analytics. Nhóm này là một tập hợp tuỳ 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.
Một nhóm Analytics chỉ có thể chứa những tài sả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 thức
API này 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ố yêu cầu API. Ví dụ: bạn có thể truy xuất tất 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 các nhóm đó. Thử ngay.
- chèn
- Tạo nhóm YouTube Analytics. Sau khi tạo một nhóm, hãy sử dụng phương thức
groupItems.insert
để thêm các mục vào nhóm đó. Thử ngay. - update
- Sửa đổi siêu dữ liệu cho một nhóm. Hiện tại, bạn chỉ có thể cập nhật tiêu đề của nhóm. (Sử dụng
groupItems.insert
vàgroupItems.delete
để thêm và xoá các mục trong nhóm.) Thử ngay. - xóa
- Xoá một nhóm. Thử ngay.
Biểu diễn tài nguyên
Cấu trúc JSON dưới đây 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 nhóm. |
snippet.publishedAt |
datetime Ngày và giờ tạo nhóm. Giá trị được chỉ định ở định dạng ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ). |
snippet.title |
string Tên nhóm. Giá trị 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 các 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 chứa. Các giá trị hợp lệ cho thuộc tính này là:
|