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.insertgroupItems.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