FanFundingEvents

Lưu ý: Đây là thông báo về việc ngừng sử dụng.

Tính năng Tài trợ của người hâm mộ đã ngừng hoạt động và API Tài trợ của người hâm mộ sẽ bị tắt vào ngày 28 tháng 2 năm 2017. Thông báo về việc ngừng cung cấp này trùng với việc phát hành tính năng Super Chat mới của YouTube.

Tài nguyên fanFundingEvent đại diện cho sự kiện Tài trợ của người hâm mộ trên kênh YouTube. Các tính năng liên quan đến Tài trợ của người hâm mộ giúp hỗ trợ nhà sáng tạo trên YouTube kiếm tiền. Sự kiện Tài trợ của người hâm mộ xảy ra khi người dùng thanh toán tự nguyện một lần cho một kênh. Xem Trung tâm trợ giúp YouTube để tìm hiểu thêm về tính năng Tài trợ của người hâm mộ.

Phương pháp

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

list
Liệt kê các sự kiện tài trợ của người hâm mộ 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 fanFundingEvents:

{
  "kind": "youtube#fanFundingEvent",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "supporterDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "commentText": string,
    "createdAt": datetime,
    "amountMicros": unsigned long,
    "currency": string,
    "displayString": 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#fanFundingEvent.
etag etag
Etag của tài nguyên này.
id string
Mã nhận dạng mà YouTube chỉ định để nhận dạng duy nhất sự kiện tài trợ của người hâm mộ.
snippet object
Đối tượng snippet chứa thông tin về sự kiện tài trợ của người hâm mộ.
snippet.channelId string
Mã nhận dạng của kênh đã nhận được tiền tài trợ.
snippet.supporterDetails object
Thông tin chi tiết về kênh của người hỗ trợ. Đối tượng này chỉ xuất hiện nếu người ủng hộ công khai sự kiện tài trợ.
snippet.supporterDetails.channelId string
Mã nhận dạng kênh YouTube của người hỗ trợ.
snippet.supporterDetails.channelUrl string
URL của kênh của người hỗ trợ.
snippet.supporterDetails.displayName string
Tên hiển thị của kênh của người hỗ trợ.
snippet.supporterDetails.profileImageUrl string
URL hình đại diện cho kênh của người hỗ trợ.
snippet.commentText string
Nội dung văn bản trong bình luận của người hỗ trợ.
snippet.createdAt datetime
Ngày và giờ gây quỹ. Giá trị này được chỉ định ở định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.amountMicros unsigned long
Số tiền đã đóng góp trong sự kiện tài trợ. Giá trị này tính theo phần triệu của đơn vị tiền tệ của quỹ. Ví dụ: nếu nhà tài trợ đóng góp một đô la (1 đô la) thì giá trị tài sản snippet.amountMicros sẽ là 1000000.
snippet.currency string
Đơn vị tiền tệ tương ứng với số tiền. Giá trị này là mã đơn vị tiền tệ ISO 4217.
snippet.displayString string
Một chuỗi dùng để hiển thị, cho biết số tiền và đơn vị tiền tệ. Nếu yêu cầu fanFundingEvents.list chỉ định một ngôn ngữ ứng dụng có tham số hl, chuỗi hiển thị sẽ được bản địa hoá để hiển thị bằng ngôn ngữ đó. Ví dụ: bằng tiếng Anh, đơn vị tiền tệ sẽ được hiển thị dưới dạng $1.50, nhưng bằng tiếng Pháp, đơn vị tiền tệ sẽ được hiển thị dưới dạng 1,50$.