API Reference

YouTube Data API ช่วยให้คุณสามารถรวมฟังก์ชันที่ปกติแล้วดำเนินการบนเว็บไซต์ 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 แทร็กได้

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

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