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

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

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

30 ตุลาคม 2024

ตอนนี้ API รองรับความสามารถในการระบุวิดีโอที่มีเนื้อหาดัดแปลงหรือสังเคราะห์ (A/S) ซึ่งดูสมจริง ดูข้อมูลเพิ่มเติมเกี่ยวกับนโยบายของ YouTube ที่เกี่ยวข้องกับเนื้อหาการซ่อมและบำรุงรักษา

ตัวอย่างเนื้อหาเกี่ยวกับการดูแลและซ่อมบำรุง ได้แก่ วิดีโอที่มีลักษณะต่อไปนี้

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

หากต้องการระบุว่าวิดีโอมีเนื้อหา A/S หรือไม่ ให้ตั้งค่าพร็อพเพอร์ตี้ status.containsSyntheticMedia คุณสามารถตั้งค่าพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด videos.insert หรือ videos.update หากตั้งค่าไว้ ระบบจะแสดงพร็อพเพอร์ตี้ในทรัพยากร video

30 เมษายน 2024

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

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

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

13 มีนาคม 2024

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

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

พารามิเตอร์ sync สำหรับเมธอด captions.insert และ captions.update เลิกใช้งานแล้ว YouTube จะหยุดรองรับพารามิเตอร์ดังกล่าวตั้งแต่วันที่ 12 เมษายน 2024

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

12 มีนาคม 2024

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

เอกสารประกอบสำหรับทรัพยากร captions ได้รับการอัปเดตเพื่อระบุว่าความยาวสูงสุดที่อนุญาตสำหรับช่อง snippet.name นั้นคือ 150 อักขระ API จะแสดงข้อผิดพลาด nameTooLong หากชื่อแทร็กยาวเกิน 255 อักขระ

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 เราได้เลิกใช้งานพารามิเตอร์ relatedToVideoId ของเมธอด search.list แล้ว ระบบไม่รองรับพารามิเตอร์ดังกล่าวอีกต่อไปและนําการอ้างอิงพารามิเตอร์ออกจากเอกสารประกอบ API แล้ว

28 มิถุนายน 2023

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

12 มิถุนายน 2023

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

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

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

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

22 สิงหาคม 2022

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

5 สิงหาคม 2022

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

เราได้อัปเดตข้อกำหนดในการให้บริการของบริการ YouTube API แล้ว โปรดดูข้อมูลเพิ่มเติมที่ประวัติการแก้ไขข้อกำหนดในการให้บริการของบริการ API ของ YouTube

27 เมษายน 2022

เราได้อัปเดตคำอธิบายวิธีการ videos.insert เพื่อแจ้งให้ทราบว่าขนาดไฟล์สูงสุดของวิดีโอที่อัปโหลดได้เพิ่มขึ้นจาก 128 GB เป็น 256 GB

8 เมษายน 2022

เราได้อัปเดตทั้งคำจำกัดความของพารามิเตอร์ myRecentSubscribers และ mySubscribers ของเมธอด subscriptions.list เพื่อระบุว่า API อาจจํากัดจํานวนผู้ติดตามสูงสุดที่แสดง การเปลี่ยนแปลงนี้เป็นการแก้ไขเอกสารประกอบ ไม่ใช่การเปลี่ยนแปลงลักษณะการทํางานของ API

15 ธันวาคม 2021

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

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

18 พฤศจิกายน 2021

เนื่องด้วยการเปลี่ยนแปลงเพื่อทำให้จำนวนการกดไม่ชอบวิดีโอเป็นแบบส่วนตัวทั่วทั้งแพลตฟอร์ม YouTube ระบบจะเปลี่ยนstatistics.dislikeCount พร็อพเพอร์ตี้ของvideoทรัพยากรเป็นส่วนตัวตั้งแต่วันที่ 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 หน่วย จนถึงปัจจุบัน นักพัฒนาแอปต้องกรอกและส่งแบบฟอร์มบริการ API ของ YouTube - การตรวจสอบและการขยายโควต้าเพื่อดำเนินการทั้งกระบวนการตรวจสอบการปฏิบัติตามข้อกำหนดและคำขอจัดสรรหน่วยโควต้าเพิ่มเติม

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

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

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

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

12 พฤษภาคม 2021

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

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

เลิกใช้งานพร็อพเพอร์ตี้ contentDetails.relatedPlaylists.favorites ของทรัพยากร channel แล้ว เราได้เลิกใช้งานฟังก์ชันวิดีโอที่ชอบไปหลายปีแล้วตามที่ระบุไว้ในรายการประวัติการแก้ไขวันที่ 28 เมษายน 2016

ก่อนการอัปเดตนี้ API จะยังคงสร้างเพลย์ลิสต์ใหม่หากไคลเอ็นต์ API พยายามเพิ่มวิดีโอลงในเพลย์ลิสต์รายการโปรดที่ไม่มีอยู่ นับจากนี้ไป ระบบจะไม่สร้างเพลย์ลิสต์ในกรณีนี้และ API จะแสดงข้อผิดพลาด นอกจากนี้ เรายังไม่แนะนำให้พยายามแก้ไขเพลย์ลิสต์รายการโปรดด้วยการเพิ่ม แก้ไข หรือลบรายการต่างๆ ตามประกาศก่อนหน้านี้ และอาจเริ่มแสดงข้อผิดพลาดได้ทุกเมื่อ
เราได้เลิกใช้งานพร็อพเพอร์ตี้ทรัพยากร channel ต่อไปนี้แล้ว พร็อพเพอร์ตี้เหล่านี้ไม่รองรับใน UI ของ YouTube Studio และบน YouTube อยู่แล้ว ด้วยเหตุนี้ ระบบจึงไม่รองรับการเรียกใช้ผ่าน API อีกต่อไป
- brandingSettings.channel.defaultTab
- brandingSettings.channel.featuredChannelsTitle
- brandingSettings.channel.featuredChannelsUrls[]
- brandingSettings.channel.profileColor
- brandingSettings.channel.showBrowseView
- brandingSettings.channel.showRelatedChannels
ระบบได้นำพร็อพเพอร์ตี้ทั้งหมดออกจากchannelการนําเสนอทรัพยากร และนําคําจํากัดความของพร็อพเพอร์ตี้เหล่านั้นออกจากรายการพร็อพเพอร์ตี้ของทรัพยากรแล้ว นอกจากนี้ เรายังได้นําข้อผิดพลาดที่เชื่อมโยงกับพร็อพเพอร์ตี้เหล่านี้ออกจากเอกสารประกอบเฉพาะวิธีการด้วย
เราได้เลิกใช้งานพร็อพเพอร์ตี้ทรัพยากร channelSection ต่อไปนี้แล้ว พร็อพเพอร์ตี้เหล่านี้ไม่รองรับใน UI ของ YouTube Studio และบน YouTube อยู่แล้ว ด้วยเหตุนี้ ระบบจึงไม่รองรับการเรียกใช้ผ่าน API อีกต่อไป
- snippet.style
- snippet.defaultLanguage
- snippet.localized.title
- localizations
- localizations.(key)
- localizations.(key).title
- targeting
- targeting.languages[]
- targeting.regions[]
- targeting.countries[]
ควบคู่ไปกับการเปลี่ยนแปลงนี้ เรายังได้เลิกใช้งานพารามิเตอร์ hl ของเมธอด channelSection.list ด้วยเนื่องจากระบบไม่รองรับฟีเจอร์ที่พารามิเตอร์ดังกล่าวรองรับ

ระบบได้นำพร็อพเพอร์ตี้ทั้งหมดออกจากchannelSectionการนําเสนอทรัพยากร และนําคําจํากัดความของพร็อพเพอร์ตี้เหล่านั้นออกจากรายการพร็อพเพอร์ตี้ของทรัพยากรแล้ว นอกจากนี้ เรายังได้นําข้อผิดพลาดที่เชื่อมโยงกับพร็อพเพอร์ตี้เหล่านี้ออกจากเอกสารประกอบเฉพาะวิธีการด้วย
สําหรับพร็อพเพอร์ตี้ snippet.type ของทรัพยากร channelSection ระบบเลิกใช้งานค่าต่อไปนี้แล้ว ค่าเหล่านี้ไม่รองรับในหน้าช่อง YouTube อยู่แล้ว และด้วยเหตุนี้ ระบบจึงไม่รองรับค่าเหล่านี้ผ่าน API อีกต่อไป
- likedPlaylists
- likes
- postedPlaylists
- postedVideos
- recentActivity
- recentPosts
เลิกใช้งานพร็อพเพอร์ตี้ snippet.tags[] ของทรัพยากร playlist แล้ว พร็อพเพอร์ตี้นี้ไม่รองรับบน YouTube อยู่แล้ว จึงไม่มีการรองรับผ่าน API อีกต่อไป

9 กุมภาพันธ์ 2021

ทรัพยากร playlistItem รองรับพร็อพเพอร์ตี้ใหม่ 2 รายการ ได้แก่

พร็อพเพอร์ตี้ snippet.videoOwnerChannelId ระบุรหัสของช่องที่อัปโหลดวิดีโอในเพลย์ลิสต์
พร็อพเพอร์ตี้ snippet.videoOwnerChannelTitle ระบุชื่อของช่องที่อัปโหลดวิดีโอในเพลย์ลิสต์

28 มกราคม 2021

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

วิธีการ playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list และ playlists.update ทั้งหมดรองรับข้อผิดพลาด playlistOperationUnsupported รูปแบบใหม่ ข้อผิดพลาดนี้เกิดขึ้นเมื่อคําขอพยายามดําเนินการที่ไม่อนุญาตสําหรับเพลย์ลิสต์หนึ่งๆ เช่น ผู้ใช้จะลบวิดีโอออกจากเพลย์ลิสต์วิดีโอที่อัปโหลดหรือลบเพลย์ลิสต์นั้นไม่ได้

