Playlists

ทรัพยากรของ 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
ค่าคีย์ที่ถูกต้องคือ
  • default – ภาพขนาดย่อเริ่มต้น ภาพขนาดย่อเริ่มต้นสําหรับวิดีโอหรือทรัพยากรที่อ้างอิงถึงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา มีความกว้าง 120 พิกเซลและสูง 90 พิกเซล ภาพขนาดย่อเริ่มต้นของช่องมีความกว้าง 88 พิกเซลและสูง 88 พิกเซล
  • medium – ภาพขนาดย่อที่มีความละเอียดสูงกว่า สําหรับวิดีโอ (หรือทรัพยากรที่อ้างอิงถึงวิดีโอ) รูปภาพนี้จะมีความกว้าง 320 พิกเซลและสูง 180 พิกเซล สําหรับช่อง รูปภาพนี้จะมีความกว้าง 240 พิกเซลและสูง 240 พิกเซล
  • high – ภาพขนาดย่อที่มีความละเอียดสูง สําหรับวิดีโอ (หรือทรัพยากรที่อ้างอิงถึงวิดีโอ) รูปภาพนี้กว้าง 480 พิกเซลและสูง 360 พิกเซล สําหรับช่องหนึ่งๆ รูปภาพนี้จะมีความกว้าง 800 พิกเซลและสูง 800 พิกเซล
  • standard – ภาพขนาดย่อที่มีความละเอียดสูงกว่ารูปภาพความละเอียด high รูปภาพนี้พร้อมใช้งานสําหรับวิดีโอบางรายการและแหล่งข้อมูลอื่นๆ ที่อ้างอิงถึงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 640 พิกเซลและสูง 480 พิกเซล
  • maxres – ภาพขนาดย่อที่มีความละเอียดสูงสุด ขนาดรูปภาพนี้ใช้ได้กับวิดีโอบางรายการและทรัพยากรอื่นๆ ที่อ้างอิงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 1280 พิกเซล และสูง 720 พิกเซล
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 จะมีชื่อและคําอธิบายที่แปลแล้วสําหรับเพลย์ลิสต์ หรือมีชื่อในภาษาเริ่มต้นสําหรับข้อมูลเมตาของเพลย์ลิสต์
  • ระบบจะแสดงผลข้อความที่แปลแล้วในข้อมูลโค้ดของทรัพยากรหากคําขอ playlists.list ใช้พารามิเตอร์ hl เพื่อระบุภาษาที่ควรจะแสดงข้อความที่แปลแล้วและข้อความที่แปลเป็นภาษาดังกล่าว
  • ระบบจะแสดงผลข้อมูลเมตาสําหรับภาษาเริ่มต้นหากไม่ได้ระบุค่าพารามิเตอร์ hl หรือ ระบุค่า แต่ไม่สามารถใช้ข้อมูลเมตาที่แปลแล้วสําหรับภาษาที่ระบุ
พร็อพเพอร์ตี้มีค่าแบบอ่านอย่างเดียว ใช้ออบเจ็กต์ localizations เพื่อเพิ่ม อัปเดต หรือลบชื่อที่แปลแล้ว
snippet.localized.title string
ชื่อเพลย์ลิสต์ที่แปลแล้ว
snippet.localized.description string
คําอธิบายเพลย์ลิสต์ที่แปลแล้ว
status object
ออบเจ็กต์ status มีข้อมูลสถานะของเพลย์ลิสต์
status.privacyStatus string
สถานะความเป็นส่วนตัวของเพลย์ลิสต์

ค่าที่ถูกต้องสําหรับพร็อพเพอร์ตี้นี้คือ
  • private
  • public
  • unlisted
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
คําอธิบายเพลย์ลิสต์ที่แปลแล้ว