GroupItems: insert

Tạo một mục trong nhóm.

Yêu cầu

Yêu cầu HTTP

POST 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ả các tham số được liệt kê đều là tham số truy vấn.

Thông số
Tham số không bắt buộc
onBehalfOfContentOwner string
Bạn chỉ có thể sử dụng thông số này trong một yêu cầu được uỷ quyền hợp lệ. 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

Cung cấp tài nguyên groupItem trong phần nội dung yêu cầu. Đối với tài nguyên đó, bạn phải chỉ định giá trị cho các thuộc tính sau.

  • groupId
  • resource.id

Phản hồi

Nếu chèn thành công mục, phương thức này sẽ trả về một tài nguyên groupItem trong phần nội dung phản hồi.

Nếu mục được chỉ định trong yêu cầu đã có trong nhóm trước khi yêu cầu được thực hiện, thì phương thức này sẽ trả về mã phản hồi 204 HTTP (No Content).

Lỗi

Bảng dưới đây xác định thông báo lỗi mà API có thể trả về để phản hồi lệnh gọi đến phương thức này. Vui lòng xem tài liệu về thông báo lỗi để biết thêm thông tin chi tiết.

Loại lỗi Chi tiết về lỗi Mô tả
forbidden (403) groupContainsMaximumNumberOfItems Nhóm này đã chứa số mục tối đa được phép.

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.