ไม่ว่าในกรณีใดก็ตาม ข้อผิดพลาดนี้จะแสดงรหัสการตอบกลับ HTTP 400 (Bad Request)
ข้อผิดพลาด watchHistoryNotAccessible และ watchLaterNotAccessible ของเมธอด playlistItems.list ถูกนำออกจากเอกสารประกอบแล้ว แม้ว่าประวัติการดูและรายการ "ดูภายหลัง" ของผู้ใช้จะเข้าถึงผ่าน API ไม่ได้ แต่ API ก็ไม่ได้แสดงข้อผิดพลาดเหล่านี้

15 ตุลาคม 2020

เราได้เพิ่มส่วนใหม่ 2 ส่วนลงในนโยบายสําหรับนักพัฒนาแอป ดังนี้

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

คู่มือการค้นหาสถานะ "สร้างมาเพื่อเด็ก" ของวิดีโอใหม่อธิบายวิธีค้นหาสถานะ MFK ของวิดีโอโดยใช้บริการ YouTube Data API

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

8 ตุลาคม 2020

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

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

9 กันยายน 2020

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

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

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

29 กรกฎาคม 2020

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

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

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

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

28 กรกฎาคม 2020

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

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

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

21 กรกฎาคม 2020

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

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

7 กรกฎาคม 2020

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

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

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

10 มกราคม 2020

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

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

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

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

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

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

10 กันยายน 2019

เอกสารอ้างอิง API ได้รับการอัปเดตเพื่อแสดงการเปลี่ยนแปลงวิธีรายงานจำนวนผู้ติดตามบน YouTube และในการตอบกลับของ API การเปลี่ยนแปลงนี้ส่งผลให้จำนวนผู้ติดตามที่บริการ YouTube Data API แสดงจะปัดเศษลงเป็นตัวเลขที่มีนัยสำคัญ 3 หลักสำหรับจำนวนผู้ติดตามที่มากกว่า 1,000 คน การเปลี่ยนแปลงนี้จะส่งผลต่อพร็อพเพอร์ตี้ statistics.subscriberCount ของchannel

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

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

โปรดทราบว่าการเปลี่ยนแปลงที่อธิบายข้างต้นจะแทนที่เครื่องมือแบบอินเทอร์แอกทีฟที่เพิ่มลงในเอกสารประกอบ API ในปี 2017

9 กรกฎาคม 2018

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

เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ snippet.thumbnails ของทรัพยากร channel เพื่อระบุว่าเมื่อแสดงภาพขนาดย่อในแอปพลิเคชัน โค้ดของคุณควรใช้ URL ของรูปภาพตามที่ได้รับในคำตอบของ API ตัวอย่างเช่น แอปพลิเคชันไม่ควรใช้โดเมน http แทนโดเมน https ใน URL ที่แสดงในคำตอบของ API

ตั้งแต่เดือนกรกฎาคม 2018 เป็นต้นไป URL ของภาพปกช่องจะมีให้บริการในโดเมน https เท่านั้น ซึ่งเป็นลักษณะที่ URL จะปรากฏในการตอบกลับของ API หลังจากเวลาดังกล่าว คุณอาจเห็นรูปภาพที่ใช้งานไม่ได้ในแอปพลิเคชันหากแอปพยายามโหลดรูปภาพ YouTube จากโดเมน http
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

เลิกใช้งานพร็อพเพอร์ตี้ recordingDetails.location.altitude ของทรัพยากร video แล้ว ไม่มีการรับประกันว่าวิดีโอจะแสดงค่าสำหรับพร็อพเพอร์ตี้นี้ ในทํานองเดียวกัน แม้ว่าคําขอ API จะพยายามตั้งค่าพร็อพเพอร์ตี้นั้น แต่ระบบอาจไม่จัดเก็บข้อมูลที่เข้ามา

22 มิถุนายน 2018

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

27 พฤศจิกายน 2017

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

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

YouTube จะหยุดรองรับฟีเจอร์วิดีโอเด่นและเว็บไซต์เด่น ซึ่งรองรับใน API ผ่านออบเจ็กต์ invideoPromotion ของทรัพยากร channel ดังนั้น เราจึงเลิกใช้งานออบเจ็กต์นั้น รวมถึงพร็อพเพอร์ตี้ย่อยทั้งหมด

คุณจะยังคงเรียกข้อมูลและตั้งค่า invideoPromotion ได้จนถึงวันที่ 14 ธันวาคม 2017 สิ่งที่จะเกิดขึ้นหลังจากวันที่ดังกล่าว
- การพยายามดึงข้อมูลส่วน invideoPromotion เมื่อเรียกใช้ channels.list จะแสดงผล invideoPromotion ว่างเปล่าหรือไม่แสดงข้อมูล invideoPromotion ใดๆ เลย
- การพยายามอัปเดตข้อมูล invideoPromotion เมื่อเรียกใช้ channels.update จะแสดงผลลัพธ์ที่สำเร็จจนถึงวันที่ 27 พฤษภาคม 2018 เป็นอย่างน้อย แต่ระบบจะถือว่าการพยายามดังกล่าวเป็นการดำเนินการที่ไม่มีผล ซึ่งหมายความว่าจะไม่ทำการอัปเดตจริง
หลังจากวันที่ 27 พฤษภาคม 2018 เป็นต้นไป คำขอเหล่านี้อาจแสดงข้อความแสดงข้อผิดพลาดเพื่อระบุว่า invalidPromotion เป็นส่วนที่ไม่ถูกต้อง เป็นต้น

16 พฤศจิกายน 2017

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

ตอนนี้เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟรองรับตัวอย่างโค้ด Node.js แล้ว ตัวอย่างจะแสดงในเอกสารประกอบสําหรับเมธอด API เกือบทั้งหมดด้วย เช่น เมธอด channels.list

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

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

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

27 เมษายน 2017

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

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

30 มีนาคม 2017

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

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

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

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

รายการรหัสหัวข้อที่รองรับตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 จะมีการเปลี่ยนแปลงเล็กๆ น้อยๆ 3 รายการ ดังนี้
- หมวดหมู่ Professional wrestling ซึ่งก่อนหน้านี้เป็นหมวดหมู่ย่อยของ Sports ตอนนี้เป็นหมวดหมู่ย่อยของ Entertainment
- หมวดหมู่ TV shows ซึ่งเป็นหมวดหมู่ย่อยของ Entertainment เป็นหมวดหมู่ใหม่
- ระบบได้นำหมวดหมู่ Health ซึ่งก่อนหน้านี้เป็นหมวดหมู่ย่อยของ Lifestyle ออกแล้ว
นอกจากนี้ โปรดทราบว่ามีหมวดหมู่หลักเพียงไม่กี่หมวดหมู่ (Entertainment, Gaming, Lifestyle, Music และ Sports) วิดีโอที่เชื่อมโยงกับหมวดหมู่ย่อย เช่น Tennis จะเชื่อมโยงกับหมวดหมู่หลัก (Sports) ด้วย

10 พฤศจิกายน 2016

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

ตามที่ประกาศไว้ครั้งแรกเมื่อวันที่ 11 สิงหาคม 2016 การเลิกใช้งาน Freebase และ Freebase API ทำให้เกิดการเปลี่ยนแปลงหลายอย่างที่เกี่ยวข้องกับรหัสหัวข้อ รหัสหัวข้อจะระบุหัวข้อที่เชื่อมโยงกับทรัพยากร channel และ video นอกจากนี้ คุณยังใช้พารามิเตอร์การค้นหา topicId เพื่อค้นหาช่องหรือวิดีโอที่เกี่ยวข้องกับหัวข้อหนึ่งๆ ได้ด้วย

ในวันที่ 10 กุมภาพันธ์ 2017 เป็นต้นไป YouTube จะเริ่มแสดงรหัสหัวข้อชุดเล็กๆ แทนรหัสชุดละเอียดที่แสดงมาจนถึงตอนนี้ นอกจากนี้ โปรดทราบว่าเราไม่รับประกันว่าช่องและวิดีโอจะเชื่อมโยงกับหัวข้อใดๆ ซึ่งสอดคล้องกับลักษณะการทํางานของ API ปัจจุบัน

เราได้อัปเดตคําจํากัดความของพารามิเตอร์และพร็อพเพอร์ตี้ API ต่อไปนี้เพื่อแสดงรหัสหัวข้อที่ระบบจะรองรับหลังจากวันที่ดังกล่าว เพื่อให้คุณเตรียมไคลเอ็นต์ API สําหรับการเปลี่ยนแปลงเหล่านั้นได้ โปรดทราบว่ารายการหมวดหมู่จะเหมือนกันสำหรับพร็อพเพอร์ตี้ทั้งหมด
- พร็อพเพอร์ตี้ topicDetails.topicIds[] ของทรัพยากร channel
- พร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] ของทรัพยากร video
- พารามิเตอร์ topicId ของเมธอด search.list
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

เราจะเลิกใช้งานพร็อพเพอร์ตี้ต่อไปนี้
- พร็อพเพอร์ตี้ topicDetails.topicIds[] ของทรัพยากร channel ระบบจะรองรับพร็อพเพอร์ตี้นี้จนถึงวันที่ 10 พฤศจิกายน 2017
- พร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] ของทรัพยากร video ระบบจะรองรับพร็อพเพอร์ตี้นี้จนถึงวันที่ 10 พฤศจิกายน 2017
- พร็อพเพอร์ตี้ topicDetails.topicIds[] ของทรัพยากร video พร็อพเพอร์ตี้นี้จะไม่มีค่าหลังจากวันที่ 10 กุมภาพันธ์ 2017 (หลังจากวันที่ดังกล่าว ค่าพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] จะระบุหัวข้อทั้งหมดที่เชื่อมโยงกับวิดีโอ)
เนื่องจากเราเลิกใช้งาน Freebase แล้ว เราจึงนำคู่มือการค้นหาด้วยหัวข้อ Freebase ออกจากเอกสารประกอบ คู่มือดังกล่าวมีตัวอย่างโค้ดเพื่อแสดงวิธีที่แอปพลิเคชันจะทำงานร่วมกับ Freebase API

