Search

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

เมธอด

API รองรับวิธีการต่อไปนี้สำหรับการค้นหา

list

แสดงผลคอลเล็กชันของผลการค้นหาที่ตรงกับพารามิเตอร์การค้นหาที่ระบุในคำขอ API โดยค่าเริ่มต้น ชุดผลการค้นหาจะระบุทรัพยากร video, channel และ playlist ที่ตรงกัน แต่คุณยังกำหนดค่าการค้นหาให้ดึงข้อมูลทรัพยากรประเภทใดประเภทหนึ่งเท่านั้นได้ด้วย ลองใช้เลย

การแสดงทรัพยากร

โครงสร้าง 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 ค่าคีย์ที่ใช้ได้มีดังนี้ default - รูปภาพขนาดย่อเริ่มต้น ภาพปกเริ่มต้นสำหรับวิดีโอหรือแหล่งข้อมูลที่อ้างอิงถึงวิดีโอ เช่น รายการในเพลย์ลิสต์หรือผลการค้นหา จะมีความกว้าง 120 พิกเซลและความสูง 90 พิกเซล ภาพปกเริ่มต้นของช่องมีความกว้าง 88 พิกเซลและความสูง 88 พิกเซล medium - รูปภาพขนาดย่อเวอร์ชันที่มีความละเอียดสูงกว่า สำหรับวิดีโอ (หรือแหล่งข้อมูลที่อ้างอิงถึงวิดีโอ) รูปภาพนี้มีความกว้าง 320 พิกเซลและความสูง 180 พิกเซล สำหรับช่อง รูปภาพนี้จะมีความกว้าง 240 พิกเซลและสูง 240 พิกเซล high – รูปภาพปกเวอร์ชันความละเอียดสูง สำหรับวิดีโอ (หรือแหล่งข้อมูลที่อ้างอิงถึงวิดีโอ) รูปภาพนี้มีความกว้าง 480 พิกเซลและความสูง 360 พิกเซล สำหรับช่อง รูปภาพนี้จะมีความกว้าง 800 พิกเซลและความสูง 800 พิกเซล standard - รูปภาพขนาดย่อเวอร์ชันที่มีความละเอียดสูงกว่ารูปภาพความละเอียด high รูปภาพนี้พร้อมใช้งานสำหรับวิดีโอบางรายการและแหล่งข้อมูลอื่นๆ ที่อ้างอิงถึงวิดีโอ เช่น รายการในเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 640 พิกเซลและสูง 480 พิกเซล maxres - รูปภาพขนาดย่อเวอร์ชันที่มีความละเอียดสูงสุด ขนาดรูปภาพนี้ใช้ได้กับวิดีโอบางรายการและแหล่งข้อมูลอื่นๆ ที่อ้างอิงถึงวิดีโอ เช่น รายการในเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้มีความกว้าง 1280 พิกเซลและความสูง 720 พิกเซล หมายเหตุ: ผลการค้นหาไม่รองรับภาพปก 1080p+ (fhd, qhd และ uhd) หากต้องการดึงข้อมูลภาพปกที่มีความละเอียดสูงขึ้น ให้เรียกใช้ปลายทางเฉพาะทรัพยากร (เช่น videos.list) โดยใช้รหัสของทรัพยากร
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 หมายความว่าช่องมี การถ่ายทอดสด ที่กำลังเผยแพร่