ทรัพยากร playlist
แสดงถึงเพลย์ลิสต์ YouTube เพลย์ลิสต์คือคอลเล็กชันวิดีโอที่สามารถดูต่อเนื่องและแชร์กับผู้ใช้คนอื่นๆ ได้ ตามค่าเริ่มต้น ผู้ใช้รายอื่นจะมองเห็นเพลย์ลิสต์ได้แบบสาธารณะ แต่เพลย์ลิสต์อาจเป็นแบบสาธารณะหรือส่วนตัวก็ได้
นอกจากนี้ YouTube ยังใช้เพลย์ลิสต์ในการระบุคอลเล็กชันพิเศษของวิดีโอสำหรับช่องด้วย เช่น
- วิดีโอที่อัปโหลด
- วิดีโอที่ได้รับคะแนนเชิงบวก (ชอบ)
channel resource
สำหรับช่องจากนั้นคุณสามารถใช้เมธอด
playlistItems.list
เพื่อเรียกข้อมูลรายการดังกล่าวได้ คุณยังเพิ่มหรือนำรายการออกจากรายการเหล่านั้นได้ด้วยการเรียกใช้เมธอด playlistItems.insert
และ playlistItems.delete
วิธีการ
API รองรับเมธอดต่อไปนี้สำหรับทรัพยากร playlists
รายการ
- list
- แสดงผลคอลเล็กชันเพลย์ลิสต์ที่ตรงกับพารามิเตอร์คำขอ API เช่น คุณเรียกข้อมูลเพลย์ลิสต์ทั้งหมดของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วได้ หรือดึงเพลย์ลิสต์อย่างน้อย 1 รายการตามรหัสที่ไม่ซ้ำกันของเพลย์ลิสต์ได้ ลองใช้เลย
- แทรก
- สร้างเพลย์ลิสต์ ลองใช้เลย
- อัปเดต
- แก้ไขเพลย์ลิสต์ เช่น คุณอาจเปลี่ยนชื่อ คำอธิบาย หรือสถานะความเป็นส่วนตัวของเพลย์ลิสต์ ลองใช้เลย
- ลบ
- ลบเพลย์ลิสต์ ลองใช้เลย
การนำเสนอทรัพยากร
โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร playlists
{ "kind": "youtube#playlist", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "defaultLanguage": string, "localized": { "title": string, "description": string } }, "status": { "privacyStatus": string }, "contentDetails": { "itemCount": unsigned integer }, "player": { "embedHtml": string }, "localizations": { (key): { "title": string, "description": string } } }
พร็อพเพอร์ตี้
ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
พร็อพเพอร์ตี้ | |
---|---|
kind |
string ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#playlist |
etag |
etag Etag ของแหล่งข้อมูลนี้ |
id |
string รหัสที่ YouTube ใช้เพื่อระบุเพลย์ลิสต์โดยไม่ซ้ำกัน |
snippet |
object ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับเพลย์ลิสต์ เช่น ชื่อและคำอธิบาย |
snippet.publishedAt |
datetime วันที่และเวลาที่สร้างเพลย์ลิสต์ ค่าจะระบุไว้ในรูปแบบ ISO 8601 |
snippet.channelId |
string รหัสที่ YouTube ใช้เพื่อระบุช่องที่เผยแพร่เพลย์ลิสต์โดยไม่ซ้ำกัน |
snippet.title |
string ชื่อเพลย์ลิสต์ |
snippet.description |
string คำอธิบายเพลย์ลิสต์ |
snippet.thumbnails |
object แผนที่ภาพขนาดย่อที่เชื่อมโยงกับเพลย์ลิสต์ สำหรับวัตถุแต่ละรายการในแผนที่ คีย์คือชื่อของภาพขนาดย่อ และค่าคือวัตถุที่มีข้อมูลอื่นๆ เกี่ยวกับภาพขนาดย่อ |
snippet.thumbnails.(key) |
object คีย์-ค่าที่ใช้ได้มีดังนี้
|
snippet.thumbnails.(key).url |
string URL ของรูปภาพ |
snippet.thumbnails.(key).width |
unsigned integer ความกว้างของรูปภาพ |
snippet.thumbnails.(key).height |
unsigned integer ความสูงของรูปภาพ |
snippet.channelTitle |
string ชื่อช่องของวิดีโอ |
snippet.tags[] |
list เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว แท็กคีย์เวิร์ดที่เชื่อมโยงกับเพลย์ลิสต์ |
snippet.defaultLanguage |
string ภาษาของข้อความในพร็อพเพอร์ตี้ snippet.title และ snippet.description ของทรัพยากร playlist |
snippet.localized |
object ออบเจ็กต์ snippet.localized มีชื่อและคำอธิบายที่แปลแล้วสำหรับเพลย์ลิสต์ หรือชื่อในภาษาเริ่มต้นสำหรับข้อมูลเมตาของเพลย์ลิสต์
localizations เพื่อเพิ่ม อัปเดต หรือลบชื่อที่แปลแล้ว |
snippet.localized.title |
string ชื่อเพลย์ลิสต์ที่แปลแล้ว |
snippet.localized.description |
string คำอธิบายเพลย์ลิสต์ที่มีการแปลภาษา |
status |
object ออบเจ็กต์ status มีข้อมูลสถานะของเพลย์ลิสต์ |
status.privacyStatus |
string สถานะความเป็นส่วนตัวของเพลย์ลิสต์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails |
object ออบเจ็กต์ contentDetails มีข้อมูลเกี่ยวกับเนื้อหาเพลย์ลิสต์ รวมถึงจำนวนวิดีโอในเพลย์ลิสต์ |
contentDetails.itemCount |
unsigned integer จำนวนวิดีโอในเพลย์ลิสต์ |
player |
object ออบเจ็กต์ player มีข้อมูลที่คุณจะใช้เล่นเพลย์ลิสต์ในโปรแกรมเล่นแบบฝัง |
player.embedHtml |
string แท็ก <iframe> ที่ฝังโปรแกรมเล่นซึ่งจะเล่นเพลย์ลิสต์ |
localizations |
object ออบเจ็กต์ localizations สรุปคำแปลของข้อมูลเมตาของเพลย์ลิสต์ |
localizations.(key) |
object ภาษาของข้อความที่แปลแล้วที่เชื่อมโยงกับคีย์-ค่า ค่าเป็นสตริงที่มีรหัสภาษา BCP-47 |
localizations.(key).title |
string ชื่อเพลย์ลิสต์ที่แปลแล้ว |
localizations.(key).description |
string คำอธิบายเพลย์ลิสต์ที่มีการแปลภาษา |