นอกจากนี้ เราได้นําโค้ดตัวอย่างหลายรายการที่เกี่ยวข้องกับรหัสหัวข้อออกจากเอกสารประกอบของเมธอด search.list แล้ว

2 พฤศจิกายน 2016

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

พร็อพเพอร์ตี้และพารามิเตอร์ใหม่
- แหล่งข้อมูล video มีพร็อพเพอร์ตี้ใหม่หลายรายการ ดังนี้
  - พร็อพเพอร์ตี้ player.embedHtml มีแท็ก <iframe> ที่คุณสามารถใช้เพื่อฝังเพลเยอร์ที่เล่นวิดีโอ พร็อพเพอร์ตี้ player.embedHeight และ player.embedWidth ใหม่จะระบุขนาดของเพลเยอร์แบบฝัง ระบบจะแสดงผลพร็อพเพอร์ตี้เหล่านี้เฉพาะในกรณีที่คําขอ API ระบุค่าสําหรับพารามิเตอร์ maxHeight หรือ maxWidth อย่างน้อย 1 รายการ เราจะอธิบายพารามิเตอร์ใหม่ 2 รายการนี้ในภายหลังในรายการประวัติการแก้ไขนี้
  - พร็อพเพอร์ตี้ hasCustomThumbnail ใหม่จะระบุว่าผู้อัปโหลดวิดีโอได้ระบุรูปภาพขนาดย่อที่กำหนดเองสำหรับวิดีโอหรือไม่ โปรดทราบว่าผู้อัปโหลดวิดีโอเท่านั้นที่เห็นพร็อพเพอร์ตี้นี้
  - fpbRatingReasons[] ใหม่จะระบุเหตุผลที่วิดีโอได้รับการจัดประเภท FPB (แอฟริกาใต้)
  - mcstRating ใหม่จะระบุการจัดประเภทที่วิดีโอได้รับในเวียดนาม
- เมธอด videos.list รองรับพารามิเตอร์ใหม่ 2 รายการ ได้แก่ maxHeight และ maxWidth คุณจะใช้พารามิเตอร์ใดพารามิเตอร์หนึ่งหรือทั้ง 2 พารามิเตอร์ก็ได้เมื่อดึงข้อมูลส่วน player ในทรัพยากร video
  
  โดยค่าเริ่มต้น ความสูงของ <iframe> ที่แสดงในพร็อพเพอร์ตี้ player.embedHtml คือ 360 พิกเซล โดยระบบจะปรับความกว้างให้ตรงกับสัดส่วนภาพของวิดีโอ เพื่อให้มั่นใจว่าวิดีโอเพลเยอร์ที่ฝังจะไม่มีแถบสีดำล้อมรอบวิดีโอ ตัวอย่างเช่น หากอัตราส่วนภาพของวิดีโอคือ 16:9 ความกว้างของโปรแกรมเล่นจะเป็น 640 พิกเซล
  
  เมื่อใช้พารามิเตอร์ใหม่ คุณจะระบุได้ว่าโค้ดการฝังควรใช้ความสูงและ/หรือความกว้างที่เหมาะสมกับเลย์เอาต์แอปพลิเคชันแทนขนาดเริ่มต้น เซิร์ฟเวอร์ API จะปรับขนาดของเพลเยอร์ตามความเหมาะสมเพื่อให้มั่นใจว่าวิดีโอเพลเยอร์แบบฝังจะไม่มีแถบสีดำล้อมรอบวิดีโอ โปรดทราบว่าทั้ง 2 พารามิเตอร์ระบุขนาดสูงสุดของโปรแกรมเล่นที่ฝัง ดังนั้น หากระบุทั้ง 2 พารามิเตอร์ มิติข้อมูลหนึ่งอาจยังน้อยกว่าจำนวนสูงสุดที่อนุญาตสําหรับมิติข้อมูลนั้น
  
  ตัวอย่างเช่น สมมติว่าวิดีโอมีสัดส่วนภาพ 16:9 ดังนั้น แท็ก player.embedHtml จะมีเพลเยอร์ขนาด 640x360 หากไม่ได้ตั้งค่าพารามิเตอร์ maxHeight หรือ maxWidth
  - หากตั้งค่าพารามิเตอร์ maxHeight เป็น 720 และไม่ได้ตั้งค่าพารามิเตอร์ maxWidth ไว้ API จะแสดงผลโปรแกรมเล่นขนาด 1280x720
  - หากตั้งค่าพารามิเตอร์ maxWidth เป็น 960 และไม่ได้ตั้งค่าพารามิเตอร์ maxHeight API จะแสดงผลโปรแกรมเล่นขนาด 960x540
  - หากตั้งค่าพารามิเตอร์ maxWidth เป็น 960 และตั้งค่าพารามิเตอร์ maxHeight เป็น 450 API จะแสดงผลโปรแกรมเล่นขนาด 800x450
  พร็อพเพอร์ตี้ player.embedHeight และ player.embedWidth ใหม่ซึ่งอธิบายไว้ข้างต้นจะระบุขนาดของเพลเยอร์
การอัปเดตเมธอด พร็อพเพอร์ตี้ และแอตทริบิวต์ที่มีอยู่
- เราได้อัปเดตคำอธิบายแหล่งข้อมูล channelSection เพื่อระบุว่าช่องสามารถสร้างชั้นวางได้สูงสุด 10 ชั้นโดยไม่ต้องตั้งค่าข้อมูลการกําหนดเป้าหมาย และสามารถสร้างชั้นวางได้สูงสุด 100 ชั้นหากมีข้อมูลการกําหนดเป้าหมาย
  
  นอกจากนี้ เราได้อัปเดตพร็อพเพอร์ตี้ targeting ของทรัพยากร channelSection เพื่อแสดงถึงข้อเท็จจริงที่ว่าตัวเลือกการกำหนดเป้าหมายจะตั้งค่าได้โดยใช้ API เท่านั้น ระบบจะลบตัวเลือกการกำหนดเป้าหมายหากมีการแก้ไขส่วนช่องโดยใช้อินเทอร์เฟซผู้ใช้ในเว็บไซต์ YouTube
- แก้ไขคำจำกัดความของพร็อพเพอร์ตี้ snippet.name ของทรัพยากร i18nLanguage เพื่อระบุว่าค่าแสดงถึงชื่อภาษาตามที่เขียนในภาษาที่ระบุโดยพารามิเตอร์ hl ของเมธอด i18nLanguage.list
- เราได้อัปเดตพร็อพเพอร์ตี้ contentDetails.note ของทรัพยากร playlistItem เพื่อระบุว่าค่าพร็อพเพอร์ตี้มีความยาวสูงสุด 280 อักขระ
- เลิกใช้งานพร็อพเพอร์ตี้ contentDetails.startAt และ contentDetails.endAt ของทรัพยากร playlistItem แล้ว ระบบจะไม่สนใจฟิลด์เหล่านี้หากมีการตั้งค่าในคำขอ playlistItems.insert หรือ playlistItems.update
- ตอนนี้เมธอด playlistItems.delete และ playlistItems.update รองรับพารามิเตอร์ onBehalfOfContentOwner แล้ว ซึ่งเมธอดอื่นๆ หลายรายการรองรับอยู่แล้ว คำขอที่ใช้วิธีการดังกล่าวยังต้องได้รับอนุญาตด้วยโทเค็นที่ให้สิทธิ์เข้าถึงขอบเขต https://www.googleapis.com/auth/youtubepartner ด้วย
- พารามิเตอร์ publishedBefore และ publishedAfter ของเมธอด search.list ได้รับการอัปเดตแล้วเพื่อระบุว่าค่าพารามิเตอร์รวมอยู่ด้วย ตัวอย่างเช่น หากตั้งค่าพารามิเตอร์ publishedBefore แล้ว API จะแสดงผลทรัพยากรที่สร้างก่อนหรือเวลาที่ระบุ
- พร็อพเพอร์ตี้ contentDetails.contentRating.grfilmRating ของแหล่งข้อมูล video รองรับค่าเพิ่มเติมอีก 3 ค่า ได้แก่ grfilmK12, grfilmK15 และ grfilmK18
- เราได้อัปเดตคำอธิบายวิธีการ videos.insert เพื่อแจ้งให้ทราบว่าขนาดไฟล์สูงสุดของวิดีโอที่อัปโหลดได้เพิ่มขึ้นจาก 64 GB เป็น 128 GB

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

API รองรับข้อผิดพลาดใหม่ต่อไปนี้

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
`forbidden (403)`	`homeParameterDeprecated`	เมธอด `activities.list` จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าไม่มีข้อมูลกิจกรรมในหน้าแรกของผู้ใช้ผ่าน API นี้ ข้อผิดพลาดนี้อาจเกิดขึ้นหากคุณตั้งค่าพารามิเตอร์ `home` เป็น `true` ในคําขอที่ไม่ได้รับอนุญาต
`invalidValue (400)`	`invalidContentDetails`	เมธอด `playlistItems.insert` จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าออบเจ็กต์ `contentDetails` ในคำขอไม่ถูกต้อง สาเหตุหนึ่งที่ทำให้ข้อผิดพลาดนี้เกิดขึ้นคือช่อง `contentDetails.note` มีความยาวมากกว่า 280 อักขระ
`forbidden (403)`	`watchHistoryNotAccessible`	เมธอด `playlistItems.list` จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคําขอพยายามดึงข้อมูลรายการเพลย์ลิสต์ "ประวัติการดู" แต่ดึงข้อมูลรายการเหล่านั้นโดยใช้ API ไม่ได้
`forbidden (403)`	`watchLaterNotAccessible`	เมธอด `playlistItems.list` จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคำขอพยายามดึงข้อมูลรายการเพลย์ลิสต์ "ดูภายหลัง" แต่ดึงข้อมูลรายการเหล่านั้นโดยใช้ API ไม่ได้
`badRequest (400)`	`uploadLimitExceeded`	เมธอด `videos.insert` จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าช่องมีวิดีโอเกินจำนวนที่อัปโหลดได้
`forbidden (403)`	`forbiddenEmbedSetting`	เมธอด `videos.update` จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคำขอ API พยายามตั้งค่าการฝังที่ไม่ถูกต้องสำหรับวิดีโอ โปรดทราบว่าบางช่องอาจไม่มีสิทธิ์เสนอเพลเยอร์แบบฝังสำหรับสตรีมแบบสด ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube

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

การอัปเดตอื่นๆ
- เราได้อัปเดตรายการประวัติการแก้ไขของวันที่ 15 กันยายน 2016 เพื่อชี้แจงว่าเมื่อใดก็ตามที่พร็อพเพอร์ตี้ contentDetails.relatedPlaylists.watchHistory และ contentDetails.relatedPlaylists.watchLater ของทรัพยากร channel รวมอยู่ในคำตอบ พร็อพเพอร์ตี้ดังกล่าวจะมีค่าเป็น HL และ WL ตามลำดับเสมอ นอกจากนี้ พร็อพเพอร์ตี้เหล่านั้นจะรวมอยู่ด้วยก็ต่อเมื่อผู้ใช้ที่ได้รับอนุญาตดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เองเท่านั้น

15 กันยายน 2016

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

การอัปเดตประวัติการแก้ไขเมื่อวันที่ 11 สิงหาคม 2016 ได้กล่าวถึงการเปลี่ยนแปลงหลายประการที่เกี่ยวข้องกับรหัสหัวข้อ รวมถึงข้อเท็จจริงที่ว่าชุดรหัสหัวข้อที่รองรับจะมีการเปลี่ยนแปลงตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 เราจะเผยแพร่รายการหัวข้อที่รองรับภายในวันที่ 10 พฤศจิกายน 2016
การเปลี่ยนแปลงต่อไปนี้มีผลบังคับใช้แล้ว ประกาศเกี่ยวกับการเปลี่ยนแปลงเหล่านี้ได้แจ้งไว้ในข้อมูลอัปเดตประวัติการแก้ไขเมื่อวันที่ 11 สิงหาคม 2016
- หากเรียกใช้เมธอด activities.list โดยตั้งค่าพารามิเตอร์ home เป็น true ขณะนี้การตอบกลับของ API จะมีรายการที่คล้ายกับสิ่งที่ผู้ใช้ YouTube ที่ออกจากระบบแล้วจะเห็นในหน้าแรก
  การเปลี่ยนแปลงเล็กน้อยนี้มีจุดประสงค์เพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ดีขึ้นกว่าลักษณะการทำงานที่อธิบายไว้ในข้อมูลอัปเดตประวัติการแก้ไขเมื่อวันที่ 11 สิงหาคม 2016 การอัปเดตดังกล่าวระบุว่าคําขอที่ใช้พารามิเตอร์ home จะแสดงผลเป็นรายการว่าง
- ตอนนี้พร็อพเพอร์ตี้ contentDetails.relatedPlaylists.watchHistory และ contentDetails.relatedPlaylists.watchLater ของทรัพยากร channel มีค่าเป็น HL และ WL ตามลำดับสำหรับทุกช่อง
  
  โปรดทราบว่าพร็อพเพอร์ตี้เหล่านี้จะแสดงต่อผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เองเท่านั้น พร็อพเพอร์ตี้จะมีค่า HL และ WL เสมอ แม้แต่สำหรับผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เอง ดังนั้น คุณจะเรียกดูประวัติการดูและรหัสเพลย์ลิสต์ "ดูภายหลัง" ผ่าน API ไม่ได้
  
  นอกจากนี้ คำขอดึงข้อมูลรายละเอียดเพลย์ลิสต์ (playlists.list) หรือรายการเพลย์ลิสต์ (playlistItems.list) สำหรับประวัติการดูหรือเพลย์ลิสต์ "ดูภายหลัง" ของช่องจะแสดงรายการว่าง ลักษณะการทำงานนี้จะมีผลกับค่าใหม่ HL และ WL รวมถึงประวัติการดูหรือรหัสเพลย์ลิสต์ "ดูภายหลัง" ที่ไคลเอ็นต์ API ของคุณอาจจัดเก็บไว้แล้ว
ระบบจะไม่แสดงออบเจ็กต์ fileDetails.recordingLocation ของทรัพยากร video และพร็อพเพอร์ตี้ย่อยอีกต่อไป ก่อนหน้านี้ เจ้าของวิดีโอเท่านั้นที่สามารถเรียกข้อมูลนี้ (เช่น ออบเจ็กต์ fileDetails หลัก) ได้

11 สิงหาคม 2016

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

ข้อกำหนดในการให้บริการของบริการ YouTube API ที่เผยแพร่ใหม่ ("ข้อกำหนดที่อัปเดต") ซึ่งมีการอธิบายอย่างละเอียดในบล็อกวิศวกรและนักพัฒนาซอฟต์แวร์ของ 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) สำหรับแหล่งข้อมูล activity, playlistItem, playlist, search result, thumbnail และ video เพื่อระบุว่าวิดีโอบางรายการมีภาพปกขนาดเพิ่มเติม
- รูปภาพ standard มีความกว้าง 640 พิกเซลและสูง 480 พิกเซล
- รูปภาพ maxres มีความกว้าง 1280 พิกเซลและสูง 720 พิกเซล
เราได้อัปเดตคำจำกัดความของพารามิเตอร์ part ของเมธอด channelSection.list เพื่อระบุว่าสามารถดึงข้อมูลส่วน targeting ได้โดยเสียค่าใช้จ่าย 2 หน่วยโควต้า
ตอนนี้เมธอด videos.list จะแสดงข้อผิดพลาดไม่ได้รับอนุญาต (403) เมื่อคําขอที่ได้รับสิทธิ์อย่างไม่ถูกต้องพยายามดึงข้อมูลส่วน fileDetails, processingDetails หรือ suggestions ของแหล่งข้อมูล video ส่วนดังกล่าวมีให้บริการสำหรับเจ้าของวิดีโอเท่านั้น

17 พฤษภาคม 2016

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

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

19 พฤศจิกายน 2015

ตอนนี้ API รองรับการตั้งค่าและดึงข้อมูลข้อความที่แปลแล้วสำหรับพร็อพเพอร์ตี้ snippet.title และ snippet.description ของทรัพยากร playlist และ video, พร็อพเพอร์ตี้ snippet.title ของทรัพยากร channelSection และพร็อพเพอร์ตี้ snippet.description ของทรัพยากร channel

การตั้งชื่อและคำอธิบายที่แปลแล้ว

คุณสามารถกําหนดค่าที่แปลแล้วสําหรับทรัพยากรได้เมื่อเรียกใช้เมธอด insert หรือ update สําหรับทรัพยากรนั้น หากต้องการตั้งค่าที่แปลแล้วสำหรับทรัพยากร ให้ทำทั้ง 2 อย่างต่อไปนี้
- ตรวจสอบว่าได้ตั้งค่าสำหรับพร็อพเพอร์ตี้ snippet.defaultLanguage ของทรัพยากร พร็อพเพอร์ตี้ดังกล่าวจะระบุภาษาของพร็อพเพอร์ตี้ snippet.title และ snippet.description ของทรัพยากร ค่าของฟิลด์นี้อาจเป็นภาษาของแอปพลิเคชันที่รองรับหรือรหัสภาษา ISO 639-1:2002 อื่นๆ ส่วนใหญ่ ตัวอย่างเช่น หากคุณอัปโหลดวิดีโอที่มีชื่อและคำอธิบายภาษาอังกฤษ คุณจะต้องตั้งค่าพร็อพเพอร์ตี้ snippet.defaultLanguage เป็น en
  
  หมายเหตุสำหรับการอัปเดตทรัพยากร channel: หากต้องการตั้งค่าพร็อพเพอร์ตี้ snippet.defaultLanguage สำหรับทรัพยากร channel คุณจะต้องอัปเดตพร็อพเพอร์ตี้ brandingSettings.channel.defaultLanguage
- เพิ่มออบเจ็กต์ localizations ลงในทรัพยากรที่อัปเดต คีย์ออบเจ็กต์แต่ละรายการคือสตริงที่ระบุภาษาของแอปพลิเคชันหรือรหัสภาษา ISO 639-1:2002 และคีย์แต่ละรายการจะเชื่อมโยงกับออบเจ็กต์ที่มีชื่อ (และคำอธิบาย) ที่แปลแล้วสำหรับทรัพยากร
  
  ตัวอย่างข้อมูลโค้ดด้านล่างจะตั้งค่าภาษาเริ่มต้นของทรัพยากรเป็นภาษาอังกฤษ รวมถึงจะเพิ่มชื่อและคำอธิบายที่แปลเป็นภาษาเยอรมันและสเปนลงในวิดีโอด้วย
```
{
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    ...
  },
  "localizations":
    "de": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    },
    "es": {
      "title": "Jugar al fútbol",
      "description": "Nosotros jugamos fútbol en el parque los domingos",
    }
  }
}
```
การดึงค่าที่แปลแล้ว

API รองรับการเรียกข้อมูลค่าที่แปลแล้วสำหรับทรัพยากร 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 ของทรัพยากรและตัวกรองเพื่อดูว่ามีข้อความที่แปลแล้วหรือไม่
  
  ตัวอย่างเช่น คุณจะต้องเรียกข้อมูลรายการคำแปลทั้งหมดเพื่อดูว่ามีข้อความที่แปลแล้วในภาษาอังกฤษ Appalachia หรือไม่
