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 ของแผงควบคุมสำหรับนักพัฒนาซอฟต์แวร์สำหรับโปรเจ็กต์ของคุณ

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

หมวดหมู่คำแนะนำ

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

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

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

ภาษา18n

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

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