API Reference

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

คู่มืออ้างอิงนี้จะอธิบายวิธีใช้ API เพื่อดําเนินการทั้งหมดเหล่านี้ คู่มือจะจัดเรียงตามประเภททรัพยากร ทรัพยากรคือประเภทของรายการที่รวมอยู่ในประสบการณ์การใช้งาน YouTube เช่น วิดีโอ เพลย์ลิสต์ หรือการติดตาม สําหรับทรัพยากรแต่ละประเภท คําแนะนําจะแสดงรายการข้อมูลอย่างน้อย 1 รายการ และแหล่งข้อมูลจะแสดงเป็นออบเจ็กต์ JSON คู่มือนี้แสดงวิธีที่รองรับอย่างน้อย 1 วิธี (LIST, POST, DELETE ฯลฯ) สําหรับทรัพยากรแต่ละประเภทและอธิบายวิธีใช้เมธอดเหล่านั้นในแอปพลิเคชัน

การเรียก API

ข้อกําหนดต่อไปนี้ใช้กับคําขอ YouTube Data API

  1. คําขอทั้งหมดต้องระบุคีย์ API (ที่มีพารามิเตอร์ key) หรือระบุโทเค็น OAuth 2.0 คีย์ API ของคุณอยู่ในแผงการเข้าถึง API ของ Developer Console สําหรับโปรเจ็กต์ของคุณ

  2. คุณต้องส่งโทเค็นการให้สิทธิ์สําหรับการแทรก อัปเดต และลบคําขอทุกรายการ นอกจากนี้ คุณจะต้องส่งโทเค็นการให้สิทธิ์สําหรับคําขอที่ดึงข้อมูลส่วนตัวของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วด้วย

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

  3. API รองรับโปรโตคอลการตรวจสอบสิทธิ์ OAuth 2.0 คุณมอบโทเค็น OAuth 2.0 ได้ด้วยวิธีใดวิธีหนึ่งต่อไปนี้

    • ใช้พารามิเตอร์การค้นหา access_token ดังนี้ ?access_token=oauth2-token
    • ใช้ส่วนหัว HTTP Authorization ดังนี้ Authorization: Bearer oauth2-token

    ดูวิธีการนําการตรวจสอบสิทธิ์ OAuth 2.0 ไปใช้ในแอปพลิเคชันได้จากคู่มือการตรวจสอบสิทธิ์

ประเภททรัพยากร

กิจกรรม

แหล่งข้อมูล activity มีข้อมูลเกี่ยวกับการกระทําที่ช่องหรือผู้ใช้หนึ่งๆ ได้ดําเนินการบน YouTube การดําเนินการที่รายงานในฟีดกิจกรรม ได้แก่ การให้คะแนนวิดีโอ การแชร์วิดีโอ การทําเครื่องหมายวิดีโอเป็นรายการโปรด การอัปโหลดวิดีโอ ฯลฯ ทรัพยากรแต่ละรายการของ activity จะระบุประเภทของการดําเนินการ ช่องที่เชื่อมโยงกับการดําเนินการ และทรัพยากรที่เชื่อมโยงกับการดําเนินการ เช่น วิดีโอที่ได้รับการจัดประเภทหรืออัปโหลด

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /activities แสดงผลรายการกิจกรรมของช่องที่ตรงกับเกณฑ์คําขอ ตัวอย่างเช่น คุณเรียกดูเหตุการณ์ที่เชื่อมโยงกับช่องใดช่องหนึ่งหรือกับช่องของผู้ใช้ได้
insert POST /activities หมายเหตุ: เราเลิกใช้งานวิธีการนี้แล้วและจะไม่ให้การสนับสนุนอีกต่อไป

คำบรรยายวิดีโอ

ทรัพยากร caption แสดงถึงแทร็กคําบรรยายวิดีโอ YouTube แทร็กคําบรรยายเชื่อมโยงกับวิดีโอ YouTube รายการเดียว

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
delete DELETE /captions ลบแทร็กคําบรรยายวิดีโอที่ระบุ
download GET /captions/id ดาวน์โหลดแทร็กคําบรรยายวิดีโอ ระบบจะแสดงผลแทร็กคําบรรยายวิดีโอในรูปแบบต้นฉบับ เว้นแต่ว่าคําขอจะระบุค่าของพารามิเตอร์ tfmt และในภาษาเดิม เว้นแต่ว่าคําขอจะระบุค่าของพารามิเตอร์ tlang
insert POST /captions อัปโหลดแทร็กคําบรรยายวิดีโอ
list GET /captions แสดงผลรายการแทร็กคําบรรยายที่เชื่อมโยงกับวิดีโอที่ระบุ โปรดทราบว่าการตอบกลับ API ไม่มีคําบรรยายวิดีโอจริง และวิธี captions.download ช่วยให้เรียกดูแทร็กคําบรรยายวิดีโอได้
update PUT /captions อัปเดตแทร็กคําบรรยายวิดีโอ เมื่ออัปเดตแทร็กคําบรรยายวิดีโอ คุณสามารถเปลี่ยนสถานะแบบร่างของแทร็กได้ อัปโหลดไฟล์คําบรรยายวิดีโอใหม่สําหรับแทร็ก หรือทั้ง 2 อย่าง

แบนเนอร์ของช่อง

ทรัพยากร channelBanner มี URL ที่คุณจะใช้ตั้งค่ารูปภาพที่อัปโหลดใหม่เป็นรูปภาพแบนเนอร์ของช่อง

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
insert POST /channelBanners/insert อัปโหลดรูปภาพแบนเนอร์ของช่องไปยัง YouTube วิธีนี้แสดง 2 ขั้นตอนแรกในกระบวนการ 3 ขั้นตอนเพื่ออัปเดตรูปภาพแบนเนอร์สําหรับช่อง

  1. เรียกเมธอด channelBanners.insert เพื่ออัปโหลดข้อมูลรูปภาพไบนารีไปยัง YouTube รูปภาพต้องมีอัตราส่วน 16:9 และมีขนาดอย่างน้อย 2048x1152 พิกเซล เราขอแนะนําให้อัปโหลดรูปภาพขนาด 2560 x 1440 พิกเซล
  2. ดึงค่าของพร็อพเพอร์ตี้ url จากการตอบกลับที่ API แสดงในขั้นตอนที่ 1
  3. เรียกใช้เมธอด channels.update เพื่ออัปเดตการตั้งค่าการสร้างแบรนด์ของช่อง ตั้งค่าพร็อพเพอร์ตี้ brandingSettings.image.bannerExternalUrl เป็น URL ที่ได้รับในขั้นตอนที่ 2

ส่วนช่อง

ทรัพยากร channelSection มีข้อมูลเกี่ยวกับชุดวิดีโอที่ช่องเลือกที่จะแสดง เช่น ส่วนอาจแสดงการอัปโหลดล่าสุดของช่อง การอัปโหลดยอดนิยม หรือวิดีโอจากเพลย์ลิสต์อย่างน้อย 1 รายการ

โปรดทราบว่าส่วนนี้จะแสดงช่องก็ต่อเมื่อเนื้อหาแสดงในมุมมองการเรียกดู (ไม่ใช่มุมมองฟีด) หากต้องการอนุญาตให้ช่องแสดงเนื้อหาในมุมมองการเรียกดู ให้ตั้งค่าพร็อพเพอร์ตี้ brandingSettings.channel.showBrowseView เป็น true สําหรับช่องที่ระบุ

ช่องสามารถสร้างชั้นวางได้สูงสุด 10 ชั้นวาง

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
delete DELETE /channelSections ลบส่วนช่อง
insert POST /channelSections เพิ่มส่วนช่องในช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว ช่องหนึ่งสามารถสร้างชั้นวางได้สูงสุด 10 ชั้นวาง
list GET /channelSections แสดงผลรายการทรัพยากร channelSection ที่ตรงกับเกณฑ์คําขอ API
update PUT /channelSections อัปเดตส่วนช่อง

ช่อง

แหล่งข้อมูล channel มีข้อมูลเกี่ยวกับช่อง YouTube

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /channels แสดงผลคอลเล็กชันทรัพยากร channel อย่างน้อย 1 รายการที่ตรงกับเกณฑ์คําขอ
update PUT /channels อัปเดตข้อมูลเมตาของช่อง โปรดทราบว่าปัจจุบันวิธีการนี้รองรับเฉพาะการอัปเดตออบเจ็กต์ brandingSettings และ invideoPromotion ของทรัพยากร channel รวมถึงพร็อพเพอร์ตี้ย่อยเท่านั้น

ชุดข้อความของความคิดเห็น

