Groups

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.insertgroupItems.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à:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset