API Reference

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

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

การเรียก API

ข้อกำหนดต่อไปนี้มีผลกับคำขอ API ข้อมูลของ YouTube

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

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

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

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

    • ใช้พารามิเตอร์การค้นหา 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 อย่างก็ได้

ChannelBanners

ทรัพยากร 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

ChannelSections

ทรัพยากร 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 ตั้งแต่ 0 รายการขึ้นไปที่ตรงกับเกณฑ์คำขอ
update PUT /channels อัปเดตข้อมูลเมตาของช่อง โปรดทราบว่าปัจจุบันเมธอดนี้รองรับเฉพาะการอัปเดตออบเจ็กต์ brandingSettings และ invideoPromotion ของทรัพยากร channel และพร็อพเพอร์ตี้ย่อยของออบเจ็กต์ดังกล่าว

CommentThreads

แหล่งข้อมูล 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 หมายเหตุ: ระบบเลิกใช้งานวิธีการนี้แล้วและไม่รองรับอีกต่อไป
delete DELETE /comments ลบความคิดเห็น
update PUT /comments แก้ไขความคิดเห็น

GuideCategories

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

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

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

I18nLanguages

แหล่งข้อมูล 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 รองรับ

I18nRegions

ทรัพยากร 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 ต้องได้รับอนุญาตจากเจ้าของช่อง

MembershipsLevels

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

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

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

PlaylistItems

ทรัพยากร 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 เพลย์ลิสต์คือคอลเล็กชันวิดีโอที่ดูตามลำดับและแชร์กับผู้ใช้คนอื่นๆ ได้ โดยค่าเริ่มต้น ผู้ใช้รายอื่นจะเห็นเพลย์ลิสต์ของคุณแบบสาธารณะ แต่คุณตั้งค่าเพลย์ลิสต์เป็นแบบสาธารณะหรือส่วนตัวก็ได้

นอกจากนี้ 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 เช่น วิดีโอความละเอียดสูงอาจรองรับภาพขนาดย่อที่มีความละเอียดสูงกว่าวิดีโอที่ไม่ใช่ความละเอียดสูง
  • ออบเจ็กต์แต่ละรายการที่มีข้อมูลเกี่ยวกับขนาดรูปภาพขนาดย่อจะมีพร็อพเพอร์ตี้ width และพร็อพเพอร์ตี้ height อย่างไรก็ตาม ระบบอาจไม่แสดงผลพร็อพเพอร์ตี้ความกว้างและความสูงของรูปภาพนั้น
  • หากภาพปกที่อัปโหลดไม่ตรงกับขนาดที่กำหนด ระบบจะปรับขนาดรูปภาพให้ตรงกับขนาดที่ถูกต้องโดยไม่ต้องเปลี่ยนสัดส่วนภาพ รูปภาพจะไม่ถูกครอบตัด แต่อาจมีแถบสีดำเพื่อให้มีขนาดถูกต้อง

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

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

VideoAbuseReportReasons

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

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

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

VideoCategories

ทรัพยากร 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 ลบรูปภาพลายน้ำของช่อง