- เมื่อดึงข้อมูลทรัพยากร ให้ใส่ localizations ในค่าพารามิเตอร์ part เพื่อดึงรายละเอียดที่แปลแล้วทั้งหมดของทรัพยากรนั้น หากต้องการเรียกข้อมูลแปลเป็นภาษาท้องถิ่นสำหรับภาษาที่ไม่ใช่ภาษาของแอปพลิเคชัน YouTube ปัจจุบัน คุณต้องใช้วิธีการนี้เพื่อเรียกข้อมูลแปลเป็นภาษาท้องถิ่นทั้งหมด จากนั้นกรองเพื่อดูว่ามีข้อมูลแปลเป็นภาษาท้องถิ่นที่ต้องการหรือไม่

ข้อผิดพลาดเกี่ยวกับค่าข้อความที่แปลแล้ว

นอกจากนี้ API ยังรองรับข้อผิดพลาดใหม่ต่อไปนี้สำหรับค่าข้อความที่แปลแล้ว

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
`badRequest (400)`	`defaultLanguageNotSetError`	ข้อผิดพลาดนี้บ่งบอกว่าคําขอที่พยายามแทรกหรืออัปเดตออบเจ็กต์ `localizations` สําหรับทรัพยากรไม่สําเร็จเนื่องจากไม่ได้ตั้งค่าพร็อพเพอร์ตี้ `snippet.defaultLanguage` สําหรับทรัพยากรนั้น วิธีการ `channels.update`, `channelSections.insert`, `channelSections.update`, `playlists.insert`, `playlists.update`, `videos.insert` และ `videos.update` รองรับข้อผิดพลาดนี้
`badRequest (400)`	`localizationValidationError`	ข้อผิดพลาดนี้แสดงว่าค่าใดค่าหนึ่งในออบเจ็กต์ `localizations` ของทรัพยากรไม่ผ่านการตรวจสอบ ตัวอย่างเช่น ข้อผิดพลาดนี้อาจเกิดขึ้นหากออบเจ็กต์มีรหัสภาษาที่ไม่ถูกต้อง วิธีการ `channels.update`, `channelSections.insert`, `channelSections.update`, `playlists.insert` และ `playlists.update` รองรับข้อผิดพลาดนี้

4 พฤศจิกายน 2015

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

การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่
- เราได้อัปเดตพารามิเตอร์ order ของเมธอด search.list เพื่อระบุว่าหากคุณจัดเรียงการถ่ายทอดสดตาม viewCount ผลการค้นหาของ API จะจัดเรียงตามจํานวนผู้ชมที่ดูการถ่ายทอดสดพร้อมกันขณะที่การถ่ายทอดสดยังดำเนินอยู่
- พารามิเตอร์ relatedToVideoId ของเมธอด search.list ได้รับการอัปเดตเพื่อระบุว่าหากตั้งค่าพารามิเตอร์ พารามิเตอร์อื่นๆ ที่รองรับมีเพียง part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (ซึ่งต้องตั้งค่าเป็น video) และ fields การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทํางานของ API
- เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ snippet.publishedAt ของทรัพยากร video เพื่อระบุว่าค่าพร็อพเพอร์ตี้ซึ่งระบุวันที่และเวลาที่เผยแพร่วิดีโออาจแตกต่างจากเวลาที่อัปโหลดวิดีโอ ตัวอย่างเช่น หากอัปโหลดวิดีโอเป็นวิดีโอส่วนตัวแล้วเปลี่ยนเป็นวิดีโอสาธารณะในภายหลัง ค่าพร็อพเพอร์ตี้จะระบุเวลาที่วิดีโอกลายเป็นวิดีโอสาธารณะ คำจำกัดความที่อัปเดตใหม่ยังอธิบายวิธีป้อนข้อมูลค่าสำหรับวิดีโอส่วนตัวและวิดีโอที่ไม่เป็นสาธารณะด้วย
  
  การเปลี่ยนแปลงนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทํางานของ API
- คำจำกัดความของพร็อพเพอร์ตี้ status.publishAt ของทรัพยากร video ได้รับการอัปเดตเพื่อระบุข้อมูลต่อไปนี้
  - หากคุณตั้งค่าพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด videos.update คุณต้องตั้งค่าพร็อพเพอร์ตี้ status.privacyStatus เป็น private ด้วย แม้ว่าวิดีโอจะเป็นแบบส่วนตัวอยู่แล้วก็ตาม
  - หากคำขอกำหนดเวลาเผยแพร่วิดีโอเป็นช่วงเวลาที่ผ่านมา ระบบจะเผยแพร่วิดีโอทันที ดังนั้น ผลของการตั้งค่าพร็อพเพอร์ตี้ status.publishAt เป็นวันที่และเวลาที่ผ่านมาจะเหมือนกับการเปลี่ยน privacyStatus ของวิดีโอจาก private เป็น public
- พร็อพเพอร์ตี้ contentDetails.contentRating.cncRating ของทรัพยากร video จะระบุการจัดประเภทของวิดีโอจาก Commission de classification cinematographique ของฝรั่งเศส พร็อพเพอร์ตี้นี้จะแทนที่พร็อพเพอร์ตี้ contentDetails.contentRating.fmocRating ซึ่งเลิกใช้งานแล้ว
- เราได้อัปเดตคำจำกัดความของ 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 เวอร์ชัน 3 รองรับฟีเจอร์ทั้งหมดของ API เวอร์ชัน 2 ตามกำหนดการ ฟีเจอร์เหล่านี้มีคำอธิบายทั้งหมดอยู่ในคู่มือการย้ายข้อมูลด้วย
การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่
- พารามิเตอร์ตัวกรอง forDeveloper ใหม่ของเมธอด search.list จะจำกัดการค้นหาให้แสดงเฉพาะวิดีโอที่อัปโหลดผ่านแอปพลิเคชันหรือเว็บไซต์ของนักพัฒนาแอป พารามิเตอร์ forDeveloper สามารถใช้ร่วมกับพารามิเตอร์การค้นหาที่ไม่บังคับ เช่น พารามิเตอร์ q
  
  สำหรับฟีเจอร์นี้ วิดีโอที่อัปโหลดแต่ละรายการจะได้รับแท็กหมายเลขโปรเจ็กต์ที่เชื่อมโยงกับแอปพลิเคชันของนักพัฒนาแอปใน Google Developers Console โดยอัตโนมัติ
  
  เมื่อคำขอค้นหาตั้งค่าพารามิเตอร์ forDeveloper เป็น true ในภายหลัง เซิร์ฟเวอร์ API จะใช้ข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอเพื่อระบุนักพัฒนาแอป ดังนั้น นักพัฒนาแอปจึงจำกัดผลการค้นหาให้แสดงเฉพาะวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์ของตนเองได้ แต่จะจำกัดให้แสดงเฉพาะวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์อื่นๆ ไม่ได้
  
  ฟีเจอร์ใหม่นี้มีฟังก์ชันการทำงานที่คล้ายกับฟังก์ชันของแท็กสำหรับนักพัฒนาซอฟต์แวร์ที่ v2 API รองรับ แต่ไม่ได้เหมือนกันทุกประการ
- พร็อพเพอร์ตี้ 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

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

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

คู่มือนี้ยังกล่าวถึงฟีเจอร์การคอมเมนท์หลายอย่างที่ API เวอร์ชัน 2 ไม่รองรับ แต่รองรับใน API เวอร์ชัน 3 ซึ่งได้แก่
- การดึงข้อมูลความคิดเห็นเกี่ยวกับช่อง
- การดึงข้อมูลชุดข้อความความคิดเห็นทั้งหมดที่เกี่ยวข้องกับช่อง ซึ่งหมายความว่าการตอบกลับของ API อาจมีความคิดเห็นเกี่ยวกับช่องหรือวิดีโอของช่อง
- การอัปเดตข้อความของความคิดเห็น
- การทําเครื่องหมายความคิดเห็นว่าเป็นสแปม
- การตั้งค่าสถานะการดูแลของความคิดเห็น
เราได้อัปเดตคู่มือการสมัครรับการแจ้งเตือนแบบพุชเพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าระบบจะพุชการแจ้งเตือนไปยังฮับ Google PubSubHubBub เท่านั้น และไม่พุชไปยังฮับ Superfeedr ด้วยตามที่ระบุไว้ก่อนหน้านี้

9 เมษายน 2015

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

ทรัพยากร commentThread และ comment ใหม่ของ API ช่วยให้คุณดึงข้อมูล แทรก อัปเดต ลบ และดูแลความคิดเห็นได้
- แหล่งข้อมูล commentThread มีข้อมูลเกี่ยวกับชุดข้อความความคิดเห็นของ YouTube ซึ่งประกอบด้วยความคิดเห็นระดับบนสุดและการตอบกลับความคิดเห็นนั้น (หากมี) ทรัพยากร commentThread อาจแสดงความคิดเห็นเกี่ยวกับวิดีโอหรือช่อง
  
  ความคิดเห็นระดับบนสุดและการตอบกลับคือทรัพยากร comment ที่ฝังอยู่ภายในทรัพยากร commentThread โปรดทราบว่าแหล่งข้อมูล commentThread ไม่จำเป็นต้องมีการตอบกลับทั้งหมดสำหรับความคิดเห็นหนึ่งๆ และคุณต้องใช้เมธอด comments.list หากต้องการดึงข้อมูลการตอบกลับทั้งหมดสำหรับความคิดเห็นหนึ่งๆ นอกจากนี้ ความคิดเห็นบางรายการก็ไม่มีการตอบกลับ
  
  API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร commentThread
  - commentThreads.list – ดึงข้อมูลรายการชุดความคิดเห็น ใช้วิธีนี้เพื่อดึงข้อมูลความคิดเห็นที่เชื่อมโยงกับวิดีโอหรือช่องใดช่องหนึ่ง
  - commentThreads.insert – สร้างความคิดเห็นระดับบนสุดใหม่ (ใช้เมธอด comments.insert เพื่อตอบกลับความคิดเห็นที่มีอยู่)
  - commentThreads.update – แก้ไขความคิดเห็นระดับบนสุด