ทรัพยากร commentThread มีข้อมูลเกี่ยวกับชุดความคิดเห็นของ YouTube ซึ่งประกอบด้วยความคิดเห็นและการตอบกลับระดับบนสุด หากมี ทรัพยากร commentThread แสดงถึงความคิดเห็นเกี่ยวกับวิดีโอหรือช่องได้

ทั้งความคิดเห็นระดับบนสุดและการตอบกลับคือทรัพยากร comment ที่ฝังอยู่ภายในทรัพยากร commentThread ทรัพยากร commentThread ไม่จําเป็นต้องตอบกลับความคิดเห็นทั้งหมด และคุณต้องใช้เมธอด comments.list หากต้องการเรียกการตอบกลับทั้งหมดสําหรับความคิดเห็นหนึ่งๆ โปรดทราบว่าความคิดเห็นบางรายการไม่มีการตอบกลับ

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /commentThreads แสดงผลรายการชุดข้อความความคิดเห็นที่ตรงกับพารามิเตอร์คําขอ API
insert POST /commentThreads สร้างความคิดเห็นระดับบนสุดใหม่ หากต้องการเพิ่มการตอบกลับความคิดเห็นที่มีอยู่ ให้ใช้เมธอด comments.insert แทน

ความคิดเห็น

แหล่งข้อมูล comment มีข้อมูลเกี่ยวกับความคิดเห็นบน YouTube รายการเดียว ทรัพยากร comment แสดงถึงความคิดเห็นเกี่ยวกับวิดีโอหรือช่องได้ นอกจากนี้ ความคิดเห็นอาจเป็นความคิดเห็นระดับบนสุดหรือการตอบกลับความคิดเห็นระดับบนสุดก็ได้

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /comments แสดงผลรายการความคิดเห็นที่ตรงกับพารามิเตอร์คําขอ API
setModerationStatus POST /comments/setModerationStatus ตั้งค่าสถานะการตรวจสอบความคิดเห็นอย่างน้อย 1 รายการ คําขอของช่อง API ต้องได้รับสิทธิ์จากเจ้าของช่องหรือวิดีโอที่เชื่อมโยงกับความคิดเห็น
insert POST /comments สร้างการตอบกลับความคิดเห็นที่มีอยู่ หมายเหตุ: หากต้องการสร้างความคิดเห็นระดับบนสุด ให้ใช้เมธอด commentThreads.insert
markAsSpam POST /comments/markAsSpam แสดงความคิดเห็นของผู้โทรว่าความคิดเห็นอย่างน้อย 1 รายการควรถูกทําเครื่องหมายว่าเป็นสแปม
delete DELETE /comments ลบความคิดเห็น
update PUT /comments แก้ไขความคิดเห็น

หมวดหมู่คําแนะนํา

ทรัพยากร guideCategory จะระบุหมวดหมู่ที่อัลกอริทึมของ YouTube กําหนดตามเนื้อหาหรือตัวบ่งชี้อื่นๆ ของช่อง เช่น ความนิยมของช่อง รายการนี้คล้ายกับหมวดหมู่วิดีโอ โดยมีความแตกต่างว่าผู้อัปโหลดวิดีโอจะกําหนดหมวดหมู่วิดีโอได้ แต่มีเพียง YouTube เท่านั้นที่จะกําหนดหมวดหมู่ของช่องได้

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /guideCategories แสดงผลรายการหมวดหมู่ที่เชื่อมโยงกับช่อง YouTube ได้

I18nlanguage

ทรัพยากรของ i18nLanguage จะระบุภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ ภาษาของแอปพลิเคชันอาจเรียกว่าภาษา UI ได้เช่นกัน สําหรับเว็บไซต์ YouTube อาจมีการเลือกภาษาของแอปพลิเคชันโดยอัตโนมัติตามการตั้งค่าบัญชี Google, ภาษาของเบราว์เซอร์ หรือตําแหน่ง IP นอกจากนี้ผู้ใช้ยังเลือกภาษาสําหรับ UI ที่ต้องการจากส่วนท้ายของเว็บไซต์ YouTube ด้วยตนเองได้อีกด้วย

ทรัพยากร i18nLanguage แต่ละรายการจะระบุรหัสภาษาและชื่อ สามารถใช้รหัสภาษาเป็นค่าของพารามิเตอร์ hl เมื่อเรียกใช้เมธอด API เช่น videoCategories.list และ guideCategories.list

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /i18nLanguages แสดงรายการภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ

I18nภูมิภาค

