ทรัพยากรของ 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 คําอธิบายเพลย์ลิสต์ที่แปลแล้ว |