Sponsors

Lưu ý: Tài nguyên này đã ngừng hoạt động kể từ ngày 31 tháng 3 năm 2020. Tài nguyên này đã được thay thế bằng tài nguyên member. Bạn có thể tìm thấy thông tin về tài nguyên đó trong tài liệu về API Dữ liệu YouTube.

Trong quá trình ngừng sử dụng này, phương thức sponsors.list sẽ không còn được hỗ trợ kể từ ngày 30 tháng 9 năm 2020. Ứng dụng API nên cập nhật các lệnh gọi đến phương thức sponsors.list để sử dụng phương thức members.list.

Tài nguyên sponsor đại diện cho hội viên của kênh (trước đây gọi là "tài trợ") cho một kênh YouTube. Một thành viên hỗ trợ định kỳ cho nhà sáng tạo và nhận các lợi ích đặc biệt. Ví dụ: Hội viên có thể trò chuyện khi nhà sáng tạo bật chế độ chỉ dành cho hội viên để trò chuyện.

Phương pháp

API hỗ trợ các phương thức sau cho tài nguyên sponsors:

list
Liệt kê các nhà tài trợ cho một kênh. Yêu cầu API phải được chủ sở hữu kênh cho phép. Thử ngay.

Biểu diễn tài nguyên

Cấu trúc JSON sau đây cho thấy định dạng của tài nguyên sponsors:

{
  "kind": "youtube#sponsor",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "sponsorDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "sponsorSince": datetime
  }
}

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#sponsor.
etag etag
Etag của tài nguyên này.
id string
Mã nhận dạng mà YouTube gán để nhận dạng duy nhất nhà tài trợ.
snippet object
Đối tượng snippet chứa thông tin chi tiết về nhà tài trợ.
snippet.channelId string
Mã nhận dạng này xác định kênh đang được tài trợ.
snippet.sponsorDetails object
Đối tượng này chứa thông tin chi tiết về nhà tài trợ.
snippet.sponsorDetails.channelId string
Mã nhận dạng kênh YouTube.
snippet.sponsorDetails.channelUrl string
URL của kênh.
snippet.sponsorDetails.displayName string
Tên hiển thị của kênh.
snippet.sponsorDetails.profileImageUrl string
URL hình đại diện của kênh.
snippet.sponsorSince datetime
Ngày và giờ người dùng trở thành nhà tài trợ. Giá trị này được chỉ định ở định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).