- ทรัพยากร comment มีข้อมูลเกี่ยวกับความคิดเห็น YouTube รายการเดียว ทรัพยากร comment อาจแสดงความคิดเห็นเกี่ยวกับวิดีโอหรือช่อง นอกจากนี้ ความคิดเห็นดังกล่าวอาจเป็นความคิดเห็นระดับบนสุดหรือการตอบกลับความคิดเห็นระดับบนสุด
  
  API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร comment
  - comments.list – ดึงข้อมูลรายการความคิดเห็น ใช้วิธีนี้เพื่อดึงข้อมูลการตอบกลับทั้งหมดของความคิดเห็นหนึ่งๆ
  - comments.insert – สร้างการตอบกลับความคิดเห็นที่มีอยู่
  - comments.update – แก้ไขความคิดเห็น
  - comments.markAsSpam – แจ้งว่าความคิดเห็นอย่างน้อย 1 รายการไม่เหมาะสม
  - comments.setModerationStatus – ตั้งค่าสถานะการดูแลความคิดเห็นอย่างน้อย 1 รายการ เช่น ล้างความคิดเห็นให้แสดงแบบสาธารณะหรือปฏิเสธความคิดเห็นเนื่องจากไม่เหมาะสมที่จะแสดง คำขอ 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
คู่มือการสมัครรับการแจ้งเตือนแบบพุชใหม่อธิบายการรองรับการแจ้งเตือนแบบพุชใหม่ของ API ผ่าน PubSubHubBub ซึ่งเป็นโปรโตคอลการเผยแพร่/การสมัครใช้บริการแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์สําหรับทรัพยากรที่เข้าถึงได้ทางเว็บ เซิร์ฟเวอร์การเรียกกลับของ 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 เพียงรายการเดียว

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

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

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

11 มีนาคม 2015

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

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

14 มกราคม 2015

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

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

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

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 เวอร์ชัน 2 ไปยัง API เวอร์ชันล่าสุด

8 กรกฎาคม 2014

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

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

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

18 มิถุนายน 2014

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

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

โปรดทราบว่าค่าใช้จ่ายตามโควต้าอาจมีการเปลี่ยนแปลงโดยไม่ต้องแจ้งเตือน
ตอนนี้ทรัพยากร video รองรับระบบการจัดประเภทเนื้อหาใหม่ 43 ระบบ ซึ่งระบุการจัดประเภทที่วิดีโอได้รับจากหน่วยงานการจัดประเภทระดับประเทศต่างๆ ระบบการจัดประเภทที่รองรับใหม่ ได้แก่ อาร์เจนตินา ออสเตรีย เบลเยียม บัลแกเรีย ชิลี (โทรทัศน์) ชิลี (ภาพยนตร์) สาธารณรัฐเช็ก โคลอมเบีย เดนมาร์ก อียิปต์ เอสโตเนีย ฟินแลนด์ ฝรั่งเศส กรีซ ฮ่องกง ไอซ์แลนด์ อินโดนีเซีย ไอร์แลนด์ อิสราเอล อิตาลี เคนยา ลัตเวีย ลักเซมเบิร์ก มาเลเซีย มัลดีฟส์ มอลตา เนเธอร์แลนด์ ไนจีเรีย นอร์เวย์ เปรู ฟิลิปปินส์ โปรตุเกส โรมาเนีย สิงคโปร์ สโลวาเกีย แอฟริกาใต้ สวีเดน สวิตเซอร์แลนด์ ไต้หวัน ไทย และเวเนซุเอลา

28 พฤษภาคม 2014

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

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

13 พฤษภาคม 2014

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

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

เลิกใช้งานพร็อพเพอร์ตี้ brandingSettings.watch.featuredPlaylistId ของทรัพยากร channel แล้ว API จะแสดงข้อผิดพลาดหากคุณพยายามตั้งค่า
เราได้เพิ่มพร็อพเพอร์ตี้ทรัพยากร video ต่อไปนี้ลงในรายการค่าที่ตั้งได้เมื่อแทรกหรืออัปเดตวิดีโอ
ตอนนี้เอกสารประกอบเกี่ยวกับข้อผิดพลาดจะระบุรหัสการตอบกลับ HTTP สำหรับข้อผิดพลาดแต่ละประเภท

ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
`badRequest (400)`	`invalidCriteria`	เมธอด `channels.list` จะแสดงข้อผิดพลาดนี้หากคําขอระบุพารามิเตอร์ตัวกรองที่ใช้ร่วมกันไม่ได้
`badRequest (400)`	`channelTitleUpdateForbidden`	เมธอด `channels.update` จะแสดงข้อผิดพลาดนี้หากคุณพยายามอัปเดตส่วน `brandingSettings` ของช่องและเปลี่ยนค่าของพร็อพเพอร์ตี้ `brandingSettings.channel.title` (โปรดทราบว่า API จะไม่แสดงข้อผิดพลาดหากคุณละเว้นพร็อพเพอร์ตี้นี้)
`badRequest (400)`	`invalidRecentlyUploadedBy`	เมธอด `channels.update` จะแสดงข้อผิดพลาดนี้หากพร็อพเพอร์ตี้ `invideoPromotion.items[].id.recentlyUploadedBy` ระบุรหัสช่องที่ไม่ถูกต้อง
`badRequest (400)`	`invalidTimingOffset`	เมธอด `channels.update` จะแสดงข้อผิดพลาดนี้หากส่วน `invideoPromotion` ระบุออฟเซ็ตเวลาที่ไม่ถูกต้อง
`badRequest (400)`	`tooManyPromotedItems`	เมธอด `channels.update` จะแสดงข้อผิดพลาดนี้หากส่วน `invideoPromotion` ระบุรายการที่โปรโมตมากกว่าจำนวนที่อนุญาต
`forbidden (403)`	`promotedVideoNotAllowed`	เมธอด `channels.update` จะแสดงข้อผิดพลาดนี้หากพร็อพเพอร์ตี้ `invideoPromotion.items[].id.videoId` ระบุรหัสวิดีโอที่ระบบไม่พบหรือไม่สามารถใช้เป็นรายการที่โปรโมตได้
`forbidden (403)`	`websiteLinkNotAllowed`	เมธอด `channels.update` จะแสดงข้อผิดพลาดนี้หากพร็อพเพอร์ตี้ `invideoPromotion.items[].id.websiteUrl` ระบุ URL ที่ไม่ได้รับอนุญาต
`required (400)`	`requiredTimingType`	เมธอด `channels.update` จะแสดงข้อผิดพลาดนี้หากคำขอไม่ได้ระบุการตั้งค่าเวลาเริ่มต้นสำหรับเวลาที่ YouTube ควรแสดงรายการที่โปรโมต
`required (400)`	`requiredTiming`	เมธอด `channels.update` ต้องระบุออบเจ็กต์ `invideoPromotion.items[].timing` สำหรับรายการที่โปรโมตแต่ละรายการ
`required (400)`	`requiredWebsiteUrl`	เมธอด `channels.update` ต้องระบุพร็อพเพอร์ตี้ `invideoPromotion.items[].id.websiteUrl` สำหรับรายการที่โปรโมตแต่ละรายการ
`badRequest (400)`	`invalidPublishAt`	เมธอด `videos.insert` จะแสดงข้อผิดพลาดนี้หากข้อมูลเมตาคำขอระบุเวลาเผยแพร่ตามกำหนดการที่ไม่ถูกต้อง

4 มีนาคม 2014

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

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

5 ธันวาคม 2013

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

