FanFundingEvents: list

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

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

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

ส่งคำขอ

คำขอ HTTP

GET https://www.googleapis.com/youtube/v3/fanFundingEvents

การให้สิทธิ์

คําขอนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขต (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtube.readonly

พารามิเตอร์

ตารางต่อไปนี้จะแสดงพารามิเตอร์ที่คําค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงคือพารามิเตอร์การค้นหา

พารามิเตอร์
พารามิเตอร์ที่จําเป็น
part string
พารามิเตอร์ part ระบุส่วนทรัพยากร fanFundingEvent ที่การตอบสนองของ API จะรวมอยู่ด้วย ค่าที่รองรับคือ id และ snippet
พารามิเตอร์ที่ไม่บังคับ
hl string
พารามิเตอร์ hl จะสั่งให้ API เรียกข้อมูลสตริงการแสดงสกุลเงินที่แปลสําหรับภาษาแอปพลิเคชันที่เฉพาะเจาะจงที่เว็บไซต์ YouTube รองรับ เช่น ในภาษาอังกฤษ ระบบจะแสดงสกุลเงินเป็น $1.50 แต่ในภาษาฝรั่งเศสจะแสดงเป็น 1,50$

ค่าพารามิเตอร์ต้องเป็นรหัสภาษาที่รวมอยู่ในรายการโดยเมธอด i18nLanguages.list
maxResults unsigned integer
พารามิเตอร์ maxResults จะระบุจํานวนรายการสูงสุดที่ควรแสดงผลในชุดผลลัพธ์ ค่าที่ยอมรับคือ 0 ถึง 50 ค่าเริ่มต้นคือ 5
pageToken string
พารามิเตอร์ pageToken จะระบุหน้าที่เจาะจงในชุดผลลัพธ์ที่มีการขอให้เซิร์ฟเวอร์ API แสดงผล ในการตอบกลับ API พร็อพเพอร์ตี้ nextPageToken จะระบุหน้าถัดไปของคําขอนั้น

เนื้อหาของคำขอ

ไม่ต้องให้เนื้อหาคําขอเมื่อเรียกใช้วิธีการนี้

คำตอบ

หากสําเร็จ วิธีนี้จะแสดงผลเนื้อหาการตอบกลับที่มีโครงสร้างต่อไปนี้

{
  "kind": "youtube#fanFundingEventListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    fanFundingEvent resource
  ]
}

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

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

พร็อพเพอร์ตี้
kind string
ระบุประเภทของทรัพยากร API ค่านี้จะเป็น youtube#fanFundingEventListResponse
etag etag
Etag ของทรัพยากรนี้
nextPageToken string
โทเค็นที่ใช้เป็นค่าของพารามิเตอร์ pageToken เพื่อดึงหน้าถัดไปในชุดผลลัพธ์ได้
pageInfo object
ออบเจ็กต์ pageInfo จะสรุปข้อมูลการแบ่งหน้าสําหรับชุดผลลัพธ์
pageInfo.totalResults integer
จํานวนผลลัพธ์ทั้งหมดในชุดผลลัพธ์
pageInfo.resultsPerPage integer
จํานวนผลลัพธ์ที่รวมอยู่ในการตอบกลับ API
items[] list
รายการเหตุการณ์การให้เงินสนับสนุนของแฟนๆ ที่ตรงกับเกณฑ์คําขอ

ข้อผิดพลาด

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงเพื่อตอบสนองต่อการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
forbidden (403) insufficientPermissions คุณไม่มีสิทธิ์ที่จําเป็นในการดูกิจกรรมการให้เงินสนับสนุนของแฟนๆ ของช่อง
invalidValue (400) fanFundingNotEnabledForChannelId ช่องนี้ไม่ได้เปิดใช้การให้เงินสนับสนุนของแฟนๆ

ลองใช้เลย

ใช้เครื่องมือสํารวจ API เพื่อใช้วิธีนี้ในข้อมูลสด รวมถึงดูคําขอและการตอบกลับ API