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à:
|