เอกสารประกอบของเมธอด search.list ได้รับการอัปเดตให้สอดคล้องกับความจริงที่ว่าคุณไม่จำเป็นต้องระบุค่าสำหรับพารามิเตอร์ตัวกรองเพียง 1 รายการเมื่อส่งคำขอค้นหา แต่คุณสามารถตั้งค่าพารามิเตอร์ตัวกรองเป็น 0 หรือ 1 รายการได้
เราได้อัปเดตคําจํากัดความสําหรับพารามิเตอร์ของเมธอด search.list เพื่อระบุว่าคุณต้องตั้งค่าพารามิเตอร์ type เป็น video หากคุณระบุค่าสําหรับพารามิเตอร์ต่อไปนี้ด้วย
- eventType
- videoCaption
- videoCategoryId
- videoDefinition
- videoDimension
- videoDuration
- videoEmbeddable
- videoLicense
- videoSyndicated
- videoType
เราลดขนาดขั้นต่ำของรูปภาพแบนเนอร์ช่องที่อัปโหลดเป็น 2048 x 1152 พิกเซล (ก่อนหน้านี้ขนาดขั้นต่ำคือ 2120 x 1192 พิกเซล) นอกจากนี้ โปรดทราบว่าเอกสารประกอบchannelทรัพยากรจะระบุขนาดสูงสุดของรูปภาพแบนเนอร์ทั้งหมดที่แสดงจาก API เช่น ขนาดสูงสุดของรูปภาพ brandingSettings.image.bannerTvImageUrl สำหรับแอปพลิเคชันทีวีคือ 2120 x 1192 พิกเซล แต่รูปภาพจริงอาจเป็น 2048 x 1152 พิกเซล ศูนย์ช่วยเหลือของ YouTube มีคำแนะนำเพิ่มเติมเกี่ยวกับการเพิ่มประสิทธิภาพหน้าปกช่องให้แสดงผลบนอุปกรณ์ประเภทต่างๆ
เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ทรัพยากร channel หลายรายการเพื่อให้สอดคล้องกับข้อมูลต่อไปนี้
- ค่าของพร็อพเพอร์ตี้ brandingSettings.channel.description มีความยาวได้สูงสุด 1,000 อักขระ
- พร็อพเพอร์ตี้ brandingSettings.channel.featuredChannelsTitle มีความยาวได้สูงสุด 30 อักขระ
- ตอนนี้พร็อพเพอร์ตี้ brandingSettings.channel.featuredChannelsUrls[] แสดงช่องได้สูงสุด 100 ช่อง
- ค่าพร็อพเพอร์ตี้ brandingSettings.channel.unsubscribedTrailer (หากมีการตั้งค่า) ต้องระบุรหัสวิดีโอ YouTube ของวิดีโอสาธารณะหรือวิดีโอไม่เป็นสาธารณะที่เจ้าของช่องเป็นเจ้าของ
ตอนนี้เมธอด channels.update รองรับการอัปเดตพร็อพเพอร์ตี้ invideoPromotion.items[].promotedByContentOwner แล้ว พร็อพเพอร์ตี้ดังกล่าวจะระบุว่าระบบจะแสดงชื่อเจ้าของเนื้อหาเมื่อแสดงโปรโมชันหรือไม่ โดยสามารถตั้งค่าได้เฉพาะในกรณีที่คำขอ API ที่ตั้งค่าพร็อพเพอร์ตี้นั้นส่งในนามของเจ้าของเนื้อหาโดยใช้พารามิเตอร์ onBehalfOfContentOwner
ตอนนี้เมธอด playlistItems.list และ playlistItems.insert รองรับพารามิเตอร์ onBehalfOfContentOwner แล้ว ซึ่งเมธอดอื่นๆ หลายรายการรองรับอยู่แล้ว
ตอนนี้พร็อพเพอร์ตี้ contentDetails.contentRating.acbRating สามารถระบุการจัดประเภทจากคณะกรรมการการจัดประเภทของออสเตรเลีย (ACB) สำหรับภาพยนตร์ หรือจากหน่วยงานกำกับดูแลการสื่อสารและสื่อของออสเตรเลีย (ACMA) สำหรับรายการทีวีสำหรับเด็ก
พร็อพเพอร์ตี้ contentDetails.contentRating.catvRating และ contentDetails.contentRating.catvfrRating ใหม่จะระบุการจัดประเภทที่วิดีโอได้รับภายใต้ระบบการจัดประเภททีวีของแคนาดาและระบบการจัดประเภทภาษาฝรั่งเศสของ Régie du cinéma ซึ่งใช้ในควิเบกตามลำดับ
พร็อพเพอร์ตี้ snippet.assignable ใหม่ของทรัพยากร videoCategory จะระบุว่าวิดีโอที่อัปเดตหรือวิดีโอที่อัปโหลดใหม่จะเชื่อมโยงกับหมวดหมู่วิดีโอนั้นได้หรือไม่
เราได้เพิ่มตัวอย่างโค้ดสำหรับเมธอดต่อไปนี้
- activities.insert (Go)
- channelBanners.insert (Python)
- channels.update (Python)
- playlistItems.list (Go)
- search.list (Go)
- thumbnails.set (Java)
- videos.insert (Go)

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 (V.M.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 แล้ว พารามิเตอร์ทั้ง 2 รายการนี้รองรับวิธีการอื่นๆ หลายวิธีอยู่แล้ว
ตอนนี้เมธอด videos.list รองรับพารามิเตอร์ regionCode แล้ว ซึ่งจะระบุภูมิภาคเนื้อหาที่ควรดึงข้อมูลแผนภูมิ พารามิเตอร์นี้ใช้ได้เฉพาะร่วมกับพารามิเตอร์ chart เท่านั้น ค่าพารามิเตอร์คือรหัสประเทศ ISO 3166-1 alpha-2

error documentation อธิบายข้อผิดพลาดใหม่เกี่ยวกับคําขอที่พบบ่อยต่อไปนี้ ซึ่งอาจเกิดขึ้นกับเมธอด API หลายรายการ

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
`forbidden`	`insufficientPermissions`	ขอบเขตที่เชื่อมโยงกับโทเค็น OAuth 2.0 ที่ระบุสำหรับคำขอไม่เพียงพอสำหรับการเข้าถึงข้อมูลที่ขอ

15 สิงหาคม 2013

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

ออบเจ็กต์ invideoPromotion ของทรัพยากร channel มีพร็อพเพอร์ตี้ใหม่และที่อัปเดตแล้วดังต่อไปนี้
- ตอนนี้ API รองรับการกำหนดเว็บไซต์เป็นรายการที่โปรโมตแล้ว โดยให้ตั้งค่าพร็อพเพอร์ตี้ invideoPromotion.items[].id.type เป็น website และใช้พร็อพเพอร์ตี้ invideoPromotion.items[].id.websiteUrl ใหม่เพื่อระบุ URL นอกจากนี้ ให้ใช้พร็อพเพอร์ตี้ invideoPromotion.items[].customMessage ใหม่เพื่อกำหนดข้อความที่กำหนดเองที่จะแสดงสำหรับโปรโมชัน
  
  ลิงก์อาจเป็นลิงก์ไปยังเว็บไซต์ที่เกี่ยวข้อง เว็บไซต์ของผู้ขาย หรือเว็บไซต์โซเชียลเน็ตเวิร์ก ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้ลิงก์สำหรับเนื้อหาของคุณได้ในวิธีการสำหรับเว็บไซต์ที่เกี่ยวข้องและเว็บไซต์ของผู้ขายในศูนย์ช่วยเหลือของ YouTube
  
  การเพิ่มลิงก์โปรโมตหมายความว่าคุณยอมรับว่าจะไม่ใช้ลิงก์เหล่านั้นเพื่อเปลี่ยนเส้นทางการเข้าชมไปยังเว็บไซต์ที่ไม่ได้รับอนุญาต และลิงก์เหล่านั้นจะต้องเป็นไปตามนโยบาย AdWords, นโยบายโฆษณาของ YouTube, หลักเกณฑ์ของชุมชน YouTube และข้อกำหนดในการให้บริการของ YouTube
- เราได้ปรับโครงสร้างพร็อพเพอร์ตี้ที่เกี่ยวข้องกับการตั้งค่าเวลาในการแสดงรายการที่โปรโมตระหว่างการเล่นวิดีโอดังนี้
  - ย้ายออบเจ็กต์ invideoPromotion.timing ไปยัง invideoPromotion.items[].timing แล้ว ตอนนี้ออบเจ็กต์นี้ช่วยให้คุณปรับแต่งข้อมูลช่วงเวลาสำหรับรายการที่โปรโมตแต่ละรายการในรายการ invideoPromotion.items[] ได้
  - ออบเจ็กต์ invideoPromotion.defaultTiming ใหม่จะระบุการตั้งค่าเวลาเริ่มต้นสำหรับโปรโมชัน การตั้งค่าเหล่านี้จะกำหนดเวลาที่ไอเทมที่โปรโมตจะแสดงระหว่างการเล่นวิดีโอของช่อง คุณลบล้างช่วงเวลาเริ่มต้นสำหรับรายการที่โปรโมตรายการใดก็ได้โดยใช้ออบเจ็กต์ invideoPromotion.items[].timing
  - พร็อพเพอร์ตี้ invideoPromotion.items[].timing.durationMs ใหม่จะระบุระยะเวลาเป็นมิลลิวินาทีที่โปรโมชันควรแสดง ออบเจ็กต์ invideoPromotion.defaultTiming ยังมีช่อง durationMs ที่ระบุระยะเวลาเริ่มต้นที่รายการที่โปรโมตจะแสดงด้วย
- ย้ายพร็อพเพอร์ตี้ invideoPromotion.items[].type และ invideoPromotion.items[].videoId ไปยังออบเจ็กต์ invideoPromotion.items[].id แล้ว
ตอนนี้เมธอด subscriptions.list รองรับพารามิเตอร์ onBehalfOfContentOwner และ onBehalfOfContentOwnerChannel แล้ว พารามิเตอร์ทั้ง 2 รายการนี้รองรับวิธีการอื่นๆ หลายวิธีอยู่แล้ว
ค่าพร็อพเพอร์ตี้ kind ในคำตอบของ API สำหรับคำขอ thumbnails.set ได้เปลี่ยนจาก youtube#thumbnailListResponse เป็น youtube#thumbnailSetResponse
เราได้เพิ่มตัวอย่างโค้ดสำหรับเมธอดต่อไปนี้
- channels.update (Java, Python)
- playlists.insert (.NET, PHP)
- subscriptions.insert (PHP, Python)
- thumbnails.set (PHP, Python)
- videos.insert (PHP)
- videos.list (PHP)
- videos.rate (Python)
- videos.update (Java, PHP, Python)
โปรดทราบว่าตัวอย่าง Python สำหรับเมธอด playlistItems.insert นั้นถูกนำออกด้วย เนื่องจากตอนนี้ฟังก์ชันการทำงานที่แสดงนั้นจัดการโดยเมธอด videos.rate แล้ว

error documentation อธิบายข้อผิดพลาดใหม่เกี่ยวกับบริบทคําขอต่อไปนี้ ซึ่งอาจเกิดขึ้นกับเมธอด API ที่รองรับพารามิเตอร์คําขอ mine

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
`badRequest`	`invalidMine`	คุณใช้พารามิเตอร์ `mine` ในคำขอที่ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วเป็นพาร์ทเนอร์ YouTube ไม่ได้ คุณควรนําพารามิเตอร์ `mine` ออก ตรวจสอบสิทธิ์ในฐานะผู้ใช้ YouTube โดยการนําพารามิเตอร์ `onBehalfOfContentOwner` ออก หรือทําตัวเป็นช่องของพาร์ทเนอร์โดยระบุพารามิเตอร์ `onBehalfOfContentOwnerChannel` หากมีสําหรับเมธอดที่เรียกใช้

8 สิงหาคม 2013

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

เราได้อัปเดตส่วนการใช้โควต้าในคู่มือเริ่มต้นใช้งาน YouTube Data API เพื่อแสดงการเปลี่ยนแปลงค่าใช้จ่ายโควต้าในการอัปโหลดวิดีโอจากประมาณ 16,000 หน่วยเป็นประมาณ 1,600 หน่วย

30 กรกฎาคม 2013

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

ในทรัพยากร channelBanner ค่าของพร็อพเพอร์ตี้ kind เปลี่ยนจาก youtube#channelBannerInsertResponse เป็น youtube#channelBannerResource ระบบแสดงทรัพยากรนี้เพื่อตอบสนองคําขอ channelBanners.insert
พร็อพเพอร์ตี้ brandingSettings.channel.profileColor ใหม่ของทรัพยากร channel จะระบุสีที่โดดเด่นซึ่งช่วยเสริมเนื้อหาของช่อง ค่าพร็อพเพอร์ตี้คือเครื่องหมายปอนด์ (#) ตามด้วยสตริงฐานสิบหก 6 อักขระ เช่น #2793e6
ตอนนี้ API รองรับการกำหนดว่าการติดตามมีไว้สำหรับกิจกรรมทั้งหมดของช่องหรือสำหรับการอัปโหลดใหม่เท่านั้น พร็อพเพอร์ตี้ contentDetails.activityType ใหม่ของทรัพยากร subscription จะระบุประเภทกิจกรรมที่ผู้ติดตามจะได้รับการแจ้งเตือน ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ all และ uploads
เมธอด videos.list รองรับพารามิเตอร์ใหม่สำหรับการดึงข้อมูลชาร์ตวิดีโอที่ได้รับความนิยมสูงสุดบน YouTube ดังนี้
- พารามิเตอร์ chart จะระบุแผนภูมิที่คุณต้องการเรียกข้อมูล ปัจจุบันค่าที่รองรับเพียงค่าเดียวคือ mostPopular โปรดทราบว่าพารามิเตอร์ chart คือพารามิเตอร์ตัวกรอง ซึ่งหมายความว่าจะใช้ในคำขอเดียวกับพารามิเตอร์ตัวกรองอื่นๆ (id และ myRating) ไม่ได้
- พารามิเตอร์ videoCategoryId จะระบุหมวดหมู่วิดีโอที่ควรดึงข้อมูลแผนภูมิ พารามิเตอร์นี้ใช้ได้เฉพาะร่วมกับพารามิเตอร์ chart เท่านั้น โดยค่าเริ่มต้น ชาร์ตจะไม่จำกัดเฉพาะหมวดหมู่ใดหมวดหมู่หนึ่ง
พร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] ใหม่ของทรัพยากร video จะแสดงรายการรหัสหัวข้อ Freebase ที่เกี่ยวข้องกับวิดีโอหรือเนื้อหาของวิดีโอ หัวข้อเหล่านี้อาจมีการกล่าวถึงหรือปรากฏในวิดีโอ
เปลี่ยนชื่อพร็อพเพอร์ตี้ recordingDetails.location.elevation ของทรัพยากร video เป็น recordingDetails.location.altitude และเปลี่ยนชื่อพร็อพเพอร์ตี้ fileDetails.recordingLocation.location.elevation เป็น fileDetails.recordingLocation.location.altitude
ออบเจ็กต์ contentDetails.contentRating ของทรัพยากร video จะระบุการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ ซึ่งรวมถึงการจัดประเภทของ MPAA, การจัดประเภท TVPG และอื่นๆ ตอนนี้ API รองรับค่าการจัดประเภทที่ระบุว่าวิดีโอยังไม่ได้จัดประเภทสำหรับระบบการจัดประเภทแต่ละระบบ โปรดทราบว่าสำหรับการจัดประเภทของ MPAA ระบบมักใช้การจัดประเภท "ไม่ได้จัดประเภท" เพื่อระบุภาพยนตร์เวอร์ชันเวอร์ชันเต็มซึ่งเวอร์ชันตัดต่อได้รับการจัดประเภทอย่างเป็นทางการ
พร็อพเพอร์ตี้ contentDetails.contentRating.ytRating ใหม่ของทรัพยากร video จะระบุเนื้อหาที่จำกัดอายุผู้ชม ค่าพร็อพเพอร์ตี้จะเป็น ytAgeRestricted หาก YouTube ระบุว่าวิดีโอมีเนื้อหาที่ไม่เหมาะสำหรับผู้ใช้ที่มีอายุต่ำกว่า 18 ปี หากไม่มีพร็อพเพอร์ตี้หรือค่าพร็อพเพอร์ตี้ว่าง แสดงว่าเนื้อหาไม่ได้ระบุว่ามีการจำกัดอายุผู้ชม
พารามิเตอร์ mySubscribers ของเมธอด channels.list เลิกใช้งานแล้ว ใช้เมธอด subscriptions.list และพารามิเตอร์ mySubscribers ของเมธอดดังกล่าวเพื่อเรียกข้อมูลรายชื่อผู้ติดตามช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
ตอนนี้เมธอด channelBanners.insert, channels.update, videos.getRating และ videos.rate ทั้งหมดรองรับพารามิเตอร์ onBehalfOfContentOwner แล้ว พารามิเตอร์ดังกล่าวระบุว่าผู้ใช้ที่ตรวจสอบสิทธิ์กำลังดำเนินการในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์
เราได้อัปเดตเอกสารประกอบของเมธอด channels.update เพื่อแสดงให้เห็นว่าเมธอดดังกล่าวสามารถใช้เพื่ออัปเดตออบเจ็กต์ brandingSettings ของทรัพยากร channel และพร็อพเพอร์ตี้ย่อย นอกจากนี้ เอกสารประกอบยังแสดงรายการพร็อพเพอร์ตี้ที่อัปเดตแล้วซึ่งคุณตั้งค่าให้กับออบเจ็กต์ invideoPromotion ของทรัพยากร channel ได้ด้วย

error documentation จะอธิบายข้อผิดพลาดใหม่ต่อไปนี้

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
`forbidden`	`accountDelegationForbidden`	ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งหมายความว่าผู้ใช้ที่ตรวจสอบสิทธิ์ไม่ได้รับอนุญาตให้ดำเนินการในนามของบัญชี Google ที่ระบุ
`forbidden`	`authenticatedUserAccountClosed`	ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งหมายความว่าบัญชี YouTube ของผู้ใช้ที่ตรวจสอบสิทธิ์ถูกปิด หากผู้ใช้ดําเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้บ่งชี้ว่าบัญชีอื่นนั้นปิดอยู่
`forbidden`	`authenticatedUserAccountSuspended`	ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งหมายความว่าบัญชี YouTube ของผู้ใช้ที่ตรวจสอบสิทธิ์ถูกระงับ หากผู้ใช้ดําเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้บ่งชี้ว่าบัญชีอื่นถูกระงับ
`forbidden`	`authenticatedUserNotChannel`	ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งหมายความว่าเซิร์ฟเวอร์ API ไม่สามารถระบุแชแนลที่เชื่อมโยงกับคําขอ API หากคําขอได้รับอนุญาตและใช้พารามิเตอร์ `onBehalfOfContentOwner` คุณควรตั้งค่าพารามิเตอร์ `onBehalfOfContentOwnerChannel` ด้วย
`forbidden`	`cmsUserAccountNotFound`	ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ผู้ใช้ CMS ไม่ได้รับอนุญาตให้ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุ
`notFound`	`contentOwnerAccountNotFound`	ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ไม่พบบัญชีเจ้าของเนื้อหาที่ระบุ
`badRequest`	`invalidPart`	ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง พารามิเตอร์ `part` ของคำขอระบุส่วนที่เขียนพร้อมกันไม่ได้
`badRequest`	`videoChartNotFound`	เมธอด `videos.list` จะแสดงข้อผิดพลาดนี้เมื่อคำขอระบุแผนภูมิวิดีโอที่ไม่รองรับหรือไม่พร้อมใช้งาน
`notFound`	`videoNotFound`	เมธอด `videos.update` จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าไม่พบวิดีโอที่คุณพยายามอัปเดต ตรวจสอบค่าของพร็อพเพอร์ตี้ `id` ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง

10 มิถุนายน 2013

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

พารามิเตอร์ 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 ระบุ

พารามิเตอร์นี้ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ CMS ของ YouTube ที่ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์ บัญชี 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 ต้องระบุพารามิเตอร์อย่างใดอย่างหนึ่งเท่านั้น (ก่อนหน้านี้พารามิเตอร์ 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, Ruby)
พารามิเตอร์ 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`
เกาหลี	영상물등급위원회 (KMRB)	`contentDetails.contentRating.kmrbRating`
เม็กซิโก	สำนักผู้อำนวยการทั่วไปของวิทยุ โทรทัศน์ และภาพยนตร์ (RTC)	`contentDetails.contentRating.rtcRating`
นิวซีแลนด์	Office of Film and Literature Classification	`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` และอื่นๆ อย่างน้อย 1 รายการที่ระบุรหัสซึ่งระบุทรัพยากรนั้นได้อย่างไม่ซ้ำกัน
`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 อีกต่อไปหากคุณพยายามcreateหรืออัปเดตเพลย์ลิสต์ที่มีชื่อเหมือนกับเพลย์ลิสต์ที่มีอยู่แล้วในช่องเดียวกัน

เมธอด API หลายรายการรองรับข้อผิดพลาดประเภทใหม่ ตารางด้านล่างจะระบุวิธีการและข้อผิดพลาดที่รองรับใหม่

วิธีการ	ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
`guideCategories.list`	`notFound`	`notFound`	ไม่พบหมวดหมู่คำแนะนำที่ระบุโดยพารามิเตอร์ `id` ใช้เมธอด guideCategories.list เพื่อดึงข้อมูลรายการค่าที่ถูกต้อง
`playlistItems.delete`	`forbidden`	`playlistItemsNotAccessible`	คำขอไม่ได้รับอนุญาตอย่างถูกต้องให้ลบรายการเพลย์ลิสต์ที่ระบุ
`videoCategories.list`	`notFound`	`videoCategoryNotFound`	ไม่พบหมวดหมู่วิดีโอที่ระบุโดยพารามิเตอร์ `id` ใช้เมธอด videoCategories.list เพื่อเรียกข้อมูลรายการค่าที่ถูกต้อง