ผลการค้นหาจะมีข้อมูลเกี่ยวกับวิดีโอ ช่อง หรือเพลย์ลิสต์ YouTube ที่ตรงกับพารามิเตอร์การค้นหาที่ระบุไว้ในคำขอ API แม้ว่าผลการค้นหาจะชี้ไปยังทรัพยากรที่ระบุตัวตนได้อย่างแน่ชัด เช่น วิดีโอ แต่จะไม่มีข้อมูลถาวรเป็นของตัวเอง
วิธีการ
API รองรับวิธีการค้นหาต่อไปนี้
การนำเสนอทรัพยากร
โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของผลการค้นหา
{ "kind": "youtube#searchResult", "etag": etag, "id": { "kind": string, "videoId": string, "channelId": string, "playlistId": string }, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "liveBroadcastContent": string } }
พร็อพเพอร์ตี้
ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่จะปรากฏในผลการค้นหา
พร็อพเพอร์ตี้ | |
---|---|
kind |
string ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#searchResult |
etag |
etag Etag ของแหล่งข้อมูลนี้ |
id |
object ออบเจ็กต์ id มีข้อมูลที่ใช้ระบุทรัพยากรที่ตรงกับคำขอการค้นหาได้โดยไม่ซ้ำกัน |
id.kind |
string ประเภทของทรัพยากร API |
id.videoId |
string หากค่าของพร็อพเพอร์ตี้ id.type คือ youtube#video พร็อพเพอร์ตี้นี้จะปรากฏ โดยค่าของพร็อพเพอร์ตี้จะมีรหัสที่ YouTube ใช้เพื่อระบุวิดีโอที่ตรงกับคำค้นหาโดยไม่ซ้ำกัน |
id.channelId |
string หากค่าของพร็อพเพอร์ตี้ id.type คือ youtube#channel พร็อพเพอร์ตี้นี้จะปรากฏ โดยค่าของพร็อพเพอร์ตี้จะมีรหัสที่ YouTube ใช้เพื่อระบุช่องที่ตรงกับคำค้นหาโดยไม่ซ้ำกัน |
id.playlistId |
string หากค่าของพร็อพเพอร์ตี้ id.type คือ youtube#playlist พร็อพเพอร์ตี้นี้จะปรากฏ โดยค่าของพร็อพเพอร์ตี้จะมีรหัสที่ 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.liveBroadcastContent |
string ตัวบ่งชี้ว่าทรัพยากร video หรือ channel มีเนื้อหาการถ่ายทอดสด ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ upcoming , live และ none สำหรับทรัพยากร video ค่า upcoming บ่งชี้ว่าวิดีโอเป็นการถ่ายทอดสดที่ยังไม่เริ่ม ในขณะที่ค่า live หมายถึงวิดีโอเป็นการถ่ายทอดสดที่ทำงานอยู่ สำหรับทรัพยากร channel ค่า upcoming บ่งชี้ว่าช่องมีการถ่ายทอดสดตามกำหนดการที่ยังไม่เริ่ม ในขณะที่ค่า live หมายความว่าช่องมีการถ่ายทอดสดที่ทำงานอยู่ |