หน้านี้แสดงการเปลี่ยนแปลงใน YouTube Data API (v3) และการอัปเดตเอกสารประกอบ ติดตามบันทึกการเปลี่ยนแปลงนี้
10 กรกฎาคม 2025
ตั้งแต่วันที่ 21 กรกฎาคม 2025 เป็นต้นไป YouTube จะปรับเนื้อหาที่แสดงโดยแผนภูมิ mostPopular
ของเมธอด video.list
ก่อนหน้านี้ ชาร์ต mostPopular
จะแสดงวิดีโอที่แนะนำในรายการมาแรง ตอนนี้ชาร์ตmostPopular
จะแสดงวิดีโอจากชาร์ตเพลง ภาพยนตร์ และเกมที่กำลังมาแรง การเปลี่ยนแปลง API นี้เกิดขึ้นพร้อมกับการเลิกใช้งานหน้ามาแรงของ YouTube
26 มีนาคม 2025
ตั้งแต่วันที่ 31 มีนาคม 2025 เป็นต้นไป YouTube จะเปลี่ยนวิธีนับยอดดู Shorts ในอดีต YouTube จะนับยอดดู Shorts เมื่อเล่นถึงระยะเวลาที่กำหนดเป็นวินาที ตอนนี้ระบบจะนับยอดดูเป็นจำนวนครั้งที่ Shorts เริ่มเล่นหรือเล่นซ้ำ โดยไม่มีการกำหนดเวลาในการรับชมขั้นต่ำ ดูข้อมูลเพิ่มเติม
ตั้งแต่วันที่ 31 มีนาคม 2025 เป็นต้นไป ช่องต่อไปนี้ใน Data API จะแสดงจำนวนยอดดูของ Shorts ตามการเปลี่ยนแปลงนี้
channels.statistics.viewCount
videos.statistics.viewCount
30 ตุลาคม 2024
ตอนนี้ API รองรับความสามารถในการระบุวิดีโอที่มีเนื้อหาดัดแปลงหรือ สังเคราะห์ (A/S) ที่ดูสมจริงแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับ YouTube นโยบายที่เกี่ยวข้องกับเนื้อหา A/S
ตัวอย่างเนื้อหา A/S ได้แก่ วิดีโอที่มีลักษณะต่อไปนี้
- ทำให้ดูเหมือนบุคคลที่มีตัวตนจริงพูดหรือกระทำบางอย่างที่บุคคลดังกล่าวไม่ได้พูดหรือกระทำ
- ดัดแปลงฟุตเทจที่แสดงเหตุการณ์หรือสถานที่จริง
- สร้างฉากที่ดูสมจริงซึ่งไม่ได้เกิดขึ้นจริง
หากต้องการระบุว่าวิดีโอมีเนื้อหา A/S หรือไม่ ให้ตั้งค่าพร็อพเพอร์ตี้
status.containsSyntheticMedia
ตั้งค่าพร็อพเพอร์ตี้นี้ได้เมื่อเรียกใช้เมธอด videos.insert
หรือ videos.update
หากตั้งค่าไว้ ระบบจะแสดงพร็อพเพอร์ตี้
ในแหล่งข้อมูล
video
30 เมษายน 2024
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
API ไม่รองรับความสามารถในการแทรกหรือดึงข้อมูลการสนทนาในช่องอีกต่อไป การเปลี่ยนแปลงนี้สอดคล้องกับฟังก์ชันการทำงานที่รองรับในเว็บไซต์ YouTube ซึ่งไม่รองรับการโพสต์ความคิดเห็นในช่อง
13 มีนาคม 2024
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
พารามิเตอร์ sync
สำหรับเมธอด
captions.insert
และ
captions.update
เลิกใช้งานแล้ว YouTube จะหยุดรองรับพารามิเตอร์
ตั้งแต่วันที่ 12 เมษายน 2024
การเปลี่ยนแปลงนี้ส่งผลให้นักพัฒนาแอปต้องระบุข้อมูลเวลาเมื่อแทรกหรืออัปเดตแทร็กคำบรรยายแทนเสียง มิฉะนั้นการอัปโหลดจะล้มเหลว
12 มีนาคม 2024
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
เราได้อัปเดตเอกสารประกอบสำหรับทรัพยากร captions
เพื่อระบุว่าความยาวสูงสุดที่อนุญาตสำหรับฟิลด์ snippet.name
คือ 150 อักขระ API จะแสดงข้อผิดพลาด nameTooLong
หากชื่อแทร็กยาวกว่านั้น
7 มีนาคม 2024
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
เลิกใช้งานพร็อพเพอร์ตี้แหล่งข้อมูล channel
brandingSettings.channel.moderateComments
แล้ว YouTube จะหยุด
รองรับพารามิเตอร์ดังกล่าวตั้งแต่วันที่ 7 มีนาคม 2024
31 มกราคม 2024
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
channels.list
วิธีการใหม่ของ forHandle
พารามิเตอร์ช่วยให้คุณดึงข้อมูลเกี่ยวกับช่องได้โดยการระบุแฮนเดิล YouTube ของช่อง
9 พฤศจิกายน 2023
เราได้นำการอ้างอิงทั้งหมดไปยังทรัพยากร videoId
ภายใต้ Comments
ออกแล้ว เนื่องจากระบบไม่ได้แสดงผลทรัพยากร videoId
โดยใช้การเรียก API
12 กันยายน 2023
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
เราเลิกใช้งานเมธอด comments.markAsSpam
มาหลายปีแล้ว YouTube ไม่รองรับวิธีการนี้อยู่แล้วและจะไม่รองรับผ่าน API อีกต่อไป
เราได้เพิ่มการแจ้งเตือนเรื่องการเลิกใช้งานลงในเอกสารทั้งหมดที่อ้างอิงถึงเมธอด comments.markAsSpam
22 สิงหาคม 2023
ตอนนี้เมธอด search.list
รองรับพารามิเตอร์
videoPaidProductPlacement
แล้ว พารามิเตอร์นี้ช่วยให้คุณกรองผลการค้นหาเพื่อรวมเฉพาะวิดีโอที่ครีเอเตอร์ระบุว่ามีการโปรโมตแบบชำระเงิน
18 สิงหาคม 2023
คำจำกัดความของvideo
แหล่งข้อมูล
liveStreamingDetails.concurrentViewers
ได้รับการอัปเดตเพื่อระบุว่าจำนวนผู้ชมพร้อมกันที่ YouTube Data API แสดงผลอาจ
แตกต่างจากจำนวนผู้ชมพร้อมกันที่ประมวลผลแล้วและไม่มีสแปมซึ่งดูได้ผ่านข้อมูลวิเคราะห์ YouTube ศูนย์ช่วยเหลือของ YouTube
มีข้อมูลเพิ่มเติมเกี่ยวกับเมตริกสตรีมมิงแบบสด
7 สิงหาคม 2023
ตามที่ประกาศเมื่อวันที่ 12 มิถุนายน 2023 พารามิเตอร์ relatedToVideoId
ของเมธอด search.list
ได้รับการเลิกใช้งานแล้ว
ระบบไม่รองรับพารามิเตอร์ดังกล่าวอีกต่อไป
และได้นำการอ้างอิงถึงพารามิเตอร์ออกจากเอกสารประกอบ API แล้ว
28 มิถุนายน 2023
ตอนนี้เมธอด thumbnails.set รองรับข้อผิดพลาด
uploadRateLimitExceeded
แล้ว ซึ่งบ่งชี้ว่าช่องอัปโหลดภาพปกมากเกินไป
ในช่วง 24 ชั่วโมงที่ผ่านมา และควรลองอีกครั้งในภายหลัง
12 มิถุนายน 2023
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
เลิกใช้พารามิเตอร์ relatedToVideoId
ของเมธอด search.list แล้ว YouTube จะหยุดรองรับพารามิเตอร์
ตั้งแต่วันที่ 7 สิงหาคม 2023
ขณะนี้เราได้เพิ่มการแจ้งเตือนเรื่องการเลิกใช้งานลงในเอกสารประกอบของเมธอด search.list
แล้ว
เราจะนำพารามิเตอร์นี้ออกจากเอกสารประกอบ search.list
โดยสมบูรณ์
ตั้งแต่วันที่ 7 สิงหาคม 2023 เป็นต้นไป
นอกจากนี้ เรายังได้นำตัวอย่างที่แสดงวิธีดึงวิดีโอที่เกี่ยวข้องออกจากคู่มือการใช้งาน API แล้วด้วย
22 สิงหาคม 2022
แก้ไขคำอธิบายประกอบประเภทสำหรับฟิลด์ video.statistics เป็นสตริงจาก unsigned long
5 สิงหาคม 2022
YouTube ได้เปลี่ยนวิธีสร้างรหัสคำบรรยายแทนเสียง และเป็นส่วนหนึ่งของการเปลี่ยนแปลงนี้ YouTube จะ
กำหนดรหัสคำบรรยายแทนเสียงใหม่ให้กับแทร็กคำบรรยายแทนเสียงทั้งหมด การเปลี่ยนแปลงนี้อาจเป็นการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันก่อนหน้าสำหรับแอปพลิเคชันที่จัดเก็บค่า caption_id
แต่จะไม่ส่งผลต่อแอปพลิเคชันที่ไม่ได้จัดเก็บค่า caption_id
นับจากนี้จนถึงวันที่ 1 ธันวาคม 2022 วิธีการ
captions.list
,
captions.update
,
captions.download
และ
captions.delete
จะรองรับทั้งรหัสแทร็กคำบรรยายแทนเสียงแบบเก่าและแบบใหม่
อย่างไรก็ตาม ตั้งแต่วันที่ 1 ธันวาคม 2022 เป็นต้นไป YouTube
จะหยุดรองรับรหัสแทร็กคำบรรยายแทนเสียงแบบเดิม ในเวลานั้น การเรียกใช้เมธอด API ใดๆ เหล่านั้น
ด้วยรหัสแทร็กคำบรรยายแทนเสียงรุ่นเก่าจะทำให้เกิดข้อผิดพลาด captionNotFound
คุณควรวางแผนที่จะแทนที่ข้อมูลแทร็กคำบรรยายแทนเสียงที่จัดเก็บไว้ทั้งหมด
อย่างสมบูรณ์ตั้งแต่ตอนนี้จนถึงวันที่ 1 ธันวาคม 2022 เพื่อเตรียมพร้อมรับการเปลี่ยนแปลงนี้ ซึ่งหมายความว่าสำหรับวิดีโอใดก็ตามที่คุณจัดเก็บข้อมูลแทร็กคำบรรยายแทนเสียง
คุณควรลบข้อมูลที่จัดเก็บไว้ในปัจจุบัน จากนั้นเรียกใช้เมธอด captions.list
เพื่อดึงข้อมูล
ชุดแทร็กคำบรรยายแทนเสียงปัจจุบันของวิดีโอ และจัดเก็บข้อมูลในการตอบกลับของ API ตามปกติ
12 กรกฎาคม 2022
เราได้อัปเดตข้อกำหนดในการให้บริการของบริการ API ของ YouTube โปรดดูข้อมูลเพิ่มเติมที่ข้อกำหนดในการให้บริการของ API ของ YouTube - ประวัติการแก้ไข
27 เมษายน 2022
videos.insert
คำอธิบายเมธอดได้รับการอัปเดตเพื่อระบุว่าขนาดไฟล์สูงสุดสำหรับวิดีโอที่อัปโหลดเพิ่มขึ้นจาก 128 GB เป็น 256 GB
8 เมษายน 2022
เราได้อัปเดตทั้งคำจำกัดความของเมธอด subscriptions.list
myRecentSubscribers
และพารามิเตอร์ mySubscribers
เพื่อระบุว่า API อาจจำกัดจำนวนผู้ติดตามสูงสุดที่แสดง
การเปลี่ยนแปลงนี้เป็นการแก้ไขเอกสารประกอบ ไม่ใช่การเปลี่ยนแปลงลักษณะการทำงานของ API
15 ธันวาคม 2021
ตามที่ประกาศเมื่อวันที่ 18 พฤศจิกายน 2021 ควบคู่ไปกับการเปลี่ยนแปลงเพื่อทำให้จำนวนการไม่ชอบวิดีโอเป็นแบบส่วนตัวในแพลตฟอร์ม YouTube ทั้งหมด ตอนนี้พร็อพเพอร์ตี้ statistics.dislikeCount
ของทรัพยากร video
เป็นแบบส่วนตัวแล้ว
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ในบล็อกอย่างเป็นทางการของ YouTube
18 พฤศจิกายน 2021
ควบคู่ไปกับการเปลี่ยนแปลงเพื่อ
ทำให้จำนวนการกดไม่ชอบวิดีโอเป็นแบบส่วนตัวทั่วทั้งแพลตฟอร์ม YouTube เราจะทำให้พร็อพเพอร์ตี้ video
ของทรัพยากร
statistics.dislikeCount
เป็นแบบส่วนตัวตั้งแต่วันที่ 13 ธันวาคม 2021 ซึ่งหมายความว่าพร็อพเพอร์ตี้นี้จะรวมอยู่ในการตอบกลับ API จากปลายทาง videos.list
ก็ต่อเมื่อเจ้าของวิดีโอได้ตรวจสอบสิทธิ์คำขอ API แล้วเท่านั้น
โดยปลายทาง videos.rate
จะไม่ได้รับผลกระทบ
จากการเปลี่ยนแปลงนี้
นักพัฒนาแอปที่ไม่ได้แสดงจำนวนไม่ชอบต่อสาธารณะและยังคงต้องการจำนวนไม่ชอบสำหรับไคลเอ็นต์ API ของตน สามารถสมัครเพื่อให้อยู่ในรายการที่อนุญาตสำหรับการยกเว้นได้ หากต้องการขอรับการยกเว้น คุณต้องกรอกแบบฟอร์มใบสมัครนี้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ในบล็อกอย่างเป็นทางการของ YouTube
2 กรกฎาคม 2021
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
เราเลิกใช้งานปลายทาง commentThreads.update
แล้ว และไม่รองรับอีกต่อไป
โดยอุปกรณ์ปลายทางนี้จะทำซ้ำฟังก์ชันที่มีให้ใช้งานผ่านอุปกรณ์ปลายทาง API อื่นๆ แต่คุณสามารถ
โทรหาcomments.update
commentThreads
รีซอร์ส ให้โทรครั้งที่ 2 ไปยังเมธอด
commentThreads.list
1 กรกฎาคม 2021
นักพัฒนาแอปทุกรายที่ใช้บริการ API ของ YouTube ต้องทำการตรวจสอบการปฏิบัติตามข้อกำหนด API ให้เสร็จสมบูรณ์เพื่อรับการจัดสรรโควต้ามากกว่าค่าเริ่มต้นที่ 10,000 หน่วย ปัจจุบันทั้งกระบวนการตรวจสอบการปฏิบัติตามข้อกำหนดและการขอการจัดสรรหน่วยโควต้าเพิ่มเติมดำเนินการโดยนักพัฒนาซอฟต์แวร์ที่กรอกและส่งแบบฟอร์มบริการ API ของ YouTube - การตรวจสอบและการขยายโควต้า
เราจึงเพิ่มแบบฟอร์มใหม่ 3 แบบและคำแนะนำในการกรอกแบบฟอร์มดังกล่าวเพื่อชี้แจงกระบวนการเหล่านี้และตอบสนองความต้องการของนักพัฒนาแอปที่ใช้บริการ API ของเราได้ดียิ่งขึ้น
- แบบฟอร์มคำขอของนักพัฒนาแอปที่ผ่านการตรวจสอบ: นักพัฒนาแอปที่ผ่านการตรวจสอบการปฏิบัติตามข้อกำหนดของ API แล้วสามารถกรอกและส่งแบบฟอร์มที่สั้นลงนี้เพื่อขอขยายโควต้าที่จัดสรรไว้
- แบบฟอร์มการอุทธรณ์: นักพัฒนาแอปที่มีโปรเจ็กต์ API ไม่ผ่านการตรวจสอบการปฏิบัติตามข้อกำหนด (หรือถูกปฏิเสธการเพิ่มหน่วยโควต้า) สามารถกรอกและส่งแบบฟอร์มนี้ได้
- แบบฟอร์มการเปลี่ยนแปลงการควบคุม: นักพัฒนาแอปหรือบุคคลใดก็ตามที่จัดการไคลเอ็นต์ API ในนามของนักพัฒนาแอปซึ่งมีการเปลี่ยนแปลงการควบคุม (เช่น ผ่านทางการซื้อหรือจำหน่ายหุ้น การควบรวมธุรกิจ หรือธุรกรรมองค์กรรูปแบบอื่น) ที่เชื่อมโยงกับโปรเจ็กต์ API จะต้องกรอกและส่งแบบฟอร์มนี้ ซึ่งจะช่วยให้ทีม API ของ YouTube อัปเดตบันทึก ตรวจสอบการปฏิบัติตามกรณีการใช้งานของโปรเจ็กต์ API ใหม่ และตรวจสอบการจัดสรรโควต้าปัจจุบันของนักพัฒนาแอปได้
แบบฟอร์มใหม่แต่ละแบบจะแจ้งให้เราทราบถึงการใช้งาน API ของ YouTube ที่คุณต้องการ และช่วยให้เราช่วยเหลือคุณได้ดียิ่งขึ้น
ดูรายละเอียดเพิ่มเติมได้ในคำแนะนำการตรวจสอบการปฏิบัติตามข้อกำหนดของ API ใหม่
12 พฤษภาคม 2021
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
การอัปเดตนี้ครอบคลุมการเปลี่ยนแปลง API ต่อไปนี้
-
เลิกใช้งานพร็อพเพอร์ตี้
contentDetails.relatedPlaylists.favorites
ของทรัพยากรchannel
แล้ว ฟังก์ชันวิดีโอโปรดถูกเลิกใช้งานมาหลายปีแล้วตามที่ระบุไว้ในรายการประวัติการแก้ไขเมื่อวันที่ 28 เมษายน 2016ก่อนการอัปเดตนี้ API จะยังคงสร้างเพลย์ลิสต์ใหม่หากไคลเอ็นต์ API พยายาม เพิ่มวิดีโอลงในเพลย์ลิสต์รายการโปรดที่ไม่มีอยู่ นับจากนี้ไป ระบบจะไม่สร้างเพลย์ลิสต์ในกรณีนี้และ API จะแสดงข้อผิดพลาด ความพยายามในการแก้ไขเพลย์ลิสต์รายการโปรด โดยการเพิ่ม แก้ไข หรือลบรายการต่างๆ จะถูกเลิกใช้งานทั้งหมดตามประกาศก่อนหน้านี้ และ อาจเริ่มแสดงข้อผิดพลาดได้ทุกเมื่อ
-
เราได้เลิกใช้งานพร็อพเพอร์ตี้ของทรัพยากร
channel
ต่อไปนี้ พร็อพเพอร์ตี้เหล่านี้ไม่รองรับใน UI ของ YouTube Studio และบน YouTube อยู่แล้ว ด้วยเหตุนี้ ระบบจึงไม่รองรับการใช้งานผ่าน API อีกต่อไปbrandingSettings.channel.defaultTab
brandingSettings.channel.featuredChannelsTitle
brandingSettings.channel.featuredChannelsUrls[]
brandingSettings.channel.profileColor
brandingSettings.channel.showBrowseView
brandingSettings.channel.showRelatedChannels
พร็อพเพอร์ตี้ทั้งหมดถูกนำออกจาก
channel
การแสดงทรัพยากร และคำจำกัดความของพร็อพเพอร์ตี้ถูกนำออกจาก รายการพร็อพเพอร์ตี้ของทรัพยากร นอกจากนี้ เรายังได้นำข้อผิดพลาด ที่เชื่อมโยงกับพร็อพเพอร์ตี้เหล่านี้ออกจากเอกสารประกอบเฉพาะวิธีการด้วย -
เราได้เลิกใช้งานพร็อพเพอร์ตี้ของทรัพยากร
channelSection
ต่อไปนี้ พร็อพเพอร์ตี้เหล่านี้ไม่รองรับใน UI ของ YouTube Studio และบน YouTube อยู่แล้ว ด้วยเหตุนี้ ระบบจึงไม่รองรับการใช้งานผ่าน API อีกต่อไปsnippet.style
snippet.defaultLanguage
snippet.localized.title
localizations
localizations.(key)
localizations.(key).title
targeting
targeting.languages[]
targeting.regions[]
targeting.countries[]
นอกเหนือจากการเปลี่ยนแปลงนี้ พารามิเตอร์
hl
ของเมธอดchannelSection.list
ยังถูกเลิกใช้งานด้วยเนื่องจากระบบไม่รองรับฟีเจอร์ที่พารามิเตอร์นี้รองรับพร็อพเพอร์ตี้ทั้งหมดถูกนำออกจาก
channelSection
การแสดงทรัพยากร และคำจำกัดความของพร็อพเพอร์ตี้ถูกนำออกจาก รายการพร็อพเพอร์ตี้ของทรัพยากร นอกจากนี้ เรายังได้นำข้อผิดพลาด ที่เชื่อมโยงกับพร็อพเพอร์ตี้เหล่านี้ออกจากเอกสารประกอบเฉพาะวิธีการด้วย -
สำหรับพร็อพเพอร์ตี้
snippet.type
ของทรัพยากรchannelSection
ค่าต่อไปนี้เลิกใช้งานแล้ว ค่าเหล่านี้ไม่รองรับในหน้าช่อง YouTube อยู่แล้ว และด้วยเหตุนี้จึงไม่รองรับผ่าน API อีกต่อไปด้วยlikedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
เลิกใช้งานพร็อพเพอร์ตี้
snippet.tags[]
ของทรัพยากรplaylist
แล้ว พร็อพเพอร์ตี้นี้ไม่รองรับบน YouTube อยู่แล้ว จึงไม่รองรับผ่าน API อีกต่อไป
9 กุมภาพันธ์ 2021
ทรัพยากร playlistItem
รองรับพร็อพเพอร์ตี้ใหม่ 2 รายการดังนี้
- พร็อพเพอร์ตี้
snippet.videoOwnerChannelId
ระบุรหัสของช่องที่อัปโหลดวิดีโอในเพลย์ลิสต์ - พร็อพเพอร์ตี้
snippet.videoOwnerChannelTitle
ระบุชื่อของช่องที่อัปโหลดวิดีโอในเพลย์ลิสต์
28 มกราคม 2021
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
วิธีการ
playlistItems.delete
,playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
และplaylists.update
รองรับข้อผิดพลาดplaylistOperationUnsupported
ใหม่ ข้อผิดพลาดจะเกิดขึ้นเมื่อคำขอพยายาม ดำเนินการที่ไม่ได้รับอนุญาตสำหรับเพลย์ลิสต์หนึ่งๆ เช่น ผู้ใช้จะ ลบวิดีโอจากเพลย์ลิสต์วิดีโอที่อัปโหลดหรือลบเพลย์ลิสต์เองไม่ได้ในทุกกรณี ข้อผิดพลาดนี้จะส่งรหัสการตอบกลับ HTTP
400
(คำขอไม่ถูกต้อง) กลับมา -
ข้อผิดพลาด
watchHistoryNotAccessible
และwatchLaterNotAccessible
ของเมธอดplaylistItems.list
ถูกนำออกจากเอกสารประกอบแล้ว แม้ว่าประวัติการดูและรายการดูภายหลังของผู้ใช้จะเข้าถึงผ่าน API ไม่ได้ แต่ API ก็ไม่ได้แสดงข้อผิดพลาดเหล่านี้
15 ตุลาคม 2020
เราได้เพิ่ม 2 ส่วนใหม่ลงในนโยบาย สำหรับนักพัฒนาแอป ดังนี้
- ส่วนที่ III.E.4.i ใหม่จะให้ ข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลที่รวบรวมและส่งผ่านโปรแกรมเล่น YouTube แบบฝัง คุณ มีหน้าที่รับผิดชอบต่อข้อมูลผู้ใช้ที่คุณส่งให้เราผ่านโปรแกรมเล่น YouTube ที่ฝังไว้ก่อนที่ ผู้ใช้จะโต้ตอบกับโปรแกรมเล่นเพื่อระบุความตั้งใจในการเล่น คุณจำกัดข้อมูลที่แชร์ กับ YouTube ก่อนที่ผู้ใช้จะโต้ตอบกับเพลเยอร์ได้โดยตั้งค่าการเล่นอัตโนมัติเป็น "false"
- ส่วนที่ III.E.4.j ใหม่เกี่ยวข้อง กับการตรวจสอบสถานะสร้างมาเพื่อเด็ก (MFK) ของเนื้อหาก่อนที่จะฝังเนื้อหาดังกล่าวในเว็บไซต์และ แอปของคุณ คุณมีหน้าที่รับผิดชอบในการทราบว่าวิดีโอที่คุณฝังในไคลเอ็นต์ API สร้างมาเพื่อเด็กหรือไม่ และต้องจัดการข้อมูลที่รวบรวมจากเพลเยอร์ที่ฝังตามนั้น ดังนั้น คุณต้อง ตรวจสอบสถานะของเนื้อหาโดยใช้บริการ YouTube Data API ก่อนที่จะฝังเนื้อหาดังกล่าวในไคลเอ็นต์ API ผ่านโปรแกรมเล่นแบบฝังของ YouTube
คำแนะนำการค้นหาสถานะ "สร้างมาเพื่อเด็ก" ของวิดีโอ ใหม่จะอธิบายวิธีค้นหาสถานะ MFK ของวิดีโอโดยใช้ บริการ YouTube Data API
นอกเหนือจากการเปลี่ยนแปลงเหล่านี้ เราได้เพิ่มการช่วยเตือนในเอกสารประกอบพารามิเตอร์ของเพลเยอร์แบบฝังเพื่ออธิบายว่า หากคุณเปิดใช้การเล่นอัตโนมัติ การเล่นจะเกิดขึ้นโดยที่ผู้ใช้ไม่ต้องโต้ตอบกับเพลเยอร์ ดังนั้นการรวบรวมและแชร์ข้อมูลการเล่นจะเกิดขึ้นเมื่อโหลดหน้าเว็บ
8 ตุลาคม 2020
การอัปเดตนี้ครอบคลุมการเปลี่ยนแปลงเล็กๆ 3 อย่างที่เกี่ยวข้องกับ
แหล่งข้อมูล channel
ดังนี้
- ออบเจ็กต์
snippet.thumbnails
ซึ่งระบุรูปภาพปกวิดีโอของช่องอาจว่างเปล่าสำหรับช่องที่สร้างขึ้นใหม่ และอาจใช้เวลาถึง 1 วันในการเติมข้อมูล - พร็อพเพอร์ตี้
statistics.videoCount
จะแสดงจำนวนวิดีโอสาธารณะของช่องเท่านั้น แม้แต่เจ้าของช่องเองก็ตาม ลักษณะการทำงานนี้ สอดคล้องกับจำนวนที่แสดงในเว็บไซต์ YouTube - ระบบอาจตัดคีย์เวิร์ดของแชแนลที่ระบุในพร็อพเพอร์ตี้
brandingSettings.channel.keywords
หากมีความยาวเกินความยาวสูงสุดที่อนุญาต 500 อักขระ หรือหากมีเครื่องหมายคำพูดที่ไม่ได้หลีกเลี่ยง ("
) โปรดทราบว่าขีดจำกัด 500 อักขระ ไม่ใช่ขีดจำกัดต่อคีย์เวิร์ด แต่เป็นขีดจำกัดความยาวรวมของคีย์เวิร์ดทั้งหมด ลักษณะการทำงานนี้สอดคล้องกับลักษณะการทำงานบนเว็บไซต์ YouTube
9 กันยายน 2020
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
การอัปเดตนี้ครอบคลุมการเปลี่ยนแปลง API ต่อไปนี้ การเปลี่ยนแปลงทั้งหมดจะมีผลตั้งแต่วันที่ 9 กันยายน 2020 เป็นต้นไป ซึ่งเป็นวันที่ประกาศนี้ ด้วยเหตุนี้ นักพัฒนาแอปจึงไม่ควร ใช้ฟีเจอร์ API ที่ระบุไว้ด้านล่างอีกต่อไป
-
เราเลิกใช้งานทรัพยากร API, เมธอด, พารามิเตอร์ และพร็อพเพอร์ตี้ทรัพยากรต่อไปนี้
โดยทันที และจะหยุดทำงานตั้งแต่วันที่ประกาศนี้เป็นต้นไป
- พร็อพเพอร์ตี้ของ
channel
ทรัพยากรต่อไปนี้- พร็อพเพอร์ตี้
statistics.commentCount
- ออบเจ็กต์
brandingSettings.image
และพร็อพเพอร์ตี้ย่อยทั้งหมดของออบเจ็กต์ brandingSettings.hints
รายการและพร็อพเพอร์ตี้ย่อยทั้งหมด
- พร็อพเพอร์ตี้
- พารามิเตอร์ตัวกรองของเมธอด
channels.list
categoryId
guideCategories
resource และเมธอดguideCategories.list
- พร็อพเพอร์ตี้ของ
-
การตอบกลับจาก API สำหรับเมธอด
channels.list
จะไม่มีพร็อพเพอร์ตี้prevPageToken
อีกต่อไป หากคำขอ API ตั้งค่าพารามิเตอร์managedByMe
เป็นtrue
การเปลี่ยนแปลงนี้จะไม่ส่งผลต่อพร็อพเพอร์ตี้prevPageToken
สำหรับคำขออื่นๆ ของchannels.list
และจะไม่ส่งผลต่อพร็อพเพอร์ตี้nextPageToken
สำหรับคำขอใดๆ -
ทั้งพร็อพเพอร์ตี้
contentDetails.relatedPlaylists.watchLater
และcontentDetails.relatedPlaylists.watchHistory
ของทรัพยากรchannel
ได้รับการประกาศว่าเลิกใช้งานแล้วเมื่อวันที่ 11 สิงหาคม 2016 การรองรับเมธอดplaylistItems.insert
และเมธอดplaylistItems.delete
สำหรับเพลย์ลิสต์เหล่านี้ก็เลิกใช้งานอย่างเต็มรูปแบบแล้วเช่นกัน และระบบได้นำพร็อพเพอร์ตี้ทั้ง 2 รายการออกจากเอกสารประกอบแล้ว -
พารามิเตอร์
mySubscribers
ของเมธอดchannels.list
ซึ่งเราได้ประกาศว่าเลิกใช้งานแล้วเมื่อวันที่ 30 กรกฎาคม 2013 ถูกนำออกจากเอกสารประกอบแล้ว ใช้เมธอดsubscriptions.list
และพารามิเตอร์mySubscribers
ของเมธอดดังกล่าวเพื่อเรียกรายชื่อผู้ติดตามช่องของ ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ -
ระบบได้นำออบเจ็กต์
invideoPromotion
ของทรัพยากรchannel
และพร็อพเพอร์ตี้ย่อยทั้งหมดออกจากเอกสารแล้ว โดยได้ประกาศว่าเลิกใช้งานไปเมื่อวันที่ 27 พฤศจิกายน 2017
29 กรกฎาคม 2020
เราได้ปรับปรุงกระบวนการเรียกเก็บเงินโควต้าสำหรับคำขอ API โดยการนำค่าใช้จ่ายเพิ่มเติมที่เชื่อมโยงกับพารามิเตอร์ part
ออก ตั้งแต่วันนี้เป็นต้นไป เราจะเรียกเก็บเฉพาะ
ต้นทุนพื้นฐานสำหรับวิธีการที่เรียกใช้ ดูข้อมูลเพิ่มเติมเกี่ยวกับโควต้าที่ลดความซับซ้อนแล้วได้ที่นี่
การเปลี่ยนแปลงนี้จะส่งผลให้การเรียก API ส่วนใหญ่มีต้นทุนโควต้าลดลงเล็กน้อย ขณะที่การเรียก API บางรายการจะยังมีต้นทุนเท่าเดิม การเปลี่ยนแปลงนี้จะไม่เพิ่มค่าใช้จ่ายในการเรียก API โดยรวมแล้ว ผลกระทบที่อาจเกิดขึ้นคือโควต้าที่จัดสรรไว้ซึ่งดูได้ใน Google Cloud Console จะใช้งานได้นานขึ้นเล็กน้อย
เราขอแนะนำให้นักพัฒนาแอปทุกรายทำการตรวจสอบการปฏิบัติตามข้อกำหนดสำหรับโปรเจ็กต์ของตนให้เสร็จสมบูรณ์ เพื่อให้มั่นใจว่าจะเข้าถึงบริการ API ของ YouTube ได้อย่างต่อเนื่อง
รายการประวัติการแก้ไขนี้เผยแพร่ครั้งแรกเมื่อวันที่ 20 กรกฎาคม 2020
28 กรกฎาคม 2020
วิดีโอทั้งหมดที่อัปโหลดผ่านปลายทาง videos.insert
จากโปรเจ็กต์ API ที่ไม่ได้รับการยืนยันซึ่งสร้างขึ้นหลังจากวันที่ 28 กรกฎาคม 2020 จะถูกจำกัดให้
ดูได้เฉพาะในโหมดส่วนตัว หากต้องการยกเลิกข้อจำกัดนี้ แต่ละโปรเจ็กต์ต้องเข้ารับการตรวจสอบเพื่อยืนยันการปฏิบัติตามข้อกำหนดในการให้บริการ
ครีเอเตอร์ที่ใช้ไคลเอ็นต์ API ที่ไม่ได้รับการยืนยันเพื่ออัปโหลดวิดีโอจะได้รับอีเมลที่อธิบายว่า วิดีโอของตนถูกล็อกเป็นส่วนตัว และสามารถหลีกเลี่ยงข้อจำกัดได้โดยใช้ไคลเอ็นต์อย่างเป็นทางการ หรือไคลเอ็นต์ที่ผ่านการตรวจสอบ
โปรเจ็กต์ API ที่สร้างก่อนวันที่ 28 กรกฎาคม 2020 จะ ไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้ในขณะนี้ อย่างไรก็ตาม เราขอแนะนำให้นักพัฒนาแอปทุกรายทำการตรวจสอบการปฏิบัติตามข้อกำหนดสำหรับโปรเจ็กต์ของตนเพื่อให้เข้าถึงบริการ API ของ YouTube ได้อย่างต่อเนื่อง
21 กรกฎาคม 2020
[อัปเดตเมื่อวันที่ 28 กรกฎาคม 2020] การปรับปรุงเอกสารประกอบที่อ้างอิงในรายการประวัติการแก้ไขนี้ ได้รับการเผยแพร่ซ้ำเมื่อวันที่ 28 กรกฎาคม 2020
เมื่อวานนี้ เราได้เผยแพร่การอัปเดตเอกสารประกอบที่เกี่ยวข้องกับกระบวนการเรียกเก็บเงินโควต้า อย่างไรก็ตาม เนื่องด้วยสถานการณ์ที่ไม่คาดคิด การเปลี่ยนแปลงโควต้าจึงยังไม่มีผล ด้วยเหตุนี้ เราจึงได้เปลี่ยนกลับไปใช้เอกสารประกอบ เพื่อความถูกต้อง เพื่อไม่ให้เกิดความสับสน เราได้นำรายการประวัติการแก้ไข ที่อธิบายการเปลี่ยนแปลงออกแล้ว และจะเผยแพร่ซ้ำในอนาคตอันใกล้นี้
7 กรกฎาคม 2020
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
ตอนนี้พารามิเตอร์ autoLevels
และ stabilize
ของเมธอด videos.insert
เลิกใช้งานแล้ว และได้นำพารามิเตอร์ทั้ง 2 รายการออกจากเอกสารประกอบแล้ว ระบบจะไม่สนใจค่าเหล่านี้และจะไม่ส่งผลต่อ
วิธีประมวลผลวิดีโอที่อัปโหลดใหม่
15 มิถุนายน 2020
คำแนะนำการปฏิบัติตามนโยบายสำหรับนักพัฒนาซอฟต์แวร์ ของ YouTube ฉบับใหม่นี้มีคำแนะนำและตัวอย่างที่จะช่วยให้คุณมั่นใจได้ว่าไคลเอ็นต์ API ของคุณปฏิบัติตาม ส่วนที่เฉพาะเจาะจงของข้อกำหนดและ นโยบาย (ข้อกำหนดในการให้บริการของ API) ของบริการ API ของ YouTube
คำแนะนำนี้จะให้ข้อมูลเชิงลึกเกี่ยวกับวิธีที่ YouTube บังคับใช้ข้อกำหนดในการให้บริการของ API ในบางแง่มุม แต่ไม่ได้แทนที่เอกสารที่มีอยู่ คู่มือนี้จะตอบคำถามที่พบบ่อยที่สุดบางส่วนที่ นักพัฒนาแอปถามระหว่างการตรวจสอบการปฏิบัติตามข้อกำหนดของ API เราหวังว่าเอกสารนี้จะช่วยลดความซับซ้อนของกระบวนการพัฒนาฟีเจอร์ ด้วยการช่วยให้คุณเข้าใจวิธีที่เราตีความและบังคับใช้นโยบาย
4 มิถุนายน 2020
หมายเหตุ: นี่เป็นการอัปเดตประกาศการเลิกใช้งานก่อนหน้านี้
ตอนนี้เราได้เลิกใช้งานฟีเจอร์กระดานข่าวของช่องอย่างสมบูรณ์แล้ว การเปลี่ยนแปลงนี้ได้รับการประกาศครั้งแรก
เมื่อวันที่ 17 เมษายน 2020 และตอนนี้มีผลแล้ว ด้วยเหตุนี้ ระบบจึงไม่รองรับ
วิธีการ activities.insert
อีกต่อไป
และวิธีการ activities.list
จะไม่แสดงกระดานข่าวของช่องอีกต่อไป ดูรายละเอียดเพิ่มเติมได้ที่
ศูนย์ช่วยเหลือของ YouTube
17 เมษายน 2020
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
YouTube จะเลิกใช้งานฟีเจอร์กระดานข่าวของช่อง ด้วยเหตุนี้ เราจึงจะเลิกใช้งาน
วิธีการ activities.insert
และวิธีการ activities.list
จะหยุดแสดงกระดานข่าวของช่อง การเปลี่ยนแปลงเหล่านี้จะมีผลใน API ตั้งแต่วันที่ 18 พฤษภาคม 2020 เป็นต้นไป
ดูรายละเอียดเพิ่มเติมได้ที่
ศูนย์ช่วยเหลือของ YouTube
31 มีนาคม 2020
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูลและวิธีการใหม่ๆ
-
แหล่งข้อมูล
member
ใหม่แสดงถึง สมาชิกของช่องสำหรับช่อง YouTube สมาชิกจะให้การสนับสนุนทางการเงินแก่ครีเอเตอร์ตามรอบและรับสิทธิประโยชน์พิเศษ เช่น สมาชิกจะแชทได้เมื่อ ครีเอเตอร์เปิดโหมดสำหรับสมาชิกเท่านั้นสำหรับแชทแหล่งข้อมูลนี้จะมาแทนที่แหล่งข้อมูล
sponsor
ซึ่งมีเอกสารประกอบเป็นส่วนหนึ่งของ YouTube Live Streaming API ขณะนี้ระบบได้เลิกใช้งานรีซอร์สsponsor
แล้ว และไคลเอ็นต์ API ควรจะอัปเดตการเรียกไปยังเมธอดsponsors.list
เพื่อใช้เมธอดmembers.list
แทน -
membershipsLevel
ใหม่ระบุระดับราคาที่ครีเอเตอร์ซึ่งให้สิทธิ์คำขอ API เป็นผู้จัดการ เมธอดmembershipsLevels.list
จะดึงรายการระดับการเป็นสมาชิกทั้งหมดของครีเอเตอร์
-
10 มกราคม 2020
ตอนนี้ API รองรับความสามารถในการระบุเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย ซึ่ง YouTube เรียกว่า "สร้างมาเพื่อเด็ก" แล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับ เนื้อหาที่ "สร้างมาเพื่อเด็ก" ในศูนย์ช่วยเหลือของ YouTube
แหล่งข้อมูล channel
และ
video
รองรับพร็อพเพอร์ตี้ใหม่ 2 รายการเพื่อ
ช่วยให้ครีเอเตอร์และผู้ชมระบุเนื้อหาที่สร้างมาเพื่อเด็กได้
-
พร็อพเพอร์ตี้
selfDeclaredMadeForKids
ช่วยให้ครีเอเตอร์เนื้อหาระบุได้ว่าช่องหรือวิดีโอสร้างมาเพื่อเด็กหรือไม่
สำหรับช่อง คุณตั้งค่าพร็อพเพอร์ตี้นี้ได้เมื่อเรียกใช้เมธอดchannels.update
สำหรับวิดีโอ คุณตั้งค่าพร็อพเพอร์ตี้นี้ได้เมื่อเรียกใช้เมธอดvideos.insert
หรือvideos.update
โปรดทราบว่าพร็อพเพอร์ตี้นี้จะรวมอยู่ในคำตอบของ API ที่มีทรัพยากรchannel
หรือvideo
ก็ต่อเมื่อเจ้าของช่องอนุญาตคำขอ API -
พร็อพเพอร์ตี้
madeForKids
ช่วยให้ผู้ใช้ทุกคนดึงข้อมูลสถานะ "สร้างมาเพื่อเด็ก" ของช่องหรือวิดีโอได้ เช่น สถานะอาจ กำหนดโดยอิงตามค่าของพร็อพเพอร์ตี้selfDeclaredMadeForKids
ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดผู้ชมสำหรับช่อง วิดีโอ หรือการออกอากาศได้ที่ ศูนย์ช่วยเหลือของ YouTube
นอกจากนี้ เรายังได้ปรับปรุงข้อกำหนดในการให้บริการของบริการ YouTube API และนโยบายสำหรับนักพัฒนาซอฟต์แวร์ด้วย โปรดดูข้อมูลเพิ่มเติมที่ข้อกำหนดในการให้บริการของ API ของ YouTube - ประวัติการแก้ไข การเปลี่ยนแปลงข้อกำหนดในการให้บริการของบริการ YouTube API และ นโยบายสำหรับนักพัฒนาซอฟต์แวร์จะมีผลในวันที่ 10 มกราคม 2020 ตามเวลาแปซิฟิก
10 กันยายน 2019
เราได้อัปเดตเอกสารอ้างอิง API เพื่อให้สอดคล้องกับการเปลี่ยนแปลงวิธีรายงานจำนวนผู้ติดตาม
บน YouTube และในการตอบกลับของ API การเปลี่ยนแปลงนี้จะส่งผลให้
ระบบจะปัดเศษจำนวนผู้ติดตามที่บริการ YouTube Data API แสดงลงให้เหลือตัวเลขที่มีนัยสำคัญ 3 ตัว
สำหรับจำนวนผู้ติดตามที่มากกว่า 1,000 คน การเปลี่ยนแปลงนี้ส่งผลต่อพร็อพเพอร์ตี้
channel
ของแหล่งข้อมูล
statistics.subscriberCount
หมายเหตุ: การเปลี่ยนแปลงนี้จะส่งผลต่อค่าพร็อพเพอร์ตี้นี้แม้ในกรณีที่ผู้ใช้ ส่งคำขอที่ได้รับอนุญาตสำหรับข้อมูลเกี่ยวกับช่องของตนเอง เจ้าของช่องจะยังคงดูจำนวนผู้ติดตามที่แน่นอนได้ใน YouTube Studio
เช่น หากช่องมีผู้ติดตาม 123,456 คน พร็อพเพอร์ตี้
statistics.subscriberCount
จะมีค่า 123000
ตารางด้านล่างแสดงตัวอย่างวิธีปัดเศษจำนวนผู้ติดตามในการตอบกลับของ API และ
การย่อในอินเทอร์เฟซผู้ใช้ YouTube อื่นๆ ที่แสดงต่อสาธารณะ
ตัวอย่างจำนวนผู้ติดตาม | YouTube Data API | UI ของ YouTube ที่มองเห็นได้แบบสาธารณะ |
---|---|---|
1,234 | 1230 | 1.23 พัน |
12,345 | 12300 | 1.23 หมื่น |
123,456 | 123000 | 1.23 แสน |
1,234,567 | 1230000 | 1.23 ล้าน |
12,345,678 | 12300000 | 12.3 ล้าน |
123,456,789 | 123000000 | 123 ล้าน |
4 เมษายน 2019
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตเอกสารอ้างอิง API เพื่ออธิบายกรณีการใช้งานทั่วไปของแต่ละเมธอดให้ดียิ่งขึ้น และเพื่อจัดหาตัวอย่างโค้ดแบบไดนามิกคุณภาพสูงผ่านวิดเจ็ต API Explorer ดูตัวอย่างได้ในเอกสารประกอบของเมธอด
channels.list
ตอนนี้หน้าเว็บที่อธิบายเมธอด API มีองค์ประกอบใหม่ 2 อย่าง ดังนี้-
วิดเจ็ตตัวสำรวจ API ช่วยให้คุณเลือกขอบเขตการให้สิทธิ์ ป้อนค่าพารามิเตอร์และพร็อพเพอร์ตี้ตัวอย่าง จากนั้นส่งคำขอ API จริงและดูการตอบกลับ API จริงได้ วิดเจ็ตยังมีมุมมองแบบเต็มหน้าจอที่แสดงตัวอย่างโค้ดที่สมบูรณ์ ซึ่งจะอัปเดตแบบไดนามิกเพื่อใช้ขอบเขตและค่าที่คุณป้อน
-
ส่วนUse Case ทั่วไปจะอธิบาย Use Case ทั่วไปอย่างน้อย 1 รายการสำหรับเมธอดที่อธิบายไว้ในหน้าเว็บ เช่น คุณสามารถเรียกใช้เมธอด
channels.list
เพื่อดึงข้อมูลเกี่ยวกับช่องที่เฉพาะเจาะจง หรือดึงข้อมูลเกี่ยวกับช่องของผู้ใช้ปัจจุบันคุณสามารถใช้ลิงก์ในส่วนนั้นเพื่อป้อนค่าตัวอย่างสำหรับกรณีการใช้งานของคุณลงในเครื่องมือสำรวจ API หรือเปิดเครื่องมือสำรวจ API แบบเต็มหน้าจอโดยมีค่าเหล่านั้นป้อนไว้แล้ว การเปลี่ยนแปลงเหล่านี้มีจุดมุ่งหมายเพื่อให้คุณดูตัวอย่างโค้ดที่ใช้ได้โดยตรงกับกรณีการใช้งานที่คุณพยายามนำไปใช้ในแอปพลิเคชันของคุณเองได้ง่ายขึ้น
ปัจจุบันตัวอย่างโค้ดรองรับ Java, JavaScript, PHP, Python และ curl
-
-
นอกจากนี้ เรายังได้อัปเดตเครื่องมือตัวอย่างโค้ดด้วย UI ใหม่ที่มีฟีเจอร์ทั้งหมดเหมือนกับที่อธิบายไว้ข้างต้น เครื่องมือนี้ช่วยให้คุณสำรวจกรณีการใช้งานสำหรับวิธีการต่างๆ โหลดค่าลงใน API Explorer และเปิด API Explorer แบบเต็มหน้าจอเพื่อดูตัวอย่างโค้ดใน Java, JavaScript, PHP และ Python ได้
และในการเปลี่ยนแปลงครั้งนี้ เราได้นำหน้าเว็บที่แสดงตัวอย่างโค้ดที่พร้อมใช้งานสำหรับ Java, JavaScript, PHP และ Python ออกแล้ว
-
เราได้อัปเดตคู่มือเริ่มใช้งานฉบับย่อสำหรับ Java, JavaScript, PHP และ Python แล้ว คำแนะนำที่แก้ไขแล้วจะอธิบายวิธีเรียกใช้ตัวอย่างหนึ่งด้วยคีย์ API และอีกตัวอย่างหนึ่งด้วยรหัสไคลเอ็นต์ OAuth 2.0 โดยใช้ตัวอย่างโค้ดจากโปรแกรมสำรวจ API
โปรดทราบว่าการเปลี่ยนแปลงที่อธิบายไว้ข้างต้นจะแทนที่เครื่องมือแบบอินเทอร์แอกทีฟที่เพิ่มลงในเอกสารประกอบ API ในปี 2017
9 กรกฎาคม 2018
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
คำจำกัดความของพร็อพเพอร์ตี้
snippet.thumbnails
ของchannel
ทรัพยากรได้รับการอัปเดตเพื่อระบุว่าเมื่อแสดงภาพขนาดย่อในแอปพลิเคชัน โค้ดควรใช้ URL ของรูปภาพตรงตามที่แสดงในคำตอบของ API เช่น แอปพลิเคชันของคุณไม่ควรใช้โดเมนhttp
แทนโดเมนhttps
ใน URL ที่แสดงผลในคำตอบของ APIตั้งแต่เดือนกรกฎาคม 2018 เป็นต้นไป URL ของภาพปกช่องจะใช้ได้ในโดเมน
https
เท่านั้น ซึ่งเป็นลักษณะที่ URL ปรากฏในการตอบกลับของ API หลังจากนั้น คุณอาจเห็นรูปภาพที่ไม่สมบูรณ์ในแอปพลิเคชันหากแอปพยายามโหลดรูปภาพ YouTube จากโดเมนhttp
-
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
เลิกใช้งานพร็อพเพอร์ตี้
recordingDetails.location.altitude
ของทรัพยากรvideo
แล้ว ไม่มีการรับประกันว่าวิดีโอจะแสดงค่าสำหรับพร็อพเพอร์ตี้นี้ ในทํานองเดียวกัน แม้ว่าคําขอ API จะพยายามตั้งค่าสําหรับพร็อพเพอร์ตี้นั้น แต่ก็เป็นไปได้ที่ระบบจะไม่จัดเก็บข้อมูลขาเข้า
22 มิถุนายน 2018
เราได้อัปเดตคู่มือการติดตั้งใช้งาน ซึ่งเดิมเรียกว่าคู่มือการติดตั้งใช้งานและการย้ายข้อมูล เพื่อนำวิธีการย้ายข้อมูลจาก v2 API ไปยัง v3 API ออก นอกจากนี้ เรายังได้นำวิธีการสำหรับฟีเจอร์ที่เลิกใช้ไปแล้วใน v3 API เช่น วิดีโอโปรด ออกด้วย
27 พฤศจิกายน 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
YouTube จะหยุดรองรับฟีเจอร์วิดีโอเด่นและเว็บไซต์เด่น ซึ่งรองรับใน API ผ่านออบเจ็กต์
invideoPromotion
ของทรัพยากรchannel
ด้วยเหตุนี้ เราจึงจะเลิกใช้งานออบเจ็กต์ดังกล่าว รวมถึงพร็อพเพอร์ตี้ย่อยทั้งหมดคุณยังคงดึงและตั้งค่าข้อมูล
invideoPromotion
ได้จนถึงวันที่ 14 ธันวาคม 2017 สิ่งที่จะเกิดขึ้นหลังจากวันที่ดังกล่าว- การพยายามดึงข้อมูลส่วน
invideoPromotion
เมื่อเรียกใช้channels.list
จะแสดงผลinvideoPromotion
ที่ว่างเปล่า หรือไม่แสดงผลข้อมูลinvideoPromotion
เลย - การพยายามอัปเดตข้อมูล
invideoPromotion
เมื่อเรียกใช้channels.update
จะแสดงผลการตอบกลับที่สําเร็จจนถึงวันที่ 27 พฤษภาคม 2018 เป็นอย่างน้อย แต่จะถือว่าเป็นการดำเนินการที่ไม่มีผล ซึ่งหมายความว่าจะไม่มีการอัปเดตจริง
หลังจากวันที่ 27 พฤษภาคม 2018 คำขอเหล่านี้อาจแสดงข้อความแสดงข้อผิดพลาดเพื่อระบุว่า
invalidPromotion
เป็นส่วนที่ไม่ถูกต้อง เป็นต้น - การพยายามดึงข้อมูลส่วน
16 พฤศจิกายน 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟรองรับตัวอย่างโค้ด Node.js แล้ว นอกจากนี้ คุณยังดูตัวอย่างได้ในเอกสารประกอบสำหรับเมธอด API เกือบทั้งหมด เช่น เมธอด
channels.list
ตัวอย่างที่ปรับแต่งได้ออกแบบมาเพื่อให้คุณมีจุดเริ่มต้นเฉพาะกรณีการใช้งานสำหรับแอปพลิเคชัน Node.js ฟังก์ชันการทำงานจะคล้ายกับโค้ดในคู่มือเริ่มต้นใช้งาน Node.js อย่างรวดเร็ว อย่างไรก็ตาม ตัวอย่างมีฟังก์ชันยูทิลิตีบางอย่างที่ไม่ได้ปรากฏในคู่มือเริ่มต้นฉบับย่อ
- ฟังก์ชัน
removeEmptyParameters
จะใช้รายการคู่คีย์-ค่าที่สอดคล้องกับพารามิเตอร์คำขอ API และนำพารามิเตอร์ที่ไม่มีค่าออก - ฟังก์ชัน
createResource
จะรับรายการคู่คีย์-ค่าที่สอดคล้องกับพร็อพเพอร์ตี้ในทรัพยากร API จากนั้นจะแปลงพร็อพเพอร์ตี้เป็นออบเจ็กต์ JSON ที่ใช้ในการดำเนินการinsert
และupdate
ได้ ตัวอย่างด้านล่างแสดงชุดชื่อและค่าพร็อพเพอร์ตี้ รวมถึงออบเจ็กต์ JSON ที่โค้ดจะสร้างขึ้นสำหรับพร็อพเพอร์ตี้นั้น# Key-value pairs: {'id': 'ABC123', 'snippet.title': 'Resource title', 'snippet.description': 'Resource description', 'status.privacyStatus': 'private'} # JSON object: { 'id': 'ABC123', 'snippet': { 'title': 'Resource title', 'description': 'Resource description', }, 'status': { 'privacyStatus': 'private' } }
ตัวอย่างทั้งหมดนี้ออกแบบมาเพื่อให้ดาวน์โหลดและเรียกใช้ได้ในเครื่อง ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดเบื้องต้นสำหรับการเรียกใช้ตัวอย่างโค้ดแบบเต็มในเครื่องในวิธีการใช้เครื่องมือข้อมูลโค้ด
- ฟังก์ชัน
25 ตุลาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตตัวอย่างโค้ด Python ในเครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟให้ใช้ไลบรารี
google-auth
และgoogle-auth-oauthlib
แทนไลบรารีoauth2client
ซึ่งเลิกใช้งานแล้วนอกจากการเปลี่ยนแปลงดังกล่าวแล้ว ตอนนี้เครื่องมือยังมีตัวอย่างโค้ดแบบเต็มสำหรับแอปพลิเคชัน Python ที่ติดตั้งและแอปพลิเคชันเว็บเซิร์ฟเวอร์ Python ซึ่งใช้ขั้นตอนการให้สิทธิ์ที่แตกต่างกันเล็กน้อย หากต้องการดูตัวอย่างทั้งหมด (และการเปลี่ยนแปลงนี้) ให้ทำดังนี้
- ไปที่เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟหรือเอกสารประกอบสำหรับเมธอด API ใดก็ได้ เช่น เมธอด
channels.list
- คลิกแท็บ
Python
เหนือตัวอย่างโค้ด - คลิกปุ่มเปิด/ปิดเหนือแท็บเพื่อเปลี่ยนจากตัวอย่างเป็นตัวอย่างแบบเต็ม
- ตอนนี้แท็บควรแสดงตัวอย่างโค้ดที่สมบูรณ์ซึ่งใช้ขั้นตอนการให้สิทธิ์
InstalledAppFlow
คำอธิบายเหนือตัวอย่างจะอธิบายเรื่องนี้และลิงก์ไปยังตัวอย่างสำหรับแอปพลิเคชันเว็บเซิร์ฟเวอร์ด้วย - คลิกลิงก์เพื่อเปลี่ยนไปที่ตัวอย่างเว็บเซิร์ฟเวอร์ ตัวอย่างดังกล่าวใช้เฟรมเวิร์กเว็บแอปพลิเคชัน Flask และกระบวนการให้สิทธิ์ที่แตกต่างกัน
ตัวอย่างทั้งหมดนี้ออกแบบมาเพื่อให้ดาวน์โหลดและเรียกใช้ได้ในเครื่อง หากต้องการเรียกใช้ตัวอย่าง ให้ดูวิธีการเรียกใช้ตัวอย่างโค้ดแบบเต็มในเครื่องในวิธีการของเครื่องมือข้อมูลโค้ด
- ไปที่เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟหรือเอกสารประกอบสำหรับเมธอด API ใดก็ได้ เช่น เมธอด
29 สิงหาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
- เราได้อัปเดตคำจำกัดความของพารามิเตอร์
forContentOwner
ของเมธอดsearch.list
เพื่อระบุว่าหากตั้งค่าพารามิเตอร์ดังกล่าวเป็นtrue
คุณจะต้องตั้งค่าพารามิเตอร์type
เป็นvideo
- เราได้อัปเดตคำจำกัดความของพารามิเตอร์
regionCode
ของเมธอดsearch.list
เพื่อชี้แจงว่าพารามิเตอร์จะจำกัดผลการค้นหาให้แสดงเฉพาะวิดีโอที่ดูได้ในภูมิภาคที่ระบุ - YouTube ได้อัปเดตโลโก้และไอคอนการสร้างแบรนด์แล้ว คุณดาวน์โหลดโลโก้ใหม่ "พัฒนาด้วย YouTube" ได้จากหน้าหลักเกณฑ์การใช้แบรนด์ นอกจากนี้ ยังมีโลโก้และไอคอนใหม่ๆ อื่นๆ ของ YouTube แสดงอยู่ในหน้านั้นด้วย และคุณสามารถดาวน์โหลดได้จากเว็บไซต์แบรนด์ของ YouTube
24 กรกฎาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
- คู่มือเริ่มต้นใช้งาน YouTube Data API ฉบับย่อใหม่พร้อมให้บริการสำหรับ iOS แล้ว คู่มือนี้อธิบายวิธีใช้ YouTube Data API ในแอปพลิเคชัน iOS อย่างง่ายที่เขียนด้วย Objective-C หรือ Swift
- ตอนนี้เครื่องมือโค้ดแบบอินเทอร์แอกทีฟสำหรับ YouTube Data API มีเอกสารประกอบที่อธิบายฟีเจอร์บางอย่างของเครื่องมือแล้ว
- การดำเนินการคำขอ API
- สลับระหว่างข้อมูลโค้ดและตัวอย่างโค้ดแบบเต็ม
- การใช้ฟังก์ชัน Boilerplate
- กำลังโหลดทรัพยากรที่มีอยู่ (สำหรับวิธีการอัปเดต)
หมายเหตุ: เครื่องมือนี้ยังฝังอยู่ในเอกสารประกอบข้อมูลอ้างอิง API สำหรับเมธอด API (ตัวอย่าง) ด้วย
1 มิถุนายน 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
เราจะเลิกใช้งานพร็อพเพอร์ตี้ทรัพยากร
video
ต่อไปนี้ แม้ว่าระบบจะรองรับพร็อพเพอร์ตี้จนถึงวันที่ 1 ธันวาคม 2017 แต่ก็ไม่รับประกันว่าวิดีโอจะยังคงแสดงค่าสำหรับพร็อพเพอร์ตี้เหล่านั้นจนถึงเวลานั้น ในทํานองเดียวกัน คําขอvideos.insert
และvideos.update
ที่ตั้งค่าพร็อพเพอร์ตีเหล่านั้นจะไม่ทําให้เกิดข้อผิดพลาดก่อนวันที่ดังกล่าว แต่เป็นไปได้ว่าระบบจะไม่จัดเก็บข้อมูลขาเข้า
17 พฤษภาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตเอกสารอ้างอิง API เพื่อให้ข้อมูลโค้ดมีความแพร่หลายและมีการโต้ตอบมากขึ้น ตอนนี้หน้าเว็บที่อธิบายเมธอด API เช่น
channels.list
หรือvideos.rate
มีเครื่องมือแบบอินเทอร์แอกทีฟที่ให้คุณดูและปรับแต่งข้อมูลโค้ดใน Java, JavaScript, PHP, Python, Ruby, Apps Script และ Go ได้แล้วสําหรับแต่ละวิธี เครื่องมือจะแสดงข้อมูลโค้ดสําหรับ Use Case อย่างน้อย 1 รายการ และแต่ละ Use Case จะอธิบายวิธีกําหนดวิธีทั่วไป เช่น คุณเรียกใช้เมธอด
channels.list
เพื่อดึงข้อมูลเกี่ยวกับช่องที่เฉพาะเจาะจงหรือเกี่ยวกับช่องของผู้ใช้ปัจจุบันได้คุณยังโต้ตอบกับตัวอย่างโค้ดได้ด้วย โดยทำดังนี้
-
แก้ไขค่าพารามิเตอร์และพร็อพเพอร์ตี้ แล้วข้อมูลโค้ดจะอัปเดตแบบไดนามิกเพื่อให้ตรงกับค่าที่คุณระบุ
-
สลับระหว่างโค้ดที่ตัดตอนมากับตัวอย่างแบบเต็ม ข้อมูลโค้ดจะแสดงส่วนของโค้ดที่เรียกใช้เมธอด API ตัวอย่างแบบเต็มจะมีทั้งข้อมูลโค้ดดังกล่าวและโค้ดมาตรฐานสำหรับการให้สิทธิ์และส่งคำขอ คุณสามารถคัดลอกและเรียกใช้ตัวอย่างแบบเต็มจากบรรทัดคำสั่งหรือเว็บเซิร์ฟเวอร์ในเครื่องได้
-
ดำเนินการคำขอโดยคลิกปุ่ม (หากต้องการดำเนินการคำขอ คุณต้องให้สิทธิ์เครื่องมือในการเรียก API ในนามของคุณ)
โปรดทราบว่าเครื่องมือนี้ได้แทนที่โปรแกรมสำรวจ API ในหน้าที่มีเครื่องมือนี้ (แต่ละหน้าจะแสดงลิงก์เพื่อให้คุณมีตัวเลือกในการโหลดคำขอที่คุณกำลังดำเนินการในโปรแกรมสำรวจ API ด้วย)
-
-
นอกจากนี้ เรายังได้อัปเดตเครื่องมือข้อมูลโค้ด Data API ด้วย UI ใหม่ที่มีฟีเจอร์ทั้งหมดแบบเดียวกับที่อธิบายไว้ข้างต้น ฟีเจอร์ใหม่ที่สำคัญซึ่งพร้อมใช้งานในหน้านี้มีดังนี้
- รองรับคำขอ API ที่เขียนข้อมูล
- การสนับสนุนสำหรับตัวอย่าง Java
- โค้ดบอยเลอร์เพลตที่ยืดหยุ่นและครอบคลุมมากขึ้นสำหรับการให้สิทธิ์ผู้ใช้และการสร้างคำขอ API
27 เมษายน 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
- คู่มือการเริ่มต้นใช้งานฉบับใหม่จะอธิบายวิธีตั้งค่าแอปพลิเคชันอย่างง่ายที่ส่งคำขอไปยัง YouTube Data API ขณะนี้มีคำแนะนำสำหรับ Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python และ Ruby
30 มีนาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
channel
พร็อพเพอร์ตี้topicDetails.topicCategories[]
ใหม่ของแหล่งข้อมูลมีรายการ URL ของ Wikipedia ที่อธิบายเนื้อหาของช่อง URL ตรงกับรหัสหัวข้อที่แสดงผลในพร็อพเพอร์ตี้topicDetails.topicIds[]
ของทรัพยากร- พร็อพเพอร์ตี้
contentDetails.videoPublishedAt
ใหม่ของแหล่งข้อมูลplaylistItem
จะระบุเวลาที่เผยแพร่วิดีโอไปยัง YouTube ทรัพยากรมีพร็อพเพอร์ตี้snippet.publishedAt
อยู่แล้ว ซึ่งระบุเวลาที่เพิ่มรายการลงในเพลย์ลิสต์ - ตอนนี้ทรัพยากร
video
จะแสดงพร็อพเพอร์ตี้topicDetails.topicCategories[]
ซึ่งมีรายการ URL ของ Wikipedia ที่อธิบายเนื้อหาของวิดีโอ เช่นเดียวกับทรัพยากรchannel
สำหรับทรัพยากรvideo
URL จะตรงกับรหัสหัวข้อที่ส่งคืนในพร็อพเพอร์ตี้topicDetails.relevantTopicIds[]
ของทรัพยากร contentDetails.contentRating.mpaatRating
พร็อพเพอร์ตี้ใหม่ของทรัพยากรvideo
จะระบุการจัดประเภทที่สมาคมภาพยนตร์แห่งอเมริกา (Motion Picture Association of America) มอบให้แก่ตัวอย่างหรือตัวอย่างภาพยนตร์
27 กุมภาพันธ์ 2017
ตามที่ประกาศเมื่อวันที่ 11 สิงหาคม 2016 YouTube ได้เปลี่ยนรายการรหัสหัวข้อที่รองรับเป็นรายการที่คัดสรรแล้ว รายการรหัสหัวข้อที่รองรับทั้งหมดจะรวมอยู่ในพร็อพเพอร์ตี้ topicDetails
สำหรับทรัพยากร channel
และ video
รวมถึงในพารามิเตอร์ topicId
ของเมธอด search.list
โปรดทราบว่ารายการที่ดูแลจัดการมีการเปลี่ยนแปลงหลายอย่างดังนี้
- เราได้เพิ่มหัวข้อต่อไปนี้เป็นหัวข้อย่อยของ
Society
ชื่อ รหัสหัวข้อ ธุรกิจ /m/09s1f
สุขภาพ /m/0kt51
การทหาร /m/01h6rj
การเมือง /m/05qt0
ศาสนา /m/06bvp
- ระบบได้นำ
Animated cartoon
หัวข้อซึ่งก่อนหน้านี้เป็นหัวข้อย่อยของEntertainment
ออกแล้ว - ระบบได้นำ
Children's music
หัวข้อซึ่งก่อนหน้านี้เป็นหัวข้อย่อยของMusic
ออกแล้ว
การเปลี่ยนแปลงนี้ส่งผลให้ระบบจะแสดงหัวข้อที่เกี่ยวข้องกับวิดีโอในค่าพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[]
ของทรัพยากร video
เสมอ
29 พฤศจิกายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราจะทำการเปลี่ยนแปลงเล็กน้อย 3 รายการในรายการรหัสหัวข้อที่จะรองรับตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 ดังนี้
- ตอนนี้หมวดหมู่
Professional wrestling
ซึ่งก่อนหน้านี้เป็นหมวดหมู่ย่อยของหมวดหมู่Sports
ได้กลายเป็นหมวดหมู่ย่อยของEntertainment
แล้ว - หมวดหมู่
TV shows
ซึ่งเป็นหมวดหมู่ย่อยของEntertainment
เป็นหมวดหมู่ใหม่ - ระบบได้นำหมวดหมู่
Health
ซึ่งก่อนหน้านี้เป็นหมวดหมู่ย่อยของLifestyle
ออกแล้ว
โปรดทราบว่ามีหมวดหมู่หลักอยู่ 5 หมวดหมู่ (
Entertainment
,Gaming
,Lifestyle
,Music
และSports
) วิดีโอใดก็ตามที่เชื่อมโยงกับหมวดหมู่ย่อย เช่นTennis
จะเชื่อมโยงกับหมวดหมู่หลัก (Sports
) ด้วย - ตอนนี้หมวดหมู่
10 พฤศจิกายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตามที่ประกาศครั้งแรกเมื่อวันที่ 11 สิงหาคม 2016 การเลิกใช้งาน Freebase และ Freebase API จำเป็นต้องมีการเปลี่ยนแปลงหลายอย่างที่เกี่ยวข้องกับรหัสหัวข้อ รหัสหัวข้อจะระบุหัวข้อที่เชื่อมโยงกับแหล่งข้อมูล
channel
และvideo
และคุณยังใช้พารามิเตอร์การค้นหาtopicId
เพื่อค้นหาช่องหรือวิดีโอที่เกี่ยวข้องกับหัวข้อใดหัวข้อหนึ่งได้ด้วยในวันที่ 10 กุมภาพันธ์ 2017 YouTube จะเริ่มแสดงรหัสหัวข้อชุดเล็กแทนชุดรหัสที่มีรายละเอียดมากกว่าที่แสดงจนถึงปัจจุบัน นอกจากนี้ โปรดทราบว่าระบบไม่รับประกันว่าช่องและวิดีโอจะเชื่อมโยงกับหัวข้อใดๆ ซึ่งสอดคล้องกับลักษณะการทำงานของ API ในปัจจุบัน
เราจึงได้อัปเดตคำจำกัดความของพารามิเตอร์และพร็อพเพอร์ตี้ API ต่อไปนี้เพื่อแสดงรหัสหัวข้อที่จะรองรับหลังจากนั้น เพื่อให้คุณเตรียมไคลเอ็นต์ API สำหรับการเปลี่ยนแปลงเหล่านั้นได้ โปรดทราบว่ารายการหมวดหมู่จะเหมือนกันสำหรับพร็อพเพอร์ตี้ทั้งหมด
- พร็อพเพอร์ตี้
topicDetails.topicIds[]
ของทรัพยากรchannel
- พร็อพเพอร์ตี้
topicDetails.relevantTopicIds[]
ของทรัพยากรvideo
- พารามิเตอร์
topicId
ของเมธอดsearch.list
- พร็อพเพอร์ตี้
-
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
เราจะเลิกใช้งานพร็อพเพอร์ตี้ต่อไปนี้
- พร็อพเพอร์ตี้
topicDetails.topicIds[]
ของทรัพยากรchannel
เราจะรองรับพร็อพเพอร์ตี้นี้จนถึงวันที่ 10 พฤศจิกายน 2017 - พร็อพเพอร์ตี้
topicDetails.relevantTopicIds[]
ของทรัพยากรvideo
เราจะรองรับพร็อพเพอร์ตี้นี้จนถึงวันที่ 10 พฤศจิกายน 2017 - พร็อพเพอร์ตี้
topicDetails.topicIds[]
ของทรัพยากรvideo
พร็อพเพอร์ตี้นี้จะไม่มีค่าหลังจากวันที่ 10 กุมภาพันธ์ 2017 (หลังจากวันที่ดังกล่าว ค่าพร็อพเพอร์ตี้topicDetails.relevantTopicIds[]
จะระบุหัวข้อทั้งหมดที่เชื่อมโยงกับวิดีโอ)
- พร็อพเพอร์ตี้
-
เนื่องจากเราเลิกใช้งาน Freebase แล้ว เราจึงนำคู่มือการค้นหาด้วยหัวข้อ Freebase ออกจากเอกสารประกอบ ซึ่งคู่มือดังกล่าวมีตัวอย่างโค้ดที่แสดงให้เห็นว่าแอปพลิเคชันจะทำงานร่วมกับ Freebase API ได้อย่างไร
นอกจากนี้ เรายังได้นำตัวอย่างโค้ดหลายรายการที่เกี่ยวข้องกับรหัสหัวข้อออกจากเอกสารประกอบของเมธอด
search.list
2 พฤศจิกายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้และพารามิเตอร์ใหม่
-
ทรัพยากร
video
มีพร็อพเพอร์ตี้ใหม่หลายรายการ ดังนี้-
พร็อพเพอร์ตี้
player.embedHtml
มีแท็ก<iframe>
ที่คุณใช้ฝังเพลเยอร์ที่เล่นวิดีโอได้ พร็อพเพอร์ตี้player.embedHeight
และplayer.embedWidth
ใหม่จะระบุขนาดของเพลเยอร์ที่ฝัง ระบบจะแสดงผลพร็อพเพอร์ตี้เหล่านี้ก็ต่อเมื่อคำขอ API ระบุค่าสำหรับพารามิเตอร์maxHeight
หรือmaxWidth
อย่างน้อย 1 รายการ เราจะอธิบายพารามิเตอร์ใหม่ 2 รายการนี้ในภายหลังในรายการประวัติการแก้ไขนี้ -
พร็อพเพอร์ตี้
hasCustomThumbnail
ใหม่จะระบุว่าผู้อัปโหลดวิดีโอได้ระบุภาพขนาดย่อที่กำหนดเองสำหรับวิดีโอหรือไม่ โปรดทราบว่ามีเพียงผู้อัปโหลดวิดีโอเท่านั้นที่จะเห็นพร็อพเพอร์ตี้นี้ -
fpbRatingReasons[]
ใหม่ระบุเหตุผลที่วิดีโอได้รับการจัดประเภท FPB (แอฟริกาใต้) -
mcstRating
ใหม่ระบุการจัดประเภทที่วิดีโอได้รับในเวียดนาม
-
-
เมธอด
videos.list
รองรับพารามิเตอร์ใหม่ 2 รายการ ได้แก่maxHeight
และmaxWidth
คุณใช้พารามิเตอร์ใดพารามิเตอร์หนึ่งหรือทั้ง 2 พารามิเตอร์ได้เมื่อเรียกข้อมูลส่วนplayer
ในทรัพยากรvideo
โดยค่าเริ่มต้น ความสูงของ
<iframe>
ที่แสดงในพร็อพเพอร์ตี้player.embedHtml
คือ 360 พิกเซล ความกว้างจะปรับให้ตรงกับสัดส่วนภาพของวิดีโอ เพื่อให้มั่นใจว่าเพลเยอร์ที่ฝังจะไม่มีแถบสีดำล้อมรอบวิดีโอ เช่น หากอัตราส่วนภาพของวิดีโอเป็น 16:9 ความกว้างของเพลเยอร์จะเป็น 640 พิกเซลพารามิเตอร์ใหม่ช่วยให้คุณระบุได้ว่าโค้ดฝังควรใช้ความสูงและ/หรือความกว้างที่เหมาะสมกับเลย์เอาต์แอปพลิเคชันแทนที่จะใช้มิติข้อมูลเริ่มต้น เซิร์ฟเวอร์ API จะปรับขนาดเพลเยอร์ตามความเหมาะสมเพื่อให้มั่นใจว่าเพลเยอร์ที่ฝังจะไม่มีแถบสีดำล้อมรอบวิดีโอ โปรดทราบว่าพารามิเตอร์ทั้ง 2 รายการจะระบุขนาดสูงสุดของเพลเยอร์ที่ฝัง ดังนั้น หากระบุทั้ง 2 พารามิเตอร์ ขนาดของมิติข้อมูลหนึ่งอาจยังคงเล็กกว่าจำนวนสูงสุดที่อนุญาตสำหรับมิติข้อมูลนั้น
เช่น สมมติว่าวิดีโอมีสัดส่วนภาพ 16:9 ดังนั้น แท็ก
player.embedHtml
จะมีเพลเยอร์ขนาด 640x360 หากไม่ได้ตั้งค่าพารามิเตอร์maxHeight
หรือmaxWidth
- หากตั้งค่าพารามิเตอร์
maxHeight
เป็น720
และไม่ได้ตั้งค่าพารามิเตอร์maxWidth
API จะแสดงผลเพลเยอร์ขนาด 1280x720 - หากตั้งค่าพารามิเตอร์
maxWidth
เป็น960
และไม่ได้ตั้งค่าพารามิเตอร์maxHeight
ไว้ API จะแสดงผลเพลเยอร์ขนาด 960x540 - หากตั้งค่าพารามิเตอร์
maxWidth
เป็น960
และตั้งค่าพารามิเตอร์maxHeight
เป็น450
API จะแสดงเพลเยอร์ขนาด 800x450
พร็อพเพอร์ตี้
player.embedHeight
และplayer.embedWidth
ใหม่ที่อธิบายไว้ข้างต้นจะระบุขนาดของเพลเยอร์ - หากตั้งค่าพารามิเตอร์
-
-
การอัปเดตเมธอด พร็อพเพอร์ตี้ และพารามิเตอร์ที่มีอยู่
-
channelSection
คำอธิบายทรัพยากรได้รับการอัปเดตเพื่อระบุว่าช่องสามารถสร้างชั้นวางได้สูงสุด 10 รายการโดยไม่ต้องตั้งค่าข้อมูลการกำหนดเป้าหมาย และสร้างชั้นวางได้สูงสุด 100 รายการโดยใช้ข้อมูลการกำหนดเป้าหมายนอกจากนี้ เรายังได้อัปเดตพร็อพเพอร์ตี้
targeting
ของทรัพยากรchannelSection
เพื่อแสดงให้เห็นว่าตัวเลือกการกำหนดเป้าหมายจะตั้งค่าได้โดยใช้ API เท่านั้น ระบบจะลบตัวเลือกการกำหนดเป้าหมายหากมีการแก้ไขส่วนของช่องโดยใช้อินเทอร์เฟซผู้ใช้ในเว็บไซต์ YouTube -
การกำหนดพร็อพเพอร์ตี้
snippet.name
ของทรัพยากรi18nLanguage
ได้รับการแก้ไขเพื่อให้สอดคล้องกับค่าที่แสดงชื่อของภาษาตามที่เขียนในภาษาที่ระบุโดยพารามิเตอร์hl
ของเมธอดi18nLanguage.list
-
พร็อพเพอร์ตี้
contentDetails.note
ของทรัพยากรplaylistItem
ได้รับการอัปเดตเพื่อระบุว่าค่าพร็อพเพอร์ตี้มีความยาวสูงสุด 280 อักขระ -
เลิกใช้งานพร็อพเพอร์ตี้
contentDetails.startAt
และcontentDetails.endAt
ของทรัพยากรplaylistItem
แล้ว ระบบจะไม่สนใจฟิลด์เหล่านี้หากมีการตั้งค่าในคำขอplaylistItems.insert
หรือplaylistItems.update
-
ตอนนี้เมธอด
playlistItems.delete
และplaylistItems.update
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งก่อนหน้านี้รองรับเมธอดอื่นๆ อยู่หลายรายการ คำขอที่ใช้วิธีดังกล่าวจะต้องได้รับอนุญาตด้วยโทเค็นที่ให้สิทธิ์เข้าถึงขอบเขตhttps://www.googleapis.com/auth/youtubepartner
ด้วย -
พารามิเตอร์
publishedBefore
และpublishedAfter
ของเมธอดsearch.list
ได้รับการอัปเดตเพื่อระบุว่าค่าพารามิเตอร์รวมอยู่ด้วย เช่น หากตั้งค่าพารามิเตอร์publishedBefore
API จะแสดงผลทรัพยากรที่สร้างขึ้นก่อนหรือในเวลาที่ระบุ -
พร็อพเพอร์ตี้
contentDetails.contentRating.grfilmRating
ของแหล่งข้อมูลvideo
รองรับค่าเพิ่มเติม 3 ค่า ได้แก่grfilmK12
,grfilmK15
และgrfilmK18
-
videos.insert
คำอธิบายเมธอดได้รับการอัปเดตเพื่อระบุว่าขนาดไฟล์สูงสุดสำหรับวิดีโอที่อัปโหลดเพิ่มขึ้นจาก 64 GB เป็น 128 GB
-
-
ข้อผิดพลาดใหม่และที่อัปเดต
-
API รองรับข้อผิดพลาดใหม่ต่อไปนี้
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย forbidden (403)
homeParameterDeprecated
เมธอด activities.list
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าข้อมูลกิจกรรมในหน้าแรกของผู้ใช้ไม่พร้อมใช้งานผ่าน API นี้ ข้อผิดพลาดนี้อาจเกิดขึ้นหากคุณตั้งค่าพารามิเตอร์home
เป็นtrue
ในคำขอที่ไม่ได้รับอนุญาตinvalidValue (400)
invalidContentDetails
เมธอด playlistItems.insert
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าออบเจ็กต์contentDetails
ในคำขอไม่ถูกต้อง สาเหตุหนึ่งที่ทำให้เกิดข้อผิดพลาดนี้คือฟิลด์contentDetails.note
มีความยาวมากกว่า 280 อักขระforbidden (403)
watchHistoryNotAccessible
เมธอด playlistItems.list
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคำขอพยายามดึงข้อมูลรายการในเพลย์ลิสต์ "ประวัติการดู" แต่ไม่สามารถดึงข้อมูลดังกล่าวโดยใช้ API ได้forbidden (403)
watchLaterNotAccessible
เมธอด playlistItems.list
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคำขอพยายามดึงข้อมูลรายการในเพลย์ลิสต์ "ดูภายหลัง" แต่ดึงข้อมูลเหล่านั้นโดยใช้ API ไม่ได้badRequest (400)
uploadLimitExceeded
videos.insert
เมธอดจะแสดงข้อผิดพลาดนี้เพื่อระบุว่าช่องอัปโหลดวิดีโอเกินจำนวนที่อนุญาตforbidden (403)
forbiddenEmbedSetting
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคำขอ API พยายามตั้งค่าการฝังที่ไม่ถูกต้องสำหรับวิดีโอ โปรดทราบว่าบางช่องอาจไม่มีสิทธิ์เสนอเพลเยอร์ที่ฝังสำหรับสตรีมแบบสด ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube -
ตอนนี้วิธี
playlistItems.insert
จะไม่แสดงข้อผิดพลาดอีกต่อไปหากคุณแทรกวิดีโอที่ซ้ำกันลงในเพลย์ลิสต์ ก่อนหน้านี้ข้อผิดพลาดดังกล่าวเกิดขึ้นกับเพลย์ลิสต์บางรายการ เช่น วิดีโอโปรด ซึ่งไม่อนุญาตให้มีวิดีโอซ้ำ แต่ปัจจุบันระบบไม่รองรับเพลย์ลิสต์ดังกล่าวแล้ว โดยทั่วไปแล้ว เพลย์ลิสต์จะอนุญาตให้มีวิดีโอที่ซ้ำกันได้
-
-
การอัปเดตอื่นๆ
-
รายการประวัติการแก้ไขสำหรับวันที่ 15 กันยายน 2016 ได้รับการอัปเดตเพื่อชี้แจงว่าเมื่อใดก็ตามที่มีการรวมพร็อพเพอร์ตี้
contentDetails.relatedPlaylists.watchHistory
และcontentDetails.relatedPlaylists.watchLater
ของทรัพยากรchannel
ไว้ในการตอบกลับ พร็อพเพอร์ตี้เหล่านั้นจะมีค่าHL
และWL
ตามลำดับเสมอ นอกจากนี้ ระบบจะรวมพร็อพเพอร์ตีเหล่านั้นก็ต่อเมื่อผู้ใช้ที่ได้รับอนุญาตดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เอง
-
15 กันยายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตประวัติการแก้ไขเมื่อวันที่ 11 สิงหาคม 2016 ได้กล่าวถึงการเปลี่ยนแปลงหลายอย่างที่เกี่ยวข้องกับรหัสหัวข้อ ซึ่งรวมถึงข้อเท็จจริงที่ว่าชุดรหัสหัวข้อที่รองรับจะมีการเปลี่ยนแปลงตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 เราจะเผยแพร่รายการหัวข้อที่จะรองรับภายในวันที่ 10 พฤศจิกายน 2016
-
การเปลี่ยนแปลงต่อไปนี้มีผลแล้ว เราได้แจ้งให้ทราบถึงการเปลี่ยนแปลงเหล่านี้ในการอัปเดตประวัติการแก้ไขเมื่อวันที่ 11 สิงหาคม 2016 ดังนี้
-
หากเรียกใช้เมธอด
activities.list
โดยตั้งค่าพารามิเตอร์home
เป็นtrue
ตอนนี้การตอบกลับของ API จะมีรายการที่คล้ายกับสิ่งที่ผู้ใช้ YouTube ที่ไม่ได้เข้าสู่ระบบจะเห็นในหน้าแรกการเปลี่ยนแปลงนี้เป็นการเปลี่ยนแปลงเล็กน้อยที่มีจุดประสงค์เพื่อมอบประสบการณ์การใช้งานที่ดีกว่าพฤติกรรมที่อธิบายไว้ในการอัปเดตประวัติการแก้ไขเมื่อวันที่ 11 สิงหาคม 2016 การอัปเดตดังกล่าวระบุว่าคำขอที่ใช้พารามิเตอร์
home
จะแสดงรายการที่ว่างเปล่า -
ตอนนี้พร็อพเพอร์ตี้
contentDetails.relatedPlaylists.watchHistory
และcontentDetails.relatedPlaylists.watchLater
ของทรัพยากรchannel
มีค่าเป็นHL
และWL
ตามลำดับสำหรับทุกช่องโปรดทราบว่ามีเพียงผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เองเท่านั้นที่จะเห็นพร็อพเพอร์ตี้เหล่านี้ พร็อพเพอร์ตี้จะมีค่า
HL
และWL
เสมอ แม้ว่าจะเป็นผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เองก็ตาม ดังนั้นจึงไม่สามารถดึงรหัสประวัติการดูและเพลย์ลิสต์ดูภายหลังผ่าน API ได้นอกจากนี้ คำขอเรียกรายละเอียดเพลย์ลิสต์ (
playlists.list
) หรือรายการในเพลย์ลิสต์ (playlistItems.list
) สำหรับประวัติการดูหรือเพลย์ลิสต์ดูภายหลังของช่องจะแสดงรายการที่ว่างเปล่า ลักษณะการทำงานนี้ใช้ได้กับค่าใหม่HL
และWL
รวมถึงรหัสประวัติการดูหรือเพลย์ลิสต์ดูภายหลังที่ไคลเอ็นต์ API อาจจัดเก็บไว้แล้ว
-
-
ระบบจะไม่แสดงออบเจ็กต์
fileDetails.recordingLocation
ของทรัพยากรvideo
และพร็อพเพอร์ตี้ย่อยอีกต่อไป ก่อนหน้านี้ เจ้าของวิดีโอเท่านั้นที่จะดึงข้อมูลนี้ได้ (เช่น ออบเจ็กต์fileDetails
หลัก)
11 สิงหาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ข้อกำหนดในการให้บริการของบริการ API ของ YouTube ที่เผยแพร่ใหม่ ("ข้อกำหนดที่อัปเดต") ซึ่งอธิบายไว้โดยละเอียดในบล็อกวิศวกรรมและนักพัฒนาซอฟต์แวร์ของ YouTube มีการอัปเดตข้อกำหนดในการให้บริการปัจจุบันมากมาย นอกเหนือจากข้อกำหนดที่ปรับปรุงแล้ว ซึ่งจะมีผลตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 การปรับปรุงนี้ยังรวมถึงเอกสารประกอบหลายฉบับที่จะช่วยอธิบายนโยบายที่นักพัฒนาแอปต้องปฏิบัติตาม
เอกสารใหม่ทั้งหมดอธิบายไว้ในประวัติการแก้ไขของข้อกำหนดที่อัปเดต นอกจากนี้ การเปลี่ยนแปลงในอนาคตของข้อกำหนดที่อัปเดตหรือเอกสารประกอบเหล่านั้นจะอธิบายไว้ในประวัติการแก้ไขด้วย คุณติดตามฟีด RSS ที่แสดงการเปลี่ยนแปลงในประวัติการแก้ไขนั้นได้จากลิงก์ในเอกสาร
-
การเลิกใช้งาน Freebase และ Freebase API ทำให้เกิดการเปลี่ยนแปลงหลายอย่างที่เกี่ยวข้องกับรหัสหัวข้อ ระบบจะใช้รหัสหัวข้อในทรัพยากรและเมธอด API ต่อไปนี้
- ส่วน
topicDetails
ของchannel
ทรัพยากรจะระบุหัวข้อที่เชื่อมโยงกับช่อง topicDetails
ของทรัพยากรvideo
ระบุหัวข้อที่เกี่ยวข้องกับวิดีโอ- พารามิเตอร์
topicId
ของเมธอดsearch.list
ช่วยให้คุณค้นหาวิดีโอหรือช่องที่เกี่ยวข้องกับหัวข้อใดหัวข้อหนึ่งได้
การเปลี่ยนแปลงฟีเจอร์เหล่านี้มีดังนี้
-
ตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 เป็นต้นไป YouTube จะเริ่มแสดงรหัสหัวข้อเพียงไม่กี่รายการแทนที่จะแสดงรหัสแบบละเอียดจำนวนมากอย่างที่เคย ชุดหัวข้อที่รองรับดังกล่าวจะระบุการจัดหมวดหมู่ระดับสูง เช่น กีฬาหรือบาสเกตบอล แต่จะไม่ระบุทีมหรือผู้เล่นที่เฉพาะเจาะจง เราจะประกาศชุดหัวข้อที่รองรับเพื่อให้คุณมีเวลาเตรียมแอปพลิเคชันสำหรับการเปลี่ยนแปลงนี้
-
คุณสามารถใช้รหัสหัวข้อ Freebase ที่ดึงข้อมูลมาแล้วเพื่อค้นหาเนื้อหาได้จนถึงวันที่ 10 กุมภาพันธ์ 2017 อย่างไรก็ตาม หลังจากนั้น คุณจะใช้ได้เฉพาะชุดหัวข้อที่เล็กลงซึ่งระบุไว้ในรายการก่อนหน้าเพื่อดึงผลการค้นหาตามหัวข้อ
-
หลังจากวันที่ 10 กุมภาพันธ์ 2017 หากคุณพยายามค้นหาผลลัพธ์โดยใช้รหัสหัวข้อที่ไม่ได้อยู่ในชุดรหัสหัวข้อที่รองรับที่เล็กลง API จะแสดงชุดผลลัพธ์ที่ว่างเปล่า
- ส่วน
-
เราจะเลิกใช้งานฟิลด์และพารามิเตอร์ API หลายรายการ โดยจะมีผลตั้งแต่วันที่ 12 กันยายน 2016 ดังนี้
-
พารามิเตอร์
activities.list
ของเมธอดhome
ช่วยให้ผู้ใช้ที่ได้รับอนุญาตดึงฟีดกิจกรรมที่จะแสดงในหน้าแรกของ YouTube สำหรับผู้ใช้รายนั้นได้ คำขอที่ใช้พารามิเตอร์นี้หลังจากวันที่ 12 กันยายน 2016 จะแสดงผลรายการที่ว่างเปล่า -
พร็อพเพอร์ตี้
contentDetails.relatedPlaylists.watchHistory
และcontentDetails.relatedPlaylists.watchLater
ของchannel
รีซอร์สจะแสดงต่อผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับแชแนลของผู้ใช้เองเท่านั้น หลังจากวันที่ 12 กันยายน 2016contentDetails.relatedPlaylists.watchHistory
จะแสดงผลค่าHL
และพร็อพเพอร์ตี้contentDetails.relatedPlaylists.watchLater
จะแสดงผลค่าWL
สำหรับทุกช่องคำขอเรียกรายละเอียดเพลย์ลิสต์ (
playlists.list
) สำหรับประวัติการดูหรือเพลย์ลิสต์ดูภายหลังของช่องจะแสดงรายการว่างเปล่าหลังจากวันที่ 12 กันยายน 2016 คำขอเรียกข้อมูลรายการเพลย์ลิสต์ (playlistItems.list
) ในเพลย์ลิสต์ใดเพลย์ลิสต์หนึ่งจะแสดงรายการที่ว่างเปล่าหลังจากเวลานั้นด้วย ซึ่งรวมถึงค่าใหม่HL
และWL
รวมถึงรหัสประวัติการดูหรือเพลย์ลิสต์ดูภายหลังที่ไคลเอ็นต์ API อาจจัดเก็บไว้แล้ว -
ระบบจะไม่แสดงออบเจ็กต์
fileDetails.recordingLocation
ของทรัพยากรvideo
หรือพร็อพเพอร์ตี้ย่อยอีกต่อไปหลังจากวันที่ 12 กันยายน 2016 เจ้าของวิดีโอเท่านั้นที่จะดึงข้อมูลนี้ได้ เนื่องจากเจ้าของวิดีโอเท่านั้นที่จะดึงออบเจ็กต์fileDetails
หลักได้
-
13 มิถุนายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เลิกใช้งานพร็อพเพอร์ตี้
contentDetails.googlePlusUserId
ของทรัพยากรchannel
แล้ว ก่อนหน้านี้ พร็อพเพอร์ตี้นี้จะแสดงเฉพาะในกรณีที่ช่องเชื่อมโยงกับโปรไฟล์ Google+ เท่านั้น หลังจากเลิกใช้งานแล้ว ระบบจะไม่รวมพร็อพเพอร์ตี้ไว้ในทรัพยากรchannel
ใดๆ อีก -
เลิกใช้งานพร็อพเพอร์ตี้
snippet.authorGoogleplusProfileUrl
ของทรัพยากรcomment
แล้ว ก่อนหน้านี้ พร็อพเพอร์ตี้นี้จะแสดงเฉพาะในกรณีที่ช่องเชื่อมโยงกับโปรไฟล์ Google+ เท่านั้น หลังจากเลิกใช้งานแล้ว ระบบจะไม่รวมพร็อพเพอร์ตี้ไว้ในทรัพยากรcomment
ใดๆ อีก
เนื่องจากระบบจะไม่แสดงพร็อพเพอร์ตี้ทั้ง 2 รายการนี้หลังจากการเลิกใช้งาน เราจึงได้นำพร็อพเพอร์ตี้ทั้ง 2 รายการออกจากเอกสารประกอบของทรัพยากรที่เกี่ยวข้อง
31 พฤษภาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พารามิเตอร์
myRecentSubscribers
ใหม่ของsubscriptions.list
เมธอดจะดึงข้อมูลรายชื่อผู้ติดตามของช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ตามลำดับเวลาแบบย้อนกลับของเวลาที่ผู้ใช้ติดตามช่องโปรดทราบว่าพารามิเตอร์ใหม่รองรับการดึงข้อมูลผู้ติดตาม 1,000 คนล่าสุดของช่องของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์เท่านั้น หากต้องการดึงข้อมูลรายชื่อผู้ติดตามทั้งหมด ให้ใช้พารามิเตอร์
mySubscribers
พารามิเตอร์ดังกล่าวซึ่งไม่ได้แสดงผู้ติดตามตามลำดับที่เฉพาะเจาะจงจะไม่จำกัดจำนวนผู้ติดตามที่ดึงข้อมูลได้ -
เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
snippet.thumbnails.(key)
สำหรับทรัพยากร activity, playlistItem, playlist, search result, thumbnail และ video เพื่อให้ทราบว่าวิดีโอบางรายการมีภาพปกเพิ่มเติมในขนาดอื่นๆ- รูปภาพ
standard
มีขนาดกว้าง 640 พิกเซลและสูง 480 พิกเซล - รูปภาพ
maxres
มีความกว้าง 1280 พิกเซลและความสูง 720 พิกเซล
- รูปภาพ
-
คำจำกัดความของพารามิเตอร์
part
ของเมธอดchannelSection.list
ได้รับการอัปเดตเพื่อระบุว่าส่วนtargeting
สามารถเรียกข้อมูลได้โดยมีค่าใช้จ่ายเป็นหน่วยโควต้า2
-
ตอนนี้เมธอด
videos.list
จะแสดงข้อผิดพลาด forbidden (403
) เมื่อคำขอที่ไม่ได้รับอนุญาตอย่างถูกต้องพยายามเรียกส่วนfileDetails
,processingDetails
หรือsuggestions
ของทรัพยากรvideo
โดยส่วนดังกล่าวจะพร้อมให้บริการแก่เจ้าของวิดีโอเท่านั้น
17 พฤษภาคม 2016
เครื่องมือข้อมูลโค้ด Data API ใหม่มีข้อมูลโค้ดสั้นๆ สำหรับกรณีการใช้งาน YouTube Data API ทั่วไป ขณะนี้ข้อมูลโค้ดพร้อมใช้งานสำหรับเมธอด API แบบอ่านอย่างเดียวทั้งหมดใน Apps Script, Go, JavaScript, PHP, Python และ Ruby
สําหรับแต่ละวิธี เครื่องมือจะแสดงตัวอย่างโค้ดสําหรับกรณีการใช้งานอย่างน้อย 1 รายการ เช่น มีข้อมูลโค้ด 5 รายการสำหรับเมธอด search.list
- แสดงวิดีโอตามคีย์เวิร์ด
- แสดงวิดีโอตามสถานที่
- แสดงการถ่ายทอดสด
- ค้นหาวิดีโอของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์
- แสดงวิดีโอที่เกี่ยวข้อง
เครื่องมือจะแสดงพารามิเตอร์ที่ใช้ในคำขอ API สำหรับแต่ละกรณีการใช้งาน คุณสามารถแก้ไขค่าพารามิเตอร์ได้ ในกรณีนี้ เครื่องมือจะอัปเดตข้อมูลโค้ดเพื่อให้สอดคล้องกับค่าพารามิเตอร์ที่คุณระบุ
สุดท้าย เครื่องมือจะแสดงการตอบกลับ API สำหรับคำขอแต่ละรายการ หากคุณแก้ไขพารามิเตอร์คำขอ การตอบกลับของ API จะอิงตามค่าพารามิเตอร์ที่คุณระบุ โปรดทราบว่าคุณต้องให้สิทธิ์เครื่องมือในการส่งคำขอในนามของคุณเพื่อให้การตอบกลับจาก API แสดง
28 เมษายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้
contentDetails.projection
ใหม่ของทรัพยากรvideo
จะระบุรูปแบบการฉายวิดีโอ ค่าพร็อพเพอร์ตี้ที่ใช้ได้คือ360
และrectangular
-
พร็อพเพอร์ตี้
recordingDetails.location
และfileDetails.recordingLocation
ของแหล่งข้อมูลvideo
ได้รับการอัปเดตเพื่ออธิบายความแตกต่างระหว่างพร็อพเพอร์ตี้ทั้ง 2 รายการ- พร็อพเพอร์ตี้
recordingDetails.location
ระบุสถานที่ที่เจ้าของวิดีโอต้องการเชื่อมโยงกับวิดีโอ คุณแก้ไขตำแหน่งนี้ได้ ค้นหาได้ในวิดีโอสาธารณะ และอาจแสดงต่อผู้ใช้สำหรับวิดีโอสาธารณะ - ค่าพร็อพเพอร์ตี้
fileDetails.recordingLocation
จะเปลี่ยนแปลงไม่ได้และแสดงถึงตำแหน่งที่เชื่อมโยงกับไฟล์วิดีโอต้นฉบับที่อัปโหลด โดยค่านี้จะแสดงต่อเจ้าของวิดีโอเท่านั้น
- พร็อพเพอร์ตี้
-
คำจำกัดความของพร็อพเพอร์ตี้
contentDetails.relatedPlaylists.favorites
ของchannel
ทรัพยากรได้รับการอัปเดตเพื่อระบุว่าค่าของพร็อพเพอร์ตี้อาจมีรหัสเพลย์ลิสต์ที่อ้างอิงถึงเพลย์ลิสต์ที่ว่างเปล่าและไม่สามารถดึงข้อมูลได้ เนื่องจากเราได้เลิกใช้งานฟังก์ชันวิดีโอโปรดแล้ว โปรดทราบว่าพร็อพเพอร์ตี้นี้ไม่อยู่ภายใต้นโยบายการเลิกใช้งาน API -
คำจำกัดความของข้อผิดพลาด
ineligibleAccount
ซึ่งอาจแสดงโดยเมธอดcomments.insert
,comments.update
,commentThreads.insert
หรือcommentThreads.update
ได้รับการอัปเดตเพื่อให้สอดคล้องกับข้อผิดพลาดที่เกิดขึ้นเมื่อบัญชี YouTube ที่ใช้เพื่อให้สิทธิ์คำขอ API ยังไม่ได้ผสานรวมกับบัญชี Google ของผู้ใช้
20 เมษายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตคำจำกัดความของพารามิเตอร์
part
ของเมธอดchannels.update
เพื่อระบุว่าlocalizations
เป็นค่าที่ใช้ได้สำหรับพารามิเตอร์นั้นด้วย -
เราได้อัปเดตส่วนการใช้โควต้าในคู่มือการเริ่มต้นใช้งานให้ลิงก์ไปยัง Google Developers Console ซึ่งคุณจะดูโควต้าจริงและการใช้โควต้าได้
16 มีนาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่
-
channelBanner
เอกสารประกอบเกี่ยวกับแหล่งข้อมูลได้รับการอัปเดตเพื่อระบุว่าขนาดที่แนะนำสำหรับรูปภาพแบนเนอร์ของช่องที่อัปโหลดคือ 2560x1440 พิกเซล ขนาดขั้นต่ำ (2048 x 1152 พิกเซล) ไม่มีการเปลี่ยนแปลง -
พร็อพเพอร์ตี้
snippet.customUrl
ใหม่ของทรัพยากรchannel
จะระบุ URL ที่กำหนดเองซึ่งเชื่อมโยงกับช่อง (บางช่องไม่มี URL ที่กำหนดเอง) ศูนย์ช่วยเหลือของ YouTube อธิบายข้อกำหนดของการได้รับสิทธิ์ในการรับ URL ที่กำหนดเอง รวมถึงวิธีตั้งค่า URL -
เลิกใช้งานออบเจ็กต์
brandingSettings.watch
ของทรัพยากรchannel
และพร็อพเพอร์ตี้ย่อยทั้งหมดแล้ว -
ตอนนี้การตอบกลับ API สำหรับคำขอ
search.list
จะมีพร็อพเพอร์ตี้regionCode
พร็อพเพอร์ตี้จะระบุรหัสภูมิภาคที่ใช้สำหรับคำค้นหา รหัสภูมิภาคจะสั่งให้ API แสดงผลการค้นหาสำหรับประเทศที่ระบุค่าพร็อพเพอร์ตี้คือรหัสประเทศ ISO แบบ 2 ตัวอักษรที่ระบุภูมิภาค เมธอด
i18nRegions.list
จะแสดงรายการภูมิภาคที่รองรับ ค่าเริ่มต้นคือUS
หากระบุภูมิภาคที่ไม่รองรับ YouTube อาจเลือกภูมิภาคอื่นแทนค่าเริ่มต้นเพื่อจัดการคำค้นหา -
เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
snippet.label
และsnippet.secondaryReasons[].label
ของทรัพยากรvideoAbuseReportReason
เพื่อระบุว่าพร็อพเพอร์ตี้มีข้อความป้ายกำกับที่แปลแล้วสำหรับเหตุผลในการรายงานการละเมิดนอกจากนี้
videoAbuseReportReasons.list
เมธอดยังรองรับพารามิเตอร์hl
ซึ่งระบุภาษาที่ควรใช้สำหรับข้อความป้ายกำกับในการตอบกลับของ API ค่าพารามิเตอร์เริ่มต้นคือen_US
-
พร็อพเพอร์ตี้
contentDetails.contentRating.ecbmctRating
ใหม่ของvideo
ทรัพยากรจะระบุการจัดประเภทวิดีโอจากคณะกรรมการประเมินและจัดประเภทของกระทรวงวัฒนธรรมและการท่องเที่ยวของตุรกีนอกจากนี้ พร็อพเพอร์ตี้ API สำหรับระบบการจัดประเภทอื่นๆ ยังรองรับค่าพร็อพเพอร์ตี้ใหม่ต่อไปนี้ด้วย
contentDetails.contentRating.fpbRating
(แอฟริกาใต้)
คะแนน: 10; ค่าพร็อพเพอร์ตี้:fpb10
contentDetails.contentRating.moctwRating
(ไต้หวัน)
การจัดประเภท: R-12; ค่าพร็อพเพอร์ตี้:moctwR12
contentDetails.contentRating.moctwRating
(ไต้หวัน)
การจัดประเภท: R-15; ค่าพร็อพเพอร์ตี้:moctwR15
-
พร็อพเพอร์ตี้
liveStreamingDetails.activeLiveChatId
ของvideo
ทรัพยากรมีรหัสของแชทสดที่ใช้งานอยู่ซึ่งเชื่อมโยงกับวิดีโอ ค่าพร็อพเพอร์ตี้จะแสดงก็ต่อเมื่อวิดีโอเป็นไลฟ์สดที่กำลังออกอากาศและเปิดใช้แชทสดอยู่ หลังจากที่การออกอากาศสิ้นสุดลงและแชทสดจบแล้ว ระบบจะไม่แสดงพร็อพเพอร์ตี้สำหรับวิดีโอนั้นอีกต่อไป -
พร็อพเพอร์ตี้
status.rejectionReason
ของทรัพยากรvideo
รองรับค่าพร็อพเพอร์ตี้ใหม่legal
-
-
API รองรับข้อผิดพลาดใหม่ต่อไปนี้
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
notEditable
เมธอด channelSections.insert
,channelSections.update
และchannelSections.delete
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าสร้าง อัปเดต หรือลบส่วนของช่องที่ระบุไม่ได้badRequest (400)
styleRequired
เมธอด channelSections.insert
และchannelSections.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากรchannelSection
ที่ส่งในคำขอ API ต้องระบุค่าสำหรับพร็อพเพอร์ตี้snippet.style
badRequest (400)
typeRequired
เมธอด channelSections.insert
และchannelSections.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากรchannelSection
ที่ส่งในคำขอ API ต้องระบุค่าสำหรับพร็อพเพอร์ตี้snippet.type
badRequest (400)
processingFailure
เมธอด commentThreads.list
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าเซิร์ฟเวอร์ API ประมวลผลคำขอไม่สำเร็จ แม้ว่าข้อผิดพลาดนี้อาจเป็นข้อผิดพลาดชั่วคราว แต่โดยปกติแล้วจะบ่งชี้ว่าอินพุตของคำขอไม่ถูกต้อง ตรวจสอบโครงสร้างของทรัพยากรcommentThread
ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้องforbidden (403)
commentsDisabled
เมธอด commentThreads.list
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่ระบุโดยพารามิเตอร์videoId
ได้ปิดใช้ความคิดเห็นbadRequest (400)
commentTextTooLong
เมธอด commentThreads.insert
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากรcomment
ที่กำลังแทรกมีอักขระมากเกินไปในพร็อพเพอร์ตี้snippet.topLevelComment.snippet.textOriginal
invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
เมธอด playlistItems.insert
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์อยู่ในเพลย์ลิสต์ซีรีส์อื่นแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับเพลย์ลิสต์ของซีรีส์ได้ที่ศูนย์ช่วยเหลือของ YouTubebadRequest (400)
subscriptionForbidden
เมธอด subscriptions.insert
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคุณสมัครใช้บริการถึงจำนวนสูงสุดแล้ว หรือสมัครใช้บริการล่าสุดมากเกินไป ในกรณีหลัง คุณสามารถลองส่งคำขออีกครั้งหลังจากผ่านไป 2-3 ชั่วโมงbadRequest (400)
invalidCategoryId
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.categoryId
ในทรัพยากรvideo
ที่อัปโหลดระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้เมธอดvideoCategories.list
เพื่อเรียกหมวดหมู่ที่รองรับbadRequest (400)
invalidDescription
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.description
ในทรัพยากรvideo
ที่อัปโหลดระบุค่าที่ไม่ถูกต้องbadRequest (400)
invalidPublishAt
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้status.publishAt
ในทรัพยากรvideo
ที่อัปโหลดระบุเวลาเผยแพร่ที่กำหนดเวลาไว้ไม่ถูกต้องbadRequest (400)
invalidRecordingDetails
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าออบเจ็กต์recordingDetails
ในทรัพยากรvideo
ที่อัปโหลดระบุรายละเอียดการบันทึกที่ไม่ถูกต้องbadRequest (400)
invalidTags
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.tags
ในทรัพยากรvideo
ที่อัปโหลดระบุค่าที่ไม่ถูกต้องbadRequest (400)
invalidTitle
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.title
ในทรัพยากรvideo
ที่อัปโหลดระบุชื่อวิดีโอที่ไม่ถูกต้องหรือว่างเปล่าbadRequest (400)
invalidVideoMetadata
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าข้อมูลเมตาของคำขอไม่ถูกต้อง ข้อผิดพลาดนี้จะเกิดขึ้นหากคำขออัปเดตส่วนsnippet
ของทรัพยากรvideo
แต่ไม่ได้ตั้งค่าสำหรับทั้งพร็อพเพอร์ตี้snippet.title
และsnippet.categoryId
18 ธันวาคม 2015
กฎหมายของสหภาพยุโรป (EU) กำหนดให้ต้องแสดงการเปิดเผยข้อมูลบางอย่างแก่ผู้ใช้ปลายทางใน EU และต้องได้รับความยินยอมจากผู้ใช้ปลายทางใน EU ดังนั้น คุณต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU สำหรับผู้ใช้ปลายทางในสหภาพยุโรป เราได้เพิ่มประกาศเกี่ยวกับข้อกำหนดนี้ในข้อกำหนดในการให้บริการของ YouTube API
19 พฤศจิกายน 2015
ตอนนี้ API รองรับความสามารถในการตั้งค่าและดึงข้อความที่แปลแล้วสำหรับพร็อพเพอร์ตี้ snippet.title
และ snippet.description
ของทรัพยากร playlist
และ video
, พร็อพเพอร์ตี้ snippet.title
ของทรัพยากร channelSection
และพร็อพเพอร์ตี้ snippet.description
ของทรัพยากร channel
-
การตั้งชื่อและคำอธิบายที่แปลแล้ว
คุณตั้งค่าที่แปลแล้วสำหรับทรัพยากรได้เมื่อเรียกใช้เมธอด
insert
หรือupdate
สำหรับทรัพยากรนั้น หากต้องการตั้งค่าที่แปลแล้วสำหรับทรัพยากร ให้ทำทั้ง 2 อย่างต่อไปนี้-
ตรวจสอบว่าได้ตั้งค่าสำหรับพร็อพเพอร์ตี้
snippet.defaultLanguage
ของทรัพยากร พร็อพเพอร์ตี้นั้นจะระบุภาษาของพร็อพเพอร์ตี้snippet.title
และsnippet.description
ของทรัพยากร ค่าของพารามิเตอร์นี้อาจเป็นภาษาของแอปพลิเคชันที่รองรับหรือรหัสภาษา ISO 639-1:2002 อื่นๆ ส่วนใหญ่ เช่น หากคุณอัปโหลดวิดีโอที่มีชื่อและคำอธิบายเป็นภาษาอังกฤษ คุณจะต้องตั้งค่าพร็อพเพอร์ตี้snippet.defaultLanguage
เป็นen
หมายเหตุสำหรับการอัปเดตทรัพยากร
channel
: หากต้องการตั้งค่าพร็อพเพอร์ตี้snippet.defaultLanguage
สำหรับทรัพยากรchannel
คุณต้องอัปเดตพร็อพเพอร์ตี้brandingSettings.channel.defaultLanguage
-
เพิ่มออบเจ็กต์
localizations
ลงในทรัพยากรที่คุณกำลังอัปเดต คีย์ออบเจ็กต์แต่ละรายการเป็นสตริงที่ระบุภาษาของแอปพลิเคชันหรือรหัสภาษา ISO 639-1:2002 และคีย์แต่ละรายการจะแมปกับออบเจ็กต์ที่มีชื่อ (และคำอธิบาย) ของทรัพยากรที่แปลแล้วข้อมูลโค้ดตัวอย่างด้านล่างตั้งค่าภาษาเริ่มต้นของทรัพยากรเป็นภาษาอังกฤษ นอกจากนี้ ยังเพิ่มชื่อและคำอธิบายภาษาเยอรมันและสเปนที่แปลแล้วลงในวิดีโอด้วย
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
สำคัญ: โปรดทราบว่าเมื่ออัปเดตข้อมูลที่แปลแล้วสำหรับทรัพยากร คำขอ API ต้องมีข้อมูลเวอร์ชันที่แปลแล้วที่มีอยู่ทั้งหมด เช่น หากคุณส่งคำขอในภายหลังเพื่อเพิ่มข้อมูลภาษาโปรตุเกสลงในวิดีโอในตัวอย่างข้างต้น คำขอจะต้องมีข้อมูลที่แปลเป็นภาษาเยอรมัน สเปน และโปรตุเกส
-
-
การดึงค่าที่แปลแล้ว
API รองรับ 2 วิธีในการดึงค่าที่แปลสำหรับทรัพยากร
-
เพิ่มพารามิเตอร์
hl
ลงในคำขอchannels.list
,channelSections.list
,playlists.list
หรือvideos.list
เพื่อดึงข้อมูลที่แปลเป็นภาษาท้องถิ่นสำหรับภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ หากมีรายละเอียดทรัพยากรที่แปลแล้วในภาษานั้น ออบเจ็กต์snippet.localized
ของทรัพยากรจะมีค่าที่แปลแล้ว อย่างไรก็ตาม หากไม่มีรายละเอียดที่แปลแล้ว ออบเจ็กต์snippet.localized
จะมีรายละเอียดทรัพยากรในภาษาเริ่มต้นของทรัพยากรเช่น สมมติว่าคำขอ
videos.list
ดึงข้อมูลสำหรับวิดีโอที่อธิบายไว้ข้างต้นพร้อมข้อมูลภาษาเยอรมันและสเปนที่แปลแล้ว หากตั้งค่าพารามิเตอร์hl
เป็นde
ทรัพยากรจะมีข้อมูลต่อไปนี้{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }
อย่างไรก็ตาม หากตั้งค่าพารามิเตอร์
hl
เป็นfr
ออบเจ็กต์snippet.localized
จะมีชื่อและคำอธิบายเป็นภาษาอังกฤษ เนื่องจากภาษาอังกฤษเป็นภาษาเริ่มต้นของทรัพยากร และไม่มีรายละเอียดภาษาฝรั่งเศสที่แปลแล้วสำคัญ: พารามิเตอร์hl
รองรับเฉพาะค่าที่ระบุภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ หากต้องการดูว่ามีข้อความที่แปลเป็นภาษาอื่นๆ หรือไม่ คุณต้องดึงข้อมูลส่วนlocalizations
ของทรัพยากรและกรองเพื่อดูว่ามีข้อความที่แปลแล้วหรือไม่
ตัวอย่างเช่น คุณจะต้องดึงข้อมูลรายการการแปลทั้งหมดเพื่อดูว่ามีข้อความที่แปลแล้วในภาษาอังกฤษแบบแอพพาเลเชียนหรือไม่
-
เมื่อเรียกข้อมูลทรัพยากร ให้ใส่
localizations
ในค่าพารามิเตอร์part
เพื่อเรียกข้อมูลรายละเอียดที่แปลแล้วทั้งหมดสำหรับทรัพยากรนั้น หากดึงข้อมูลที่แปลแล้วสำหรับภาษาที่ไม่ได้เป็นภาษาปัจจุบันของแอปพลิเคชัน YouTube คุณจะต้องใช้วิธีนี้เพื่อดึงข้อมูลที่แปลแล้วทั้งหมด จากนั้นกรองเพื่อดูว่ามีข้อมูลที่แปลแล้วที่ต้องการหรือไม่
-
-
ข้อผิดพลาดที่เกี่ยวข้องกับค่าข้อความที่แปลแล้ว
นอกจากนี้ API ยังรองรับข้อผิดพลาดใหม่ต่อไปนี้สำหรับค่าข้อความที่แปลแล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
defaultLanguageNotSetError
ข้อผิดพลาดนี้บ่งชี้ว่าคำขอที่พยายามแทรกหรืออัปเดตออบเจ็กต์ localizations
สำหรับทรัพยากรไม่สำเร็จเนื่องจากไม่ได้ตั้งค่าพร็อพเพอร์ตี้snippet.defaultLanguage
สำหรับทรัพยากรนั้น วิธีการchannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
และvideos.update
รองรับข้อผิดพลาดนี้badRequest (400)
localizationValidationError
ข้อผิดพลาดนี้แสดงว่าค่าใดค่าหนึ่งในออบเจ็กต์ localizations
ของทรัพยากรไม่ผ่านการตรวจสอบ เช่น ข้อผิดพลาดนี้อาจเกิดขึ้นหากออบเจ็กต์มีรหัสภาษาที่ไม่ถูกต้อง เมธอดchannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
และplaylists.update
รองรับข้อผิดพลาดนี้
4 พฤศจิกายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่
-
พารามิเตอร์
order
ของเมธอดsearch.list
ได้รับการอัปเดตเพื่อระบุว่าหากคุณจัดเรียงการถ่ายทอดสดตามviewCount
ผลลัพธ์ของ API จะได้รับการจัดเรียงตามจำนวนผู้ชมที่ดูพร้อมกันของการถ่ายทอดสดในขณะที่การถ่ายทอดสดกำลังดำเนินอยู่ -
พารามิเตอร์
relatedToVideoId
ของเมธอดsearch.list
ได้รับการอัปเดตเพื่อระบุว่าหากตั้งค่าพารามิเตอร์นี้ พารามิเตอร์อื่นๆ ที่รองรับจะมีเพียงpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(ซึ่งต้องตั้งค่าเป็นvideo
) และfields
การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API -
คำจำกัดความของพร็อพเพอร์ตี้
snippet.publishedAt
ของทรัพยากรvideo
ได้รับการอัปเดตเพื่อระบุว่าค่าพร็อพเพอร์ตี้ซึ่งระบุวันที่และเวลาที่เผยแพร่วิดีโออาจแตกต่างจากเวลาที่อัปโหลดวิดีโอ ตัวอย่างเช่น หากอัปโหลดวิดีโอเป็นวิดีโอส่วนตัว แล้วเปลี่ยนเป็นสาธารณะในภายหลัง ค่าพร็อพเพอร์ตี้จะระบุเวลาที่วิดีโอเปลี่ยนเป็นสาธารณะ คำจำกัดความที่อัปเดตยังอธิบายวิธีป้อนค่าสำหรับวิดีโอส่วนตัวและวิดีโอที่ไม่เป็นสาธารณะด้วยการเปลี่ยนแปลงนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API
-
คำจำกัดความของพร็อพเพอร์ตี้
status.publishAt
ของทรัพยากรvideo
ได้รับการอัปเดตแล้ว โดยมีข้อความดังนี้- หากตั้งค่าพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด
videos.update
คุณต้องตั้งค่าพร็อพเพอร์ตี้status.privacyStatus
เป็นprivate
ด้วย แม้ว่าวิดีโอจะเป็นแบบส่วนตัวอยู่แล้วก็ตาม - หากคำขอตั้งเวลาให้เผยแพร่วิดีโอในอดีต ระบบจะเผยแพร่วิดีโอทันที ดังนั้น การตั้งค่าพร็อพเพอร์ตี้
status.publishAt
เป็นวันที่และเวลาในอดีตจึงมีผลเช่นเดียวกับการเปลี่ยนprivacyStatus
ของวิดีโอจากprivate
เป็นpublic
- หากตั้งค่าพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด
-
พร็อพเพอร์ตี้
contentDetails.contentRating.cncRating
ของvideo
ทรัพยากรจะระบุการจัดประเภทของวิดีโอจาก Commission de classification cinematographique ของฝรั่งเศส พร็อพเพอร์ตี้นี้จะแทนที่พร็อพเพอร์ตี้contentDetails.contentRating.fmocRating
ซึ่งตอนนี้เลิกใช้งานแล้ว -
คำจำกัดความของ
channel
ของbrandingSettings.channel.keywords
ได้รับการอัปเดตเพื่อให้แสดงอย่างถูกต้องว่าค่าพร็อพเพอร์ตี้มีรายการสตริงที่คั่นด้วยช่องว่าง ไม่ใช่รายการที่คั่นด้วยคอมมาตามที่ระบุไว้ก่อนหน้านี้ การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API -
เอกสารประกอบสำหรับเมธอด
thumbnails.set
ได้รับการอัปเดตเพื่อให้แสดงอย่างถูกต้องว่าเนื้อหาของคำขอมีรูปภาพปกที่คุณอัปโหลดและเชื่อมโยงกับวิดีโอ เนื้อความของคำขอไม่มีทรัพยากรthumbnail
ก่อนหน้านี้ เอกสารระบุว่าคุณไม่ควรระบุเนื้อหาคำขอเมื่อเรียกใช้เมธอดนี้ การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API -
คำอธิบายของ
activity
ทรัพยากรได้รับการอัปเดตเพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าขณะนี้เมธอดactivities.list
ไม่มีทรัพยากรที่เกี่ยวข้องกับความคิดเห็นใหม่ในวิดีโอ นอกจากนี้ เรายังได้อัปเดตsnippet.type
และcontentDetails.comment
ของทรัพยากรด้วย
-
-
ข้อผิดพลาดใหม่และที่อัปเดต
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
รายละเอียดข้อผิดพลาด activities.insert
รหัสการตอบกลับ HTTP badRequest (400)
เหตุผล invalidMetadata
คำอธิบาย พร็อพเพอร์ตี้ kind
ไม่ตรงกับประเภทรหัสที่ระบุcommentThreads.update
comments.insert
comments.update
รหัสการตอบกลับ HTTP badRequest (400)
เหตุผล commentTextTooLong
คำอธิบาย comment
ทรัพยากรที่กำลังแทรกหรืออัปเดตมีอักขระมากเกินไปในพร็อพเพอร์ตี้snippet.topLevelComment.snippet.textOriginal
playlistItems.insert
playlistItems.update
รหัสการตอบกลับ HTTP forbidden (403)
เหตุผล playlistItemsNotAccessible
คำอธิบาย คำขอไม่ได้รับอนุญาตอย่างถูกต้องเพื่อแทรก อัปเดต หรือลบรายการในเพลย์ลิสต์ที่ระบุ playlists.delete
playlists.insert
playlists.update
รหัสการตอบกลับ HTTP badRequest (400)
เหตุผล playlistForbidden
คำอธิบาย การดำเนินการนี้ถูกห้ามหรือคำขอไม่ได้รับอนุญาตอย่างถูกต้อง search.list
รหัสการตอบกลับ HTTP badRequest (400)
เหตุผล invalidLocation
คำอธิบาย ค่าพารามิเตอร์ location
และ/หรือlocationRadius
มีรูปแบบไม่ถูกต้องsearch.list
รหัสการตอบกลับ HTTP badRequest (400)
เหตุผล invalidRelevanceLanguage
คำอธิบาย ค่าพารามิเตอร์ relevanceLanguage
มีรูปแบบไม่ถูกต้องsubscriptions.insert
รหัสการตอบกลับ HTTP badRequest (400)
เหตุผล subscriptionForbidden
คำอธิบาย ข้อผิดพลาดนี้จะเกิดขึ้นเมื่อมีกรณีใดกรณีหนึ่งต่อไปนี้ - มีการสมัครใช้บริการที่คุณพยายามสร้างอยู่แล้ว
- คุณสมัครใช้บริการครบตามจำนวนสูงสุดแล้ว
- คุณพยายามติดตามช่องของตัวเอง ซึ่งระบบไม่รองรับ
- คุณเพิ่งสร้างการติดตามมากเกินไปและต้องรอ 2-3 ชั่วโมงก่อนที่จะลองส่งคำขออีกครั้ง
videos.update
รหัสการตอบกลับ HTTP badRequest (400)
เหตุผล invalidDefaultBroadcastPrivacySetting
คำอธิบาย คำขอพยายามตั้งค่าความเป็นส่วนตัวที่ไม่ถูกต้องสำหรับการออกอากาศเริ่มต้น
-
28 สิงหาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่
-
เลิกใช้งานพร็อพเพอร์ตี้
statistics.favoriteCount
ของทรัพยากรvideo
แล้วตามนโยบายการเลิกใช้งานของเรา เราจะยังคงรวมพร็อพเพอร์ตี้นี้ไว้ในแหล่งข้อมูล
video
เป็นเวลาอย่างน้อย 1 ปีหลังจากประกาศนี้ อย่างไรก็ตาม ตอนนี้ค่าพร็อพเพอร์ตี้จะตั้งค่าเป็น0
เสมอ
-
7 สิงหาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่
-
เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
snippet.tags[]
ของvideo
ทรัพยากร เพื่อให้ข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่เซิร์ฟเวอร์ API คำนวณความยาวของค่าพร็อพเพอร์ตี้ โปรดทราบว่าการอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ APIโดยเฉพาะอย่างยิ่ง ตอนนี้คำจำกัดความอธิบายว่าหากแท็กมีช่องว่าง เซิร์ฟเวอร์ API จะจัดการค่าแท็กราวกับว่าค่าดังกล่าวอยู่ในเครื่องหมายคำพูด และเครื่องหมายคำพูดจะนับรวมในขีดจำกัดของจำนวนอักขระ ดังนั้นเพื่อวัตถุประสงค์ในการจำกัดจำนวนอักขระ แท็ก Foo-Baz จะมีอักขระ 7 ตัว แต่แท็ก Foo Baz จะมีอักขระ 9 ตัว
-
commentThreads.insert
เมธอดไม่รองรับพารามิเตอร์shareOnGooglePlus
อีกต่อไป ซึ่งก่อนหน้านี้จะระบุว่าควรโพสต์ความคิดเห็นและการตอบกลับความคิดเห็นนั้นไปยังโปรไฟล์ Google+ ของผู้เขียนด้วยหรือไม่ หากคำขอส่งพารามิเตอร์ เซิร์ฟเวอร์ API จะไม่สนใจพารามิเตอร์ แต่จะจัดการคำขอ
-
18 มิถุนายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่
-
พารามิเตอร์
order
ใหม่ของเมธอดcommentThreads.list
จะระบุลำดับที่การตอบกลับของ API ควรแสดงชุดความคิดเห็น คุณจัดเรียงเธรดตามเวลาหรือความเกี่ยวข้องได้ ลักษณะการทำงานเริ่มต้นคือการจัดเรียงตามเวลา -
พร็อพเพอร์ตี้
snippet.defaultAudioLanguage
ใหม่ของvideo
ทรัพยากรจะระบุภาษาที่ใช้ในแทร็กเสียงเริ่มต้นของวิดีโอ -
เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
contentDetails.licensedContent
ของvideo
ทรัพยากรเพื่อชี้แจงว่าเนื้อหาต้องอัปโหลดไปยังช่องที่ลิงก์กับพาร์ทเนอร์เนื้อหาของ YouTube เป็นครั้งแรก แล้วพาร์ทเนอร์รายนั้นจึงจะอ้างสิทธิ์ได้ การดำเนินการนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API จริง -
ตอนนี้เมธอด
captions.delete
,captions.download
,captions.insert
,captions.list
และcaptions.update
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งก่อนหน้านี้เมธอดอื่นๆ อีกหลายรายการก็รองรับพารามิเตอร์นี้อยู่แล้ว คำขอที่ใช้วิธีดังกล่าวจะต้องได้รับอนุญาตด้วยโทเค็นที่ให้สิทธิ์เข้าถึงขอบเขตhttps://www.googleapis.com/auth/youtubepartner
ด้วย
-
-
ข้อผิดพลาดใหม่และที่อัปเดต
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
รายละเอียดข้อผิดพลาด videos.rate
รหัสการตอบกลับ HTTP badRequest (400)
เหตุผล emailNotVerified
คำอธิบาย ผู้ใช้ต้องยืนยันอีเมลของตนก่อนให้คะแนนวิดีโอ videos.rate
รหัสการตอบกลับ HTTP badRequest (400)
เหตุผล videoPurchaseRequired
คำอธิบาย มีเพียงผู้ใช้ที่เช่าวิดีโอเท่านั้นที่จะให้คะแนนวิดีโอที่เช่าได้ -
วิธีการ
subscriptions.delete
และsubscriptions.insert
ไม่รองรับข้อผิดพลาดaccountClosed
และaccountSuspended
อีกต่อไป
-
27 เมษายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูลและวิธีการใหม่ๆ
-
videoAbuseReportReason
แหล่งข้อมูลใหม่นี้มีข้อมูลเกี่ยวกับเหตุผลที่วิดีโออาจถูกแจ้งว่ามีเนื้อหาที่เป็นการละเมิด เมธอดvideoAbuseReportReasons.list
ช่วยให้คุณดึงรายการเหตุผลทั้งหมดที่วิดีโออาจถูกแจ้งได้ -
videos.reportAbuse
วิธีใหม่นี้ช่วยให้คุณแจ้งว่าวิดีโอมีเนื้อหาที่เป็นการละเมิดได้จริงๆ เนื้อหาของคำขอมีออบเจ็กต์ JSON ที่ระบุวิดีโอที่ถูกแจ้งว่าไม่เหมาะสม รวมถึงเหตุผลที่ระบบพิจารณาว่าวิดีโอมีเนื้อหาที่เป็นการละเมิด คุณดูเหตุผลที่ถูกต้องได้จากวิธีการvideoAbuseReportReason.list
ที่อธิบายไว้ข้างต้นนอกจากนี้ เรายังได้อัปเดตคำแนะนำในการย้ายข้อมูลพร้อมตัวอย่างการรายงานวิดีโอที่มีการละเมิด การเปลี่ยนแปลงนี้ทำให้ตอนนี้ API v3 รองรับฟีเจอร์ทั้งหมดของ API v2 ตามกำหนดการที่วางไว้ นอกจากนี้ คู่มือการย้ายข้อมูลยังอธิบายฟีเจอร์เหล่านี้ทั้งหมดด้วย
-
-
การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่
-
search.list
พารามิเตอร์ตัวกรองใหม่ของเมธอดforDeveloper
จะจำกัดการค้นหาให้ดึงเฉพาะวิดีโอที่อัปโหลดผ่านแอปพลิเคชันหรือเว็บไซต์ของนักพัฒนาแอปเท่านั้น คุณใช้พารามิเตอร์forDeveloper
ร่วมกับพารามิเตอร์การค้นหาที่ไม่บังคับ เช่น พารามิเตอร์q
ได้สำหรับฟีเจอร์นี้ ระบบจะติดแท็กหมายเลขโปรเจ็กต์ที่เชื่อมโยงกับแอปพลิเคชันของนักพัฒนาแอปใน Google Developers Console ให้กับวิดีโอแต่ละรายการที่อัปโหลดโดยอัตโนมัติ
เมื่อคำขอค้นหาตั้งค่าพารามิเตอร์
forDeveloper
เป็นtrue
ในภายหลัง เซิร์ฟเวอร์ API จะใช้ข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอเพื่อระบุนักพัฒนาซอฟต์แวร์ ดังนั้น นักพัฒนาแอปจึงจำกัดผลการค้นหาให้แสดงเฉพาะวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์ของนักพัฒนาแอปเองได้ แต่จะจำกัดวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์อื่นๆ ไม่ได้ฟีเจอร์ใหม่นี้มีฟังก์ชันการทำงานที่คล้ายกับฟังก์ชันการทำงานของแท็กสำหรับนักพัฒนาซอฟต์แวร์ที่ API เวอร์ชัน 2 รองรับ แม้ว่าจะไม่เหมือนกันก็ตาม
-
channel
พร็อพเพอร์ตี้ใหม่ของทรัพยากรsnippet.country
ช่วยให้เจ้าของช่องเชื่อมโยงช่องของตนกับประเทศใดประเทศหนึ่งได้หมายเหตุ: หากต้องการตั้งค่าพร็อพเพอร์ตี้
snippet.country
สำหรับทรัพยากรchannel
คุณต้องอัปเดตพร็อพเพอร์ตี้brandingSettings.channel.country
-
ตอนนี้ API รองรับการกำหนดเป้าหมายสำหรับทรัพยากร
channelSection
แล้ว การกำหนดเป้าหมายส่วนของช่องเป็นวิธีจำกัดการมองเห็นส่วนเนื้อหาสำหรับผู้ใช้ที่ตรงตามเกณฑ์ที่เฉพาะเจาะจงAPI จะแสดงตัวเลือกการกำหนดเป้าหมาย 3 รายการ ผู้ใช้ต้องมีคุณสมบัติตรงตามการตั้งค่าการกำหนดเป้าหมายทั้งหมดเพื่อให้ส่วนของช่องปรากฏ
-
targeting.languages[]
: รายการภาษาของแอปพลิเคชัน YouTube ผู้ใช้ที่เลือกภาษาใดภาษาหนึ่งดังกล่าวจะเห็นส่วนช่องที่เกี่ยวข้อง -
targeting.regions[]
: รายการภูมิภาคที่ YouTube แนะนำให้ใช้ ส่วนช่องจะแสดงต่อผู้ใช้ที่เลือกภูมิภาคใดภูมิภาคหนึ่งดังกล่าว รวมถึงผู้ใช้ที่ระบบเลือกภูมิภาคใดภูมิภาคหนึ่งดังกล่าวให้โดยอัตโนมัติ -
targeting.countries[]
: รายชื่อประเทศที่มองเห็นส่วนช่อง ค่าแต่ละค่าในรายการคือรหัสประเทศ ISO 3166-1 Alpha-2
-
-
การกำหนดพร็อพเพอร์ตี้
contentDetails.duration
ของทรัพยากรvideo
ได้รับการแก้ไขเพื่อให้สอดคล้องกับค่าที่อาจแสดงเป็นชั่วโมง วัน และอื่นๆ -
เราได้แก้ไขเอกสารประกอบสำหรับเมธอด
channelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
และvideos.delete
เพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าเมื่อดำเนินการสำเร็จ เมธอดเหล่านั้นจะแสดงรหัสการตอบกลับ HTTP204
(No Content
)
-
-
ข้อผิดพลาดใหม่และที่อัปเดต
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
targetInvalidCountry
เมธอด channelSections.insert
และchannelSections.update
จะแสดงข้อผิดพลาดนี้หากทรัพยากรchannelSection
ที่แทรกมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้targeting.countries[]
badRequest (400)
targetInvalidLanguage
เมธอด channelSections.insert
และchannelSections.update
จะแสดงข้อผิดพลาดนี้หากทรัพยากรchannelSection
ที่แทรกมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้targeting.languages[]
badRequest (400)
targetInvalidRegion
เมธอด channelSections.insert
และchannelSections.update
จะแสดงข้อผิดพลาดนี้หากทรัพยากรchannelSection
ที่แทรกมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้targeting.regions[]
badRequest (400)
operationNotSupported
เมธอด comments.insert
จะแสดงข้อผิดพลาดนี้หากผู้ใช้ API ไม่สามารถแทรกความคิดเห็นเพื่อตอบกลับความคิดเห็นระดับบนสุดที่ระบุโดยพร็อพเพอร์ตี้snippet.parentId
ในcommentThread
ทรัพยากร พร็อพเพอร์ตี้snippet.canReply
จะระบุว่าผู้ชมปัจจุบันตอบกลับเธรดได้หรือไม่badRequest (400)
invalidChannelId
เมธอด search.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์channelId
ในคำขอระบุรหัสช่องที่ไม่ถูกต้องbadRequest (400)
subscriptionForbidden
เมธอด subscriptions.insert
จะแสดงข้อผิดพลาดนี้หากผู้ใช้ API พยายามติดตามช่องของตนเอง -
วิธีการ
captions.update
ไม่รองรับข้อผิดพลาดinvalidMetadata
และvideoNotFound
อีกต่อไป
-
16 เมษายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตคู่มือการย้ายข้อมูลเพื่ออธิบายวิธีย้ายข้อมูลแอปพลิเคชันที่ยังใช้ฟังก์ชันความคิดเห็นจาก API เวอร์ชัน 2
นอกจากนี้ คู่มือยังระบุฟีเจอร์การแสดงความคิดเห็นหลายอย่างที่ API v2 ไม่รองรับ แต่รองรับใน API v3 ซึ่งได้แก่
- การดึงข้อมูลความคิดเห็นเกี่ยวกับช่อง
- ดึงข้อมูลชุดความคิดเห็นทั้งหมดที่เกี่ยวข้องกับช่อง ซึ่งหมายความว่าการตอบกลับของ API อาจมีทั้งความคิดเห็นเกี่ยวกับช่องหรือวิดีโอใดๆ ของช่อง
- การอัปเดตข้อความของความคิดเห็น
- การทำเครื่องหมายความคิดเห็นว่าเป็นสแปม
- การตั้งค่าสถานะการดูแลความคิดเห็น
-
เราได้อัปเดตคำแนะนำการสมัครรับการแจ้งเตือนแบบพุชเพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าระบบจะพุชการแจ้งเตือนไปยังฮับ Google PubSubHubBub เท่านั้น และจะไม่พุชไปยังฮับ Superfeedr ด้วยตามที่ระบุไว้ก่อนหน้านี้
9 เมษายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูล
commentThread
และcomment
ใหม่ของ API ช่วยให้คุณดึงข้อมูล แทรก อัปเดต ลบ และกลั่นกรองความคิดเห็นได้-
commentThread
ทรัพยากรประกอบด้วยข้อมูลเกี่ยวกับชุดข้อความความคิดเห็นบน YouTube ซึ่งประกอบด้วยความคิดเห็นระดับบนสุดและการตอบกลับความคิดเห็นนั้น (หากมี)commentThread
ทรัพยากรอาจแสดงความคิดเห็นเกี่ยวกับวิดีโอหรือช่องความคิดเห็นระดับบนสุดและการตอบกลับเป็น
comment
ทรัพยากรที่ซ้อนอยู่ภายในทรัพยากรcommentThread
โปรดทราบว่าcommentThread
ทรัพยากรนี้อาจไม่ได้มีคำตอบทั้งหมดของความคิดเห็น และคุณต้องใช้วิธีcomments.list
หากต้องการดึงคำตอบทั้งหมดของความคิดเห็นหนึ่งๆ นอกจากนี้ ความคิดเห็นบางรายการอาจไม่มีคำตอบAPI รองรับวิธีการต่อไปนี้สำหรับทรัพยากร
commentThread
commentThreads.list
- ดึงข้อมูลรายการเทรดความคิดเห็น ใช้วิธีนี้เพื่อดึงความคิดเห็นที่เชื่อมโยงกับวิดีโอหรือช่องใดช่องหนึ่งcommentThreads.insert
– สร้างความคิดเห็นระดับบนสุดใหม่ (ใช้วิธีcomments.insert
เพื่อตอบกลับความคิดเห็นที่มีอยู่)commentThreads.update
– แก้ไขความคิดเห็นระดับบนสุด
-
ทรัพยากร
comment
มีข้อมูลเกี่ยวกับความคิดเห็น YouTube รายการเดียวcomment
แหล่งข้อมูลอาจแสดงความคิดเห็นเกี่ยวกับวิดีโอหรือช่อง นอกจากนี้ ความคิดเห็นอาจเป็นความคิดเห็นระดับบนสุดหรือการตอบกลับความคิดเห็นระดับบนสุดก็ได้API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร
comment
comments.list
– ดึงข้อมูลรายการความคิดเห็น ใช้วิธีนี้เพื่อดึงข้อมูลการตอบกลับทั้งหมดของความคิดเห็นหนึ่งๆcomments.insert
– สร้างคำตอบสำหรับความคิดเห็นที่มีอยู่comments.update
- แก้ไขความคิดเห็นcomments.markAsSpam
– แจ้งว่าความคิดเห็นอย่างน้อย 1 รายการเป็นสแปมcomments.setModerationStatus
- ตั้งค่าสถานะการดูแลความคิดเห็นอย่างน้อย 1 รายการ เช่น ล้างความคิดเห็นเพื่อแสดงต่อสาธารณะ หรือปฏิเสธความคิดเห็นว่าไม่เหมาะสมที่จะแสดง เจ้าของช่องหรือวิดีโอที่เชื่อมโยงกับความคิดเห็นต้องให้สิทธิ์คำขอ APIcomments.delete
– ลบความคิดเห็น
โปรดทราบว่าการเรียกใช้เมธอด
comments.insert
,comments.update
,comments.markAsSpam
,comments.setModerationStatus
,comments.delete
,commentThreads.insert
และcommentThreads.update
ต้องใช้https://www.googleapis.com/auth/youtube.force-ssl
ขอบเขตใหม่ของ API ซึ่งอธิบายไว้ในประวัติการแก้ไขวันที่ 2 เมษายน 2015 -
-
คำแนะนำการสมัครรับการแจ้งเตือนแบบพุชฉบับใหม่จะอธิบายการรองรับการแจ้งเตือนแบบพุชใหม่ของ API ผ่าน PubSubHubBub ซึ่งเป็นโปรโตคอลการเผยแพร่/การสมัครรับข้อมูลแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์สำหรับทรัพยากรที่เข้าถึงได้บนเว็บ เซิร์ฟเวอร์การเรียกกลับของ PubSubHubBub จะได้รับการแจ้งเตือนฟีด Atom เมื่อช่องทำกิจกรรมต่อไปนี้
- อัปโหลดวิดีโอ
- อัปเดตชื่อวิดีโอ
- อัปเดตคำอธิบายของวิดีโอ
-
นอกจากนี้ เรายังได้อัปเดตคำแนะนำในการย้ายข้อมูลเพื่อระบุการรองรับใหม่สำหรับข้อความ Push ด้วย อย่างไรก็ตาม เนื่องจาก API v2 รองรับข้อความ Push ประเภทอื่นๆ อีกมากมายที่ API v3 ไม่รองรับ การกล่าวถึงการรองรับ PubSubHubBub จึงยังคงแสดงอยู่ในส่วนเลิกใช้งานแล้วของคำแนะนำดังกล่าว
-
https://www.googleapis.com/auth/youtube.force-ssl
ขอบเขตใหม่ของ API เป็นขอบเขตที่ใช้ได้กับเมธอด API ใดก็ตามที่ก่อนหน้านี้รองรับขอบเขตhttps://www.googleapis.com/auth/youtube
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
invalidRating
เมธอด videos.rate
จะแสดงข้อผิดพลาดนี้หากคำขอมีค่าที่ไม่คาดคิดสำหรับพารามิเตอร์rating
-
subscriptions.insert
วิธีการนี้ไม่รองรับข้อผิดพลาดsubscriptionLimitExceeded
อีกต่อไป ซึ่งก่อนหน้านี้ระบุว่าผู้ติดตามที่ระบุในคำขอมีอัตราการสมัครใช้บริการเกินขีดจำกัด
2 เมษายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
captions
ทรัพยากรใหม่แสดงถึงแทร็กคำบรรยายแทนเสียงของ YouTube แทร็กคำบรรยายแทนเสียงจะเชื่อมโยงกับวิดีโอ YouTube เพียง 1 รายการเท่านั้นAPI รองรับวิธีการในการแสดง แทรก อัปเดต ดาวน์โหลด และลบแทร็กคำบรรยายแทนเสียง
-
นอกจากนี้ เรายังได้อัปเดตคำแนะนำในการย้ายข้อมูลเพื่ออธิบายวิธีย้ายข้อมูลแอปพลิเคชันที่ยังใช้ฟังก์ชันคำบรรยายแทนเสียงใน v2 API
-
https://www.googleapis.com/auth/youtube.force-ssl
ขอบเขตใหม่ของ API กำหนดให้การสื่อสารกับเซิร์ฟเวอร์ API ต้องเกิดขึ้นผ่านการเชื่อมต่อ SSLขอบเขตใหม่นี้ให้สิทธิ์เข้าถึงเดียวกันกับขอบเขต
https://www.googleapis.com/auth/youtube
และในความเป็นจริง ขอบเขตทั้ง 2 นี้ทำงานเหมือนกันทุกประการเนื่องจากเซิร์ฟเวอร์ YouTube API พร้อมให้บริการผ่านอุปกรณ์ปลายทาง HTTPS เท่านั้น ด้วยเหตุนี้ แม้ว่าhttps://www.googleapis.com/auth/youtube
scope จะไม่จำเป็นต้องใช้การเชื่อมต่อ SSL แต่จริงๆ แล้วไม่มีวิธีอื่นในการส่งคำขอ APIต้องใช้ขอบเขตใหม่สำหรับการเรียกใช้วิธีการทั้งหมดของทรัพยากร
caption
11 มีนาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
คำแนะนำในการย้ายข้อมูล YouTube Data API (v3) มีแท็บใหม่ชื่อฟีเจอร์ใหม่ใน v3 API ซึ่งแสดงรายการฟีเจอร์ที่ v3 API รองรับและ v2 API ไม่รองรับ ก่อนหน้านี้ฟีเจอร์เดียวกันนี้จะแสดงอยู่ในแท็บอื่นๆ ในคำแนะนำ และยังคงแสดงอยู่ ตัวอย่างเช่น ฟีเจอร์ใหม่ที่อธิบายวิธีอัปเดตข้อมูลแคมเปญโปรโมตในวิดีโอของช่องจะแสดงอยู่ในแท็บช่อง (โปรไฟล์) ด้วย
-
เราได้อัปเดตคู่มือการย้ายข้อมูล YouTube Data API (v3) เพื่อระบุว่า API v3 จะรองรับฟีเจอร์ API v2 ต่อไปนี้
-
เราได้อัปเดตคำแนะนำในการย้ายข้อมูล YouTube Data API (v3) เพื่อระบุว่า API เวอร์ชัน 3 จะไม่รองรับฟีเจอร์ API เวอร์ชัน 2 ต่อไปนี้
-
ดึงข้อมูลวิดีโอแนะนำ - API เวอร์ชัน 3 จะไม่ดึงข้อมูลรายการที่มีเฉพาะวิดีโอที่แนะนำสำหรับผู้ใช้ API ปัจจุบัน อย่างไรก็ตาม คุณสามารถใช้ API เวอร์ชัน 3 เพื่อค้นหาวิดีโอแนะนำได้โดยการเรียกใช้เมธอด
activities.list
และตั้งค่าพารามิเตอร์home
เป็นtrue
ในคำตอบของ API แหล่งข้อมูลจะสอดคล้องกับวิดีโอที่แนะนำหากค่าของพร็อพเพอร์ตี้
snippet.type
เป็นrecommendation
ในกรณีดังกล่าว พร็อพเพอร์ตี้contentDetails.recommendation.reason
และcontentDetails.recommendation.seedResourceId
จะมีข้อมูลเกี่ยวกับเหตุผลที่ระบบแนะนำวิดีโอ โปรดทราบว่าเราไม่รับประกันว่าการตอบกลับจะมีวิดีโอแนะนำตามจำนวนที่เฉพาะเจาะจง -
ดึงข้อมูลวิดีโอจากการติดตามใหม่ - API เวอร์ชัน 3 จะไม่ดึงข้อมูลรายการที่มีเฉพาะวิดีโอที่เพิ่งอัปโหลดไปยังช่องที่ผู้ใช้ API ติดตาม อย่างไรก็ตาม คุณสามารถใช้ v3 API เพื่อค้นหาวิดีโอที่ช่องที่คุณติดตามเพิ่งอัปโหลดได้โดยเรียกใช้เมธอด
activities.list
และตั้งค่าพารามิเตอร์home
เป็นtrue
ในคำตอบของ API ทรัพยากรจะสอดคล้องกับวิดีโอการสมัครใช้บริการใหม่หากค่าของพร็อพเพอร์ตี้
snippet.type
เป็นupload
โปรดทราบว่าเราไม่รับประกันว่าการตอบกลับจะมีวิดีโอใหม่จากการติดตามจำนวนหนึ่งๆ -
ข้อความ Push สำหรับการอัปเดตฟีด - API เวอร์ชัน 2 รองรับข้อความ Push โดยใช้ Simple Update Protocol (SUP) หรือ PubSubHubbub เพื่อตรวจสอบฟีดกิจกรรมของผู้ใช้สำหรับผู้ใช้ YouTube ระบบจะแจ้งเตือนเมื่อมีการติดตามช่องใหม่ รวมถึงเมื่อมีการให้คะแนน แชร์ ทำเครื่องหมายเป็นรายการโปรด แสดงความคิดเห็น หรืออัปโหลดวิดีโอ
API เวอร์ชัน 3 จะรองรับข้อความพุชโดยใช้โปรโตคอล PubSubHubbub แต่การแจ้งเตือนจะครอบคลุมเฉพาะการอัปโหลดวิดีโอและการอัปเดตชื่อวิดีโอหรือคำอธิบายวิดีโอเท่านั้น
-
สถานที่ตั้งของช่อง - API v2 ใช้แท็ก
<yt:location>
เพื่อระบุสถานที่ตั้งของผู้ใช้ตามที่ป้อนในโปรไฟล์สาธารณะของช่องบน YouTube แม้ว่านักพัฒนาแอปบางรายจะใช้ช่องนี้เพื่อเชื่อมโยงช่องกับประเทศหนึ่งๆ แต่ข้อมูลในช่องก็ไม่สามารถใช้เพื่อวัตถุประสงค์ดังกล่าวได้อย่างสม่ำเสมอ -
ตั้งค่าหรือดึงแท็กนักพัฒนาซอฟต์แวร์ - API v2 รองรับความสามารถในการเชื่อมโยงคีย์เวิร์ดหรือแท็กนักพัฒนาซอฟต์แวร์กับวิดีโอในขณะที่อัปโหลดวิดีโอ แท็กนักพัฒนาแอปจะไม่แสดงต่อผู้ใช้ YouTube แต่เจ้าของวิดีโอจะดึงวิดีโอที่ตรงกับแท็กนักพัฒนาแอปที่เฉพาะเจาะจงได้
API เวอร์ชัน 3 จะมีฟีเจอร์ที่คล้ายกัน แต่ไม่เหมือนกัน กล่าวคือ นักพัฒนาแอปจะค้นหาวิดีโอที่แอปพลิเคชันของตนเองอัปโหลดได้ สำหรับฟีเจอร์นี้ ระบบจะติดแท็กหมายเลขโปรเจ็กต์ที่เชื่อมโยงกับแอปพลิเคชันของนักพัฒนาแอปใน Google Developers Console ให้กับวิดีโอแต่ละรายการที่อัปโหลดโดยอัตโนมัติ จากนั้นนักพัฒนาแอปจะใช้หมายเลขโปรเจ็กต์เดียวกันเพื่อค้นหาวิดีโอ
-
แสดงวิดีโอตามวันที่เผยแพร่ จำนวนการดู หรือการจัดประเภท - ใน API เวอร์ชัน 2 พารามิเตอร์
orderby
จะช่วยให้คุณจัดเรียงวิดีโอในเพลย์ลิสต์ตามตำแหน่ง ระยะเวลา วันที่เผยแพร่ ชื่อ และค่าอื่นๆ อีกหลายค่าได้ ใน API เวอร์ชัน 3 โดยปกติแล้ว ระบบจะจัดเรียงรายการในเพลย์ลิสต์ตามตำแหน่งในลำดับจากน้อยไปมาก และไม่มีตัวเลือกการจัดเรียงอื่นๆโดยมีข้อยกเว้นบางประการ ระบบจะเพิ่มวิดีโอที่อัปโหลดใหม่ วิดีโอโปรด วิดีโอที่ชอบ หรือวิดีโอที่ดูเมื่อเร็วๆ นี้เป็นรายการแรก (
snippet.position
=0
) โดยอัตโนมัติสำหรับเพลย์ลิสต์ประเภทต่อไปนี้ ดังนั้น รายการเหล่านี้แต่ละรายการจึงได้รับการจัดเรียงตามลำดับจากรายการใหม่สุดไปเก่าสุดตามเวลาที่เพิ่มรายการลงในรายการ- การอัปโหลดของผู้ใช้
- วิดีโอโปรด
- วิดีโอที่ชอบ
- ประวัติการดู
อย่างไรก็ตาม โปรดทราบว่าระบบจะเพิ่มรายการใหม่ที่เพิ่มลงในเพลย์ลิสต์ "ดูภายหลัง" เป็นรายการสุดท้ายในเพลย์ลิสต์นั้น ดังนั้นเพลย์ลิสต์ดังกล่าวจึงเรียงจากรายการเก่าสุดไปใหม่สุด
-
การประมวลผลแบบกลุ่ม - API v3 รองรับ Use Case การประมวลผลแบบกลุ่มรายการหนึ่งที่ API v2 รองรับ เมธอด
channels.list
,channelSections.list
,guideCategories.list
,playlistItems.list
,playlists.list
,subscriptions.list
,videoCategories.list
และvideos.list
ของ API v3 รองรับพารามิเตอร์id
ซึ่งใช้เพื่อระบุรายการรหัสที่คั่นด้วยคอมมา (รหัสวิดีโอ รหัสช่อง ฯลฯ) ได้ เมื่อใช้วิธีการดังกล่าว คุณจะดึงรายการทรัพยากรหลายรายการได้ด้วยคำขอเดียว
การเปลี่ยนแปลงเหล่านี้ทำให้ตอนนี้คู่มือระบุฟังก์ชันทั้งหมดที่รองรับใน API เวอร์ชันเก่า (v2) ซึ่งจะเลิกใช้งานใน API เวอร์ชันปัจจุบัน (v3)
-
4 มีนาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้เมธอด
channelSections.delete
และchannelSections.update
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งก่อนหน้านี้รองรับเมธอดอื่นๆ อยู่หลายรายการ -
เราได้เลิกใช้งานพร็อพเพอร์ตี้ต่อไปนี้และพร็อพเพอร์ตี้ย่อยแล้ว
brandingSettings.image.backgroundImageUrl
brandingSettings.image.largeBrandedBannerImageImapScript
brandingSettings.image.largeBrandedBannerImageUrl
brandingSettings.image.smallBrandedBannerImageImapScript
brandingSettings.image.smallBrandedBannerImageUrl
หมายเหตุ: พร็อพเพอร์ตี้เหล่านี้ไม่เคยอยู่ภายใต้นโยบายการเลิกใช้งาน API
-
พร็อพเพอร์ตี้
contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
ใหม่ของvideo
ทรัพยากรจะระบุเหตุผลที่อธิบายว่าทำไมวิดีโอจึงได้รับการจัดประเภท DJCQT (บราซิล) -
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย notFound (404)
channelNotFound
เมธอด channels.update
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์id
ของคำขอระบุแชแนลที่ไม่พบbadRequest (400)
manualSortRequiredinvalidValue
เมธอด playlistItems.insert
และplaylistItems.update
จะแสดงข้อผิดพลาดนี้หากคำขอพยายามตั้งค่าตำแหน่งของรายการในเพลย์ลิสต์ แต่เพลย์ลิสต์ไม่ได้ใช้การจัดเรียงด้วยตนเอง เช่น ระบบอาจจัดเรียงรายการในเพลย์ลิสต์ตามวันที่หรือความนิยม คุณแก้ไขข้อผิดพลาดนี้ได้โดยนำองค์ประกอบsnippet.position
ออกจากทรัพยากรที่ส่งในเนื้อหาของคำขอ หากต้องการให้รายการในเพลย์ลิสต์มีตำแหน่งที่เฉพาะเจาะจงในรายการ คุณต้องอัปเดตการตั้งค่าการจัดเรียงของเพลย์ลิสต์เป็นกำหนดเองก่อน คุณปรับการตั้งค่านี้ได้ในเครื่องมือจัดการวิดีโอของ YouTubeforbidden (403)
channelClosed
เมธอด playlists.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์channelId
ของคำขอระบุช่องที่ปิดไปแล้วforbidden (403)
channelSuspended
เมธอด playlists.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์channelId
ของคำขอระบุช่องที่ถูกระงับforbidden (403)
playlistForbidden
เมธอด playlists.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์id
ของคำขอไม่รองรับคำขอ หรือคำขอไม่ได้รับอนุญาตอย่างถูกต้องnotFound (404)
channelNotFound
เมธอด playlists.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์channelId
ของคำขอระบุแชแนลที่ไม่พบnotFound (404)
playlistNotFound
เมธอด playlists.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์id
ของคำขอระบุเพลย์ลิสต์ที่ไม่พบnotFound (404)
videoNotFound
เมธอด videos.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์id
ของคำขอระบุวิดีโอที่ไม่พบbadRequest (400)
invalidRating
เมธอด videos.rate
จะแสดงข้อผิดพลาดนี้หากคำขอมีค่าที่ไม่คาดคิดสำหรับพารามิเตอร์rating
2 มีนาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้
search.list
เมธอดรองรับพารามิเตอร์relevanceLanguage
แล้ว ซึ่งช่วยให้คุณขอผลการค้นหาที่เกี่ยวข้องกับภาษาใดภาษาหนึ่งมากที่สุดได้นอกจากนี้ เรายังได้อัปเดตคำแนะนำในการย้ายข้อมูล YouTube Data API (v3) เพื่ออธิบายวิธีใช้พารามิเตอร์ใหม่นี้ด้วย พารามิเตอร์นี้ช่วยเติมเต็มช่องว่างของฟีเจอร์ที่เคยมีอยู่ระหว่าง API เวอร์ชันปัจจุบัน (v3) กับเวอร์ชันก่อนหน้า (v2) ซึ่งเลิกใช้งานไปแล้ว
-
นอกจากนี้ เรายังได้อัปเดตคู่มือการย้ายข้อมูล YouTube Data API (v3) เพื่อระบุการเลิกใช้งานฟีดพิเศษและฟิลด์ข้อมูลเมตาที่ v2 API มีไว้สำหรับอธิบายภาพยนตร์ ตัวอย่างภาพยนตร์ รายการโทรทัศน์ ซีซันของรายการโทรทัศน์ และตอนของรายการโทรทัศน์
14 มกราคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตคู่มือการย้ายข้อมูล YouTube Data API (v3) เพื่ออธิบายวิธีใช้ v3 API ในการอัปโหลดวิดีโอโดยใช้ JavaScript (ดูรายละเอียดได้ที่ส่วนอัปโหลดวิดีโอ) ฟังก์ชันนี้เทียบเท่ากับฟังก์ชันการอัปโหลดบนเบราว์เซอร์ที่ API v2 รองรับ โปรดทราบว่าการเปลี่ยนแปลงคำแนะนำในการย้ายข้อมูลนี้ไม่ได้แสดงถึงการเปลี่ยนแปลง API จริง แต่เป็นการแสดงความพร้อมใช้งานของโค้ดตัวอย่างใหม่สำหรับการอัปโหลดวิดีโอด้วย JavaScript ฝั่งไคลเอ็นต์
เนื่องจากรองรับการอัปโหลดวิดีโอด้วยไลบรารีไคลเอ็นต์ JavaScript และ CORS คู่มือการย้ายข้อมูลจึงไม่ได้ระบุการอัปโหลดบนเบราว์เซอร์เป็นฟีเจอร์ที่อาจเลิกใช้งานใน API เวอร์ชัน 3 อีกต่อไป
-
เอกสารประกอบสำหรับเมธอด
videos.insert
ได้รับการอัปเดตให้มีตัวอย่างโค้ด JavaScript ใหม่ที่อธิบายไว้ข้างต้น นอกจากนี้ เรายังได้อัปเดตรายการตัวอย่างโค้ด JavaScript สำหรับ YouTube Data API (v3) ด้วย
11 พฤศจิกายน 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ค่าใช้จ่ายโควต้าสำหรับการเรียกใช้เมธอด
search.list
เปลี่ยนเป็น 100 หน่วยแล้วสำคัญ: ในหลายกรณี คุณสามารถใช้วิธีการ API อื่นๆ เพื่อดึงข้อมูลโดยใช้โควต้าที่ต่ำกว่าได้ ตัวอย่างเช่น ลองพิจารณาวิธีค้นหาวิดีโอที่อัปโหลดไปยังช่อง GoogleDevelopers 2 วิธีต่อไปนี้
-
ค่าใช้จ่ายของโควต้า: 100 หน่วย
เรียกใช้เมธอด
search.list
และค้นหาGoogleDevelopers
-
ค่าใช้จ่ายของโควต้า: 6 หน่วย
เรียกใช้เมธอด
channels.list
เพื่อค้นหารหัสช่องที่ถูกต้อง ตั้งค่าพารามิเตอร์forUsername
เป็นGoogleDevelopers
และพารามิเตอร์part
เป็นcontentDetails
ในคำตอบของ API พร็อพเพอร์ตี้contentDetails.relatedPlaylists.uploads
จะระบุรหัสเพลย์ลิสต์สำหรับวิดีโอที่อัปโหลดของช่องจากนั้นเรียกใช้เมธอด
playlistItems.list
และตั้งค่าพารามิเตอร์playlistId
เป็นรหัสที่บันทึกไว้ และตั้งค่าพารามิเตอร์part
เป็นsnippet
-
8 ตุลาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
channel
ทรัพยากรมีพร็อพเพอร์ตี้ใหม่ 2 รายการ ดังนี้-
พร็อพเพอร์ตี้
status.longUploadsStatus
จะระบุว่าช่องมีสิทธิ์อัปโหลดวิดีโอที่มีความยาวมากกว่า 15 นาทีหรือไม่ ระบบจะแสดงพร็อพเพอร์ตี้นี้ก็ต่อเมื่อเจ้าของช่องอนุญาตคำขอ API เท่านั้น ค่าพร็อพเพอร์ตี้ที่ใช้ได้มีดังนี้allowed
– ช่องจะอัปโหลดวิดีโอที่มีความยาวมากกว่า 15 นาทีได้eligible
– ช่องมีสิทธิ์อัปโหลดวิดีโอที่มีความยาวเกิน 15 นาที แต่ต้องเปิดใช้ฟีเจอร์นี้ก่อนdisallowed
– ช่องไม่สามารถหรือไม่มีสิทธิ์อัปโหลดวิดีโอที่มีความยาวเกิน 15 นาที
ดูข้อมูลเพิ่มเติมเกี่ยวกับค่าเหล่านี้ได้ที่คําจํากัดความของพร็อพเพอร์ตี้ ศูนย์ช่วยเหลือของ YouTube ยังมีข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ด้วย
-
พร็อพเพอร์ตี้
invideoPromotion.useSmartTiming
จะระบุว่าแคมเปญโปรโมชันของช่องใช้ "เวลาที่เหมาะสม" หรือไม่ ฟีเจอร์นี้พยายามแสดงโปรโมชันในจุดที่ผู้ชมมีแนวโน้มที่จะคลิกมากที่สุดและรบกวนประสบการณ์การรับชมน้อยที่สุด นอกจากนี้ ฟีเจอร์นี้ยังเลือกโปรโมชันรายการเดียวเพื่อแสดงในวิดีโอแต่ละรายการด้วย
-
-
เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
snippet.title
และsnippet.categoryId
ของทรัพยากรvideo
เพื่อชี้แจงวิธีที่ API จัดการการเรียกเมธอดvideos.update
หากเรียกใช้เมธอดนั้นเพื่ออัปเดตส่วนsnippet
ของทรัพยากรvideo
คุณต้องตั้งค่าสำหรับพร็อพเพอร์ตี้ทั้ง 2 รายการหากคุณพยายามอัปเดตส่วน
snippet
ของทรัพยากรvideo
และไม่ได้ตั้งค่าสำหรับพร็อพเพอร์ตี้ทั้ง 2 รายการ API จะแสดงข้อผิดพลาดinvalidRequest
นอกจากนี้ เรายังได้อัปเดตคำอธิบายของข้อผิดพลาดดังกล่าวด้วย -
พร็อพเพอร์ตี้
contentDetails.contentRating.oflcRating
ของvideo
ทรัพยากร ซึ่งระบุการจัดประเภทของวิดีโอจากสำนักงานการจัดประเภทภาพยนตร์และวรรณกรรมของนิวซีแลนด์ รองรับการจัดประเภทใหม่ 2 รายการ ได้แก่oflcRp13
และoflcRp16
โดยจะสอดคล้องกับการจัดประเภทRP13
และRP16
ตามลำดับ -
ตอนนี้เมธอด
channelBanners.insert
รองรับข้อผิดพลาดต่อไปนี้แล้วประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
bannerAlbumFull
อัลบั้มหน้าปกช่อง YouTube ของเจ้าของช่องมีรูปภาพมากเกินไป เจ้าของช่องควรไปที่ http://photos.google.com ไปที่หน้าอัลบั้ม แล้วนำรูปภาพบางส่วนออกจากอัลบั้มนั้น
12 กันยายน 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ต้นทุนโควต้าสำหรับการเรียกใช้เมธอด
search.list
เปลี่ยนจาก 1 หน่วยเป็น 2 หน่วย นอกเหนือจากต้นทุนของชิ้นส่วนทรัพยากรที่ระบุ
13 สิงหาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้เมธอด
subscriptions.insert
รองรับข้อผิดพลาดต่อไปนี้แล้วประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
subscriptionLimitExceeded
ผู้ติดตามที่ระบุในคำขอมีอัตราการติดตามเกินขีดจำกัด คุณจะลองสมัครใช้บริการเพิ่มเติมได้ในอีก 2-3 ชั่วโมง
12 สิงหาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
คำแนะนำใหม่ชื่อการย้ายข้อมูลแอปพลิเคชันไปยัง YouTube Data API (v3) อธิบายวิธีใช้ YouTube Data API (v3) เพื่อดำเนินการฟังก์ชันที่มีใน YouTube Data API (v2) เราได้เลิกใช้งาน API เวอร์ชันเก่าอย่างเป็นทางการตั้งแต่วันที่ 4 มีนาคม 2014 คู่มือนี้มีจุดประสงค์เพื่อช่วยคุณย้ายข้อมูลแอปพลิเคชันที่ยังใช้ API เวอร์ชัน 2 ไปยัง API เวอร์ชันล่าสุด
8 กรกฎาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้เมธอด
playlists.insert
รองรับข้อผิดพลาดต่อไปนี้แล้วประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
maxPlaylistExceeded
ข้อผิดพลาดนี้จะเกิดขึ้นหากสร้างเพลย์ลิสต์ไม่ได้เนื่องจากช่องมีเพลย์ลิสต์ถึงจำนวนสูงสุดที่อนุญาตแล้ว
18 มิถุนายน 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
คำอธิบายของเมธอด API แต่ละรายการได้รับการอัปเดตให้รวมต้นทุนโควต้าที่เกิดจากการเรียกเมธอดนั้น ในทํานองเดียวกัน เราได้อัปเดตคําจํากัดความของ
part
พารามิเตอร์เพื่อระบุต้นทุนโควต้าของแต่ละส่วนที่เรียกข้อมูลได้ในการเรียก API เช่น การเรียกใช้เมธอดsubscriptions.insert
จะมีต้นทุนโควต้าประมาณ 50 หน่วย นอกจากนี้ ทรัพยากรsubscription
ยังมี 3 ส่วน (snippet
,contentDetails
และsubscriberSnippet
) และแต่ละส่วนมีต้นทุน 2 หน่วยโปรดทราบว่าค่าใช้จ่ายของโควต้าอาจเปลี่ยนแปลงได้โดยไม่ต้องแจ้งให้ทราบ
-
ตอนนี้ทรัพยากร
video
รองรับระบบการจัดประเภทเนื้อหาใหม่ 43 ระบบ ซึ่งจะระบุการจัดประเภทที่วิดีโอได้รับจากหน่วยงานจัดประเภทระดับชาติต่างๆ ระบบการจัดประเภทที่รองรับใหม่มาจากอาร์เจนตินา ออสเตรีย เบลเยียม บัลแกเรีย ชิลี (โทรทัศน์) ชิลี (ภาพยนตร์) สาธารณรัฐเช็ก โคลอมเบีย เดนมาร์ก อียิปต์ เอสโตเนีย ฟินแลนด์ ฝรั่งเศส กรีซ ฮ่องกง ไอซ์แลนด์ อินโดนีเซีย ไอร์แลนด์ อิสราเอล อิตาลี เคนยา ลัตเวีย ลักเซมเบิร์ก มาเลเซีย มัลดีฟส์ มอลตา เนเธอร์แลนด์ ไนจีเรีย นอร์เวย์ เปรู ฟิลิปปินส์ โปรตุเกส โรมาเนีย สิงคโปร์ สโลวาเกีย แอฟริกาใต้ สวีเดน สวิตเซอร์แลนด์ ไต้หวัน ไทย และเวเนซุเอลา
28 พฤษภาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้
search.list
เมธอดรองรับพารามิเตอร์location
และlocationRadius
แล้ว ซึ่งจะช่วยให้คุณค้นหาวิดีโอที่เชื่อมโยงกับสถานที่ตั้งทางภูมิศาสตร์ได้ คำขอต้องระบุค่าสำหรับพารามิเตอร์ทั้ง 2 รายการเพื่อดึงผลลัพธ์ตามสถานที่ตั้ง และ API จะแสดงข้อผิดพลาดหากคำขอมีพารามิเตอร์เพียงรายการเดียวจาก 2 รายการ-
พารามิเตอร์
location
จะระบุพิกัดละติจูด/ลองจิจูดที่กึ่งกลางของพื้นที่ทางภูมิศาสตร์ที่เป็นวงกลม -
พารามิเตอร์
locationRadius
ระบุระยะทางสูงสุดที่สถานที่ตั้งซึ่งเชื่อมโยงกับวิดีโอสามารถอยู่ห่างจากศูนย์กลางของพื้นที่เพื่อให้วิดีโอยังคงรวมอยู่ในผลการค้นหา
-
13 พฤษภาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตพร็อพเพอร์ตี้
invideoPromotion.items[]
ของchannel
ทรัพยากรเพื่อระบุว่าโดยปกติแล้วคุณจะตั้งค่ารายการที่โปรโมตสำหรับช่องได้เพียงรายการเดียว หากคุณพยายามแทรกสินค้าโปรโมตมากเกินไป API จะแสดงข้อผิดพลาดtooManyPromotedItems
ซึ่งมีรหัสสถานะ HTTP400
-
ตอนนี้
channelSection
สามารถมีข้อมูลเกี่ยวกับเนื้อหาแนะนำประเภทใหม่ๆ ได้แล้ว ตอนนี้พร็อพเพอร์ตี้snippet.type
ของchannelSection
ทรัพยากรรองรับค่าต่อไปนี้แล้วpostedPlaylists
- เพลย์ลิสต์ที่เจ้าของช่องโพสต์ลงในฟีดกิจกรรมของช่องpostedVideos
- วิดีโอที่เจ้าของช่องโพสต์ไปยังฟีดกิจกรรมของช่องsubscriptions
- ช่องที่เจ้าของช่องติดตาม
-
พร็อพเพอร์ตี้
contentDetails.contentRating.ifcoRating
ใหม่ของvideo
ทรัพยากรจะระบุการจัดประเภทที่วิดีโอได้รับจากสำนักงานการจัดประเภทภาพยนตร์ของไอร์แลนด์ -
เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
position.cornerPosition
ของwatermark
แหล่งข้อมูลเพื่อระบุว่าลายน้ำจะปรากฏที่มุมขวาบนของเพลเยอร์เสมอ -
เราได้อัปเดตคำจำกัดความของพารามิเตอร์
q
สำหรับเมธอดsearch.list
เพื่อระบุว่าข้อความค้นหาสามารถใช้โอเปอเรเตอร์บูลีน NOT (-
) เพื่อยกเว้นวิดีโอที่เชื่อมโยงกับข้อความค้นหาที่เฉพาะเจาะจงได้ ค่านี้ยังใช้โอเปอเรเตอร์บูลีน OR (|
) เพื่อค้นหาวิดีโอที่เชื่อมโยงกับคำค้นหาคำใดคำหนึ่งจากหลายๆ คำได้ด้วย -
เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
pageInfo.totalResults
ที่แสดงในการตอบกลับ API สำหรับการเรียกsearch.list
เพื่อระบุว่าค่าดังกล่าวเป็นค่าประมาณและอาจไม่ใช่ค่าที่แน่นอน นอกจากนี้ ค่าสูงสุดคือ 1,000,000 คุณไม่ควรใช้ค่านี้เพื่อสร้างลิงก์การแบ่งหน้า แต่ให้ใช้ค่าพร็อพเพอร์ตี้nextPageToken
และprevPageToken
เพื่อพิจารณาว่าจะแสดงลิงก์การแบ่งหน้าหรือไม่ -
เราได้อัปเดตเมธอด
watermarks.set
และwatermarks.unset
เพื่อให้ API แสดงรหัสการตอบกลับ HTTP204
สำหรับคำขอที่สำเร็จไปยังเมธอดเหล่านั้น
2 พฤษภาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
i18nLanguage
แหล่งข้อมูลใหม่จะระบุภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ ภาษาของแอปพลิเคชันยังเรียกว่าภาษา UI ได้ด้วย สำหรับเว็บไซต์ YouTube ระบบอาจเลือกภาษาของแอปพลิเคชันโดยอัตโนมัติตามการตั้งค่าบัญชี Google, ภาษาของเบราว์เซอร์ หรือตำแหน่ง IP และผู้ใช้ยังเลือกภาษา UI ที่ต้องการได้ด้วยตนเองจากส่วนท้ายของเว็บไซต์ YouTubeAPI รองรับวิธีการแสดงภาษาของแอปพลิเคชันที่รองรับ คุณใช้ภาษาที่รองรับเป็นค่าของพารามิเตอร์
hl
ได้เมื่อเรียกใช้เมธอด API เช่นvideoCategories.list
และguideCategories.list
-
i18nRegion
ใหม่ระบุพื้นที่ทางภูมิศาสตร์ที่ผู้ใช้ YouTube เลือกเป็นภูมิภาคเนื้อหาที่ต้องการได้ ภูมิภาคของเนื้อหาอาจเรียกว่าภาษาของเนื้อหาด้วย สำหรับเว็บไซต์ YouTube ระบบอาจเลือกภูมิภาคเนื้อหาโดยอัตโนมัติตามฮิวริสติก เช่น โดเมน YouTube หรือตำแหน่ง IP ของผู้ใช้ และผู้ใช้ยังเลือกภูมิภาคเนื้อหาที่ต้องการได้ด้วยตนเองจากส่วนท้ายของเว็บไซต์ YouTubeAPI รองรับวิธีการแสดงภูมิภาคที่รองรับเนื้อหา คุณสามารถใช้รหัสภูมิภาคที่รองรับเป็นค่าของพารามิเตอร์
regionCode
เมื่อเรียกใช้เมธอด API เช่นsearch.list
,videos.list
,activities.list
และvideoCategories.list
7 เมษายน 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
channelSection
ใหม่มีข้อมูลเกี่ยวกับชุดวิดีโอที่ช่องเลือกแสดง เช่น ส่วนอาจแสดงวิดีโอที่อัปโหลดล่าสุดของช่อง วิดีโอที่อัปโหลดซึ่งได้รับความนิยมมากที่สุด หรือวิดีโอจากเพลย์ลิสต์อย่างน้อย 1 รายการAPI รองรับเมธอดในการแสดง แทรก อัปเดต หรือลบส่วนของช่อง คุณสามารถดึงรายการส่วนของช่องสำหรับช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ได้โดยระบุรหัสช่องที่เฉพาะเจาะจง หรือระบุรายการรหัสส่วนของช่องที่ไม่ซ้ำกัน
นอกจากนี้ เรายังได้อัปเดตเอกสารประกอบเกี่ยวกับข้อผิดพลาดเพื่ออธิบายข้อความแสดงข้อผิดพลาดที่ API รองรับสำหรับเมธอดใหม่เหล่านี้โดยเฉพาะ
-
เราได้อัปเดตคำจำกัดความของออบเจ็กต์
fileDetails
ของทรัพยากรvideo
เพื่ออธิบายว่าระบบจะแสดงผลออบเจ็กต์ดังกล่าวก็ต่อเมื่อพร็อพเพอร์ตี้processingDetails.fileDetailsAvailability
ของวิดีโอมีค่าเป็นavailable
เท่านั้นในทำนองเดียวกัน คำจำกัดความของออบเจ็กต์
suggestions
ของทรัพยากรvideo
ได้รับการอัปเดตเพื่ออธิบายว่าระบบจะแสดงผลออบเจ็กต์นั้นก็ต่อเมื่อพร็อพเพอร์ตี้processingDetails.tagSuggestionsAvailability
ของวิดีโอหรือพร็อพเพอร์ตี้processingDetails.editorSuggestionsAvailability
มีค่าเป็นavailable
-
เราได้อัปเดตเอกสารประกอบสำหรับเมธอด
videos.insert
และvideos.update
เพื่อให้สอดคล้องกับการตั้งค่าพร็อพเพอร์ตี้status.publishAt
เมื่อเรียกใช้เมธอดเหล่านั้น -
เราได้อัปเดตคำจำกัดความของออบเจ็กต์
invideoPromotion
ของทรัพยากรchannel
เพื่ออธิบายว่าเจ้าของช่องเท่านั้นที่จะเรียกข้อมูลออบเจ็กต์ได้ -
เราได้อัปเดตรายการพารามิเตอร์สำหรับเมธอด
videos.rate
เพื่อให้เห็นว่าเมธอดดังกล่าวไม่รองรับพารามิเตอร์onBehalfOfContentOwner
จริงๆ นี่เป็นข้อผิดพลาดในเอกสารเนื่องจากvideos.rate
คำขอที่ตั้งค่าพารามิเตอร์นี้จะแสดงข้อผิดพลาด500
31 มีนาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้
video
resource's newstatus.publishAt
ช่วยให้คุณระบุวันที่และเวลาที่กำหนดเวลาเผยแพร่วิดีโอส่วนตัวได้ คุณจะตั้งค่าพร็อพเพอร์ตี้นี้ได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอเป็นprivate
และวิดีโอนั้นไม่เคยเผยแพร่มาก่อน พร็อพเพอร์ตี้ใหม่นี้ไม่อยู่ภายใต้นโยบายการเลิกใช้งาน
13 มีนาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้ API รองรับส่วน
contentOwnerDetails
สำหรับทรัพยากรchannel
แล้ว ส่วนใหม่นี้มีข้อมูลช่องที่เกี่ยวข้องกับพาร์ทเนอร์ YouTube ที่ลิงก์กับช่อง รวมถึงรหัสของเจ้าของเนื้อหาที่ลิงก์กับช่อง และวันที่และเวลาที่เจ้าของเนื้อหาและช่องลิงก์กัน โปรดทราบว่าส่วนใหม่นี้ไม่อยู่ภายใต้นโยบายการเลิกใช้งาน -
ตอนนี้เอกสารประกอบจะแสดงความยาวอักขระสูงสุดที่รองรับสำหรับพร็อพเพอร์ตี้ต่อไปนี้
ทรัพยากร พร็อพเพอร์ตี้ ความยาวสูงสุด channel
invideoPromotion.items[].customMessage
40 อักขระ video
snippet.title
100 อักขระ video
snippet.description
5,000 ไบต์ video
snippet.tags
500 อักขระ โปรดทราบว่าค่าพร็อพเพอร์ตี้คือรายการ และคอมมาระหว่างรายการในรายการจะนับรวมในขีดจํากัด -
เลิกใช้งานพร็อพเพอร์ตี้
brandingSettings.watch.featuredPlaylistId
ของทรัพยากรchannel
แล้ว API จะแสดงข้อผิดพลาดหากคุณพยายามตั้งค่า -
เราได้เพิ่ม
video
พร็อพเพอร์ตี้ทรัพยากรต่อไปนี้ลงในรายการค่าที่ตั้งได้เมื่อแทรกหรืออัปเดตวิดีโอ -
ตอนนี้เอกสารประกอบเกี่ยวกับข้อผิดพลาดระบุรหัสการตอบกลับ HTTP สำหรับข้อผิดพลาดแต่ละประเภทแล้ว
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
invalidCriteria
เมธอด channels.list
จะแสดงข้อผิดพลาดนี้หากคำขอระบุพารามิเตอร์ตัวกรองที่ใช้ร่วมกันไม่ได้badRequest (400)
channelTitleUpdateForbidden
เมธอด channels.update
จะแสดงข้อผิดพลาดนี้หากคุณพยายามอัปเดตส่วนbrandingSettings
ของช่องและเปลี่ยนค่าของพร็อพเพอร์ตี้brandingSettings.channel.title
(โปรดทราบว่า API จะไม่แสดงข้อผิดพลาดหากคุณละเว้นพร็อพเพอร์ตี้นี้)badRequest (400)
invalidRecentlyUploadedBy
channels.update
เมธอดจะแสดงข้อผิดพลาดนี้หากพร็อพเพอร์ตี้invideoPromotion.items[].id.recentlyUploadedBy
ระบุรหัสช่องที่ไม่ถูกต้องbadRequest (400)
invalidTimingOffset
เมธอด channels.update
จะแสดงข้อผิดพลาดนี้หากส่วนinvideoPromotion
ระบุออฟเซ็ตเวลาที่ไม่ถูกต้องbadRequest (400)
tooManyPromotedItems
เมธอด channels.update
จะแสดงข้อผิดพลาดนี้หากส่วนinvideoPromotion
ระบุสินค้าที่โปรโมตมากกว่าจำนวนที่อนุญาตforbidden (403)
promotedVideoNotAllowed
เมธอด channels.update
จะแสดงข้อผิดพลาดนี้หากพร็อพเพอร์ตี้invideoPromotion.items[].id.videoId
ระบุรหัสวิดีโอที่ไม่พบหรือใช้เป็นรายการที่โปรโมตไม่ได้forbidden (403)
websiteLinkNotAllowed
channels.update
เมธอดจะแสดงข้อผิดพลาดนี้หากพร็อพเพอร์ตี้invideoPromotion.items[].id.websiteUrl
ระบุ URL ที่ไม่อนุญาตrequired (400)
requiredTimingType
เมธอด channels.update
จะแสดงข้อผิดพลาดนี้หากคำขอไม่ได้ระบุการตั้งค่าเวลาเริ่มต้นสำหรับเวลาที่ YouTube ควรแสดงรายการที่โปรโมตrequired (400)
requiredTiming
channels.update
method ต้องระบุออบเจ็กต์invideoPromotion.items[].timing
สำหรับสินค้าแต่ละรายการที่โปรโมตrequired (400)
requiredWebsiteUrl
เมธอด channels.update
ต้องระบุพร็อพเพอร์ตี้invideoPromotion.items[].id.websiteUrl
สำหรับสินค้าที่โปรโมตแต่ละรายการbadRequest (400)
invalidPublishAt
videos.insert
เมธอดจะแสดงข้อผิดพลาดนี้หากข้อมูลเมตาของคำขอระบุเวลาเผยแพร่ที่กำหนดเวลาไว้ที่ไม่ถูกต้อง
4 มีนาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้ YouTube Data API เวอร์ชัน 3 อยู่ภายใต้นโยบายการเลิกใช้งานที่อธิบายไว้ในข้อกำหนดในการให้บริการของ YouTube APIs โปรดทราบว่าหน้าเว็บที่แสดง API ที่อยู่ภายใต้นโยบายการเลิกใช้งานจะยกเว้นฟังก์ชันการทำงานของ API บางอย่างใน v3 ไม่ให้อยู่ภายใต้นโยบายนี้โดยเฉพาะ
5 ธันวาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตเอกสารประกอบของเมธอด
search.list
เพื่อให้แสดงอย่างถูกต้องว่าคุณไม่จำเป็นต้องระบุค่าสำหรับพารามิเตอร์ตัวกรองเพียง 1 รายการเมื่อส่งคำขอค้นหา แต่คุณสามารถตั้งค่าสำหรับพารามิเตอร์ตัวกรอง 0 รายการหรือพารามิเตอร์ตัวกรอง 1 รายการได้ -
เราได้อัปเดตคําจํากัดความของพารามิเตอร์ของเมธอด
search.list
เพื่อให้ทราบว่าคุณต้องตั้งค่าพารามิเตอร์type
เป็นvideo
หากคุณระบุค่าสําหรับพารามิเตอร์ต่อไปนี้eventType
videoCaption
videoCategoryId
videoDefinition
videoDimension
videoDuration
videoEmbeddable
videoLicense
videoSyndicated
videoType
-
เราได้ลดขนาดขั้นต่ำของรูปภาพแบนเนอร์ช่องที่อัปโหลดเป็น 2048 x 1152 พิกเซล (ก่อนหน้านี้ ขนาดขั้นต่ำคือ 2120 x 1192 พิกเซล) นอกจากนี้ โปรดทราบว่า
channel
เอกสารประกอบเกี่ยวกับทรัพยากรระบุขนาดสูงสุดของรูปภาพแบนเนอร์ทั้งหมดที่แสดงจาก API ตัวอย่างเช่น ขนาดสูงสุดของรูปภาพbrandingSettings.image.bannerTvImageUrl
สำหรับแอปพลิเคชันโทรทัศน์คือ 2120 x 1192 พิกเซล แต่รูปภาพจริงอาจมีขนาด 2048 x 1152 พิกเซล ศูนย์ช่วยเหลือของ YouTube มีคำแนะนำเพิ่มเติมในการเพิ่มประสิทธิภาพหน้าปกช่องให้แสดงผลบนอุปกรณ์ประเภทต่างๆ -
channel
คำจำกัดความของพร็อพเพอร์ตี้ทรัพยากรหลายรายการได้รับการอัปเดตเพื่อให้สอดคล้องกับข้อมูลต่อไปนี้- ค่าของพร็อพเพอร์ตี้
brandingSettings.channel.description
มีความยาวสูงสุด 1,000 อักขระ - พร็อพเพอร์ตี้
brandingSettings.channel.featuredChannelsTitle
มีความยาวได้สูงสุด 30 อักขระ - ตอนนี้
brandingSettings.channel.featuredChannelsUrls[]
สามารถแสดงช่องได้สูงสุด 100 ช่องแล้ว - หากตั้งค่าไว้ ค่าพร็อพเพอร์ตี้
brandingSettings.channel.unsubscribedTrailer
ต้องระบุรหัสวิดีโอ YouTube ของวิดีโอแบบสาธารณะหรือแบบไม่เป็นสาธารณะซึ่งเป็นของเจ้าของช่อง
- ค่าของพร็อพเพอร์ตี้
-
ตอนนี้เมธอด
channels.update
รองรับการอัปเดตพร็อพเพอร์ตี้invideoPromotion.items[].promotedByContentOwner
แล้ว พร็อพเพอร์ตี้นี้จะระบุว่าชื่อของเจ้าของเนื้อหาจะแสดงเมื่อแสดงโปรโมชันหรือไม่ โดยจะตั้งค่าได้ก็ต่อเมื่อมีการส่งคำขอ API ที่ตั้งค่าพร็อพเพอร์ตี้ในนามของเจ้าของเนื้อหาโดยใช้พารามิเตอร์onBehalfOfContentOwner
-
ตอนนี้เมธอด
playlistItems.list
และplaylistItems.insert
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งก่อนหน้านี้รองรับเมธอดอื่นๆ อยู่หลายรายการ -
ตอนนี้พร็อพเพอร์ตี้
contentDetails.contentRating.acbRating
สามารถระบุการจัดประเภทจาก Australian Classification Board (ACB) สำหรับภาพยนตร์ หรือจาก Australian Communications and Media Authority (ACMA) สำหรับรายการทีวีสำหรับเด็ก -
พร็อพเพอร์ตี้ใหม่
contentDetails.contentRating.catvRating
และcontentDetails.contentRating.catvfrRating
จะระบุการจัดประเภทที่วิดีโอได้รับภายใต้ระบบการจัดประเภททีวีของแคนาดาและระบบการจัดประเภทของ Régie du cinéma ในภาษาฝรั่งเศส ซึ่งใช้ในควิเบกตามลำดับ -
พร็อพเพอร์ตี้
snippet.assignable
ใหม่ของทรัพยากรvideoCategory
จะระบุว่าวิดีโอที่อัปเดตหรือวิดีโอที่อัปโหลดใหม่เชื่อมโยงกับหมวดหมู่วิดีโอนั้นได้หรือไม่ -
เราได้เพิ่มตัวอย่างโค้ดสำหรับเมธอดต่อไปนี้แล้ว
activities.insert
(ไป)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(ไป)search.list
(ไป)thumbnails.set
(Java)videos.insert
(ไป)
24 ตุลาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API มีฟีเจอร์เพิ่มเติม 2 อย่างที่ออกแบบมาเพื่อช่วยค้นหาและแนะนำเนื้อหาการถ่ายทอดสด ดังนี้
snippet.liveBroadcastContent
พร็อพเพอร์ตี้ใหม่ในผลการค้นหาจะระบุว่าทรัพยากรวิดีโอหรือช่องมีเนื้อหาการถ่ายทอดสดหรือไม่ ค่าพร็อพเพอร์ตี้ที่ใช้ได้คือupcoming
,active
และnone
-
พร็อพเพอร์ตี้
snippet.liveBroadcastContent
ใหม่ของทรัพยากรvideo
จะระบุว่าวิดีโอเป็นไลฟ์สดที่กำลังจะเผยแพร่หรือกำลังเผยแพร่ รายการด้านล่างอธิบายค่าที่เป็นไปได้ของพร็อพเพอร์ตี้upcoming
– วิดีโอเป็นการออกอากาศสดที่ยังไม่เริ่มactive
– วิดีโอเป็นการถ่ายทอดสดที่กำลังดำเนินอยู่none
– วิดีโอไม่ใช่การถ่ายทอดสดที่กำลังจะเผยแพร่หรือที่กำลังเผยแพร่ ซึ่งจะเป็นค่าพร็อพเพอร์ตี้สำหรับการออกอากาศที่เสร็จสมบูรณ์แล้วและยังดูได้บน YouTube
-
พร็อพเพอร์ตี้
liveStreamingDetails
ใหม่ของvideo
รีซอร์สเป็นออบเจ็กต์ที่มีข้อมูลเมตาเกี่ยวกับการออกอากาศวิดีโอสด หากต้องการดึงข้อมูลเมตานี้ ให้ใส่liveStreamingDetails
ในรายการค่าพารามิเตอร์part
ของส่วนทรัพยากร ข้อมูลเมตามีพร็อพเพอร์ตี้ใหม่ต่อไปนี้liveStreamingDetails.actualStartTime
– เวลาที่การออกอากาศเริ่มขึ้นจริง (ค่านี้จะปรากฏเมื่อสถานะการออกอากาศเป็นactive
)liveStreamingDetails.actualEndTime
- เวลาที่การออกอากาศสิ้นสุดลงจริง (ค่านี้จะปรากฏเมื่อการออกอากาศสิ้นสุดลง)liveStreamingDetails.scheduledStartTime
– เวลาที่กำหนดให้การออกอากาศเริ่มต้นliveStreamingDetails.scheduledEndTime
- เวลาที่กำหนดให้การออกอากาศสิ้นสุด หากค่าพร็อพเพอร์ตี้ว่างเปล่าหรือไม่มีพร็อพเพอร์ตี้ ระบบจะตั้งเวลาการออกอากาศให้ดำเนินต่อไปเรื่อยๆliveStreamingDetails.concurrentViewers
– จำนวนผู้ชมที่ดูการออกอากาศสด
หากต้องการดึงข้อมูลเมตานี้ ให้ใส่
liveStreamingDetails
ในค่าพารามิเตอร์part
เมื่อเรียกใช้เมธอดvideos.list
,videos.insert
หรือvideos.update
โปรดทราบว่าเราได้เปิดตัวฟีเจอร์อื่นๆ อีก 2 รายการสำหรับการระบุเนื้อหาการถ่ายทอดสดเมื่อวันที่ 1 ตุลาคม 2013 ซึ่งได้แก่ พารามิเตอร์
search.list
eventType
ของเมธอดและพร็อพเพอร์ตี้snippet.liveBroadcastContent
ของผลการค้นหา -
-
ตอนนี้เมธอด
videos.insert
รองรับพารามิเตอร์notifySubscribers
แล้ว ซึ่งจะระบุว่า YouTube ควรส่งการแจ้งเตือนเกี่ยวกับวิดีโอใหม่ไปยังผู้ใช้ที่ติดตามช่องของวิดีโอหรือไม่ ค่าเริ่มต้นของพารามิเตอร์คือTrue
ซึ่งหมายความว่าระบบจะแจ้งเตือนวิดีโอที่อัปโหลดใหม่ให้ผู้ติดตามทราบ อย่างไรก็ตาม เจ้าของช่องที่อัปโหลดวิดีโอจำนวนมากอาจต้องการตั้งค่าเป็นFalse
เพื่อหลีกเลี่ยงการส่งการแจ้งเตือนเกี่ยวกับวิดีโอใหม่แต่ละรายการไปยังผู้ติดตามของช่อง -
เราได้อัปเดตรายการพร็อพเพอร์ตี้ที่แก้ไขได้เมื่อเรียกใช้เมธอด
channels.update
ให้รวมพร็อพเพอร์ตี้invideoPromotion.items[].customMessage
และinvideoPromotion.items[].websiteUrl
นอกจากนี้ เรายังได้แก้ไขรายการเพื่อระบุbrandingSettings
พร็อพเพอร์ตี้ที่แก้ไขได้ พร็อพเพอร์ตี้brandingSettings
เหล่านี้แก้ไขได้อยู่แล้ว ดังนั้นการเปลี่ยนแปลงเอกสารประกอบจึงไม่ได้แสดงถึงการเปลี่ยนแปลงฟังก์ชันการทำงานที่มีอยู่ของ API -
ตอนนี้เมธอด
playlists.insert
,playlists.update
และplaylists.delete
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งก่อนหน้านี้รองรับในเมธอดอื่นๆ อีกหลายรายการ -
ตอนนี้
playlists.insert
เมธอดรองรับพารามิเตอร์onBehalfOfContentOwnerChannel
ซึ่งรองรับเมธอดอื่นๆ อีกหลายรายการอยู่แล้ว -
ตอนนี้พร็อพเพอร์ตี้
contentDetails.contentRating.tvpgRating
ของทรัพยากรvideo
รองรับค่าpg14
ซึ่งสอดคล้องกับการจัดประเภทTV-14
แล้ว -
เราได้แก้ไขคำจำกัดความของพร็อพเพอร์ตี้
snippet.liveBroadcastContent
ซึ่งเป็นส่วนหนึ่งของผลการค้นหา เพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าlive
เป็นค่าพร็อพเพอร์ตี้ที่ถูกต้อง แต่active
ไม่ใช่ค่าพร็อพเพอร์ตี้ที่ถูกต้อง -
พร็อพเพอร์ตี้
contentDetails.contentRating.mibacRating
ของแหล่งข้อมูลvideo
รองรับการจัดประเภทเพิ่มเติม 2 รายการแล้วmibacVap
(VAP) - เด็กควรมีผู้ใหญ่รับชมด้วยmibacVm6
(V.M.6) - จำกัดสำหรับผู้ชมที่มีอายุตั้งแต่ 6 ปีขึ้นไปmibacVm12
(V.M.12) - จำกัดสำหรับผู้ชมที่มีอายุตั้งแต่ 12 ปีขึ้นไป
-
channel
พร็อพเพอร์ตี้ใหม่ของinvideoPromotion.items[].promotedByContentOwner
ทรัพยากรจะระบุว่าชื่อของเจ้าของเนื้อหาจะแสดงเมื่อแสดงโปรโมชันหรือไม่ ตั้งค่าฟิลด์นี้ได้ก็ต่อเมื่อมีการส่งคำขอ API ที่ตั้งค่าในนามของเจ้าของเนื้อหา ดูข้อมูลเพิ่มเติมได้ที่พารามิเตอร์onBehalfOfContentOwner
1 ตุลาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ออบเจ็กต์
auditDetails
ใหม่ของchannel
แหล่งข้อมูลมีข้อมูลช่องที่เครือข่ายแบบหลายช่อง (MCN) จะประเมินขณะพิจารณาว่าจะยอมรับหรือปฏิเสธช่องใดช่องหนึ่ง โปรดทราบว่าคำขอ API ใดก็ตามที่เรียกข้อมูลส่วนนี้ของทรัพยากรจะต้องระบุโทเค็นการให้สิทธิ์ที่มีขอบเขตhttps://www.googleapis.com/auth/youtubepartner-channel-audit
นอกจากนี้ คุณต้องเพิกถอนโทเค็นที่ใช้ขอบเขตดังกล่าวเมื่อ MCN ตัดสินใจที่จะยอมรับหรือปฏิเสธช่อง หรือภายใน 2 สัปดาห์นับจากวันที่ออกโทเค็น -
ตอนนี้พร็อพเพอร์ตี้
invideoPromotion.items[].id.type
ของทรัพยากรchannel
รองรับค่าrecentUpload
แล้ว ซึ่งระบุว่ารายการที่โปรโมตคือวิดีโอที่อัปโหลดล่าสุดจากช่องที่ระบุโดยค่าเริ่มต้น ช่องจะเหมือนกับช่องที่ตั้งค่าข้อมูลการโปรโมตในวิดีโอ อย่างไรก็ตาม คุณสามารถโปรโมตวิดีโอที่อัปโหลดล่าสุดจากช่องอื่นได้โดยการตั้งค่าพร็อพเพอร์ตี้
invideoPromotion.items[].id.recentlyUploadedBy
ใหม่เป็นรหัสช่องของช่องนั้น -
แหล่งข้อมูล
channel
มีพร็อพเพอร์ตี้ใหม่ 3 รายการ ได้แก่brandingSettings.image.bannerTvLowImageUrl
,brandingSettings.image.bannerTvMediumImageUrl
และbrandingSettings.image.bannerTvHighImageUrl
ซึ่งระบุ URL สำหรับรูปภาพแบนเนอร์ที่แสดงในหน้าช่องในแอปพลิเคชันโทรทัศน์ -
snippet.liveBroadcastContent
พร็อพเพอร์ตี้ใหม่ในผลการค้นหาจะระบุว่าทรัพยากรวิดีโอหรือช่องมีเนื้อหาการถ่ายทอดสดหรือไม่ ค่าพร็อพเพอร์ตี้ที่ใช้ได้คือupcoming
,active
และnone
- สำหรับทรัพยากร
video
ค่าupcoming
จะระบุว่าวิดีโอเป็นไลฟ์สดที่ยังไม่เริ่ม ในขณะที่ค่าactive
จะระบุว่าวิดีโอเป็นไลฟ์สดที่กำลังดำเนินอยู่ - สำหรับทรัพยากร
channel
ค่าupcoming
จะบ่งบอกว่าช่องมีการออกอากาศที่กำหนดเวลาไว้ซึ่งยังไม่เริ่ม ในขณะที่ค่าacive
จะบ่งบอกว่าช่องมีการออกอากาศสดที่กำลังดำเนินอยู่
- สำหรับทรัพยากร
-
ในแหล่งข้อมูล
watermark
พร็อพเพอร์ตี้targetChannelId
เปลี่ยนจากออบเจ็กต์เป็นสตริง แทนที่จะมีพร็อพเพอร์ตี้ย่อยที่ระบุรหัสช่อง YouTube ของช่องที่รูปภาพลายน้ำลิงก์ไปถึง ตอนนี้พร็อพเพอร์ตี้targetChannelId
จะระบุค่านั้นเอง ดังนั้น เราจึงนำพร็อพเพอร์ตี้targetChannelId.value
ของทรัพยากรออก -
ตอนนี้
thumbnails.set
เมธอดรองรับพารามิเตอร์onBehalfOfContentOwner
ซึ่งรองรับเมธอดอื่นๆ อีกหลายรายการอยู่แล้ว -
ตอนนี้เมธอด
search.list
รองรับพารามิเตอร์eventType
แล้ว ซึ่งจะจำกัดการค้นหาให้แสดงเฉพาะกิจกรรมการออกอากาศที่ใช้งานอยู่ กำลังจะเกิดขึ้น หรือเสร็จสมบูรณ์แล้ว -
พร็อพเพอร์ตี้
contentDetails.contentRating.mibacRating
ใหม่จะระบุการจัดประเภทที่วิดีโอได้รับจาก Ministero dei Beni e delle Attivita Culturali e del Turismo ของอิตาลี -
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
invalidImage
เมธอด thumbnails.set
จะแสดงข้อผิดพลาดนี้หากเนื้อหารูปภาพที่ระบุไม่ถูกต้องforbidden
videoRatingDisabled
เมธอด videos.rate
จะแสดงข้อผิดพลาดนี้หากเจ้าของวิดีโอที่กำลังได้รับการจัดประเภทได้ปิดใช้การจัดประเภทสำหรับวิดีโอนั้น
27 สิงหาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
watermark
ใหม่ระบุรูปภาพที่จะแสดงในระหว่างการเล่นวิดีโอของช่องที่ระบุ นอกจากนี้ คุณยังระบุช่องเป้าหมายที่รูปภาพจะลิงก์ไปถึง รวมถึงรายละเอียดเวลาที่กำหนดเวลาที่ลายน้ำจะปรากฏในระหว่างการเล่นวิดีโอและระยะเวลาที่ลายน้ำจะปรากฏได้ด้วยเมธอด
watermarks.set
จะอัปโหลดและตั้งค่ารูปภาพลายน้ำของช่องwatermarks.unset
วิธีนี้จะลบรูปภาพลายน้ำของช่องเอกสารประกอบเกี่ยวกับข้อผิดพลาดจะอธิบายข้อความแสดงข้อผิดพลาดที่ API รองรับสำหรับเมธอด
watermarks.set
และwatermarks.unset
โดยเฉพาะ -
พร็อพเพอร์ตี้
statistics.hiddenSubscriberCount
ใหม่ของทรัพยากรchannel
มีค่าบูลีนที่ระบุว่าซ่อนจำนวนผู้ติดตามของช่องหรือไม่ ดังนั้น ค่าของพร็อพเพอร์ตี้จะเป็นfalse
หากจำนวนผู้ติดตามของช่องปรากฏต่อสาธารณะ -
ตอนนี้เมธอด
playlists.list
รองรับพารามิเตอร์onBehalfOfContentOwner
และonBehalfOfContentOwnerChannel
แล้ว ระบบรองรับพารามิเตอร์ทั้ง 2 รายการนี้สำหรับวิธีการอื่นๆ อีกหลายวิธีอยู่แล้ว -
ตอนนี้เมธอด
videos.list
รองรับพารามิเตอร์regionCode
แล้ว ซึ่งจะระบุภูมิภาคของเนื้อหาที่ควรดึงแผนภูมิ พารามิเตอร์นี้ใช้ได้เฉพาะเมื่อใช้ร่วมกับพารามิเตอร์chart
ค่าพารามิเตอร์คือรหัสประเทศ ISO 3166-1 Alpha-2 -
error documentation
อธิบายข้อผิดพลาดใหม่ที่พบบ่อยในการส่งคำขอ ซึ่งอาจเกิดขึ้นกับเมธอด API หลายรายการ ดังนี้ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย forbidden
insufficientPermissions
ขอบเขตที่เชื่อมโยงกับโทเค็น OAuth 2.0 ที่ระบุสำหรับคำขอไม่เพียงพอสำหรับการเข้าถึงข้อมูลที่ขอ
15 สิงหาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ออบเจ็กต์
invideoPromotion
ของทรัพยากรchannel
มีพร็อพเพอร์ตี้ใหม่และที่อัปเดตต่อไปนี้-
ตอนนี้ API รองรับความสามารถในการระบุเว็บไซต์เป็นสินค้าที่โปรโมตแล้ว โดยตั้งค่าพร็อพเพอร์ตี้
invideoPromotion.items[].id.type
เป็นwebsite
และใช้พร็อพเพอร์ตี้invideoPromotion.items[].id.websiteUrl
ใหม่เพื่อระบุ URL นอกจากนี้ ให้ใช้พร็อพเพอร์ตี้invideoPromotion.items[].customMessage
ใหม่เพื่อกำหนดข้อความที่กำหนดเองที่จะแสดงสำหรับโปรโมชันลิงก์อาจนำไปยังเว็บไซต์ที่เกี่ยวข้อง เว็บไซต์ของผู้ขาย หรือเว็บไซต์โซเชียลเน็ตเวิร์ก ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้ลิงก์สำหรับเนื้อหาได้ที่วิธีการสำหรับเว็บไซต์ที่เชื่อมโยงและเว็บไซต์ของผู้ขายในศูนย์ช่วยเหลือของ YouTube
การเพิ่มลิงก์โปรโมตถือเป็นการยอมรับว่าลิงก์ดังกล่าวจะไม่ถูกใช้เพื่อเปลี่ยนเส้นทางการเข้าชมไปยังเว็บไซต์ที่ไม่ได้รับอนุญาต และลิงก์ดังกล่าวจะเป็นไปตามนโยบายของ AdWords, นโยบายโฆษณาของ YouTube, หลักเกณฑ์ของชุมชน YouTube และข้อกำหนดในการให้บริการของ YouTube
-
เราได้ปรับโครงสร้างพร็อพเพอร์ตี้ที่เกี่ยวข้องกับการตั้งค่าเวลาสำหรับการแสดงรายการที่โปรโมตในระหว่างการเล่นวิดีโอ ดังนี้
-
ย้ายออบเจ็กต์
invideoPromotion.timing
ไปที่invideoPromotion.items[].timing
แล้ว ตอนนี้ออบเจ็กต์นี้ช่วยให้คุณปรับแต่งข้อมูลเวลาสำหรับสินค้าที่โปรโมตแต่ละรายการในรายการinvideoPromotion.items[]
ได้แล้ว -
ออบเจ็กต์
invideoPromotion.defaultTiming
ใหม่จะระบุการตั้งค่าเวลาเริ่มต้นสำหรับโปรโมชัน การตั้งค่าดังกล่าวจะกำหนดเวลาที่รายการที่โปรโมตจะแสดงในระหว่างการเล่นวิดีโอใดวิดีโอหนึ่งของช่อง คุณลบล้างเวลาเริ่มต้นสำหรับสินค้าที่โปรโมตที่ต้องการได้โดยใช้invideoPromotion.items[].timing
ออบเจ็กต์ -
พร็อพเพอร์ตี้
invideoPromotion.items[].timing.durationMs
ใหม่จะระบุระยะเวลาเป็นมิลลิวินาทีที่โปรโมชันควรแสดง นอกจากนี้ ออบเจ็กต์invideoPromotion.defaultTiming
ยังมีช่องdurationMs
ที่ระบุระยะเวลาเริ่มต้นที่สินค้าที่โปรโมตจะแสดง
-
-
ทั้งพร็อพเพอร์ตี้
invideoPromotion.items[].type
และinvideoPromotion.items[].videoId
ได้ย้ายไปอยู่ในออบเจ็กต์invideoPromotion.items[].id
แล้ว
-
-
ตอนนี้เมธอด
subscriptions.list
รองรับพารามิเตอร์onBehalfOfContentOwner
และonBehalfOfContentOwnerChannel
แล้ว ระบบรองรับพารามิเตอร์ทั้ง 2 รายการนี้สำหรับวิธีการอื่นๆ อีกหลายวิธีอยู่แล้ว -
ในการตอบกลับ API สำหรับคำขอ
thumbnails.set
ค่าพร็อพเพอร์ตี้kind
เปลี่ยนจากyoutube#thumbnailListResponse
เป็นyoutube#thumbnailSetResponse
-
เราได้เพิ่มตัวอย่างโค้ดสำหรับเมธอดต่อไปนี้แล้ว
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(PHP)videos.list
(PHP)videos.rate
(Python)videos.update
(Java, PHP, Python)
โปรดทราบว่าเราได้นำตัวอย่าง Python สำหรับเมธอด
playlistItems.insert
ออกแล้วด้วย เนื่องจากตอนนี้เมธอดvideos.rate
จะจัดการฟังก์ชันการทำงานที่ตัวอย่างดังกล่าวแสดงให้เห็น -
error documentation
อธิบายข้อผิดพลาดเกี่ยวกับบริบทคำขอใหม่ต่อไปนี้ ซึ่งอาจเกิดขึ้นกับเมธอด API ใดก็ได้ที่รองรับพารามิเตอร์คำขอmine
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
invalidMine
ใช้พารามิเตอร์ mine
ในคำขอที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์เป็นพาร์ทเนอร์ YouTube ไม่ได้ คุณควรนำพารามิเตอร์mine
ออก ยืนยันตัวตนเป็นผู้ใช้ YouTube โดยนำพารามิเตอร์onBehalfOfContentOwner
ออก หรือทำหน้าที่เป็นช่องใดช่องหนึ่งของพาร์ทเนอร์โดยระบุพารามิเตอร์onBehalfOfContentOwnerChannel
หากมีสำหรับเมธอดที่เรียกใช้
8 สิงหาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ส่วนการใช้โควต้าในคู่มือเริ่มต้นใช้งาน YouTube Data API ได้รับการอัปเดตเพื่อให้สอดคล้องกับการเปลี่ยนแปลงต้นทุนโควต้าของการอัปโหลดวิดีโอจากประมาณ 16,000 หน่วยเป็นประมาณ 1,600 หน่วย
30 กรกฎาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ในแหล่งข้อมูล
channelBanner
ค่าของพร็อพเพอร์ตี้kind
เปลี่ยนจากyoutube#channelBannerInsertResponse
เป็นyoutube#channelBannerResource
ระบบจะแสดงทรัพยากรนี้เพื่อตอบสนองต่อคำขอchannelBanners.insert
-
พร็อพเพอร์ตี้
brandingSettings.channel.profileColor
ใหม่ของchannel
ทรัพยากรจะระบุสีเด่นที่ช่วยเสริมเนื้อหาของช่อง ค่าพร็อพเพอร์ตี้คือเครื่องหมายปอนด์ (#
) ตามด้วยสตริงฐานสิบหก 6 อักขระ เช่น#2793e6
-
ตอนนี้ API รองรับความสามารถในการระบุว่าการติดตามนั้นมีไว้สำหรับกิจกรรมทั้งหมดของช่องหรือเฉพาะการอัปโหลดใหม่เท่านั้น พร็อพเพอร์ตี้
contentDetails.activityType
ใหม่ของsubscription
ทรัพยากรจะระบุประเภทกิจกรรมที่ระบบจะแจ้งเตือนผู้ติดตาม ค่าพร็อพเพอร์ตี้ที่ใช้ได้คือall
และuploads
-
วิธีการ
videos.list
รองรับพารามิเตอร์ใหม่สำหรับการดึงข้อมูลชาร์ตวิดีโอที่ได้รับความนิยมมากที่สุดบน YouTube ดังนี้- พารามิเตอร์
chart
จะระบุชาร์ตที่คุณต้องการดึงข้อมูล ปัจจุบันค่าที่รองรับมีเพียงmostPopular
โปรดทราบว่าพารามิเตอร์chart
เป็นพารามิเตอร์ตัวกรอง ซึ่งหมายความว่าใช้ในคำขอเดียวกันกับพารามิเตอร์ตัวกรองอื่นๆ (id
และmyRating
) ไม่ได้ - พารามิเตอร์
videoCategoryId
ระบุหมวดหมู่วิดีโอที่ควรดึงแผนภูมิ พารามิเตอร์นี้ใช้ได้เฉพาะเมื่อใช้ร่วมกับพารามิเตอร์chart
โดยค่าเริ่มต้น ชาร์ตไม่ได้จำกัดไว้ที่หมวดหมู่ใดหมวดหมู่หนึ่ง
- พารามิเตอร์
-
พร็อพเพอร์ตี้
topicDetails.relevantTopicIds[]
ใหม่ของvideo
ทรัพยากรจะแสดงรายการรหัสหัวข้อ Freebase ที่เกี่ยวข้องกับวิดีโอหรือเนื้อหาของวิดีโอ วิดีโออาจมีการกล่าวถึงหรือปรากฏเนื้อหาเกี่ยวกับหัวข้อเหล่านี้ -
เราได้เปลี่ยนชื่อพร็อพเพอร์ตี้
recordingDetails.location.elevation
ของทรัพยากรvideo
เป็นrecordingDetails.location.altitude
และเปลี่ยนชื่อพร็อพเพอร์ตี้fileDetails.recordingLocation.location.elevation
เป็นfileDetails.recordingLocation.location.altitude
-
ออบเจ็กต์
contentDetails.contentRating
ของvideo
ทรัพยากรจะระบุการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ ซึ่งรวมถึงการจัดประเภทของ MPAA, TVPG และอื่นๆ ตอนนี้ API รองรับค่าการจัดประเภทที่ระบุว่าวิดีโอไม่ได้รับการจัดประเภทสำหรับระบบการจัดประเภทแต่ละระบบ โปรดทราบว่าสำหรับการจัดประเภทของ MPAA มักจะใช้การจัดประเภท "ไม่ได้รับการจัดประเภท" เพื่อระบุภาพยนตร์เวอร์ชันที่ไม่มีการตัดต่อซึ่งเวอร์ชันที่ตัดต่อของภาพยนตร์ได้รับการจัดประเภทอย่างเป็นทางการ -
พร็อพเพอร์ตี้
contentDetails.contentRating.ytRating
ใหม่ของแหล่งข้อมูลvideo
จะระบุเนื้อหาที่จำกัดอายุผู้ชม ค่าพร็อพเพอร์ตี้จะเป็นytAgeRestricted
หาก YouTube ระบุว่าวิดีโอมีเนื้อหาที่ไม่เหมาะสมสำหรับผู้ใช้ที่มีอายุต่ำกว่า 18 ปี หากไม่มีพร็อพเพอร์ตี้หรือค่าพร็อพเพอร์ตี้ว่าง แสดงว่าระบบไม่ได้ระบุว่าเนื้อหามีการจำกัดอายุ -
ระบบเลิกใช้งานพารามิเตอร์
mySubscribers
ของเมธอดchannels.list
แล้ว ใช้เมธอดsubscriptions.list
และพารามิเตอร์mySubscribers
เพื่อดึงข้อมูลรายชื่อผู้ติดตามช่องของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ -
ตอนนี้เมธอด
channelBanners.insert
,channels.update
,videos.getRating
และvideos.rate
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว พารามิเตอร์ดังกล่าวระบุว่าผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์กำลังดำเนินการในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ -
เราได้อัปเดตเอกสารประกอบของเมธอด
channels.update
เพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าเมธอดดังกล่าวสามารถใช้เพื่ออัปเดตออบเจ็กต์brandingSettings
ของทรัพยากรchannel
และพร็อพเพอร์ตี้ย่อยของออบเจ็กต์ได้ นอกจากนี้ เอกสารประกอบยังแสดงรายการพร็อพเพอร์ตี้ที่อัปเดตแล้วซึ่งคุณตั้งค่าได้สำหรับออบเจ็กต์invideoPromotion
ของทรัพยากรchannel
-
error documentation
อธิบายข้อผิดพลาดใหม่ต่อไปนี้ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย forbidden
accountDelegationForbidden
ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งระบุว่าผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ไม่มีสิทธิ์ดำเนินการในนามของบัญชี Google ที่ระบุ forbidden
authenticatedUserAccountClosed
ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งหมายความว่าบัญชี YouTube ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ถูกปิด หากผู้ใช้ดำเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้จะบ่งชี้ว่าบัญชีอื่นนั้นถูกปิด forbidden
authenticatedUserAccountSuspended
ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งระบุว่าบัญชี YouTube ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ถูกระงับ หากผู้ใช้ดำเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้จะบ่งชี้ว่าบัญชีอื่นนั้นถูกระงับ forbidden
authenticatedUserNotChannel
ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งบ่งบอกว่าเซิร์ฟเวอร์ API ระบุช่องที่เชื่อมโยงกับคำขอ API ไม่ได้ หากคำขอได้รับอนุญาตและใช้พารามิเตอร์ onBehalfOfContentOwner
คุณควรตั้งค่าพารามิเตอร์onBehalfOfContentOwnerChannel
ด้วยforbidden
cmsUserAccountNotFound
ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ผู้ใช้ CMS ไม่ได้รับอนุญาตให้ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุ notFound
contentOwnerAccountNotFound
ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ไม่พบบัญชีเจ้าของเนื้อหาที่ระบุ badRequest
invalidPart
ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง พารามิเตอร์ part
ของคำขอระบุชิ้นส่วนที่เขียนพร้อมกันไม่ได้badRequest
videoChartNotFound
videos.list
เมธอดจะแสดงข้อผิดพลาดนี้เมื่อคำขอระบุชาร์ตวิดีโอที่ไม่รองรับหรือไม่พร้อมใช้งานnotFound
videoNotFound
videos.update
เมธอดจะแสดงข้อผิดพลาดนี้เพื่อระบุว่าไม่พบวิดีโอที่คุณพยายามอัปเดต ตรวจสอบค่าของพร็อพเพอร์ตี้id
ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง
10 มิถุนายน 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
channels.list
พารามิเตอร์forUsername
ใหม่ของเมธอดช่วยให้คุณดึงข้อมูลเกี่ยวกับช่องได้โดยการระบุชื่อผู้ใช้ YouTube ของช่อง -
ตอนนี้เมธอด
activities.list
รองรับพารามิเตอร์regionCode
แล้ว ซึ่งจะสั่งให้ API แสดงผลลัพธ์ที่เกี่ยวข้องกับประเทศที่ระบุ YouTube จะใช้ค่านี้เมื่อกิจกรรมก่อนหน้าของผู้ใช้ที่ได้รับอนุญาตบน YouTube มีข้อมูลไม่เพียงพอที่จะสร้างฟีดกิจกรรม -
ตอนนี้ทรัพยากรเพลย์ลิสต์มีพร็อพเพอร์ตี้
snippet.tags
แล้ว ระบบจะแสดงพร็อพเพอร์ตี้ต่อผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับเพลย์ลิสต์ของตนเองเท่านั้น นอกจากนี้ ผู้ใช้ที่ได้รับอนุญาตยังตั้งค่าแท็กเพลย์ลิสต์เมื่อเรียกใช้เมธอดplaylists.insert
หรือplaylists.update
ได้ด้วย -
ตอนนี้พารามิเตอร์
onBehalfOfContentOwner
ซึ่งก่อนหน้านี้รองรับเมธอดchannels.list
และsearch.list
ก็รองรับเมธอดvideos.insert
,videos.update
และvideos.delete
ด้วย โปรดทราบว่าเมื่อใช้พารามิเตอร์นี้ในการเรียกใช้เมธอดvideos.insert
คำขอต้องระบุค่าสำหรับพารามิเตอร์onBehalfOfContentOwnerChannel
ใหม่ด้วย ซึ่งจะระบุแชแนลที่จะเพิ่มวิดีโอ ช่องต้องลิงก์กับเจ้าของเนื้อหาที่พารามิเตอร์onBehalfOfContentOwner
ระบุพารามิเตอร์ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์จะต้องลิงก์กับเจ้าของเนื้อหา YouTube ที่ระบุ
พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาที่เป็นเจ้าของและจัดการช่อง YouTube ที่แตกต่างกันหลายช่อง พารามิเตอร์นี้ช่วยให้พาร์ทเนอร์เหล่านั้นสามารถตรวจสอบสิทธิ์เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดได้โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบเพื่อตรวจสอบสิทธิ์สำหรับแต่ละช่อง
โดยเฉพาะอย่างยิ่งในส่วนของการเปิดตัวนี้ ตอนนี้พารามิเตอร์ช่วยให้พาร์ทเนอร์เนื้อหาสามารถแทรก อัปเดต หรือลบวิดีโอในช่อง YouTube ใดก็ได้ที่พาร์ทเนอร์เป็นเจ้าของ
-
error documentation
อธิบายข้อผิดพลาดใหม่ต่อไปนี้ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย forbidden
insufficientCapabilities
ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งบ่งบอกว่าผู้ใช้ CMS ที่เรียก API ไม่มีสิทธิ์เพียงพอที่จะดำเนินการตามที่ขอ ข้อผิดพลาดนี้เกี่ยวข้องกับการใช้พารามิเตอร์ onBehalfOfContentOwner
ซึ่งรองรับในเมธอด API หลายรายการunauthorized
authorizationRequired
เมธอด activities.list
จะแสดงข้อผิดพลาดนี้เมื่อคำขอใช้พารามิเตอร์home
แต่ไม่ได้รับอนุญาตอย่างถูกต้อง -
ในแหล่งข้อมูล
channels
เราได้นำพร็อพเพอร์ตี้invideoPromotion.channelId
ออกเนื่องจากได้ระบุรหัสช่องไว้แล้วโดยใช้พร็อพเพอร์ตี้id
ของแหล่งข้อมูล -
คู่มือการทำงานกับรหัสช่องใหม่จะอธิบายวิธีที่ API ใช้รหัสช่อง คำแนะนำนี้อาจมีประโยชน์อย่างยิ่งสำหรับนักพัฒนาแอปที่ย้ายข้อมูลจาก API เวอร์ชันก่อนหน้า และผู้ที่มีแอปพลิเคชันที่ขอเนื้อหาสำหรับ
default
ผู้ใช้ หรือผู้ที่ใช้แนวคิดที่ว่าทุกช่อง YouTube มีชื่อผู้ใช้ที่ไม่ซ้ำกัน ซึ่งปัจจุบันไม่มีอีกต่อไป
22 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
channelBanners.insert
วิธีการใหม่นี้ช่วยให้คุณอัปโหลดรูปภาพแบนเนอร์ที่สามารถตั้งเป็นรูปภาพแบนเนอร์สำหรับช่องได้ในภายหลังโดยใช้พร็อพเพอร์ตี้brandingSettings.image.bannerExternalUrl
ใหม่ของทรัพยากรchannel
-
เราได้อัปเดตเอกสารประกอบสำหรับเมธอด
channels.update
เพื่อแสดงรายการพร็อพเพอร์ตี้ที่แก้ไขได้เมื่อเรียกใช้เมธอด -
เอกสารประกอบของแหล่งข้อมูล
video
จะไม่แสดงunspecified
เป็นค่าพร็อพเพอร์ตี้ที่ถูกต้องสำหรับพร็อพเพอร์ตี้suggestions.processingErrors[]
,suggestions.processingHints[]
,suggestions.processingWarnings[]
และsuggestions.editorSuggestions[]
อีกต่อไป -
ตอนนี้พารามิเตอร์
maxResults
ของเมธอดvideos.list
มีค่าเริ่มต้นเป็น5
แล้ว -
ตอนนี้
error documentation
แสดงข้อผิดพลาดสำหรับเมธอดchannelBanners.insert
และsubscriptions.list
แล้ว นอกจากนี้ ยังแสดงข้อผิดพลาดใหม่หลายรายการสำหรับเมธอดchannels.update
14 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้หน้าเว็บแบบสแตนด์อโลนแสดงตัวอย่างโค้ดสำหรับ Java, .NET, PHP และ Ruby แล้ว
-
ตอนนี้หน้าเว็บที่แสดงตัวอย่างโค้ด Python มีตัวอย่างสำหรับการเพิ่มการติดตาม การสร้างเพลย์ลิสต์ และการอัปเดตวิดีโอแล้ว
10 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
YouTube จะไม่ระบุฟีเจอร์และบริการ API ที่เป็นเวอร์ชันทดลองอีกต่อไป ตอนนี้เราจึงมีรายการ API ของ YouTube ที่อยู่ภายใต้นโยบายการเลิกใช้งานแทน
8 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้ทรัพยากรของช่องรองรับออบเจ็กต์
inVideoPromotion
แล้ว ซึ่งจะห่อหุ้มข้อมูลเกี่ยวกับแคมเปญโปรโมชันที่เชื่อมโยงกับช่อง ช่องสามารถใช้แคมเปญโปรโมตในวิดีโอเพื่อแสดงภาพขนาดย่อของวิดีโอที่โปรโมตภายในวิดีโอเพลเยอร์ระหว่างการเล่นวิดีโอของช่องคุณดึงข้อมูลนี้ได้โดยใส่
invideoPromotion
ในค่าพารามิเตอร์part
ในคำขอchannels.list
-
คุณสามารถใช้วิธี
channels.update
ใหม่เพื่ออัปเดตข้อมูลแคมเปญโปรโมตในวิดีโอของช่อง โปรดทราบว่าวิธีการนี้รองรับเฉพาะการอัปเดตinvideoPromotion
ของทรัพยากรchannel
และยังไม่รองรับการอัปเดตส่วนอื่นๆ ของทรัพยากรดังกล่าว
2 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้ทรัพยากรของช่องรองรับพร็อพเพอร์ตี้
status.isLinked
แล้ว ซึ่งจะระบุว่าข้อมูลช่องระบุผู้ใช้ที่ลิงก์กับชื่อผู้ใช้ YouTube หรือบัญชี Google+ อยู่แล้วหรือไม่ ผู้ใช้ที่มีลิงก์เหล่านี้จะมีตัวตนแบบสาธารณะบน YouTube อยู่แล้ว ซึ่งเป็นข้อกำหนดเบื้องต้นสำหรับการดำเนินการหลายอย่าง เช่น การอัปโหลดวิดีโอ -
ตอนนี้ทรัพยากรการสมัครใช้บริการรองรับส่วน
subscriberSnippet
แล้ว ออบเจ็กต์ดังกล่าวจะห่อหุ้มข้อมูลข้อมูลโค้ดสำหรับช่องของสมาชิก -
ตอนนี้ API รองรับเมธอด
videos.getRating
ซึ่งจะดึงข้อมูลการจัดประเภทที่ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ให้ไว้กับวิดีโออย่างน้อย 1 รายการ -
พารามิเตอร์
myRating
ใหม่ของvideos.list
เมธอดช่วยให้คุณดึงรายการวิดีโอที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ให้คะแนนlike
หรือdislike
ได้ตอนนี้ทั้งพารามิเตอร์
myRating
และพารามิเตอร์id
ถือเป็นพารามิเตอร์ตัวกรอง ซึ่งหมายความว่าคำขอ API ต้องระบุพารามิเตอร์ใดพารามิเตอร์หนึ่งอย่างชัดเจน (ก่อนหน้านี้ พารามิเตอร์id
เป็นพารามิเตอร์ที่จำเป็นสำหรับเมธอดนี้)เมธอดจะแสดง
forbidden
ข้อผิดพลาดสำหรับคำขอที่พยายามดึงข้อมูลการจัดประเภทวิดีโอ แต่ไม่ได้รับอนุญาตอย่างถูกต้อง -
เมื่อเปิดตัวพารามิเตอร์
myRating
เราจึงได้อัปเดตเมธอดvideos.list
เพื่อรองรับการแบ่งหน้าด้วย อย่างไรก็ตาม โปรดทราบว่าระบบรองรับพารามิเตอร์การแบ่งหน้าสำหรับคำขอที่ใช้พารามิเตอร์myRating
เท่านั้น (ระบบไม่รองรับพารามิเตอร์และข้อมูลการแบ่งหน้าสำหรับคำขอที่ใช้พารามิเตอร์id
)-
พารามิเตอร์
maxResults
จะระบุจำนวนวิดีโอสูงสุดที่ API สามารถแสดงในชุดผลลัพธ์ และพารามิเตอร์pageToken
จะระบุหน้าหนึ่งๆ ในชุดผลลัพธ์ที่คุณต้องการดึงข้อมูล -
ตอนนี้ทรัพยากร
youtube#videoListResponse
ซึ่งแสดงผลในการตอบกลับคำขอvideos.list
มีออบเจ็กต์pageInfo
ซึ่งมีรายละเอียดต่างๆ เช่น จำนวนผลลัพธ์ทั้งหมดและจำนวนผลลัพธ์ที่รวมอยู่ในชุดผลลัพธ์ปัจจุบันyoutube#videoListResponse
ยังมีพร็อพเพอร์ตี้nextPageToken
และprevPageToken
ซึ่งแต่ละพร็อพเพอร์ตี้จะให้โทเค็นที่ใช้ดึงข้อมูลหน้าเว็บที่เฉพาะเจาะจงในชุดผลลัพธ์ได้
-
-
เมธอด
videos.insert
รองรับพารามิเตอร์ใหม่ต่อไปนี้autoLevels
- ตั้งค่าพารามิเตอร์นี้เป็นtrue
เพื่อสั่งให้ YouTube ปรับปรุงแสงและสีของวิดีโอโดยอัตโนมัติstabilize
– ตั้งค่าพารามิเตอร์นี้เป็นtrue
เพื่อสั่งให้ YouTube ปรับวิดีโอโดยการนำความสั่นไหวที่เกิดจากการเคลื่อนไหวของกล้องออก
-
เราได้เพิ่มพร็อพเพอร์ตี้
channelTitle
ลงในsnippet
สำหรับแหล่งข้อมูลต่อไปนี้แล้วplaylistItem
– พร็อพเพอร์ตี้ระบุชื่อของช่องที่เพิ่มรายการในเพลย์ลิสต์playlist
– พร็อพเพอร์ตี้ระบุชื่อของช่องที่สร้างเพลย์ลิสต์subscription
– พร็อพเพอร์ตี้ระบุชื่อของช่องที่ติดตาม
-
เราได้เพิ่มตัวอย่างโค้ดสำหรับเมธอดต่อไปนี้แล้ว
activities.insert
(Ruby)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, Ruby)
-
subscriptions.list
พารามิเตอร์mySubscribers
ใหม่ของเมธอดช่วยให้คุณดึงข้อมูลรายชื่อผู้ติดตามของผู้ใช้ปัจจุบันที่ตรวจสอบสิทธิ์แล้วได้ พารามิเตอร์นี้ใช้ได้ในคำขอที่ได้รับอนุญาตอย่างถูกต้องเท่านั้นหมายเหตุ: ฟังก์ชันนี้มีไว้เพื่อแทนที่พารามิเตอร์
mySubscribers
ที่ปัจจุบันรองรับสำหรับเมธอดchannels.list
เราจะเลิกใช้งานพารามิเตอร์ดังกล่าว -
ในทรัพยากร
video
ค่าพร็อพเพอร์ตี้unspecified
จะไม่ใช่ค่าที่เป็นไปได้สำหรับพร็อพเพอร์ตี้ต่อไปนี้อีกต่อไป -
ตอนนี้คำขอ API ที่มีพารามิเตอร์ที่ไม่คาดคิดจะแสดงข้อผิดพลาด
badRequest
และเหตุผลที่รายงานสำหรับข้อผิดพลาดคือunexpectedParameter
-
เราได้อัปเดตข้อผิดพลาดที่เมธอด
playlistItems.insert
แสดงเมื่อเพลย์ลิสต์มีรายการถึงจำนวนสูงสุดที่อนุญาตแล้ว ตอนนี้ระบบจะรายงานข้อผิดพลาดเป็นforbidden
และสาเหตุของข้อผิดพลาดคือplaylistContainsMaximumNumberOfVideos
19 เมษายน 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
videos.rate
วิธีใหม่นี้ช่วยให้ผู้ใช้สามารถตั้งค่าการจัดประเภทlike
หรือdislike
ในวิดีโอ หรือนำการจัดประเภทออกจากวิดีโอได้นอกจากนี้ เรายังได้อัปเดตเอกสารประกอบเกี่ยวกับข้อผิดพลาดเพื่อแสดงข้อผิดพลาดที่ API อาจแสดงในการตอบกลับการเรียกเมธอด
videos.rate
-
ขณะนี้ระบบจะระบุรูปภาพปกในเอกสารประกอบ API เป็นแหล่งข้อมูลแยกต่างหาก และเมธอด
thumbnails.set
ใหม่จะช่วยให้คุณอัปโหลดปกวิดีโอที่กำหนดเองไปยัง YouTube และตั้งค่าปกสำหรับวิดีโอได้นอกจากนี้ เรายังได้อัปเดตเอกสารประกอบเกี่ยวกับข้อผิดพลาดเพื่อแสดงข้อผิดพลาดที่ API อาจแสดงในการตอบกลับการเรียกเมธอด
thumbnails.set
โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่ได้ส่งผลต่อทรัพยากรที่มีอยู่ซึ่งแสดงผลรูปภาพขนาดย่อ ระบบจะแสดงรูปภาพปกในทรัพยากรเหล่านั้นในลักษณะเดียวกับที่เคยทำ แต่ตอนนี้เอกสารจะแสดงชื่อของขนาดปกต่างๆ ที่ API อาจแสดง
-
brandingSettings
พาร์ทใหม่ของchannel
แหล่งข้อมูลจะระบุการตั้งค่า ข้อความ และรูปภาพสำหรับหน้าช่องและหน้าดูวิดีโอของช่อง -
แหล่งข้อมูล
playlistItem
มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้-
ออบเจ็กต์
status
ใหม่จะห่อหุ้มข้อมูลสถานะเกี่ยวกับรายการในเพลย์ลิสต์ และพร็อพเพอร์ตี้status.privacyStatus
จะระบุสถานะความเป็นส่วนตัวของรายการในเพลย์ลิสต์
-
-
แหล่งข้อมูล
video
มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้-
พร็อพเพอร์ตี้
status.publicStatsViewable
จะระบุว่าสถิติของวิดีโอแบบขยายในหน้าดูวิดีโอเป็นแบบสาธารณะหรือไม่ โดยค่าเริ่มต้น สถิติเหล่านั้นจะดูได้ และสถิติ เช่น จำนวนการดูและการจัดอันดับของวิดีโอจะยังคงปรากฏต่อสาธารณะแม้ว่าจะตั้งค่าพร็อพเพอร์ตี้นี้เป็นfalse
ก็ตาม คุณตั้งค่าพร็อพเพอร์ตี้นี้ได้เมื่อเรียกใช้เมธอดvideos.insert
หรือvideos.update
-
ออบเจ็กต์
contentDetails.contentRating
จะห่อหุ้มการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ รายการด้านล่างระบุระบบการจัดประเภทที่รองรับและมีลิงก์ไปยังที่พักที่เชื่อมโยงกับระบบการจัดประเภทแต่ละระบบ คำจำกัดความของพร็อพเพอร์ตี้จะระบุค่าการจัดประเภทที่รองรับสำหรับแต่ละระบบประเทศ ระบบการจัดประเภท พร็อพเพอร์ตี้ United States
สมาคมภาพยนตร์แห่งสหรัฐอเมริกา (Motion Picture Association of America หรือ MPAA) contentDetails.contentRating.mpaaRating
United States
TV Parental Guidelines contentDetails.contentRating.tvpgRating
Australia
คณะกรรมการการจัดประเภทของออสเตรเลีย (ACB) contentDetails.contentRating.acbRating
Brazil
Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
Canada
ระบบการจัดประเภทวิดีโอในบ้านของแคนาดา (CHVRS) contentDetails.contentRating.chvrsRating
France
Centre national du cinéma et de l'image animée (กระทรวงวัฒนธรรมของฝรั่งเศส) contentDetails.contentRating.fmocRating
Germany
Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
Great Britain
คณะกรรมการจัดประเภทภาพยนตร์ของอังกฤษ (BBFC) contentDetails.contentRating.bbfcRating
India
Central Board of Film Certification (CBFC) contentDetails.contentRating.cbfcRating
Japan
映倫管理委員会 (EIRIN) contentDetails.contentRating.eirinRating
Korea
영상물등급위원회 (KMRB) contentDetails.contentRating.kmrbRating
Mexico
General Directorate of Radio, Television and Cinematography (RTC) contentDetails.contentRating.rtcRating
New Zealand
Office of Film and Literature Classification contentDetails.contentRating.oflcRating
Russia
ทะเบียนภาพยนตร์แห่งชาติของสหพันธรัฐรัสเซีย contentDetails.contentRating.russiaRating
Spain
Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)
contentDetails.contentRating.icaaRating
-
-
เอกสารประกอบของเมธอด
playlistItems.update
ได้รับการอัปเดตเพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าต้องระบุพร็อพเพอร์ตี้snippet.resourceId
ในทรัพยากรที่ส่งเป็นเนื้อหาของคำขอ -
ตอนนี้
search.list
รองรับฟังก์ชันการทำงานต่อไปนี้แล้ว-
พารามิเตอร์
forMine
ใหม่จะจำกัดการค้นหาให้ดึงเฉพาะวิดีโอของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ -
ตอนนี้พารามิเตอร์
order
รองรับความสามารถในการจัดเรียงผลการค้นหาตามตัวอักษรตามชื่อ (order=title
) หรือตามจำนวนวิดีโอจากมากไปน้อย (order=videoCount
) -
พารามิเตอร์
safeSearch
ใหม่จะระบุว่าผลการค้นหาควรรวมเนื้อหาที่ถูกจำกัดหรือไม่
-
-
วิธี
videos.insert
รองรับข้อผิดพลาดใหม่หลายรายการซึ่งแสดงอยู่ในตารางด้านล่างประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
invalidCategoryId
พร็อพเพอร์ตี้ snippet.categoryId
ระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้เมธอดvideoCategories.list
เพื่อเรียกหมวดหมู่ที่รองรับbadRequest
invalidRecordingDetails
metadata
ระบุรายละเอียดการบันทึกที่ไม่ถูกต้องbadRequest
invalidVideoGameRating
ข้อมูลเมตาของคำขอระบุการจัดประเภทวิดีโอเกมที่ไม่ถูกต้อง badRequest
invalidVideoMetadata
ข้อมูลเมตาของคำขอไม่ถูกต้อง -
พารามิเตอร์
onBehalfOfContentOwner
ถูกนำออกจากรายการพารามิเตอร์ที่รองรับสำหรับเมธอดvideos.update
และvideos.delete
12 มีนาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้เพิ่มพร็อพเพอร์ตี้
channelTitle
ลงในsnippet
สำหรับแหล่งข้อมูลต่อไปนี้แล้ว -
เมธอด
search.list
รองรับพารามิเตอร์ใหม่ต่อไปนี้-
พารามิเตอร์
channelType
ช่วยให้คุณจำกัดการค้นหาช่องเพื่อดึงข้อมูลช่องทั้งหมดหรือดึงข้อมูลเฉพาะรายการ -
พารามิเตอร์
videoType
ช่วยให้คุณจำกัดการค้นหาวิดีโอเพื่อดึงวิดีโอทั้งหมด หรือดึงเฉพาะภาพยนตร์หรือเฉพาะตอนของรายการ
-
-
เราได้อัปเดตคำจำกัดความของ
video
ส่วนrecordingDetails
ของทรัพยากรเพื่อระบุว่าระบบจะแสดงออบเจ็กต์สำหรับวิดีโอเท่านั้นหากมีการตั้งค่าข้อมูลตำแหน่งทางภูมิศาสตร์หรือเวลาที่บันทึกของวิดีโอ -
ตอนนี้เมธอด
playlistItems.update
จะแสดงข้อผิดพลาดinvalidSnippet
ซึ่งจะแสดงหากคำขอ API ไม่ได้ระบุข้อมูลโค้ดที่ถูกต้อง -
เมธอด API หลายรายการรองรับพารามิเตอร์ใหม่ที่มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube โดยเฉพาะ พาร์ทเนอร์เนื้อหาของ YouTube ได้แก่ สตูดิโอภาพยนตร์และโทรทัศน์ ค่ายเพลง และครีเอเตอร์เนื้อหารายอื่นๆ ที่เผยแพร่เนื้อหาของตนบน YouTube
-
พารามิเตอร์
onBehalfOfContentOwner
ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์จะต้องลิงก์กับเจ้าของเนื้อหา YouTube ที่ระบุพารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาที่เป็นเจ้าของและจัดการช่อง YouTube ที่แตกต่างกันหลายช่อง พารามิเตอร์นี้ช่วยให้พาร์ทเนอร์เหล่านั้นสามารถตรวจสอบสิทธิ์เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดได้โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบเพื่อตรวจสอบสิทธิ์สำหรับแต่ละช่อง
เมธอด
channels.list
,search.list
,videos.delete
,videos.list
และvideos.update
รองรับพารามิเตอร์นี้ทั้งหมด -
พารามิเตอร์
managedByMe
ซึ่งเมธอดchannels.list
รองรับ จะสั่งให้ API แสดงช่องทั้งหมดที่เป็นของเจ้าของเนื้อหาที่พารามิเตอร์onBehalfOfContentOwner
ระบุ -
พารามิเตอร์
forContentOwner
ซึ่งเมธอดsearch.list
รองรับ จะสั่งให้ API จำกัดผลการค้นหาให้รวมเฉพาะทรัพยากรที่เป็นของเจ้าของเนื้อหาที่พารามิเตอร์onBehalfOfContentOwner
ระบุ
-
25 กุมภาพันธ์ 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API รองรับชิ้นส่วนและพร็อพเพอร์ตี้ใหม่หลายรายการสำหรับทรัพยากร
video
ดังนี้-
ส่วนใหม่
fileDetails
,processingDetails
และsuggestions
จะให้ข้อมูลแก่เจ้าของวิดีโอเกี่ยวกับวิดีโอที่อัปโหลด ข้อมูลนี้มีประโยชน์อย่างยิ่งในแอปพลิเคชันที่เปิดใช้การอัปโหลดวิดีโอ และประกอบด้วยข้อมูลต่อไปนี้- สถานะและความคืบหน้าในการประมวลผล
- ข้อผิดพลาดหรือปัญหาอื่นๆ ที่พบขณะประมวลผลวิดีโอ
- ความพร้อมใช้งานของภาพขนาดย่อ
- คำแนะนำในการปรับปรุงคุณภาพวิดีโอหรือข้อมูลเมตา
- รายละเอียดเกี่ยวกับไฟล์ต้นฉบับที่อัปโหลดไปยัง YouTube
โดยเจ้าของวิดีโอเท่านั้นที่จะดึงข้อมูลส่วนต่างๆ เหล่านี้ได้ รายการด้านล่างอธิบายส่วนใหม่ๆ โดยย่อ และ
video
เอกสารประกอบของทรัพยากรจะกำหนดพร็อพเพอร์ตี้ทั้งหมดที่แต่ละส่วนมี-
ออบเจ็กต์
fileDetails
มีข้อมูลเกี่ยวกับไฟล์วิดีโอที่อัปโหลดไปยัง YouTube รวมถึงความละเอียด ระยะเวลา ตัวแปลงรหัสเสียงและวิดีโอ บิตเรตของสตรีม และอื่นๆ ของไฟล์ -
processingProgress
ออบเจ็กต์มีข้อมูลเกี่ยวกับความคืบหน้าของ YouTube ในการประมวลผลไฟล์วิดีโอที่อัปโหลด พร็อพเพอร์ตี้ของออบเจ็กต์จะระบุสถานะการประมวลผลปัจจุบันและประมาณเวลาที่เหลือจนกว่า YouTube จะประมวลผลวิดีโอเสร็จ นอกจากนี้ ส่วนนี้ยังระบุว่ามีข้อมูลหรือเนื้อหาประเภทต่างๆ เช่น รายละเอียดไฟล์หรือภาพปก สำหรับวิดีโอหรือไม่ออบเจ็กต์นี้ออกแบบมาเพื่อใช้ในการสำรวจเพื่อให้ผู้อัปโหลดวิดีโอติดตามความคืบหน้าที่ YouTube ดำเนินการในการประมวลผลไฟล์วิดีโอที่อัปโหลดได้
-
ออบเจ็กต์
suggestions
มีคำแนะนำที่ระบุโอกาสในการปรับปรุงคุณภาพวิดีโอหรือข้อมูลเมตาสำหรับวิดีโอที่อัปโหลด
-
ส่วน
contentDetails
มีพร็อพเพอร์ตี้ใหม่ 4 รายการ คุณสามารถดึงข้อมูลพร็อพเพอร์ตี้เหล่านี้ได้ด้วยคำขอที่ไม่ผ่านการตรวจสอบสิทธิ์dimension
– ระบุว่าวิดีโอพร้อมให้รับชมในรูปแบบ 2 มิติหรือ 3 มิติdefinition
– ระบุว่าวิดีโอมีความละเอียดมาตรฐานหรือความละเอียดสูงcaption
– ระบุว่าวิดีโอมีคำบรรยายแทนเสียงหรือไม่licensedContent
– ระบุว่าวิดีโอมีเนื้อหาที่พาร์ทเนอร์ด้านเนื้อหาของ YouTube อ้างสิทธิ์หรือไม่
-
ส่วน
status
มีพร็อพเพอร์ตี้ใหม่ 2 รายการ เจ้าของวิดีโอสามารถตั้งค่าสำหรับพร็อพเพอร์ตี้ทั้ง 2 รายการได้เมื่อแทรกหรืออัปเดตวิดีโอ นอกจากนี้ คุณยังเรียกข้อมูลพร็อพเพอร์ตี้เหล่านี้ได้ด้วยคำขอที่ไม่ผ่านการตรวจสอบสิทธิ์embeddable
– Indicates whether the video can be embedded on another website.license
- ระบุใบอนุญาตของวิดีโอ ค่าที่ใช้ได้คือcreativeCommon
และyoutube
-
-
เราได้อัปเดตคำจำกัดความของพารามิเตอร์
part
สำหรับเมธอดvideos.list
,videos.insert
และvideos.update
เพื่อแสดงรายการชิ้นส่วนที่เพิ่มใหม่ตามที่อธิบายไว้ข้างต้น รวมถึงชิ้นส่วนrecordingDetails
ซึ่งเราได้ละเว้นไปโดยไม่ตั้งใจ -
พร็อพเพอร์ตี้
contentDetails.googlePlusUserId
ใหม่ของchannel
ทรัพยากรจะระบุรหัสโปรไฟล์ Google+ ที่เชื่อมโยงกับช่อง ค่านี้ใช้เพื่อสร้างลิงก์ไปยังโปรไฟล์ Google+ ได้ -
ตอนนี้ออบเจ็กต์รูปภาพขนาดย่อแต่ละรายการจะระบุความกว้างและความสูงของรูปภาพ ปัจจุบันระบบจะแสดงรูปภาพขนาดย่อในทรัพยากร
activity
,channel
,playlist
,playlistItem
,search result
,subscription
และvideo
-
playlistItems.list
รองรับพารามิเตอร์videoId
แล้ว ซึ่งใช้ร่วมกับพารามิเตอร์playlistId
เพื่อดึงข้อมูลเฉพาะรายการในเพลย์ลิสต์ที่แสดงวิดีโอที่ระบุได้API จะแสดงข้อผิดพลาด
notFound
หากไม่พบวิดีโอที่พารามิเตอร์ระบุในเพลย์ลิสต์ -
เอกสารประกอบเกี่ยวกับข้อผิดพลาดอธิบายข้อผิดพลาด
forbidden
ใหม่ ซึ่งบ่งชี้ว่าคำขอไม่ได้รับอนุญาตอย่างถูกต้องสำหรับการดำเนินการที่ขอ -
ระบบได้นำพร็อพเพอร์ตี้
snippet.channelId
ของทรัพยากรchannel
ออกแล้ว พร็อพเพอร์ตี้id
ของทรัพยากรมีค่าเดียวกัน
30 มกราคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
หน้าข้อผิดพลาดใหม่จะแสดงข้อผิดพลาดที่ API สามารถแสดงได้ หน้านี้มีข้อผิดพลาดทั่วไปซึ่งอาจเกิดขึ้นกับเมธอด API ที่แตกต่างกันหลายรายการ รวมถึงข้อผิดพลาดเฉพาะเมธอด
16 มกราคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้โค้ดตัวอย่างพร้อมใช้งานสำหรับเมธอดและภาษาที่แสดงในรายการด้านล่างแล้ว
activities.insert
– JavaplaylistItems.insert
– PythonplaylistItems.list
- Java, JavaScript, PHP, Python, Rubyplaylists.insert
– Java, JavaScript, Pythonsearch.list
- Java, JavaScript, Python, Rubyvideos.insert
– Java
-
ตอนนี้
activity
แหล่งข้อมูลสามารถรายงานchannelItem
การดำเนินการได้แล้ว ซึ่งจะเกิดขึ้นเมื่อ YouTube เพิ่มวิดีโอลงในช่อง YouTube ที่สร้างขึ้นโดยอัตโนมัติ (อัลกอริทึมของ YouTube จะระบุหัวข้อที่มีอยู่เป็นจำนวนมากบนเว็บไซต์ YouTube และสร้างช่องสำหรับหัวข้อเหล่านั้นโดยอัตโนมัติ) -
มีการอัปเดต
search.list
พารามิเตอร์ต่อไปนี้- ระบบจะไม่กำหนดให้พารามิเตอร์
q
เป็นตัวกรองอีกต่อไป ซึ่งหมายความว่า .... - เปลี่ยนชื่อพารามิเตอร์
relatedToVideo
เป็นrelatedToVideoId
แล้ว - พารามิเตอร์
published
ถูกแทนที่ด้วยพารามิเตอร์ใหม่ 2 รายการ ได้แก่publishedAfter
และpublishedBefore
ซึ่งอธิบายไว้ด้านล่าง
- ระบบจะไม่กำหนดให้พารามิเตอร์
-
เมธอด
search.list
รองรับพารามิเตอร์ใหม่ต่อไปนี้ชื่อพารามิเตอร์ ค่า คำอธิบาย channelId
string
แสดงผลแหล่งข้อมูลที่ช่องที่ระบุสร้างขึ้น publishedAfter
datetime
แสดงทรัพยากรที่สร้างขึ้นหลังจากเวลาที่ระบุ publishedBefore
datetime
คืนค่าทรัพยากรที่สร้างขึ้นก่อนเวลาที่ระบุ regionCode
string
แสดงผลทรัพยากรสำหรับประเทศที่ระบุ videoCategoryId
string
กรองผลการค้นหาวิดีโอให้แสดงเฉพาะวิดีโอที่เชื่อมโยงกับหมวดหมู่วิดีโอที่ระบุ videoEmbeddable
string
กรองผลการค้นหาวิดีโอให้แสดงเฉพาะวิดีโอที่เล่นในเพลเยอร์ที่ฝังในหน้าเว็บได้ ตั้งค่าพารามิเตอร์เป็น true
เพื่อดึงข้อมูลวิดีโอที่ฝังได้เท่านั้นvideoSyndicated
string
กรองผลการค้นหาวิดีโอให้แสดงเฉพาะวิดีโอที่เล่นนอก YouTube.com ได้ ตั้งค่าพารามิเตอร์เป็น true
เพื่อดึงข้อมูลเฉพาะวิดีโอที่เผยแพร่ -
ทรัพยากร API หลายรายการรองรับพร็อพเพอร์ตี้ใหม่ ตารางด้านล่างจะระบุทรัพยากรและพร็อพเพอร์ตี้ใหม่ของทรัพยากรเหล่านั้น
ทรัพยากร ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย activity
contentDetails.playlistItem.playlistItemId
string
รหัสรายการในเพลย์ลิสต์ที่ YouTube กำหนดเพื่อระบุรายการในเพลย์ลิสต์อย่างไม่ซ้ำกัน activity
contentDetails.channelItem
object
ออบเจ็กต์ที่มีข้อมูลเกี่ยวกับแหล่งข้อมูลที่เพิ่มลงในช่อง พร็อพเพอร์ตี้นี้จะแสดงก็ต่อเมื่อ snippet.type
เป็นchannelItem
activity
contentDetails.channelItem.resourceId
object
ออบเจ็กต์ที่ระบุแหล่งข้อมูลที่เพิ่มลงในช่อง เช่นเดียวกับ resourceId
พร็อพเพอร์ตี้อื่นๆ พร็อพเพอร์ตี้นี้มีkind
พร็อพเพอร์ตี้ที่ระบุประเภททรัพยากร เช่น วิดีโอหรือเพลย์ลิสต์ นอกจากนี้ ยังมีพร็อพเพอร์ตี้หลายรายการ เช่นvideoId
,playlistId
ฯลฯ ซึ่งระบุรหัสที่ระบุทรัพยากรนั้นๆ ได้อย่างไม่ซ้ำกันchannel
status
object
ออบเจ็กต์นี้จะห่อหุ้มข้อมูลเกี่ยวกับสถานะความเป็นส่วนตัวของช่อง channel
status.privacyStatus
string
สถานะความเป็นส่วนตัวของช่อง ค่าที่ใช้ได้คือ private
และpublic
playlist
contentDetails
object
ออบเจ็กต์นี้มีข้อมูลเมตาเกี่ยวกับเนื้อหาของเพลย์ลิสต์ playlist
contentDetails.itemCount
unsigned integer
จำนวนวิดีโอในเพลย์ลิสต์ playlist
player
object
ออบเจ็กต์นี้มีข้อมูลที่คุณจะใช้เพื่อเล่นเพลย์ลิสต์ในโปรแกรมเล่นแบบฝัง playlist
player.embedHtml
string
แท็ก <iframe>
ที่ฝังวิดีโอเพลเยอร์ซึ่งเล่นเพลย์ลิสต์video
recordingDetails
object
ออบเจ็กต์นี้ห่อหุ้มข้อมูลที่ระบุหรืออธิบายสถานที่และเวลาที่บันทึกวิดีโอ video
recordingDetails.location
object
ออบเจ็กต์นี้มีข้อมูลตำแหน่งทางภูมิศาสตร์ที่เชื่อมโยงกับวิดีโอ video
recordingDetails.location.latitude
double
ละติจูดในหน่วยองศา video
recordingDetails.location.longitude
double
ลองจิจูดเป็นองศา video
recordingDetails.location.elevation
double
ระดับความสูงเหนือพื้นโลกในหน่วยเมตร video
recordingDetails.locationDescription
string
คำอธิบายข้อความของสถานที่ที่มีการบันทึกวิดีโอ video
recordingDetails.recordingDate
datetime
วันที่และเวลาที่บันทึกวิดีโอ ค่าจะระบุในรูปแบบ ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ
) -
ตอนนี้เอกสารประกอบสำหรับเมธอด API หลายรายการระบุพร็อพเพอร์ตี้ที่ต้องระบุในเนื้อหาคำขอหรือที่อัปเดตตามค่าในเนื้อหาคำขอ ตารางด้านล่างแสดงรายการเมธอดเหล่านั้น รวมถึงพร็อพเพอร์ตี้ที่ต้องระบุหรือแก้ไขได้
หมายเหตุ: เอกสารประกอบสำหรับเมธอดอื่นๆ อาจแสดงพร็อพเพอร์ตี้ที่จำเป็นและแก้ไขได้อยู่แล้ว
วิธีการ พร็อพเพอร์ตี้ activities.insert
พร็อพเพอร์ตี้ที่จำเป็น: snippet.description
snippet.description
contentDetails.bulletin.resourceId
playlists.update
พร็อพเพอร์ตี้ที่จำเป็น: id
playlistItems.update
พร็อพเพอร์ตี้ที่จำเป็น: id
videos.update
พร็อพเพอร์ตี้ที่จำเป็น: id
-
API จะไม่รายงานข้อผิดพลาด
playlistAlreadyExists
อีกต่อไปหากคุณพยายามสร้างหรืออัปเดตเพลย์ลิสต์ที่มีชื่อเดียวกันกับเพลย์ลิสต์ที่มีอยู่ในช่องเดียวกันอยู่แล้ว -
เมธอด API หลายรายการรองรับข้อผิดพลาดประเภทใหม่ ตารางด้านล่างระบุวิธีการและข้อผิดพลาดที่รองรับใหม่
วิธีการ ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย guideCategories.list
notFound
notFound
ไม่พบหมวดหมู่คำแนะนำที่ระบุโดยพารามิเตอร์ id
ใช้วิธี guideCategories.list เพื่อดึงรายการค่าที่ถูกต้องplaylistItems.delete
forbidden
playlistItemsNotAccessible
คำขอไม่ได้รับอนุญาตอย่างถูกต้องในการลบรายการเพลย์ลิสต์ที่ระบุ videoCategories.list
notFound
videoCategoryNotFound
ไม่พบหมวดหมู่วิดีโอที่ระบุโดยพารามิเตอร์ id
ใช้วิธี videoCategories.list เพื่อดึงข้อมูลรายการค่าที่ถูกต้อง