API ข้อมูลของ YouTube ช่วยให้คุณสามารถรวมฟังก์ชันที่ดำเนินการโดยปกติบนเว็บไซต์ YouTube ลงในเว็บไซต์หรือแอปพลิเคชันของคุณเอง รายการด้านล่างระบุทรัพยากรประเภทต่างๆ ที่คุณเรียกข้อมูลได้โดยใช้ API API ยังรองรับวิธีการแทรก อัปเดต หรือลบทรัพยากรเหล่านี้ด้วย
คู่มืออ้างอิงนี้จะอธิบายวิธีการใช้ API เพื่อดำเนินการทั้งหมดเหล่านี้ คู่มือนี้จะจัดเรียงตามประเภททรัพยากร ทรัพยากรแสดงประเภทของรายการที่รวมอยู่ในประสบการณ์การใช้งาน YouTube เช่น วิดีโอ เพลย์ลิสต์ หรือการสมัครใช้บริการ สำหรับทรัพยากรแต่ละประเภท คำแนะนำจะแสดงการนำเสนอข้อมูลอย่างน้อย 1 รายการ และทรัพยากรในจะแสดงเป็นออบเจ็กต์ JSON คู่มือนี้จะแสดงเมธอดที่รองรับอย่างน้อย 1 รายการ (LIST
, POST
, DELETE
ฯลฯ) สําหรับทรัพยากรแต่ละประเภท และอธิบายวิธีใช้เมธอดเหล่านั้นในแอปพลิเคชันของคุณ
การเรียกใช้ API
ข้อกำหนดต่อไปนี้ใช้กับคำขอ YouTube Data API
-
ทุกคำขอต้องระบุคีย์ API (ด้วยพารามิเตอร์
key
) หรือระบุโทเค็น OAuth 2.0 คีย์ API ของคุณแสดงอยู่ในแผงการเข้าถึง API ของแผงควบคุมสำหรับนักพัฒนาซอฟต์แวร์สำหรับโปรเจ็กต์ของคุณ -
คุณต้องส่งโทเค็นการให้สิทธิ์สำหรับคำขอการแทรก อัปเดต และลบทุกรายการ นอกจากนี้ คุณต้องส่งโทเค็นการให้สิทธิ์สำหรับคำขอที่เรียกข้อมูลส่วนตัวของผู้ใช้ที่ตรวจสอบสิทธิ์ด้วย
นอกจากนี้ เมธอด API ในการเรียกข้อมูลทรัพยากรอาจรองรับพารามิเตอร์ที่ต้องมีการให้สิทธิ์หรืออาจมีข้อมูลเมตาเพิ่มเติมเมื่อคำขอได้รับอนุมัติ ตัวอย่างเช่น คำขอเรียกวิดีโอที่อัปโหลดของผู้ใช้อาจมีวิดีโอส่วนตัวด้วยหากคำขอนั้นได้รับอนุญาตจากผู้ใช้รายนั้น
-
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 ขั้นตอนเพื่ออัปเดตรูปภาพแบนเนอร์สำหรับช่อง
|
ส่วนช่อง
ทรัพยากร 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 ยังใช้เพลย์ลิสต์ในการระบุคอลเล็กชันวิดีโอพิเศษของช่องด้วย เช่น
- วิดีโอที่อัปโหลด
- วิดีโอที่ได้รับคะแนนเชิงบวก (ชอบ)
- ประวัติการดู
- ดูภายหลัง
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 |
ลบรูปภาพลายน้ำของช่อง |