ทรัพยากร i18nRegion จะระบุพื้นที่ทางภูมิศาสตร์ที่ผู้ใช้ YouTube เลือกเป็นภูมิภาคเนื้อหาที่ต้องการได้ ภูมิภาคของเนื้อหายังเรียกว่าภาษาของเนื้อหาได้อีกด้วย สําหรับเว็บไซต์ YouTube อาจมีการเลือกเขตเนื้อหาโดยอัตโนมัติโดยพิจารณาจากฮิวริสติก เช่น โดเมน YouTube หรือตําแหน่ง IP ของผู้ใช้ ผู้ใช้ยังเลือกภูมิภาคของเนื้อหาที่ต้องการจากส่วนท้ายของเว็บไซต์ YouTube ด้วยตนเองได้ด้วย

ทรัพยากร i18nRegion แต่ละรายการจะระบุรหัสภูมิภาคและชื่อ รหัสภูมิภาคสามารถใช้เป็นค่าของพารามิเตอร์ regionCode เมื่อเรียกใช้เมธอด API เช่น search.list, videos.list, activities.list และ videoCategories.list

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /i18nRegions แสดงผลรายการภูมิภาคของเนื้อหาที่เว็บไซต์ YouTube รองรับ

สมาชิก

ทรัพยากร member แสดงถึงสมาชิกของช่องสําหรับช่อง YouTube สมาชิกจะให้การสนับสนุนทางการเงินแก่ครีเอเตอร์ตามรอบและรับสิทธิประโยชน์พิเศษ เช่น สมาชิกจะแชทได้เมื่อครีเอเตอร์เปิดโหมดแชทสําหรับสมาชิกเท่านั้น

ดูข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ได้ที่การแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /members รายชื่อสมาชิกของช่อง (ก่อนหน้านี้เรียกว่า "ผู้สนับสนุน") สําหรับช่อง เจ้าของช่องต้องเป็นผู้อนุญาตคําขอ API

ระดับการเป็นสมาชิก

ทรัพยากร membershipsLevel จะระบุระดับการกําหนดราคาสําหรับครีเอเตอร์ที่ให้สิทธิ์คําขอ API

ดูข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ได้ที่การแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /membershipsLevels แสดงผลคอลเล็กชันทรัพยากร membershipsLevel อย่างน้อย 1 รายการที่เป็นของช่องที่ให้สิทธิ์คําขอ API ระดับจะแสดงตามลําดับการแสดงโดยนัย

รายการเพลย์ลิสต์

ทรัพยากร playlistItem จะระบุทรัพยากรอื่น เช่น วิดีโอ รวมอยู่ในเพลย์ลิสต์ นอกจากนี้ ทรัพยากรของ playlistItem มีรายละเอียดเกี่ยวกับทรัพยากรที่รวมซึ่งเกี่ยวข้องกับวิธีการใช้ทรัพยากรดังกล่าวในเพลย์ลิสต์ดังกล่าวโดยเฉพาะ

YouTube ยังใช้เพลย์ลิสต์เพื่อระบุรายชื่อวิดีโอที่อัปโหลดของช่อง โดย playlistItem แต่ละรายการในลิสต์นั้นแสดงถึงวิดีโอที่อัปโหลด 1 รายการ คุณดึงรหัสเพลย์ลิสต์ของรายการดังกล่าวจาก channel resource สําหรับช่องนั้นๆ ได้ จากนั้นคุณจะใช้เมธอด playlistItems.list กับรายการดังกล่าวได้

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
delete DELETE /playlistItems ลบรายการเพลย์ลิสต์
insert POST /playlistItems เพิ่มทรัพยากรลงในเพลย์ลิสต์
list GET /playlistItems แสดงคอลเล็กชันรายการเพลย์ลิสต์ที่ตรงกับพารามิเตอร์คําขอ API คุณสามารถเรียกดูรายการเพลย์ลิสต์ทั้งหมดในเพลย์ลิสต์ที่ระบุ หรือเรียกรายการเพลย์ลิสต์อย่างน้อย 1 รายการตามรหัสที่ไม่ซ้ํากัน
update PUT /playlistItems แก้ไขรายการเพลย์ลิสต์ เช่น อัปเดตตําแหน่งของรายการในเพลย์ลิสต์

เพลย์ลิสต์

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

