FanFundingEvents

หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

เราจะเลิกใช้งานฟีเจอร์การให้เงินสนับสนุนของแฟนๆ และ API ของการให้เงินสนับสนุนของแฟนๆ จะปิดลงในวันที่ 28 กุมภาพันธ์ 2017 ประกาศเกี่ยวกับการเลิกใช้งานนี้สอดคล้องกับการเปิดตัวฟีเจอร์ Super Chat ใหม่ของ YouTube

แหล่งข้อมูล fanFundingEvent แสดงถึงกิจกรรมการให้เงินสนับสนุนของแฟนๆ ในช่อง YouTube การให้เงินสนับสนุนของแฟนๆ เป็นช่องทางที่ช่วยสนับสนุนครีเอเตอร์ YouTube ที่สร้างรายได้ เหตุการณ์การให้เงินสนับสนุนของแฟนๆ เกิดขึ้นเมื่อผู้ใช้ชําระเงินแบบครั้งเดียวโดยสมัครใจให้แก่ช่อง ดูข้อมูลเพิ่มเติมเกี่ยวกับการให้เงินสนับสนุนของแฟนๆ ได้ที่ศูนย์ช่วยเหลือของ YouTube

วิธีการ

API รองรับวิธีต่อไปนี้สําหรับทรัพยากร fanFundingEvents รายการ

list
แสดงรายการกิจกรรมการให้เงินสนับสนุนของแฟนๆ สําหรับช่อง เจ้าของช่องต้องเป็นผู้อนุญาตคําขอ API ลองใช้เลย

การนําเสนอแหล่งข้อมูล

โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบทรัพยากร 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
  }
}

พร็อพเพอร์ตี้

ตารางต่อไปนี้กําหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้

พร็อพเพอร์ตี้
kind string
ระบุประเภทของทรัพยากร API ค่านี้จะเป็น youtube#fanFundingEvent
etag etag
Etag ของทรัพยากรนี้
id string
รหัสที่ YouTube กําหนดเพื่อระบุกิจกรรมการให้เงินสนับสนุนของแฟนๆ ที่ไม่ซ้ํากัน
snippet object
ออบเจ็กต์ snippet มีข้อมูลเกี่ยวกับเหตุการณ์การให้เงินสนับสนุนของแฟนๆ
snippet.channelId string
รหัสของช่องที่ได้รับเงินสนับสนุน
snippet.supporterDetails object
รายละเอียดเกี่ยวกับช่องของผู้สนับสนุน ออบเจ็กต์นี้จะปรากฏต่อเมื่อผู้สนับสนุนเผยแพร่กิจกรรมการระดมทุนต่อสาธารณะเท่านั้น
snippet.supporterDetails.channelId string
รหัสช่อง YouTube ของผู้สนับสนุน
snippet.supporterDetails.channelUrl string
URL ช่องของผู้สนับสนุน
snippet.supporterDetails.displayName string
ชื่อที่แสดงของช่องของผู้สนับสนุน
snippet.supporterDetails.profileImageUrl string
URL รูปโปรไฟล์สําหรับช่องของผู้สนับสนุน
snippet.commentText string
เนื้อหาข้อความในความคิดเห็นของผู้สนับสนุน
snippet.createdAt datetime
วันที่และเวลาที่เกิดเงินสนับสนุน ค่านี้ระบุในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ)
snippet.amountMicros unsigned long
จํานวนเงินที่มีส่วนร่วมในกิจกรรมการระดมทุน ค่าเป็นไมโครของสกุลเงินกองทุน เช่น หากผู้ให้ทุนสนับสนุน $1 ดอลลาร์ ($1) มูลค่าพร็อพเพอร์ตี้ snippet.amountMicros จะเป็น 1000000
snippet.currency string
สกุลเงินที่เชื่อมโยงกับจํานวนเงินทุน ค่าคือรหัสสกุลเงิน ISO 4217
snippet.displayString string
สตริงที่ใช้สําหรับการแสดงจํานวนเงินและสกุลเงิน หากคําขอ fanFundingEvents.list ระบุภาษาของแอปพลิเคชันที่มีพารามิเตอร์ hl ระบบจะแปลสตริงที่แสดงเป็นภาษานั้น เช่น ในภาษาอังกฤษ ระบบจะแสดงสกุลเงินเป็น $1.50 แต่ในภาษาฝรั่งเศสจะแสดงเป็น 1,50$