หน้านี้ได้รับการแปลโดย Cloud Translation API

ประวัติการแก้ไข

หน้านี้จะแสดงรายการการเปลี่ยนแปลง API ข้อมูลของ YouTube (v3) และการอัปเดตเอกสาร สมัครรับบันทึกการเปลี่ยนแปลงนี้

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

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

forHandle ใหม่ของเมธอด channels.list ช่วยให้คุณสามารถดึงข้อมูลเกี่ยวกับช่องโดยการระบุแฮนเดิล 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 Analytics ศูนย์ช่วยเหลือของ YouTube ให้ข้อมูลเพิ่มเติมเกี่ยวกับเมตริกสตรีมมิงแบบสด

7 สิงหาคม 2023

ตามที่ได้ประกาศไปเมื่อวันที่ 12 มิถุนายน 2023 ของเมธอด search.list เลิกใช้งานพารามิเตอร์ relatedToVideoId แล้ว พารามิเตอร์ดังกล่าวไม่ได้รับการสนับสนุนอีกต่อไป ที่สนับสนุน และการอ้างอิงถึงพารามิเตอร์นี้ถูกลบออกจากเอกสาร API แล้ว

28 มิถุนายน 2023

ตอนนี้เมธอด thumbnails.set สนับสนุนเมธอด ข้อผิดพลาด uploadRateLimitExceeded ซึ่งระบุว่าช่องอัปโหลดมากเกินไป ภาพขนาดย่อในช่วง 24 ชั่วโมงที่ผ่านมาและควรลองอีกครั้งในภายหลัง

12 มิถุนายน 2023

หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

เมธอด search.list เลิกใช้งานพารามิเตอร์ relatedToVideoId แล้ว YouTube จะหยุดสนับสนุน ณ วันที่ 7 สิงหาคม 2023

ในตอนนี้ มีการเพิ่มการแจ้งเตือนการเลิกใช้งานลงในเมธอด search.list เอกสารประกอบ ระบบจะนำพารามิเตอร์นี้ออกจากเอกสารประกอบเกี่ยวกับ search.list โดยสมบูรณ์ ตั้งแต่วันที่ 7 สิงหาคม 2023 เป็นต้นไป

นอกจากนี้ ในตัวอย่างที่แสดงวิธีดึงข้อมูลวิดีโอที่เกี่ยวข้อง ที่นำออกจากคู่มือการใช้งาน API

22 สิงหาคม 2022

แก้ไขคำอธิบายประกอบประเภทสำหรับ video.statistics แล้ว เป็นสตริงจากสตริงแบบยาว

5 สิงหาคม 2022

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 รายการ ทั้ง 2 อย่างมีการปรับปรุงโปรดทราบว่าจำนวนสูงสุดของผู้ติดตามที่ API แสดงผลอาจถูกจำกัด การเปลี่ยนแปลงนี้แสดงถึงการแก้ไขในเอกสาร ไม่ใช่การเปลี่ยนแปลงลักษณะการทำงานของ API

15 ธันวาคม 2021

ตามประกาศเมื่อวันที่ 18 พฤศจิกายน 2021 ซึ่งเกี่ยวกับ การเปลี่ยนแปลงที่จะทำให้วิดีโอไม่ชอบ นับเป็นแบบส่วนตัวทั่วทั้งแพลตฟอร์ม YouTube ซึ่งเป็นทรัพยากร video statistics.dislikeCount ตอนนี้ที่พักเป็นแบบส่วนตัวแล้ว

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ในบล็อกอย่างเป็นทางการของ YouTube

18 พฤศจิกายน 2021

รวมทั้งการเปลี่ยนแปลงเกี่ยวกับ ทำให้จำนวนการกดไม่ชอบวิดีโอเป็นแบบส่วนตัวทั่วทั้งแพลตฟอร์ม YouTube ซึ่งเป็นแหล่งข้อมูลใน video statistics.dislikeCount ที่พักจะถูกทำให้เป็นแบบส่วนตัวตั้งแต่วันที่ 13 ธันวาคม 2021 ซึ่งหมายความว่าพร็อพเพอร์ตี้จะ รวมอยู่ในการตอบกลับของ API จากปลายทาง videos.list หากคำขอ API คือ ตรวจสอบสิทธิ์โดยเจ้าของวิดีโอแล้ว

ปลายทาง videos.rate ไม่ได้รับผลกระทบ ตามการเปลี่ยนแปลงนี้

นักพัฒนาซอฟต์แวร์ที่ไม่แสดงจำนวนการกดไม่ชอบแบบสาธารณะ แต่ยังคงต้องการจำนวนการกดไม่ชอบสำหรับ คุณสามารถสมัครไคลเอ็นต์ API เพื่ออยู่ในรายการอนุญาตสำหรับการยกเว้นได้ หากต้องการสมัครขอรับการยกเว้น คุณต้อง ต้องดำเนินการให้เสร็จสมบูรณ์ แบบฟอร์มการสมัคร

2 กรกฎาคม 2021

หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

เราเลิกใช้งานปลายทาง commentThreads.update แล้ว และระบบไม่รองรับอีกต่อไป ปลายทางนี้ทำซ้ำฟังก์ชันการทำงานที่พร้อมใช้งานผ่านปลายทาง API อื่นๆ อย่างไรก็ตาม คุณสามารถ โทรหา comments.update

วิธีการ และหากรหัสของคุณต้องใช้ทรัพยากร commentThreads ให้ทำการเรียกสำรองไปยัง commentThreads.list วิธี

1 กรกฎาคม 2021

นักพัฒนาซอฟต์แวร์ทุกรายที่ใช้บริการ API ของ YouTube ต้องผ่านการตรวจสอบการปฏิบัติตามข้อกำหนดของ API เพื่อให้ได้รับการจัดสรรมากกว่าโควต้าเริ่มต้นที่ 10,000 หน่วย ที่ผ่านมา ทั้งกระบวนการตรวจสอบการปฏิบัติตามข้อกำหนดและคำขอจัดสรรหน่วยโควต้าเพิ่มเติมได้รับการดำเนินการโดยนักพัฒนาซอฟต์แวร์ได้กรอกและส่งบริการ YouTube API - แบบฟอร์มการตรวจสอบและการขยายโควต้า

เราจะเพิ่มแบบฟอร์มใหม่ 3 แบบฟอร์มและคำแนะนำในการกรอกแบบฟอร์มเหล่านั้น เพื่ออธิบายกระบวนการเหล่านี้และตอบสนองความต้องการของนักพัฒนาแอปที่ใช้บริการ API ของเราได้ดียิ่งขึ้น

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

โดยแบบฟอร์มใหม่แต่ละรายการจะแจ้งให้เราทราบถึงวัตถุประสงค์การใช้งาน API ของ YouTube และช่วยให้เราช่วยเหลือคุณได้ดียิ่งขึ้น

โปรดดูรายละเอียดเพิ่มเติมในคู่มือการตรวจสอบการปฏิบัติตามข้อกำหนด API ใหม่

12 พฤษภาคม 2021

หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

การอัปเดตนี้ครอบคลุมถึงการเปลี่ยนแปลง API ต่อไปนี้

ทรัพยากรของ channel วันที่ contentDetails.relatedPlaylists.favorites เลิกใช้งานพร็อพเพอร์ตี้แล้ว เราได้เลิกใช้งานฟังก์ชันวิดีโอโปรดสำหรับ หลายปีตามที่ระบุไว้ในวันที่ 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[]
เมื่อใช้ร่วมกับการเปลี่ยนแปลงนี้ เมธอด channelSection.list พารามิเตอร์ hl ยัง ถูกเลิกใช้งานแล้วเนื่องจากระบบไม่รองรับฟีเจอร์ที่รองรับ

พร็อพเพอร์ตี้ทั้งหมดถูกนำออกจาก channelSection การแสดงทรัพยากร และคำจำกัดความของทรัพยากรได้ถูกนำออกจากทรัพยากร รายการพร็อพเพอร์ตี้ นอกจากนี้ ข้อผิดพลาด รวมถึงได้นำพร็อพเพอร์ตี้เหล่านี้ออกจากเอกสารเฉพาะของเมธอดแล้ว
สำหรับทรัพยากร channelSection พร็อพเพอร์ตี้ snippet.type ค่าต่อไปนี้เลิกใช้งานแล้ว ระบบไม่รองรับค่าเหล่านี้บน YouTube อยู่แล้ว หน้าแชแนล ด้วยเหตุนี้ จึงจะไม่ได้รับการสนับสนุนผ่าน API อีกต่อไป
- likedPlaylists
- likes
- postedPlaylists
- postedVideos
- recentActivity
- recentPosts
ทรัพยากรของ playlist เลิกใช้งานพร็อพเพอร์ตี้ snippet.tags[] แล้ว ระบบไม่รองรับพร็อพเพอร์ตี้นี้แล้ว บน 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 (คำขอไม่ถูกต้อง)
เมธอด playlistItems.list มีข้อผิดพลาด watchHistoryNotAccessible และ watchLaterNotAccessible รายการ ออกจากเอกสารประกอบแล้ว ในขณะที่ผู้ใช้ ที่จริงแล้ว ประวัติการดูและรายการดูภายหลัง ไม่สามารถเข้าถึงได้ผ่าน API ข้อผิดพลาดเฉพาะเหล่านี้จะไม่แสดงผลโดย API

15 ตุลาคม 2020

มีการเพิ่มส่วนใหม่ 2 ส่วนในส่วน นโยบาย:

ส่วนที่ III.E.4.i ใหม่มี ข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลที่รวบรวมและส่งผ่านโปรแกรมเล่นแบบฝังของ YouTube คุณ จะรับผิดชอบต่อข้อมูลผู้ใช้ใดๆ ที่คุณส่งให้เราผ่านโปรแกรมเล่นแบบฝังของ YouTube ก่อน ผู้ใช้โต้ตอบกับโปรแกรมเล่นเพื่อระบุความตั้งใจในการเล่น คุณสามารถจำกัดข้อมูลที่แชร์ได้ กับ YouTube ก่อนที่ผู้ใช้จะโต้ตอบกับโปรแกรมเล่นด้วยการตั้งค่า "เล่นอัตโนมัติ" เป็น "เท็จ"
ส่วนที่ III.E.4.j ใหม่เกี่ยวข้องกับ สำหรับการตรวจสอบสถานะเนื้อหาที่สร้างมาเพื่อเด็ก (MFK) ก่อนฝังเนื้อหาลงในเว็บไซต์และ แอป คุณมีหน้าที่รับผิดชอบในการตรวจสอบว่าวิดีโอที่ฝังในไคลเอ็นต์ API สร้างขึ้นเมื่อใด สำหรับเด็กและจัดการกับข้อมูลที่รวบรวมจากโปรแกรมเล่นแบบฝังตามความเหมาะสม คุณจึงต้อง ตรวจสอบสถานะของเนื้อหาโดยใช้บริการ API ข้อมูลของ YouTube ก่อนฝังลงใน API ไคลเอ็นต์ผ่านโปรแกรมเล่นแบบฝังของ YouTube

การค้นหาสถานะ MadeForKids ใหม่ของวิดีโอ คู่มือจะอธิบายวิธีค้นหาสถานะ MFK ของวิดีโอโดยใช้ บริการ API ข้อมูลของ YouTube

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

8 ตุลาคม 2020

การปรับปรุงครั้งนี้ครอบคลุมการเปลี่ยนแปลงเล็กๆ น้อยๆ 3 อย่างที่เกี่ยวข้องกับ แหล่งข้อมูล channel:

snippet.thumbnails ที่ระบุภาพขนาดย่อของช่องอาจว่างเปล่าสำหรับที่เพิ่งสร้างใหม่ และอาจใช้เวลานานถึง 1 วันจึงจะสร้างได้
statistics.videoCount พร็อพเพอร์ตี้จะแสดงจำนวนวิดีโอสาธารณะของช่องเท่านั้น แม้ว่าจะแสดงต่อเจ้าของก็ตาม ลักษณะการทำงานนี้ จะสอดคล้องกับจำนวนที่แสดงบนเว็บไซต์ YouTube
คีย์เวิร์ดของช่อง ซึ่งระบุอยู่ใน brandingSettings.channel.keywords พร็อพเพอร์ตี้ อาจมีการตัดให้สั้นลงหากเกินความยาวสูงสุดที่อนุญาตไว้ที่ 500 ตัวอักษรหรือ หากมีเครื่องหมายคำพูดที่ไม่ได้ใช้ Escape (") โปรดทราบว่า 500 อักขระ ขีดจำกัดไม่ใช่ขีดจำกัดต่อคีย์เวิร์ด แต่เป็นขีดจำกัดความยาวรวมของคีย์เวิร์ดทั้งหมด ลักษณะการทำงานนี้จะสอดคล้องกับพฤติกรรมนี้บนเว็บไซต์ YouTube

9 กันยายน 2020

หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

การอัปเดตนี้ครอบคลุมถึงการเปลี่ยนแปลง API ต่อไปนี้ การเปลี่ยนแปลงทั้งหมดจะมีผลในวันที่หรือหลังจาก 9 กันยายน 2020 ซึ่งเป็นวันที่ของประกาศนี้ ด้วยเหตุนี้ นักพัฒนาซอฟต์แวร์จึงไม่ควร ต้องอาศัยฟีเจอร์ใดๆ ของ API ที่ระบุไว้ด้านล่าง

ทรัพยากร เมธอด พารามิเตอร์ และพร็อพเพอร์ตี้ทรัพยากรของ API ต่อไปนี้เลิกใช้งานแล้ว ในทันทีและจะหยุดทำงานในหรือหลังจากวันที่ประกาศนี้
- ทรัพยากร channel ต่อไปนี้ พร็อพเพอร์ตี้:
  - พร็อพเพอร์ตี้ statistics.commentCount
  - ออบเจ็กต์ brandingSettings.image และพร็อพเพอร์ตี้ย่อยทั้งหมด
  - รายการ brandingSettings.hints และพร็อพเพอร์ตี้ย่อยทั้งหมด
- เมธอด channels.list พารามิเตอร์ตัวกรอง categoryId
- ทรัพยากร guideCategories และ guideCategories.list วิธีการ
การตอบกลับจาก API สำหรับ หมายเลขเมธอด channels.list มีแอตทริบิวต์ วันที่ prevPageToken หากคำขอ API ตั้งค่า พารามิเตอร์ managedByMe รายการ ไปยัง true การเปลี่ยนแปลงนี้ไม่มีผลกับพร็อพเพอร์ตี้ prevPageToken สำหรับคำขอ channels.list อื่นๆ และจะไม่ส่งผลต่อ nextPageToken สำหรับคำขอใดก็ได้
contentDetails.relatedPlaylists.watchLater ของทรัพยากร channel และประกาศที่พักทั้ง contentDetails.relatedPlaylists.watchHistory แห่ง เลิกใช้งานไปแล้วเมื่อวันที่ 11 สิงหาคม 2016 การรองรับเมธอด playlistItems.insert และ playlistItems.delete สำหรับเพลย์ลิสต์เหล่านี้ก็หยุดให้บริการโดยสมบูรณ์แล้ว และนำพร็อพเพอร์ตี้ทั้ง 2 รายการออก จากเอกสารประกอบ
พารามิเตอร์ mySubscribers ของเมธอด channels.list ซึ่งเดิม ได้ประกาศว่าเลิกใช้งานไปแล้วเมื่อวันที่ 30 กรกฎาคม 2013 ได้ นำออกจากเอกสารแล้ว ใช้เมนู subscriptions.list วิธีและ พารามิเตอร์ mySubscribers เพื่อเรียกดูรายชื่อสมาชิกของ ช่องของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์แล้ว
ออบเจ็กต์ channel ของทรัพยากร invideoPromotion และออบเจ็กต์ย่อยทั้งหมด ซึ่งมีการประกาศว่าเลิกใช้งานเมื่อวันที่ นำวันที่ 27 พฤศจิกายน 2017 ออกจากเอกสารประกอบแล้ว

29 กรกฎาคม 2020

เราได้ลดความซับซ้อนของขั้นตอนการเรียกเก็บเงินสำหรับโควต้าคำขอ API โดยการลบ ค่าใช้จ่ายที่เชื่อมโยงกับพารามิเตอร์ part การเรียกเก็บเงินจะมีผลทันที ต้นทุนฐานสำหรับเมธอดที่เรียกใช้ คุณสามารถดูข้อมูลเพิ่มเติมเกี่ยวกับ ที่นี่

ผลกระทบของการเปลี่ยนแปลงนี้คือ การเรียก API ส่วนใหญ่จะมีต้นทุนโควต้าลดลงเล็กน้อย ขณะที่ การเรียก API บางรายการจะยังคงมีค่าใช้จ่ายเท่าเดิม การเปลี่ยนแปลงนี้ไม่ได้เพิ่มค่าใช้จ่ายของ API โดยรวมแล้ว ผลกระทบที่เป็นไปได้คือโควต้าที่จัดสรรของคุณ ซึ่งสามารถดูได้ใน คอนโซล Google Cloud จะอยู่ไกลออกไปเล็กน้อย

เราขอแนะนำให้นักพัฒนาแอปทุกราย การตรวจสอบการปฏิบัติตามข้อกำหนดสำหรับ เพื่อให้เข้าถึงบริการ API ของ YouTube ได้ต่อไป

รายการประวัติการแก้ไขนี้เผยแพร่ครั้งแรกเมื่อวันที่ 20 กรกฎาคม 2020

28 กรกฎาคม 2020

วิดีโอทั้งหมดที่อัปโหลดผ่าน videos.insert ปลายทางจากโปรเจ็กต์ API ที่ไม่ได้รับการยืนยันซึ่งสร้างขึ้นหลังจากวันที่ 28 กรกฎาคม 2020 จะถูกจำกัดไว้เฉพาะ โหมดการดูแบบส่วนตัว หากต้องการยกเลิกข้อจำกัดนี้ แต่ละโปรเจ็กต์จะต้อง ทำการตรวจสอบเพื่อยืนยัน การปฏิบัติตามข้อกำหนด ข้อกำหนดในการให้บริการ

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

โปรเจ็กต์ API ที่สร้างก่อนวันที่ 28 กรกฎาคม 2020 มีดังนี้ ไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้ แต่เราขอแนะนำเป็นอย่างยิ่งให้นักพัฒนาแอปทุกราย ตรวจสอบการปฏิบัติตามข้อกำหนด สำหรับโปรเจ็กต์ต่อเพื่อให้เข้าถึงบริการ YouTube API ได้อย่างต่อเนื่อง

21 กรกฎาคม 2020

[อัปเดตเมื่อ 28 กรกฎาคม 2020] การอัปเดตเอกสารที่อ้างอิงในการแก้ไขครั้งนี้ รายการประวัติมีการเผยแพร่อีกครั้งในวันที่ 28 กรกฎาคม 2020

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

7 กรกฎาคม 2020

หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

เมธอด videos.insert ขณะนี้มีการเลิกใช้งานพารามิเตอร์ autoLevels และ stabilize และทั้ง ออกจากเอกสารประกอบแล้ว ระบบจะไม่สนใจค่าของเมตริกและจะไม่ส่งผลต่อ วิธีประมวลผลวิดีโอที่อัปโหลดใหม่

15 มิถุนายน 2020

นโยบายใหม่การปฏิบัติตามข้อกำหนดของนักพัฒนาซอฟต์แวร์ YouTube คู่มือนโยบายจะให้คำแนะนำและตัวอย่างเพื่อช่วยให้คุณตรวจสอบว่าไคลเอ็นต์ API ของคุณปฏิบัติตามนโยบาย สำหรับบริการ API ของ YouTube บางส่วน ข้อกำหนดและ นโยบาย (ข้อกำหนดในการให้บริการของ API)

คำแนะนำนี้จะให้ข้อมูลเชิงลึกเกี่ยวกับวิธีที่ 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 ซึ่งมีเอกสารประกอบไว้เป็นส่วนหนึ่งของ API สตรีมมิงแบบสดของ YouTube เลิกใช้งานทรัพยากร sponsor แล้ว และไคลเอ็นต์ API ควรอัปเดตการเรียกไปยัง เมธอด sponsors.list เพื่อใช้ members.list แทน
- membershipsLevel ใหม่ ระบุระดับราคาที่จัดการโดยผู้สร้างที่ให้สิทธิ์คำขอ API membershipsLevels.list จะเรียกรายการระดับการเป็นสมาชิกทั้งหมดของครีเอเตอร์

10 มกราคม 2020

ปัจจุบัน API รองรับความสามารถในการระบุเนื้อหาที่มุ่งเน้นเด็กเป็นหลัก ซึ่ง YouTube เรียกใช้ "สร้างมาเพื่อเด็ก" ดูข้อมูลเพิ่มเติมเกี่ยวกับ "สร้างมาเพื่อเด็ก" เนื้อหาในศูนย์ช่วยเหลือของ YouTube

channel และ ทรัพยากร video รองรับพร็อพเพอร์ตี้ใหม่ 2 รายการเพื่อ ช่วยให้ครีเอเตอร์เนื้อหาและผู้ชมระบุเนื้อหาที่สร้างมาเพื่อเด็กได้

พร็อพเพอร์ตี้ selfDeclaredMadeForKids ช่วยให้ครีเอเตอร์เนื้อหาระบุได้ว่า channel หรือ วิดีโอสร้างมาเพื่อเด็ก

สำหรับช่อง คุณสามารถตั้งค่าพร็อพเพอร์ตี้นี้เมื่อเรียกฟังก์ชัน channels.update วิธี สำหรับวิดีโอ คุณสามารถตั้งค่าพร็อพเพอร์ตี้นี้เมื่อเรียกฟังก์ชัน videos.insert หรือ videos.update วิธี

โปรดทราบว่าพร็อพเพอร์ตี้นี้รวมอยู่ในการตอบกลับ API ที่มี channel หรือ เท่านั้น แหล่งข้อมูล video หากเจ้าของช่องให้สิทธิ์คำขอ API
พร็อพเพอร์ตี้ madeForKids ช่วยให้ผู้ใช้ทุกคนสามารถดึงข้อมูลเนื้อหาที่ "สร้างมาเพื่อเด็ก" สถานะ ของช่องหรือ วิดีโอ ตัวอย่างเช่น สถานะอาจเป็น กำหนดตามค่าของพร็อพเพอร์ตี้ selfDeclaredMadeForKids โปรดดู ศูนย์ช่วยเหลือของ YouTube เพื่อดูข้อมูลเพิ่มเติม ข้อมูลเกี่ยวกับการกำหนดผู้ชมสำหรับช่อง วิดีโอ หรือการออกอากาศของคุณ

นอกจากนี้ เรายังปรับปรุงข้อกำหนดในการให้บริการของบริการ API ของ YouTube และนโยบายสำหรับนักพัฒนาซอฟต์แวร์ด้วย โปรด ดูข้อกำหนดในการให้บริการของบริการ API ของ YouTube - การแก้ไข ประวัติสำหรับข้อมูลเพิ่มเติม การเปลี่ยนแปลงข้อกำหนดในการให้บริการของบริการ API ของ YouTube และ นโยบายสำหรับนักพัฒนาแอปจะมีผลบังคับใช้ในวันที่ 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 ตอนนี้มีองค์ประกอบใหม่ 2 รายการในหน้าเว็บที่อธิบายเมธอด API ดังนี้
- วิดเจ็ต API Explorer ให้คุณเลือกขอบเขตการให้สิทธิ์ ป้อนพารามิเตอร์ตัวอย่างและค่าพร็อพเพอร์ตี้ แล้วส่งคำขอ API จริงและดูการตอบกลับจาก API จริงได้ วิดเจ็ตยังมีมุมมองแบบเต็มหน้าจอที่แสดงตัวอย่างโค้ดที่สมบูรณ์ ซึ่งจะอัปเดตแบบไดนามิกเพื่อใช้ขอบเขตและค่าที่คุณป้อน
- ส่วน Use Case ที่พบบ่อย จะอธิบาย Use Case ที่พบบ่อยอย่างน้อย 1 กรณีสำหรับวิธีการที่อธิบายไว้ในหน้า ตัวอย่างเช่น คุณสามารถเรียกใช้เมธอด channels.list เพื่อดึงข้อมูลเกี่ยวกับแชแนลที่ระบุ หรือเพื่อดึงข้อมูลเกี่ยวกับแชแนลของผู้ใช้ปัจจุบัน
  
  คุณสามารถใช้ลิงก์ในส่วนดังกล่าวเพื่อเติมข้อมูลให้กับ API Explorer ด้วยค่าตัวอย่างสำหรับกรณีการใช้งานของคุณ หรือเพื่อเปิด API Explorer แบบเต็มหน้าจอที่ป้อนข้อมูลค่าเหล่านั้นไว้แล้ว การเปลี่ยนแปลงเหล่านี้มีจุดมุ่งหมายเพื่อให้คุณดูตัวอย่างโค้ดที่นำไปใช้โดยตรงกับกรณีการใช้งานที่คุณพยายามติดตั้งใช้งานในแอปพลิเคชันของคุณเองได้ง่ายขึ้น
ปัจจุบันตัวอย่างโค้ดรองรับ Java, JavaScript, PHP, Python และ curl
นอกจากนี้ เครื่องมือตัวอย่างโค้ดยังได้รับการอัปเดตด้วย UI ใหม่ที่มีฟีเจอร์เดียวกันทั้งหมดดังที่อธิบายไว้ข้างต้น เมื่อใช้เครื่องมือดังกล่าว คุณจะสามารถสำรวจกรณีการใช้งานสำหรับวิธีการต่างๆ, โหลดค่าลงใน API Explorer และเปิด API Explorer แบบเต็มหน้าจอเพื่อรับตัวอย่างโค้ดใน Java, JavaScript, PHP และ Python

การเปลี่ยนแปลงนี้ทำให้หน้าเว็บที่ก่อนหน้านี้แสดงรายการตัวอย่างโค้ดสำหรับ Java, JavaScript, PHP และ Python ถูกนำออกแล้ว
คู่มือเริ่มใช้งานฉบับย่อสำหรับ Java, JavaScript, PHP และ Python ได้รับการอัปเดตแล้ว คำแนะนำที่แก้ไขแล้วจะอธิบายวิธีเรียกใช้ตัวอย่าง 1 รายการกับคีย์ API และอีกตัวอย่างหนึ่งที่มีรหัสไคลเอ็นต์ OAuth 2.0 โดยใช้ตัวอย่างโค้ดจาก API Explorer

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

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 ซึ่งใช้ขั้นตอนการให้สิทธิ์ที่แตกต่างกันเล็กน้อย หากต้องการดูตัวอย่างทั้งหมด (และการเปลี่ยนแปลงนี้) ให้ทำดังนี้
1. ไปที่เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟหรือเอกสารสำหรับเมธอด API เช่น เมธอด channels.list
2. คลิกแท็บ Python เหนือตัวอย่างโค้ด
3. คลิกปุ่มเปิด/ปิดเหนือแท็บเพื่อเปลี่ยนจากการแสดงตัวอย่างเป็นตัวอย่างแบบเต็ม
4. ตอนนี้แท็บควรแสดงตัวอย่างโค้ดที่สมบูรณ์ที่ใช้ขั้นตอนการให้สิทธิ์ InstalledAppFlow คำอธิบายเหนือตัวอย่างจะอธิบายเรื่องนี้ และยังลิงก์ไปยังตัวอย่างสำหรับแอปพลิเคชันเว็บเซิร์ฟเวอร์
5. คลิกลิงก์เพื่อเปลี่ยนเป็นตัวอย่างเว็บเซิร์ฟเวอร์ ตัวอย่างดังกล่าวใช้เฟรมเวิร์กเว็บแอปพลิเคชัน Flask และขั้นตอนการให้สิทธิ์ที่แตกต่างกัน
ตัวอย่างทั้งหมดนี้ออกแบบมาเพื่อดาวน์โหลดและเรียกใช้ในเครื่อง หากต้องการเรียกใช้ตัวอย่าง โปรดดูวิธีการเรียกใช้ตัวอย่างโค้ดแบบเต็มในเครื่องในวิธีการใช้เครื่องมือข้อมูลโค้ด

29 สิงหาคม 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

อัปเดตคําจํากัดความของพารามิเตอร์ forContentOwner ของเมธอด search.list แล้วโปรดทราบว่าหากตั้งค่าพารามิเตอร์เป็น true พารามิเตอร์ type จะต้องตั้งค่าเป็น video
อัปเดตคําจํากัดความของพารามิเตอร์ regionCode ของเมธอด search.list เพื่อชี้แจงว่าพารามิเตอร์จํากัดผลการค้นหาให้แสดงเฉพาะวิดีโอที่ดูได้ในภูมิภาคที่ระบุ
YouTube ได้อัปเดตโลโก้และไอคอนการสร้างแบรนด์ "พัฒนาด้วย YouTube" ใหม่ ดาวน์โหลดโลโก้ได้จากหน้าหลักเกณฑ์การสร้างแบรนด์ โลโก้และไอคอน YouTube ใหม่อื่นๆ จะแสดงอยู่ในหน้านั้นเช่นกัน และสามารถดาวน์โหลดได้จากเว็บไซต์แบรนด์ YouTube

24 กรกฎาคม 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

คู่มือเริ่มใช้งานฉบับย่อสำหรับ Data API ของ YouTube ใหม่พร้อมใช้งานแล้วสำหรับ iOS คำแนะนำนี้จะอธิบายวิธีใช้ API ข้อมูลของ YouTube ในแอปพลิเคชัน iOS แบบง่ายที่เขียนด้วย Objective-C หรือ Swift
ตอนนี้เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟสำหรับ YouTube Data API มีเอกสารที่อธิบายฟีเจอร์บางอย่างของเครื่องมือ ดังนี้
- การดำเนินการคำขอ API
- การสลับระหว่างข้อมูลโค้ดและตัวอย่างโค้ดแบบเต็ม
- การใช้ฟังก์ชันสำเร็จรูป
- กำลังโหลดทรัพยากรที่มีอยู่ (สำหรับวิธีการอัปเดต)
หมายเหตุ: เครื่องมือนี้ยังฝังอยู่ในเอกสารอ้างอิง 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 Explorer บนหน้าเว็บที่มีให้บริการ (แต่ละหน้าจะแสดงลิงก์เพื่อให้คุณมีทางเลือกในการโหลดคำขอที่คุณกำลังทำใน API Explorer)
นอกจากนี้ เครื่องมือข้อมูลโค้ด API ข้อมูลยังได้รับการอัปเดตด้วย UI ใหม่ที่มีฟีเจอร์เดียวกันทั้งหมดดังที่อธิบายไว้ข้างต้น ฟีเจอร์ใหม่หลักๆ ที่มีอยู่ในหน้านี้มีดังนี้
- การรองรับคำขอ API ที่เขียนข้อมูล
- สนับสนุนตัวอย่าง Java
- โค้ดต้นแบบที่ยืดหยุ่นและครอบคลุมมากกว่าสำหรับการให้สิทธิ์ผู้ใช้และการสร้างคำขอ API

27 เมษายน 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

คู่มือเริ่มใช้งานฉบับย่อใหม่อธิบายวิธีตั้งค่าแอปพลิเคชันง่ายๆ ที่สร้างคำขอ API ข้อมูลของ YouTube ปัจจุบันมีคำแนะนำที่พร้อมใช้งานสำหรับ Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python และ Ruby

30 มีนาคม 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

พร็อพเพอร์ตี้ topicDetails.topicCategories[] ใหม่ของทรัพยากร channel มีรายการ URL ของ Wikipedia ที่อธิบายเนื้อหาของช่อง URL ที่สอดคล้องกับรหัสหัวข้อที่แสดงในพร็อพเพอร์ตี้ topicDetails.topicIds[] ของทรัพยากร
พร็อพเพอร์ตี้ contentDetails.videoPublishedAt ใหม่ของทรัพยากร playlistItem จะระบุเวลาที่มีการเผยแพร่วิดีโอไปยัง YouTube ทรัพยากรมีพร็อพเพอร์ตี้ snippet.publishedAt อยู่แล้ว ซึ่งระบุเวลาที่เพิ่มรายการลงในเพลย์ลิสต์
เช่นเดียวกับแหล่งข้อมูล channel ตอนนี้ทรัพยากร video จะแสดงพร็อพเพอร์ตี้ topicDetails.topicCategories[] ซึ่งมีรายการ URL ของ Wikipedia ที่อธิบายเนื้อหาของวิดีโอ สำหรับทรัพยากร video นั้น URL จะตรงกับรหัสหัวข้อที่แสดงในพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] ของทรัพยากร
พร็อพเพอร์ตี้ contentDetails.contentRating.mpaatRating ใหม่ของทรัพยากร video ระบุการจัดประเภทที่สมาคมภาพยนตร์แห่งสหรัฐอเมริกาให้กับตัวอย่างหรือตัวอย่างภาพยนตร์

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 ถูกนำออกแล้ว
โปรดทราบว่ายังมีหมวดหมู่หลักอยู่ 2-3 หมวดหมู่ (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 จะปรับขนาดของโปรแกรมเล่นตามความเหมาะสมเพื่อให้มั่นใจว่าโปรแกรมเล่นที่ฝังไว้ไม่มีแถบสีดำล้อมรอบวิดีโอ โปรดทราบว่าพารามิเตอร์ทั้งสองจะระบุขนาดสูงสุดของโปรแกรมเล่นแบบฝัง ดังนั้น หากระบุพารามิเตอร์ทั้งคู่ มิติข้อมูลหนึ่งอาจยังคงน้อยกว่าจำนวนสูงสุดที่อนุญาตสำหรับมิติข้อมูลนั้น
  
  ตัวอย่างเช่น สมมติว่าวิดีโอมีอัตราส่วน 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 แล้ว โปรดทราบว่าขนาดไฟล์สูงสุดของวิดีโอที่อัปโหลดเพิ่มขึ้นจาก 64GB เป็น 128GB

ข้อผิดพลาดใหม่และอัปเดต

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 ดังนี้
- พารามิเตอร์ home ของเมธอด activities.list ทำให้ผู้ใช้ที่ได้รับอนุญาตสามารถเรียกฟีดกิจกรรมที่จะแสดงบนหน้าแรกของ YouTube สำหรับผู้ใช้รายนั้น คำขอที่ใช้พารามิเตอร์นี้หลังจากวันที่ 12 กันยายน 2016 จะแสดงรายการที่ว่างเปล่า
- พร็อพเพอร์ตี้ contentDetails.relatedPlaylists.watchHistory และ contentDetails.relatedPlaylists.watchLater ของทรัพยากร channel จะปรากฏแก่ผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เองเท่านั้น หลังจากวันที่ 12 กันยายน 2016 ค่า contentDetails.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 รายการออกจากเอกสารประกอบของทรัพยากรที่เกี่ยวข้อง

31 พฤษภาคม 2016

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

พารามิเตอร์ myRecentSubscribers ใหม่ของเมธอด subscriptions.list จะเรียกรายชื่อผู้ติดตามช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์โดยจะเรียงตามลำดับเวลาจากใหม่ไปหาเก่า

โปรดทราบว่าพารามิเตอร์ใหม่รองรับเฉพาะการดึงข้อมูลผู้ติดตาม 1,000 คนล่าสุดมายังช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์เท่านั้น หากต้องการดึงข้อมูลรายการผู้ติดตามทั้งหมด ให้ใช้พารามิเตอร์ mySubscribers พารามิเตอร์ดังกล่าวซึ่งไม่ได้แสดงผลสมาชิกตามลำดับที่กำหนดนั้น จะไม่จำกัดจำนวนผู้ติดตามที่เรียกดูได้
อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ snippet.thumbnails.(key) สำหรับแหล่งข้อมูลกิจกรรม, playlistItem, เพลย์ลิสต์, ผลการค้นหา, ภาพขนาดย่อ และ วิดีโอ แล้ว เพื่อให้ทราบว่าวิดีโอบางรายการมีขนาดภาพขนาดย่อเพิ่มเติม
- รูปภาพ 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

สำหรับแต่ละวิธี เครื่องมือจะแสดงตัวอย่างโค้ดสำหรับ Use Case อย่างน้อย 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 Developer ซึ่งคุณจะเห็นโควต้าการใช้งานจริงและโควต้าการใช้งาน

16 มีนาคม 2016

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

การอัปเดตทรัพยากรและวิธีการที่มีอยู่
- เอกสารแหล่งข้อมูล channelBanner ได้รับการอัปเดตแล้ว โดยพบว่าขนาดที่แนะนำสำหรับรูปภาพแบนเนอร์ของช่องที่อัปโหลดคือ 2560 x 1440 พิกเซล ขนาดต่ำสุด (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` จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่คุณพยายามเพิ่มไปยังเพลย์ลิสต์อยู่ในเพลย์ลิสต์ของซีรีส์อื่นอยู่แล้ว ไปที่ศูนย์ช่วยเหลือของ YouTube เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับรายการซีรีส์
`badRequest (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 เราได้เพิ่มประกาศข้อกำหนดนี้ไว้ในข้อกำหนดในการให้บริการ API ของ YouTube แล้ว

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 รองรับ 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 สำหรับแหล่งข้อมูลและตัวกรองเพื่อดูว่าข้อความแปลนั้นมีอยู่ไหม
  
  ตัวอย่างเช่น คุณจะต้องเรียกข้อมูลรายการการแปลเป็นภาษาท้องถิ่นทั้งหมดเพื่อดูว่าข้อความที่แปลแล้วเป็นภาษาอังกฤษแบบ Appalachian หรือไม่
- เมื่อเรียกข้อมูลทรัพยากร ให้ใส่ 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 Ratings ของฝรั่งเศส พร็อพเพอร์ตี้นี้มาแทนที่พร็อพเพอร์ตี้ contentDetails.contentRating.fmocRating ซึ่งตอนนี้เลิกใช้งานแล้ว
- ระบบได้อัปเดตคําจํากัดความ brandingSettings.channel.keywords ของทรัพยากร channel ให้แสดงอย่างถูกต้องว่าค่าพร็อพเพอร์ตี้มีรายการสตริงที่คั่นด้วยการเว้นวรรค และไม่ใช่รายการที่คั่นด้วยคอมมาอย่างที่ระบุก่อนหน้านี้ การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ 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 ที่กำหนดเวลาไว้ให้รองรับแล้ว ฟีเจอร์เหล่านี้จะอธิบายทั้งหมดไว้ในคำแนะนำในการย้ายข้อมูลด้วย
การอัปเดตทรัพยากรและวิธีการที่มีอยู่
- พารามิเตอร์ตัวกรอง forDeveloper ใหม่ของเมธอด search.list จะจำกัดการค้นหาให้ดึงเฉพาะวิดีโอที่อัปโหลดผ่านแอปพลิเคชันหรือเว็บไซต์ของนักพัฒนาซอฟต์แวร์เท่านั้น พารามิเตอร์ forDeveloper สามารถใช้ร่วมกับพารามิเตอร์การค้นหาที่ไม่บังคับ เช่น พารามิเตอร์ q
  
  สำหรับฟีเจอร์นี้ วิดีโอที่อัปโหลดแต่ละรายการจะได้รับการติดแท็กด้วยหมายเลขโปรเจ็กต์ที่เชื่อมโยงกับแอปพลิเคชันของนักพัฒนาซอฟต์แวร์ใน Google Developers Console โดยอัตโนมัติ
  
  เมื่อคำขอค้นหาตั้งค่าพารามิเตอร์ forDeveloper เป็น true ในภายหลัง เซิร์ฟเวอร์ API จะใช้ข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอเพื่อระบุนักพัฒนาซอฟต์แวร์ ดังนั้น นักพัฒนาแอปจึงจำกัดผลการค้นหาไว้เฉพาะวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์ของนักพัฒนาแอปเอง แต่จะจำกัดผลการค้นหาผ่านแอปหรือเว็บไซต์อื่นๆ ไม่ได้
  
  ฟีเจอร์ใหม่มีฟังก์ชันการทำงานที่คล้ายกัน (แม้จะไม่เหมือนกัน) กับฟังก์ชันของแท็กนักพัฒนาซอฟต์แวร์ที่ API เวอร์ชัน 2 รองรับ
- พร็อพเพอร์ตี้ snippet.country ใหม่ของทรัพยากร channel ช่วยให้เจ้าของช่องเชื่อมโยงช่องกับประเทศที่ต้องการได้
  
  หมายเหตุ: หากต้องการตั้งค่าพร็อพเพอร์ตี้ 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 ได้รับการแก้ไขแล้วเพื่อแสดงให้เห็นว่าเมธอดเหล่านั้นทั้งหมดจะแสดงโค้ดตอบกลับ HTTP 204 (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 ไม่รองรับ แต่รองรับใน v3 API ซึ่งได้แก่
- เรียกดูความคิดเห็นเกี่ยวกับช่อง
- เรียกดูชุดข้อความความคิดเห็นทั้งหมดที่เกี่ยวข้องกับช่อง ซึ่งหมายความว่าการตอบกลับจาก API อาจมีความคิดเห็นเกี่ยวกับช่องหรือวิดีโอในช่องได้
- การอัปเดตข้อความของความคิดเห็น
- การทำเครื่องหมายความคิดเห็นว่าเป็นสแปม
- ตั้งค่าสถานะการดูแลความคิดเห็น
คำแนะนำการสมัครรับข้อความ Push ได้รับการอัปเดตเพื่อแสดงข้อเท็จจริงที่ว่าการแจ้งเตือนจะพุชไปที่ฮับ Google PubSubHubBub เท่านั้น และไม่ส่งไปยัง Superfeedr Hub ตามที่ระบุไว้ก่อนหน้านี้

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 รายการ เช่น ล้างความคิดเห็นสำหรับการแสดงต่อสาธารณะ หรือปฏิเสธความคิดเห็นที่ไม่เหมาะที่จะแสดง คำขอ API จะต้องได้รับอนุญาตจากเจ้าของช่องหรือวิดีโอที่เชื่อมโยงกับความคิดเห็น
  - comments.delete – ลบความคิดเห็น
โปรดทราบว่าจำเป็นต้องมีขอบเขต https://www.googleapis.com/auth/youtube.force-ssl ใหม่ของ API ที่อธิบายไว้ในประวัติการแก้ไขสำหรับวันที่ 2 เมษายน 2015 สำหรับการเรียกไปยังเมธอด comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert และ commentThreads.update
คู่มือการสมัครรับข้อความ Push ใหม่จะอธิบายการสนับสนุนใหม่ๆ ของ API สำหรับข้อความ Push ผ่าน PubSubHubBub ซึ่งเป็นโปรโตคอลการเผยแพร่/สมัครรับข้อมูลแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์สำหรับแหล่งข้อมูลที่สามารถเข้าถึงเว็บได้ เซิร์ฟเวอร์ Callback PubSubHubBub จะได้รับการแจ้งเตือนฟีด Atom เมื่อช่องทำกิจกรรมต่อไปนี้
- อัปโหลดวิดีโอ
- อัปเดตชื่อของวิดีโอ
- อัปเดตคำอธิบายของวิดีโอ
เราได้ปรับปรุงคู่มือการย้ายข้อมูลเพื่อให้ทราบถึงการรองรับข้อความ Push ใหม่ อย่างไรก็ตาม เนื่องจาก API เวอร์ชัน 2 รองรับข้อความ Push ประเภทอื่นๆ จำนวนมากที่ไม่รองรับใน API เวอร์ชัน 3 การพูดถึงการสนับสนุน 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 รองรับเมธอดในการแสดงรายการ แทรก อัปเดต ดาวน์โหลด และลบแทร็กคำบรรยาย
เรายังได้อัปเดตคำแนะนำในการย้ายข้อมูลเพื่ออธิบายวิธีย้ายข้อมูลแอปพลิเคชันที่ยังใช้ฟังก์ชันคำบรรยายแทนเสียงใน API เวอร์ชัน 2 อีกด้วย
ขอบเขต https://www.googleapis.com/auth/youtube.force-ssl ใหม่ของ API กำหนดให้สื่อสารกับเซิร์ฟเวอร์ API ผ่านการเชื่อมต่อ SSL

ขอบเขตใหม่นี้จะให้สิทธิ์เข้าถึงเหมือนกับขอบเขต https://www.googleapis.com/auth/youtube และในความเป็นจริง ขอบเขตทั้ง 2 อย่างนี้มีฟังก์ชันการทำงานเหมือนกันเนื่องจากเซิร์ฟเวอร์ API ของ YouTube จะใช้งานได้ผ่านปลายทาง HTTPS เท่านั้น ด้วยเหตุนี้ แม้ว่าขอบเขต https://www.googleapis.com/auth/youtube จะไม่จำเป็นต้องใช้การเชื่อมต่อ SSL แต่จริงๆ แล้ว จึงไม่มีวิธีอื่นๆ ในการส่งคำขอ API

ต้องมีขอบเขตใหม่สำหรับการเรียกเมธอดของทรัพยากร caption ทั้งหมด

11 มีนาคม 2015

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

คำแนะนำในการย้ายข้อมูล YouTube Data API (v3) มีแท็บใหม่ชื่อใหม่ใน v3 API ซึ่งแสดงฟีเจอร์ที่ API v3 รองรับและ v2 API ไม่รองรับ คุณลักษณะเดิมมีอยู่ก่อนหน้านี้และยังคงปรากฏในแท็บอื่นๆ ในคำแนะนำ ตัวอย่างเช่น ฟีเจอร์ใหม่ที่อธิบายวิธีอัปเดตข้อมูลแคมเปญโปรโมตในวิดีโอของช่องจะปรากฏในแท็บช่อง (โปรไฟล์) ด้วย
เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล YouTube Data API (v3) เพื่อสังเกตว่า v3 API จะรองรับฟีเจอร์ v2 API ต่อไปนี้
- การแจ้งวิดีโอที่ไม่เหมาะสม
เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล API ข้อมูลของ YouTube (v3) เพื่อสังเกตว่า API เวอร์ชัน 2 จะไม่รองรับฟีเจอร์ API เวอร์ชัน 2 ต่อไปนี้
- ดึงข้อมูลวิดีโอแนะนำ – API v3 จะไม่เรียกข้อมูลรายการที่มีเฉพาะวิดีโอที่แนะนำสำหรับผู้ใช้ API ปัจจุบัน อย่างไรก็ตาม คุณใช้ v3 API เพื่อค้นหาวิดีโอแนะนำได้โดยเรียกใช้เมธอด activities.list และตั้งค่าพารามิเตอร์ home เป็น true
  
  ในการตอบกลับ API ทรัพยากรสอดคล้องกับวิดีโอแนะนำหากค่าของพร็อพเพอร์ตี้ snippet.type เป็น recommendation ในกรณีนี้ พร็อพเพอร์ตี้ contentDetails.recommendation.reason และ contentDetails.recommendation.seedResourceId จะมีข้อมูลเกี่ยวกับเหตุผลที่แนะนำวิดีโอ ทั้งนี้ เราไม่รับประกันว่าการตอบกลับจะมีวิดีโอแนะนำตามจำนวนที่เฉพาะเจาะจงใดๆ
- เรียกข้อมูลช่องที่แนะนำ
- เรียกดูวิดีโอที่ต้องสมัครรับข้อมูลใหม่ – API v3 จะไม่เรียกรายการที่มีเฉพาะวิดีโอซึ่งเพิ่งอัปโหลดไปยังช่องที่ผู้ใช้ API สมัครรับข้อมูล อย่างไรก็ตาม คุณสามารถใช้ v3 API เพื่อค้นหาวิดีโอที่ต้องสมัครใช้บริการใหม่ได้โดยเรียกใช้เมธอด activities.list และตั้งค่าพารามิเตอร์ home เป็น true
  
  ในการตอบกลับของ API ทรัพยากรจะสอดคล้องกับวิดีโอการสมัครใช้บริการใหม่หากค่าของพร็อพเพอร์ตี้ snippet.type คือ upload ทั้งนี้ เราไม่รับประกันว่าการตอบกลับจะมีจำนวนวิดีโอที่มีการสมัครรับข้อมูลใหม่
- การรองรับฟีด RSS
- ข้อความ Push สำหรับการอัปเดตฟีด – ข้อความ Push ที่รองรับ v2 API โดยใช้ Simple Update Protocol (SUP) หรือ PubSubHubbub เพื่อตรวจสอบฟีดกิจกรรมของผู้ใช้สำหรับผู้ใช้ YouTube การแจ้งเตือนมีให้สำหรับการติดตามช่องใหม่ และเมื่อมีการให้คะแนน แบ่งปัน ทำเครื่องหมายเป็นรายการโปรด แสดงความคิดเห็น หรืออัปโหลด
  
  v3 API จะรองรับข้อความ Push โดยใช้โปรโตคอล PubSubHubbub แต่การแจ้งเตือนจะครอบคลุมเฉพาะการอัปโหลดวิดีโอและการอัปเดตชื่อวิดีโอหรือคำอธิบายวิดีโอ
- ตำแหน่งของช่อง – API เวอร์ชัน 2 ใช้แท็ก <yt:location> เพื่อระบุตำแหน่งของผู้ใช้ตามที่ป้อนในโปรไฟล์สาธารณะของ YouTube ของช่อง แม้ว่านักพัฒนาซอฟต์แวร์บางรายใช้ฟิลด์นี้เพื่อเชื่อมโยงช่องกับประเทศหนึ่งๆ แต่ข้อมูลของช่องนั้นไม่สามารถใช้เพื่อวัตถุประสงค์ดังกล่าวอย่างสม่ำเสมอได้
- ตั้งค่าหรือเรียกแท็กนักพัฒนาซอฟต์แวร์ – API เวอร์ชัน 2 รองรับความสามารถในการเชื่อมโยงคีย์เวิร์ดหรือแท็กนักพัฒนาซอฟต์แวร์กับวิดีโอในขณะที่อัปโหลดวิดีโอ แท็กนักพัฒนาซอฟต์แวร์จะไม่แสดงต่อผู้ใช้ YouTube แต่เจ้าของวิดีโอสามารถดึงข้อมูลวิดีโอที่ตรงกับแท็กนักพัฒนาซอฟต์แวร์หนึ่งๆ ได้
  
  API v3 จะมีฟีเจอร์ที่คล้ายกันแต่ไม่เหมือนกัน กล่าวอย่างเจาะจงคือ นักพัฒนาซอฟต์แวร์จะค้นหาวิดีโอที่อัปโหลดโดยแอปพลิเคชันของนักพัฒนาซอฟต์แวร์เองได้ สำหรับฟีเจอร์นี้ วิดีโอที่อัปโหลดแต่ละรายการจะได้รับการติดแท็กด้วยหมายเลขโปรเจ็กต์ที่เชื่อมโยงกับแอปพลิเคชันของนักพัฒนาซอฟต์แวร์ใน Google Developers Console โดยอัตโนมัติ จากนั้นนักพัฒนาซอฟต์แวร์จะใช้หมายเลขโปรเจ็กต์เดียวกันเพื่อค้นหาวิดีโอ
- แสดงรายการวิดีโอตามวันที่เผยแพร่ ยอดดู หรือการจัดประเภท – ใน API เวอร์ชัน 2 พารามิเตอร์ orderby จะช่วยให้คุณจัดเรียงวิดีโอในเพลย์ลิสต์ตามตำแหน่ง ระยะเวลา วันที่เผยแพร่ ชื่อ และค่าอื่นๆ ได้อีกมากมาย ใน API เวอร์ชัน 3 โดยทั่วไปแล้วรายการเพลย์ลิสต์จะจัดเรียงตามลำดับจากน้อยไปมาก และตัวเลือกการจัดเรียงอื่นๆ จะใช้งานไม่ได้
  
  โดยมีข้อยกเว้นบางประการ ระบบจะเพิ่มวิดีโอที่อัปโหลด วิดีโอโปรด วิดีโอที่ชอบ หรือวิดีโอที่ดูล่าสุดโดยอัตโนมัติเป็นรายการแรก (snippet.position=0) สำหรับเพลย์ลิสต์ประเภทต่อไปนี้ ดังนั้น รายการเหล่านี้จึงจัดเรียงอย่างมีประสิทธิภาพตามลำดับจากใหม่สุดไปเก่าสุด ตามเวลาที่มีการเพิ่มสินค้าลงในรายการ
  - การอัปโหลดของผู้ใช้
  - วิดีโอโปรด
  - วิดีโอที่ชอบ
  - ประวัติการดู
  อย่างไรก็ตาม โปรดทราบว่ารายการใหม่ที่เพิ่มไปยังส่วน "ดูภายหลัง" เพลย์ลิสต์จะเพิ่มเป็นรายการสุดท้ายในรายการนั้น เพื่อให้จัดเรียงรายการอย่างมีประสิทธิภาพจากเก่าสุดไปใหม่สุด
- การประมวลผลแบบกลุ่ม – API v3 รองรับกรณีการใช้งานการประมวลผลเป็นกลุ่มรายการใดรายการหนึ่งที่ API v2 เคยรองรับ เมธอด channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list และ videos.list ของ v3 API ทั้งหมดรองรับพารามิเตอร์ 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` ออกจากทรัพยากรที่ส่งในเนื้อหาคำขอ หากต้องการให้รายการในเพลย์ลิสต์มีตำแหน่งที่เฉพาะเจาะจงในรายการ คุณต้องอัปเดตการตั้งค่าการจัดลำดับของเพลย์ลิสต์เป็นกำหนดเองก่อน คุณปรับการตั้งค่านี้ได้ในเครื่องมือจัดการวิดีโอของ YouTube
`forbidden (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 มีให้ในการอธิบายภาพยนตร์ ตัวอย่าง รายการทีวี ซีซันรายการทีวี และตอนต่างๆ ของรายการโทรทัศน์

14 มกราคม 2015

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล API ข้อมูลของ YouTube (v3) เพื่ออธิบายวิธีใช้ API เวอร์ชัน 3 ในการอัปโหลดวิดีโอโดยใช้ JavaScript (ดูรายละเอียดในส่วนอัปโหลดวิดีโอ) ฟังก์ชันนี้เทียบได้กับฟังก์ชันการอัปโหลดบนเบราว์เซอร์ที่ v2 API รองรับ โปรดทราบว่าการเปลี่ยนแปลงคำแนะนำในการย้ายข้อมูลนี้ไม่ได้แสดงถึงการเปลี่ยนแปลง API จริง แต่เป็นความพร้อมใช้งานของโค้ดตัวอย่างใหม่สำหรับการอัปโหลดวิดีโอด้วย JavaScript ฝั่งไคลเอ็นต์

เนื่องจากการรองรับการอัปโหลดวิดีโอด้วยไลบรารีของไคลเอ็นต์ JavaScript และ CORS คำแนะนำในการย้ายข้อมูลจะไม่แสดงการอัปโหลดผ่านเบราว์เซอร์ว่าเป็นฟีเจอร์ที่อาจเลิกใช้งานใน API เวอร์ชัน 3 อีกต่อไป
เอกสารสำหรับเมธอด videos.insert ได้รับการอัปเดตให้รวมตัวอย่างโค้ด JavaScript ใหม่ตามที่อธิบายไว้ข้างต้น มีการอัปเดตรายการตัวอย่างโค้ด JavaScript สำหรับ YouTube Data API (v3) ด้วย

11 พฤศจิกายน 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

ต้นทุนโควต้าสำหรับการเรียกเมธอด search.list เปลี่ยนเป็น 100 หน่วยแล้ว

สำคัญ: ในหลายกรณี คุณสามารถใช้เมธอด API อื่นๆ เพื่อเรียกข้อมูลด้วยค่าใช้จ่ายในโควต้าที่ต่ำกว่าได้ ตัวอย่างเช่น ลองพิจารณา 2 วิธีนี้ในการค้นหาวิดีโอที่อัปโหลดลงในช่อง GoogleDevelopers
- ต้นทุนโควต้า: 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 v2 อยู่ไปยัง API เวอร์ชันล่าสุด

8 กรกฎาคม 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

เมธอด playlists.insert รองรับข้อผิดพลาดต่อไปนี้แล้ว

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
`badRequest`	`maxPlaylistExceeded`	ข้อผิดพลาดนี้เกิดขึ้นหากไม่สามารถสร้างเพลย์ลิสต์ได้เนื่องจากช่องมีเพลย์ลิสต์ถึงจำนวนสูงสุดที่อนุญาตแล้ว

18 มิถุนายน 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

คำอธิบายเมธอด API แต่ละเมธอดได้รับการอัปเดตให้รวมต้นทุนโควต้าที่เกิดจากการเรียกใช้เมธอดนั้น ในทํานองเดียวกัน มีการอัปเดตคําจํากัดความของพารามิเตอร์ part เพื่อระบุต้นทุนโควต้าของแต่ละส่วนที่ดึงได้ในการเรียก API เช่น การเรียกใช้เมธอด subscriptions.insert จะมีต้นทุนโควต้าประมาณ 50 หน่วย ทรัพยากร subscription ยังมี 3 ส่วน (snippet, contentDetails และ subscriberSnippet) และแต่ละส่วนจะมีค่าใช้จ่าย 2 หน่วย

โปรดทราบว่าค่าใช้จ่ายสำหรับโควต้าอาจเปลี่ยนแปลงได้โดยไม่ต้องแจ้งให้ทราบ
ปัจจุบัน แหล่งข้อมูล video รองรับระบบการจัดประเภทเนื้อหาใหม่ 43 ระบบซึ่งระบุการจัดประเภทที่วิดีโอได้รับจากหน่วยงานการจัดประเภทระดับประเทศต่างๆ ระบบการจัดประเภทที่ได้รับการสนับสนุนใหม่นี้มาจากอาร์เจนตินา ออสเตรีย เบลเยียม และบัลแกเรีย ชิลี (ชิลี (1, ชิลี (1 และทั้งหมดนี้) มีตั้งแต่อาร์เจนตินา ออสเตรีย เบลเยียม และบัลแกเรีย ชิลี (ชิลีและชิลี (1, ชิลี (111118ต่อตั้งแต่คุณของประเทศและของประเทศอาร์เจนตินา ออสเตรีย เบลเยียม และบัลแกเรีย ชิลี (ชิลี) ชิลีและชิลี (1, ชิลี (1, 28. อย่าให้ประเทศและกระบวนการที่เราสนับสนุน{12

28 พฤษภาคม 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

ตอนนี้เมธอด search.list รองรับพารามิเตอร์ location และ locationRadius แล้ว ซึ่งจะช่วยให้คุณค้นหาวิดีโอที่เชื่อมโยงกับสถานที่ตั้งทางภูมิศาสตร์ได้ คำขอต้องระบุค่าของพารามิเตอร์ทั้ง 2 ตัวเพื่อดึงผลลัพธ์ตามตำแหน่ง และ API จะแสดงข้อผิดพลาดหากคำขอมีเพียงพารามิเตอร์เดียวจาก 2 พารามิเตอร์
- พารามิเตอร์ location ระบุพิกัดละติจูด/ลองจิจูดที่ศูนย์กลางของพื้นที่ทางภูมิศาสตร์ที่เป็นวงกลม
- พารามิเตอร์ locationRadius จะระบุระยะทางสูงสุดที่ตำแหน่งที่เชื่อมโยงกับวิดีโอจะต้องอยู่ตรงกึ่งกลางของพื้นที่เพื่อให้วิดีโอยังคงรวมอยู่ในผลการค้นหา

13 พฤษภาคม 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

พร็อพเพอร์ตี้ invideoPromotion.items[] ของทรัพยากร channel ได้รับการอัปเดตแล้วโปรดทราบว่าโดยปกติแล้วคุณจะตั้งค่ารายการที่โปรโมตสำหรับช่องของคุณได้ 1 รายการเท่านั้น หากคุณพยายามแทรกรายการที่โปรโมตจำนวนมากเกินไป API จะแสดงผลข้อผิดพลาด tooManyPromotedItems ซึ่งมีรหัสสถานะ HTTP 400
ตอนนี้แหล่งข้อมูล channelSection จะมีข้อมูลเกี่ยวกับเนื้อหาเด่นประเภทใหม่ 2-3 ประเภท พร็อพเพอร์ตี้ snippet.type ของทรัพยากร channelSection รองรับค่าต่อไปนี้แล้ว
- postedPlaylists - เพลย์ลิสต์ที่เจ้าของช่องโพสต์ลงในฟีดกิจกรรมของช่อง
- postedVideos - วิดีโอที่เจ้าของช่องโพสต์ลงในฟีดกิจกรรมของช่อง
- subscriptions - ช่องที่เจ้าของช่องติดตาม
พร็อพเพอร์ตี้ contentDetails.contentRating.ifcoRating ใหม่ของทรัพยากร video ระบุการจัดประเภทที่วิดีโอได้รับจากสำนักงานการจัดประเภทภาพยนตร์ของไอร์แลนด์ (Irish Film Classification Office)
อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ position.cornerPosition ของทรัพยากร watermark แล้ว โปรดทราบว่าลายน้ำจะปรากฏที่มุมขวาบนของโปรแกรมเล่นเสมอ
อัปเดตคําจํากัดความของพารามิเตอร์ q สําหรับเมธอด search.list แล้ว โปรดทราบว่าคําค้นหาสามารถใช้โอเปอเรเตอร์บูลีน NOT (-) เพื่อยกเว้นวิดีโอที่เชื่อมโยงกับข้อความค้นหาหนึ่งๆ ได้ ค่ายังสามารถใช้โอเปอเรเตอร์บูลีน OR (|) เพื่อค้นหาวิดีโอที่เชื่อมโยงกับหนึ่งในข้อความค้นหาต่างๆ ได้อีกด้วย
คําจํากัดความของพร็อพเพอร์ตี้ pageInfo.totalResults ที่แสดงผลในการตอบกลับของ API ต่อการเรียก search.list ได้รับการอัปเดตแล้วเนื่องจากค่าดังกล่าวเป็นค่าประมาณและอาจไม่ได้แสดงค่าที่แน่นอน นอกจากนี้ ค่าสูงสุดคือ 1,000,000 คุณไม่ควรใช้ค่านี้เพื่อสร้างลิงก์การใส่เลขหน้า ให้ใช้ค่าพร็อพเพอร์ตี้ nextPageToken และ prevPageToken แทนเพื่อกำหนดว่าจะแสดงลิงก์การใส่เลขหน้าหรือไม่
ระบบได้อัปเดตเมธอด watermarks.set และ watermarks.unset เพื่อแสดงให้เห็นว่า API ส่งโค้ดตอบกลับ HTTP 204 สำหรับคำขอที่ส่งไปยังเมธอดเหล่านั้นได้สำเร็จ

2 พฤษภาคม 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

แหล่งข้อมูลใหม่ i18nLanguage ระบุภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ ภาษาของแอปพลิเคชันอาจหมายถึงภาษา UI ได้เช่นกัน สำหรับเว็บไซต์ YouTube ระบบจะเลือกภาษาของแอปพลิเคชันให้โดยอัตโนมัติตามการตั้งค่าบัญชี Google, ภาษาของเบราว์เซอร์ หรือตำแหน่ง IP นอกจากนี้ผู้ใช้ยังเลือกภาษา UI ที่ต้องการด้วยตนเองจากส่วนท้ายของเว็บไซต์ YouTube ได้อีกด้วย

API รองรับเมธอดในการแสดงภาษาของแอปพลิเคชันที่รองรับ ภาษาที่รองรับสามารถใช้เป็นค่าของพารามิเตอร์ hl เมื่อเรียกใช้เมธอด API เช่น videoCategories.list และ guideCategories.list
ทรัพยากร i18nRegion ใหม่จะระบุพื้นที่ทางภูมิศาสตร์ที่ผู้ใช้ YouTube สามารถเลือกเป็นภูมิภาคของเนื้อหาที่ต้องการได้ ภูมิภาคของเนื้อหาอาจหมายถึงภาษาของเนื้อหาได้เช่นกัน สำหรับเว็บไซต์ YouTube อาจมีการเลือกภูมิภาคของเนื้อหาโดยอัตโนมัติตามการเรียนรู้ เช่น โดเมน YouTube หรือตำแหน่ง IP ของผู้ใช้ และผู้ใช้สามารถเลือกภูมิภาคเนื้อหาที่ต้องการด้วยตนเองได้จากส่วนท้ายของเว็บไซต์ YouTube

API รองรับเมธอดในการแสดงรายการภูมิภาคเนื้อหาที่รองรับ รหัสภูมิภาคที่รองรับสามารถใช้เป็นค่าของพารามิเตอร์ 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

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

พร็อพเพอร์ตี้ status.publishAt ใหม่ของทรัพยากร video ช่วยให้คุณระบุวันที่และเวลาที่กำหนดให้เผยแพร่วิดีโอส่วนตัวได้ คุณจะตั้งค่าพร็อพเพอร์ตี้นี้ได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอคือ private และไม่เคยมีการเผยแพร่วิดีโอ พร็อพเพอร์ตี้ใหม่นี้ไม่อยู่ภายใต้นโยบายการเลิกใช้งาน

13 มีนาคม 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

API รองรับส่วน contentOwnerDetails สำหรับทรัพยากร channel แล้ว ส่วนใหม่จะมีข้อมูลช่องที่เกี่ยวข้องกับพาร์ทเนอร์ YouTube ที่ลิงก์กับช่อง ซึ่งรวมถึงรหัสของเจ้าของเนื้อหาที่ลิงก์กับช่อง ตลอดจนวันที่และเวลาที่เจ้าของเนื้อหากับช่องลิงก์กัน โปรดทราบว่าส่วนใหม่นี้ไม่อยู่ภายใต้นโยบายการเลิกใช้งาน

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

ทรัพยากร	พร็อพเพอร์ตี้	ความยาวสูงสุด
`channel`	`invideoPromotion.items[].customMessage`	40 อักขระ
`video`	`snippet.title`	100 อักขระ
`video`	`snippet.description`	5000 ไบต์
`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` ต้องระบุออบเจ็กต์ `invideoPromotion.items[].timing` สำหรับแต่ละรายการที่โปรโมต
`required (400)`	`requiredWebsiteUrl`	เมธอด `channels.update` ต้องระบุพร็อพเพอร์ตี้ `invideoPromotion.items[].id.websiteUrl` สำหรับรายการที่โปรโมตแต่ละรายการ
`badRequest (400)`	`invalidPublishAt`	เมธอด `videos.insert` จะแสดงผลข้อผิดพลาดนี้หากข้อมูลเมตาของคำขอระบุเวลาการเผยแพร่ที่กำหนดไว้ไม่ถูกต้อง

4 มีนาคม 2014

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

ขณะนี้ API ข้อมูลของ YouTube เวอร์ชัน 3 จะอยู่ภายใต้นโยบายการเลิกใช้งานที่อธิบายไว้ในข้อกำหนดในการให้บริการ API ของ YouTube โปรดทราบว่าหน้าที่แสดง API ที่อยู่ภายใต้นโยบายการเลิกใช้งานจะยกเว้นฟังก์ชันการทำงานของ API v3 บางอย่างไม่ให้เป็นไปตามนโยบาย

5 ธันวาคม 2013

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

เอกสารประกอบของเมธอด search.list ได้รับการอัปเดตอย่างเหมาะสมเพื่อแสดงให้เห็นว่าคุณไม่จำเป็นต้องระบุค่าสำหรับพารามิเตอร์ตัวกรอง 1 รายการเมื่อส่งคำขอการค้นหา แต่คุณสามารถกำหนดค่าให้กับพารามิเตอร์ตัวกรองเป็นศูนย์ หรือสำหรับพารามิเตอร์ตัวกรองหนึ่งรายการได้
อัปเดตคําจํากัดความสําหรับพารามิเตอร์ของเมธอด search.list แล้ว โปรดทราบว่าคุณต้องตั้งค่าของพารามิเตอร์ type เป็น video หากระบุค่าสําหรับพารามิเตอร์ใดๆ ต่อไปนี้ด้วย
- eventType
- videoCaption
- videoCategoryId
- videoDefinition
- videoDimension
- videoDuration
- videoEmbeddable
- videoLicense
- videoSyndicated
- videoType
ขนาดขั้นต่ำของรูปภาพแบนเนอร์ของช่องที่อัปโหลดได้ลดลงเป็น 2048px x 1152px (ก่อนหน้านี้ ขนาดขั้นต่ำคือ 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 ซึ่งได้แก่ พารามิเตอร์ eventType ของเมธอด search.list และพร็อพเพอร์ตี้ 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 (เวอร์ชัน 6) – จำกัดสำหรับผู้ที่มีอายุตั้งแต่ 6 ปีขึ้นไป
- mibacVm12 (V.M.12) – จำกัดสำหรับผู้ที่มีอายุ 12 ปีขึ้นไป
พร็อพเพอร์ตี้ invideoPromotion.items[].promotedByContentOwner ใหม่ของทรัพยากร channel ระบุว่าชื่อของเจ้าของเนื้อหาจะปรากฏเมื่อแสดงโปรโมชันหรือไม่ ตั้งค่าช่องนี้ได้เฉพาะในกรณีที่มีการสร้างคำขอ 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 ได้เปลี่ยนจากออบเจ็กต์เป็นสตริง ตอนนี้พร็อพเพอร์ตี้ targetChannelId จะระบุค่านั้นของตัวเอง แทนที่จะมีพร็อพเพอร์ตี้ย่อยที่ระบุรหัสช่อง YouTube ของช่องที่รูปภาพที่มีลายน้ำลิงก์อยู่ ด้วยเหตุนี้ ระบบจึงนำพร็อพเพอร์ตี้ 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 แล้ว มีการรองรับพารามิเตอร์ทั้งสองสำหรับวิธีการอื่นๆ อยู่แล้ว
ตอนนี้เมธอด 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 แล้ว มีการรองรับพารามิเตอร์ทั้งสองสำหรับวิธีการอื่นๆ อยู่แล้ว
ในการตอบกลับ 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

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

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 ต้องระบุพารามิเตอร์ที่แน่ชัด 1 รายการ (ก่อนหน้านี้ พารามิเตอร์ 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 (ทับทิม)
- playlistItems.list (.NET)
- search.list (.NET)
- subscriptions.insert (Java, Ruby)
- videos.insert (.NET, ทับทิม)
พารามิเตอร์ mySubscribers ใหม่ของเมธอด subscriptions.list ช่วยให้คุณเรียกข้อมูลรายการสมาชิกของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบันได้ สามารถใช้พารามิเตอร์นี้ในคำขอที่ได้รับอนุญาตอย่างถูกต้องเท่านั้น

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

ประเทศ	ระบบการจัดประเภท	พร็อพเพอร์ตี้
สหรัฐอเมริกา	สมาคมภาพยนตร์แห่งสหรัฐอเมริกา (MPAA)	`contentDetails.contentRating.mpaaRating`
สหรัฐอเมริกา	TV Parental Guidelines	`contentDetails.contentRating.tvpgRating`
ออสเตรเลีย	คณะกรรมการการจัดประเภทแห่งออสเตรเลีย (ACB)	`contentDetails.contentRating.acbRating`
บราซิล	Departamento de Justiça, Classificação, Qualificação e Títulos	`contentDetails.contentRating.djctqRating`
แคนาดา	ระบบการจัดเรตโฮมวิดีโอของแคนาดา (CHVRS)	`contentDetails.contentRating.chvrsRating`
ฝรั่งเศส	Centre National du cinéma et de l'image animée (กระทรวงวัฒนธรรมของฝรั่งเศส)	`contentDetails.contentRating.fmocRating`
เยอรมนี	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	`contentDetails.contentRating.fskRating`
สหราชอาณาจักร	คณะกรรมการการจัดประเภทภาพยนตร์ของอังกฤษ (British Board of Film Classification หรือ BBFC)	`contentDetails.contentRating.bbfcRating`
อินเดีย	Central Board of Film Certification (CBFC)	`contentDetails.contentRating.cbfcRating`
ญี่ปุ่น	映倫管の委員会 (EIRIN)	`contentDetails.contentRating.eirinRating`
เกาหลี	영상물이springตอบรีวิวบาร์ และอาจเรียกว่า KMRB)	`contentDetails.contentRating.kmrbRating`
เม็กซิโก	คณะกรรมการทั่วไปด้านวิทยุ โทรทัศน์ และการถ่ายทำภาพยนตร์ (RTC)	`contentDetails.contentRating.rtcRating`
นิวซีแลนด์	ฝ่ายการจัดประเภทภาพยนตร์และวรรณกรรม	`contentDetails.contentRating.oflcRating`
รัสเซีย	สำนักทะเบียนภาพยนตร์แห่งชาติสหพันธรัฐรัสเซีย	`contentDetails.contentRating.russiaRating`
สเปน	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 specifies invalid recording details.`
`badRequest`	`invalidVideoGameRating`	ข้อมูลเมตาของคำขอระบุการจัดประเภทวิดีโอเกมที่ไม่ถูกต้อง
`badRequest`	`invalidVideoMetadata`	ข้อมูลเมตาของคำขอไม่ถูกต้อง

นำพารามิเตอร์ onBehalfOfContentOwner ออกจากรายการพารามิเตอร์ที่รองรับสำหรับเมธอด videos.update และ videos.delete แล้ว

12 มีนาคม 2013

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

เพิ่มพร็อพเพอร์ตี้ channelTitle ใน snippet สำหรับทรัพยากรต่อไปนี้แล้ว
- activity – พร็อพเพอร์ตี้จะระบุชื่อของช่องที่รับผิดชอบกิจกรรม
- search – พร็อพเพอร์ตี้จะระบุชื่อของแชแนลที่เชื่อมโยงกับทรัพยากรที่ผลการค้นหาระบุ
- video – พร็อพเพอร์ตี้จะระบุชื่อช่องที่อัปโหลดวิดีโอ
เมธอด search.list รองรับพารามิเตอร์ใหม่ต่อไปนี้
- พารามิเตอร์ channelType ช่วยให้คุณจำกัดการค้นหาแชแนลเพื่อดึงข้อมูลแชแนลทั้งหมดหรือเพื่อดึงเฉพาะรายการเท่านั้นได้
- พารามิเตอร์ videoType ช่วยให้คุณจำกัดการค้นหาวิดีโอเพื่อเรียกวิดีโอทั้งหมด หรือดึงเฉพาะภาพยนตร์หรือเฉพาะตอนของรายการทีวีได้
อัปเดตคําจํากัดความของส่วน recordingDetails ของทรัพยากร video แล้ว โปรดทราบว่าระบบจะส่งคืนออบเจ็กต์ในวิดีโอเท่านั้นหากมีการตั้งค่าข้อมูลตำแหน่งทางภูมิศาสตร์หรือเวลาในการบันทึกของวิดีโอไว้
ตอนนี้เมธอด 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 – ระบุว่าสามารถฝังวิดีโอในเว็บไซต์อื่นได้หรือไม่
  - 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 – Java
- playlistItems.insert – Python
- playlistItems.list – Java, JavaScript, PHP, Python, Ruby
- playlists.insert – Java, JavaScript, Python
- search.list – Java, JavaScript, Python, Ruby
- videos.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 เพื่อเรียกดูรายการค่าที่ถูกต้อง