YouTube ยังใช้เพลย์ลิสต์เพื่อระบุคอลเล็กชันวิดีโอพิเศษสําหรับช่อง เช่น

  • วิดีโอที่อัปโหลด
  • วิดีโอเชิงบวก (กดชอบ) ในเชิงบวก
  • ประวัติการดู
  • ดูภายหลัง
รายการนี้มีความเชื่อมโยงกับช่องโดยเฉพาะ ซึ่งเป็นคอลเล็กชันของวิดีโอ กลุ่ม หรือบริษัท วิดีโอ หรือเพลย์ลิสต์อื่นๆ ของบริษัท กลุ่ม หรือบริษัท คุณดึงรหัสเพลย์ลิสต์ของแต่ละรายการได้จาก channel resource สําหรับช่องที่กําหนด

จากนั้นจึงใช้วิธี playlistItems.list เพื่อเรียกข้อมูลรายการเหล่านั้น คุณยังสามารถเพิ่มหรือนํารายการออกจากรายการเหล่านั้นได้ด้วยการเรียกเมธอด playlistItems.insert และ playlistItems.delete

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
delete DELETE /playlists ลบเพลย์ลิสต์
list GET /playlists แสดงคอลเล็กชันเพลย์ลิสต์ที่ตรงกับพารามิเตอร์คําขอ API ตัวอย่างเช่น คุณสามารถเรียกดูเพลย์ลิสต์ทั้งหมดที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์เป็นเจ้าของ หรือสามารถเรียกดูเพลย์ลิสต์อย่างน้อย 1 รายการตามรหัสที่ไม่ซ้ํากัน
insert POST /playlists สร้างเพลย์ลิสต์
update PUT /playlists แก้ไขเพลย์ลิสต์ ตัวอย่างเช่น คุณสามารถเปลี่ยนชื่อเพลย์ลิสต์ คําอธิบาย หรือสถานะความเป็นส่วนตัว

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

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /search แสดงคอลเล็กชันผลการค้นหาที่ตรงกับพารามิเตอร์การค้นหาที่ระบุในคําขอ API โดยค่าเริ่มต้น ชุดผลการค้นหาจะระบุทรัพยากร video, channel และ playlist ที่ตรงกัน แต่คุณสามารถกําหนดค่าการค้นหาให้ดึงเฉพาะทรัพยากรประเภทที่ต้องการได้

การสมัครใช้บริการ

แหล่งข้อมูล subscription มีข้อมูลเกี่ยวกับการติดตามผู้ใช้ YouTube การสมัครใช้บริการจะแจ้งให้ผู้ใช้ทราบเมื่อมีการเพิ่มวิดีโอใหม่ๆ ลงในช่อง หรือเมื่อผู้ใช้อื่นดําเนินการอย่างใดอย่างหนึ่งบน YouTube เช่น อัปโหลดวิดีโอ จัดประเภทวิดีโอ หรือแสดงความคิดเห็นในวิดีโอ

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
delete DELETE /subscriptions ลบการสมัครใช้บริการ
insert POST /subscriptions เพิ่มการสมัครใช้บริการสําหรับช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
list GET /subscriptions แสดงทรัพยากรการสมัครใช้บริการที่ตรงกับเกณฑ์คําขอ API

ภาพปก

