GroupItems: list

Lưu ý quan trọng: Các yêu cầu API đối với phương thức này yêu cầu quyền truy cập vào:
  • https://www.googleapis.com/auth/youtubephạm vi
    hoặc
  • phạm vi https://www.googleapis.com/auth/youtube.readonly
    và
    phạm vi https://www.googleapis.com/auth/yt-analytics.readonly

Tuỳ chọn đầu tiên sử dụng một phạm vi, đó là phạm vi đọc-ghi, trong khi tuỳ chọn thứ hai sử dụng hai phạm vi chỉ có thể đọc.

Trả về một tập hợp các mục nhóm khớp với các tham số yêu cầu API.

Yêu cầu

Yêu cầu HTTP

GET https://youtubeanalytics.googleapis.com/v2/groupItems

Ủy quyền

Yêu cầu này yêu cầu uỷ quyền với ít nhất một trong các phạm vi sau (đọc thêm về việc xác thực và uỷ quyền).

Phạm vi
https://www.googleapis.com/auth/yt-analytics.readonly Xem báo cáo YouTube Analytics cho nội dung trên YouTube của bạn. Phạm vi này cung cấp quyền truy cập vào các chỉ số về hoạt động của người dùng, chẳng hạn như số lượt xem và số lượt xếp hạng.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Xem các báo cáo tài chính của YouTube Analytics cho nội dung trên YouTube của bạn. Phạm vi này cung cấp quyền truy cập vào các chỉ số về hoạt động của người dùng, cũng như các chỉ số về doanh thu ước tính và hiệu suất quảng cáo.
https://www.googleapis.com/auth/youtube Quản lý tài khoản YouTube của bạn. Trong API YouTube Analytics, chủ sở hữu kênh sử dụng phạm vi này để quản lý các nhóm và mục trong nhóm trên YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner Xem và quản lý tài sản cũng như nội dung được liên kết trên YouTube. Trong API YouTube Analytics, chủ sở hữu nội dung sử dụng phạm vi này để quản lý các nhóm và mục trong nhóm trên YouTube Analytics.

Thông số

Bảng dưới đây liệt kê các tham số mà truy vấn này hỗ trợ. Tất cả tham số được liệt kê đều là tham số truy vấn.

Thông số
Tham số bắt buộc
groupId string
Tham số id chỉ định mã nhận dạng duy nhất của nhóm mà bạn muốn truy xuất các mục trong nhóm.
Thông số tuỳ chọn
onBehalfOfContentOwner string
Bạn chỉ có thể dùng thông số này trong một yêu cầu được uỷ quyền phù hợp. Lưu ý: Thông số này chỉ dành cho những đối tác nội dung trên YouTube sở hữu và quản lý nhiều kênh YouTube.

Thông số onBehalfOfContentOwner cho biết rằng thông tin xác thực uỷ quyền của yêu cầu xác định một người dùng YouTube đang thay mặt cho chủ sở hữu nội dung được chỉ định trong giá trị thông số. Tính năng này cho phép chủ sở hữu nội dung xác thực một lần và có quyền truy cập vào tất cả dữ liệu về video và kênh của họ mà không cần phải cung cấp thông tin xác thực cho từng kênh. Tài khoản mà người dùng xác thực phải được liên kết với chủ sở hữu nội dung YouTube được chỉ định.

Nội dung yêu cầu

Không cung cấp nội dung yêu cầu khi gọi phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về một phần nội dung phản hồi có cấu trúc sau:

{
  "kind": "youtube#groupItemListResponse",
  "etag": etag,
  "items": [
    groupItem Resource
  ]
}

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#groupItemListResponse.
etag etag
Etag của tài nguyên này.
items[] list
Danh sách các mục mà nhóm chứa. Mỗi mục trong danh sách đại diện cho một tài nguyên groupItem.

Lỗi

API không xác định bất kỳ thông báo lỗi nào dành riêng cho phương thức API này. Tuy nhiên, phương thức này vẫn có thể trả về các lỗi API chung được liệt kê trong tài liệu về thông báo lỗi.

Hãy dùng thử!

Sử dụng APIs Explorer để gọi API này và xem yêu cầu và phản hồi API.