ทรัพยากร thumbnail ระบุขนาดภาพขนาดย่อที่แตกต่างกันที่เชื่อมโยงกับทรัพยากร โปรดคํานึงถึงลักษณะเฉพาะของภาพขนาดย่อต่อไปนี้

  • พร็อพเพอร์ตี้ snippet.thumbnails ของทรัพยากรคือออบเจ็กต์ที่ระบุภาพขนาดย่อของภาพขนาดย่อสําหรับทรัพยากรนั้น
  • ทรัพยากร thumbnail มีชุดออบเจ็กต์ ชื่อของออบเจ็กต์แต่ละรายการ (default, medium, high ฯลฯ) หมายถึงขนาดภาพขนาดย่อ
  • ทรัพยากรประเภทต่างๆ อาจรองรับภาพขนาดย่อขนาดต่างๆ
  • แหล่งข้อมูลประเภทต่างๆ อาจกําหนดขนาดที่แตกต่างกันสําหรับภาพขนาดย่อที่มีชื่อเดียวกัน ตัวอย่างเช่น ภาพขนาดย่อของ default สําหรับทรัพยากร video มักจะเท่ากับ 120 x 90 พิกเซล และภาพขนาดย่อของ default สําหรับทรัพยากร channel มักจะอยู่ที่ 88 x 88 พิกเซล
  • แหล่งข้อมูลประเภทเดียวกันอาจยังมีขนาดภาพขนาดย่อที่แตกต่างกันสําหรับบางรูปภาพ ขึ้นอยู่กับความละเอียดของรูปภาพต้นฉบับหรือเนื้อหาที่อัปโหลดไปยัง YouTube เช่น วิดีโอ HD อาจรองรับภาพขนาดย่อที่มีความละเอียดสูงกว่าวิดีโอที่ไม่ใช่ HD
  • ออบเจ็กต์แต่ละรายการที่มีข้อมูลเกี่ยวกับขนาดของภาพขนาดย่อจะมีพร็อพเพอร์ตี้ width และพร็อพเพอร์ตี้ height อย่างไรก็ตาม ระบบอาจไม่แสดงผลคุณสมบัติความกว้างและความสูงสําหรับรูปภาพนั้น
  • หากภาพขนาดย่อที่อัปโหลดไม่ตรงกับขนาดที่กําหนด ระบบจะปรับขนาดรูปภาพให้ตรงกับขนาดที่ถูกต้องโดยไม่เปลี่ยนสัดส่วนภาพ รูปภาพไม่ได้ถูกครอบตัด แต่อาจมีแถบสีดําเพื่อให้ขนาดถูกต้อง

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
set POST /thumbnails/set อัปโหลดภาพปกวิดีโอที่กําหนดเองไปยัง YouTube และตั้งค่าสําหรับวิดีโอ

เหตุผลที่รายงานการละเมิดวิดีโอ

แหล่งข้อมูล videoAbuseReportReason มีข้อมูลเกี่ยวกับเหตุผลที่วิดีโอจะได้รับการแจ้งว่ามีเนื้อหาไม่เหมาะสม เมื่อแอปพลิเคชันเรียกใช้เมธอด videos.reportAbuse เพื่อรายงานวิดีโอที่เป็นการละเมิด คําขอจะใช้ข้อมูลจากทรัพยากร videoAbuseReportReason เพื่อระบุสาเหตุที่รายงานวิดีโอ

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /videoAbuseReportReasons รับรายการเหตุผลที่สามารถใช้เพื่อรายงานวิดีโอที่เป็นการละเมิด

หมวดหมู่วิดีโอ

ทรัพยากร videoCategory ระบุหมวดหมู่ที่เชื่อมโยงหรือเชื่อมโยงกับวิดีโอที่อัปโหลด

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
list GET /videoCategories แสดงผลรายการหมวดหมู่ที่สามารถเชื่อมโยงกับวิดีโอ YouTube

วิดีโอ

ทรัพยากร video แสดงถึงวิดีโอ YouTube

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
insert POST /videos อัปโหลดวิดีโอไปยัง YouTube และเลือกตั้งค่าข้อมูลเมตาของวิดีโอ
list GET /videos แสดงผลรายการวิดีโอที่ตรงกับพารามิเตอร์คําขอ API
delete DELETE /videos ลบวิดีโอ YouTube
update PUT /videos อัปเดตข้อมูลเมตาของวิดีโอ
rate POST /videos/rate เพิ่มการกดชอบหรือไม่ชอบลงในวิดีโอ หรือนําคะแนนออกจากวิดีโอ
getRating GET /videos/getRating ดึงข้อมูลคะแนนที่ผู้ใช้ที่ได้รับอนุญาตให้ในรายการวิดีโอที่ระบุ
reportAbuse POST /videos/reportAbuse รายงานวิดีโอที่มีเนื้อหาไม่เหมาะสม

ลายน้ํา

ทรัพยากร watermark ระบุรูปภาพที่แสดงระหว่างการเล่นวิดีโอของช่องที่ระบุ นอกจากนี้ คุณยังระบุช่องเป้าหมายที่รูปภาพจะลิงก์ รวมถึงรายละเอียดช่วงเวลาที่กําหนดเวลาที่ลายน้ําจะปรากฏระหว่างการเล่นวิดีโอ และระยะเวลาที่มองเห็นได้

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากรนี้ โปรดดูการแสดงทรัพยากรและรายการพร็อพเพอร์ตี้

วิธีการ คำขอ HTTP คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/youtube/v3
set POST /watermarks/set อัปโหลดรูปภาพลายน้ําไปยัง YouTube และตั้งค่าเป็นช่อง
unset POST /watermarks/unset ลบรูปภาพลายน้ําของช่อง