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

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

30 ตุลาคม 2024

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

ตัวอย่างเนื้อหา A/S ได้แก่ วิดีโอที่มีลักษณะต่อไปนี้

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

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

30 เมษายน 2024

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

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

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

13 มีนาคม 2024

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

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

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

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

12 มีนาคม 2024

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

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

ระบบได้อัปเดตคําจํากัดความของ liveStreamingDetails.concurrentViewers ของทรัพยากร video แล้ว โปรดทราบว่าจํานวนผู้ชมที่กลับมาชมพร้อมกันซึ่งแสดงผลจาก 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 ของตน สามารถสมัครเพื่อรับการยกเว้นลงในรายการที่อนุญาต หากต้องการสมัครขอรับการยกเว้น คุณต้องกรอกแบบฟอร์มการสมัครนี้

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

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

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

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

12 พฤษภาคม 2021

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

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

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

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

• พร็อพเพอร์ตี้ทรัพยากร channel ต่อไปนี้เลิกใช้งานแล้ว ระบบไม่รองรับพร็อพเพอร์ตี้เหล่านี้ใน UI ของ YouTube Studio และ YouTube อยู่แล้ว ด้วยเหตุนี้ จึงไม่ได้รับการรองรับผ่าน API อีกต่อไป

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

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

• พร็อพเพอร์ตี้ทรัพยากร channelSection ต่อไปนี้เลิกใช้งานแล้ว ระบบไม่รองรับพร็อพเพอร์ตี้เหล่านี้ใน UI ของ YouTube Studio และ YouTube อยู่แล้ว ด้วยเหตุนี้ ระบบจึงไม่รองรับการเรียกใช้ผ่าน API อีกต่อไป

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  ควบคู่ไปกับการเปลี่ยนแปลงนี้ เรายังได้เลิกใช้งานพารามิเตอร์ hl ของเมธอด channelSection.list ด้วยเนื่องจากระบบไม่รองรับฟีเจอร์ที่พารามิเตอร์ดังกล่าวรองรับ

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

• สําหรับพร็อพเพอร์ตี้ snippet.type ของทรัพยากร channelSection ระบบเลิกใช้งานค่าต่อไปนี้แล้ว ค่าเหล่านี้ไม่รองรับในหน้าช่อง YouTube อยู่แล้ว และด้วยเหตุนี้ ระบบจึงไม่รองรับค่าเหล่านี้ผ่าน API อีกต่อไป

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• เลิกใช้งานพร็อพเพอร์ตี้ snippet.tags[] ของทรัพยากร playlist แล้ว YouTube ไม่รองรับพร็อพเพอร์ตี้นี้แล้ว ด้วยเหตุนี้จึงไม่รองรับพร็อพเพอร์ตี้นี้ผ่าน API อีกต่อไป

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

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

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

28 มกราคม 2021

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

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

  ในทุกกรณี ข้อผิดพลาดนี้จะแสดงรหัสการตอบสนอง HTTP 400 (คำขอไม่ถูกต้อง)

• ระบบได้นำข้อผิดพลาด watchHistoryNotAccessible และ watchLaterNotAccessible ของเมธอด playlistItems.list ออกจากเอกสารประกอบแล้ว แม้ว่าจริงๆ แล้วประวัติการดูและรายการดูภายหลังของผู้ใช้จะเข้าถึงผ่าน API ไม่ได้ แต่ API จะไม่แสดงผลข้อผิดพลาดเหล่านี้

15 ตุลาคม 2020

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

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

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

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

8 ตุลาคม 2020

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

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

9 กันยายน 2020

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

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

• เราจะเลิกใช้งานทรัพยากร API, เมธอด, พารามิเตอร์ และพร็อพเพอร์ตี้ทรัพยากรต่อไปนี้โดยทันที และจะหยุดทำงานตั้งแต่วันที่ประกาศนี้เป็นต้นไป
  • พร็อพเพอร์ตี้ของทรัพยากร channel ต่อไปนี้
    • พร็อพเพอร์ตี้ statistics.commentCount
    • ออบเจ็กต์ brandingSettings.image และพร็อพเพอร์ตี้ย่อยทั้งหมดของออบเจ็กต์
    • รายการ brandingSettings.hints และพร็อพเพอร์ตี้ย่อยทั้งหมด
  • พารามิเตอร์ตัวกรอง 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 จะไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้ อย่างไรก็ตาม เราขอแนะนำเป็นอย่างยิ่งให้นักพัฒนาแอปทุกรายทำการตรวจสอบการปฏิบัติตามข้อกำหนดสำหรับโปรเจ็กต์ให้เสร็จสมบูรณ์ เพื่อให้เข้าถึงบริการ API ของ YouTube ได้ต่อไป

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

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

  ปัจจุบันระบบรองรับตัวอย่างโค้ดสําหรับ Java, JavaScript, PHP, Python และ curl

• นอกจากนี้ เครื่องมือตัวอย่างโค้ดยังได้รับการอัปเดต UI ใหม่ที่มีฟีเจอร์เดียวกันทั้งหมดดังที่อธิบายไว้ข้างต้น การใช้เครื่องมือดังกล่าวจะช่วยให้คุณสำรวจกรณีการใช้งานสำหรับวิธีการต่างๆ, โหลดค่าลงใน API Explorer และเปิด API Explorer แบบเต็มหน้าจอเพื่อรับตัวอย่างโค้ดใน Java, JavaScript, PHP และ Python

  การเปลี่ยนแปลงนี้ทำให้หน้าเว็บที่ก่อนหน้านี้แสดงรายการตัวอย่างโค้ดสำหรับ Java, JavaScript, PHP และ Python ถูกนำออกแล้ว

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

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

27 พฤศจิกายน 2017

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

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

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

  คุณยังเรียกและตั้งค่าข้อมูล invideoPromotion ได้จนถึงวันที่ 14 ธันวาคม 2017 สิ่งที่จะเกิดขึ้นหลังจากวันที่ดังกล่าว

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

  หลังจากวันที่ 27 พฤษภาคม 2018 เป็นต้นไป คำขอเหล่านี้อาจแสดงข้อความแสดงข้อผิดพลาดเพื่อระบุว่า invalidPromotion เป็นส่วนที่ไม่ถูกต้อง เป็นต้น

16 พฤศจิกายน 2017

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

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

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

  • ฟังก์ชัน removeEmptyParameters จะใช้รายการคู่คีย์-ค่าที่สอดคล้องกับพารามิเตอร์คำขอ API และนำพารามิเตอร์ที่ไม่มีค่าออก
  • ฟังก์ชัน createResource จะใช้รายการคู่คีย์-ค่าที่เกี่ยวข้องกับพร็อพเพอร์ตี้ในทรัพยากร API จากนั้นจะแปลงพร็อพเพอร์ตี้เป็นออบเจ็กต์ JSON ที่สามารถใช้ได้ในการดำเนินการ insert และ update ตัวอย่างด้านล่างแสดงชุดชื่อและค่าพร็อพเพอร์ตี้ รวมถึงออบเจ็กต์ JSON ที่โค้ดจะสร้าง

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

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

25 ตุลาคม 2017

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

• ตัวอย่างโค้ด Python ในเครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟได้รับการอัปเดตให้ใช้ไลบรารี google-auth และ google-auth-oauthlib แทนไลบรารี oauth2client ซึ่งตอนนี้เลิกใช้งานแล้ว

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

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

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

29 สิงหาคม 2017

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

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

24 กรกฎาคม 2017

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

• คู่มือเริ่มใช้งานฉบับย่อสำหรับ Data API ของ YouTube ใหม่พร้อมใช้งานแล้วสำหรับ iOS คู่มือนี้จะอธิบายวิธีใช้ YouTube Data API ในแอปพลิเคชัน iOS แบบง่ายที่เขียนด้วย Objective-C หรือ Swift
• ตอนนี้เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟสำหรับ YouTube Data API มีเอกสารประกอบที่อธิบายฟีเจอร์บางอย่างของเครื่องมือแล้ว
  • การดำเนินการกับคำขอ API
  • สลับระหว่างข้อมูลโค้ดกับตัวอย่างโค้ดแบบเต็ม
  • การใช้ฟังก์ชันที่เขียนไว้ล่วงหน้า
  • กำลังโหลดทรัพยากรที่มีอยู่ (สำหรับวิธีการอัปเดต)

  หมายเหตุ: เครื่องมือนี้ยังฝังอยู่ในเอกสารอ้างอิง API สําหรับเมธอด API ด้วย (ตัวอย่าง)

1 มิถุนายน 2017

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

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

  เราจะเลิกใช้งานพร็อพเพอร์ตี้ทรัพยากร video ต่อไปนี้ แม้ว่าระบบจะรองรับพร็อพเพอร์ตี้จนถึงวันที่ 1 ธันวาคม 2017 แต่ก็ไม่มีการรับประกันว่าวิดีโอจะแสดงค่าของพร็อพเพอร์ตี้เหล่านั้นต่อไปจนกว่าจะถึงวันดังกล่าว ในทํานองเดียวกัน คําขอ videos.insert และ videos.update ที่กําหนดค่าพร็อพเพอร์ตี้เหล่านั้นจะไม่สร้างข้อผิดพลาดก่อนวันที่ดังกล่าว แต่ก็เป็นไปได้ว่าระบบจะไม่จัดเก็บข้อมูลที่เข้ามาใหม่

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

17 พฤษภาคม 2017

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

• เราได้อัปเดตเอกสารอ้างอิง API เพื่อให้ข้อมูลโค้ดเข้าถึงได้ง่ายขึ้นและมีการโต้ตอบมากขึ้น ตอนนี้หน้าเว็บที่อธิบายวิธี API เช่น channels.list หรือ videos.rate มีเครื่องมือแบบอินเทอร์แอกทีฟที่ให้คุณดูและปรับแต่งข้อมูลโค้ดใน Java, JavaScript, PHP, Python, Ruby, Apps Script และ Go

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

  นอกจากนี้ คุณยังโต้ตอบกับตัวอย่างโค้ดได้ด้วย โดยทำดังนี้

  • แก้ไขค่าพารามิเตอร์และพร็อพเพอร์ตี้ จากนั้นข้อมูลโค้ดจะอัปเดตแบบไดนามิกเพื่อแสดงค่าที่คุณระบุ

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

  • ดำเนินการตามคำขอโดยคลิกปุ่ม (หากต้องการดำเนินการตามคำขอ คุณต้องให้สิทธิ์เครื่องมือเรียก API ในนามของคุณ)

  โปรดทราบว่าเครื่องมือนี้ได้แทนที่ API Explorer บนหน้าเว็บที่มีให้บริการ (แต่ละหน้าจะแสดงลิงก์เพื่อให้คุณมีตัวเลือกในการโหลดคำขอที่คุณกําลังทําในโปรแกรมสํารวจ API ด้วย)

• นอกจากนี้ เครื่องมือข้อมูลโค้ด API ข้อมูลยังได้รับการอัปเดตให้มี UI ใหม่ที่มีคุณลักษณะเดียวกันทั้งหมดดังที่อธิบายไว้ข้างต้น ฟีเจอร์ใหม่หลักๆ ที่มีอยู่ในหน้านี้มีดังนี้

  • การรองรับคำขอ API ที่เขียนข้อมูล
  • รองรับตัวอย่าง Java
  • โค้ดที่เขียนไว้ล่วงหน้าที่ยืดหยุ่นและครอบคลุมมากขึ้นสำหรับการให้สิทธิ์ผู้ใช้และสร้างคําขอ API

27 เมษายน 2017

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

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

30 มีนาคม 2017

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

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

27 กุมภาพันธ์ 2017

ตามที่ได้ประกาศไปเมื่อวันที่ 11 สิงหาคม 2016 ทาง YouTube ได้เปลี่ยนรายการรหัสหัวข้อที่รองรับเป็นรายการที่มีการดูแลจัดการ รายการรหัสหัวข้อที่รองรับทั้งหมดจะรวมอยู่ในพร็อพเพอร์ตี้ topicDetails สำหรับทรัพยากร channel และ video รวมถึงในพารามิเตอร์ topicId ของเมธอด search.list

โปรดทราบว่ารายการที่ดูแลจัดการมีการเปลี่ยนแปลงหลายอย่าง ดังนี้

• เราได้เพิ่มหัวข้อต่อไปนี้เป็นหัวข้อย่อยของ Society แล้ว

  ชื่อ	รหัสหัวข้อ
  ธุรกิจ	/m/09s1f
  สุขภาพ	/m/0kt51
  การทหาร	/m/01h6rj
  การเมือง	/m/05qt0
  ศาสนา	/m/06bvp

• หัวข้อ Animated cartoon ซึ่งก่อนหน้านี้เป็นส่วนย่อยของ Entertainment ถูกนำออกแล้ว
• หัวข้อ Children's music ซึ่งก่อนหน้านี้เป็นส่วนย่อยของ Music ถูกนำออกแล้ว

การเปลี่ยนแปลงนี้ส่งผลให้ระบบแสดงหัวข้อที่เกี่ยวข้องกับวิดีโอในค่าพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] ของvideo ทรัพยากรเสมอ

29 พฤศจิกายน 2016

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

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

19 พฤศจิกายน 2015

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

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

  คุณสามารถกําหนดค่าที่แปลแล้วสําหรับทรัพยากรได้เมื่อเรียกใช้เมธอด insert หรือ update สําหรับทรัพยากรนั้น หากต้องการตั้งค่าที่แปลแล้วสำหรับทรัพยากร ให้ทำทั้ง 2 อย่างต่อไปนี้

  • ตรวจสอบว่าได้ตั้งค่าสำหรับพร็อพเพอร์ตี้ snippet.defaultLanguage ของทรัพยากรแล้ว พร็อพเพอร์ตี้ดังกล่าวจะระบุภาษาของพร็อพเพอร์ตี้ snippet.title และ snippet.description ของทรัพยากร ค่าของฟิลด์นี้อาจเป็นภาษาของแอปพลิเคชันที่รองรับหรือรหัสภาษา ISO 639-1:2002 อื่นๆ ส่วนใหญ่ ตัวอย่างเช่น หากคุณอัปโหลดวิดีโอที่มีชื่อและคำอธิบายภาษาอังกฤษ คุณต้องตั้งค่าพร็อพเพอร์ตี้ snippet.defaultLanguage เป็น en

    หมายเหตุสำหรับการอัปเดตทรัพยากร channel: หากต้องการตั้งค่าพร็อพเพอร์ตี้ snippet.defaultLanguage สำหรับทรัพยากร channel คุณต้องอัปเดตพร็อพเพอร์ตี้ brandingSettings.channel.defaultLanguage

  • เพิ่มออบเจ็กต์ localizations ลงในทรัพยากรที่อัปเดต คีย์ออบเจ็กต์แต่ละรายการเป็นสตริงที่ระบุภาษาของแอปพลิเคชันหรือรหัสภาษา ISO 639-1:2002 และแต่ละคีย์จะแมปกับออบเจ็กต์ที่มีชื่อที่แปลแล้ว (และคำอธิบาย) สำหรับทรัพยากร

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

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        ...
      },
      "localizations":
        "de": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        },
        "es": {
          "title": "Jugar al fútbol",
          "description": "Nosotros jugamos fútbol en el parque los domingos",
        }
      }
    }

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

• การดึงค่าที่แปลแล้ว

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

• การอัปเดตทรัพยากรและวิธีการที่มีอยู่

  • พารามิเตอร์ตัวกรอง forDeveloper ใหม่ของเมธอด search.list จะจำกัดการค้นหาให้แสดงเฉพาะวิดีโอที่อัปโหลดผ่านแอปพลิเคชันหรือเว็บไซต์ของนักพัฒนาแอป พารามิเตอร์ forDeveloper สามารถใช้ร่วมกับพารามิเตอร์การค้นหาที่ไม่บังคับ เช่น พารามิเตอร์ q

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

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

    ฟีเจอร์ใหม่มีฟังก์ชันการทำงานที่คล้ายกัน (แม้จะไม่เหมือนกัน) กับฟังก์ชันของแท็กนักพัฒนาซอฟต์แวร์ที่ API v2 รองรับ

  • พร็อพเพอร์ตี้ 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 v2 ไม่รองรับ แต่รองรับใน v3 API ซึ่งได้แก่

  • การดึงข้อมูลความคิดเห็นเกี่ยวกับช่อง
  • เรียกดูชุดข้อความความคิดเห็นทั้งหมดที่เกี่ยวข้องกับช่อง ซึ่งหมายความว่าการตอบกลับจาก 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

• คู่มือการสมัครรับข้อความ Push ใหม่จะอธิบายการสนับสนุนใหม่ๆ ของ API สำหรับข้อความ Push ผ่าน 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) เพื่อสังเกตว่า v3 API จะรองรับฟีเจอร์ v2 API ต่อไปนี้

  • การแจ้งวิดีโอที่ไม่เหมาะสม

• เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล API ข้อมูลของ YouTube (v3) เพื่อสังเกตว่า API เวอร์ชัน 2 จะไม่รองรับฟีเจอร์ API เวอร์ชัน 2 ต่อไปนี้

  • ดึงข้อมูลวิดีโอแนะนำ – API เวอร์ชัน 3 จะไม่ดึงข้อมูลรายการที่มีเฉพาะวิดีโอที่แนะนำสำหรับผู้ใช้ API ปัจจุบัน อย่างไรก็ตาม คุณสามารถใช้ v3 API เพื่อค้นหาวิดีโอแนะนำได้โดยเรียกใช้เมธอด activities.list และตั้งค่าพารามิเตอร์ home เป็น true

    ในการตอบกลับของ API แหล่งข้อมูลจะสอดคล้องกับวิดีโอแนะนำหากค่าของพร็อพเพอร์ตี้ snippet.type คือ recommendation ในกรณีนี้ พร็อพเพอร์ตี้ contentDetails.recommendation.reason และ contentDetails.recommendation.seedResourceId จะมีข้อมูลเกี่ยวกับเหตุผลที่ระบบแนะนำวิดีโอ ทั้งนี้ เราไม่รับประกันว่าการตอบกลับจะมีวิดีโอแนะนำตามจำนวนที่เฉพาะเจาะจงใดๆ

  • เรียกข้อมูลช่องที่แนะนำ

  • เรียกดูวิดีโอที่ต้องสมัครรับข้อมูลใหม่ – API v3 จะไม่เรียกรายการที่มีเฉพาะวิดีโอซึ่งเพิ่งอัปโหลดไปยังช่องที่ผู้ใช้ API สมัครรับข้อมูล อย่างไรก็ตาม คุณสามารถใช้ v3 API เพื่อค้นหาวิดีโอการติดตามใหม่ได้โดยเรียกใช้เมธอด activities.list และตั้งค่าพารามิเตอร์ home เป็น true

    ในการตอบกลับของ API ทรัพยากรจะสอดคล้องกับวิดีโอการสมัครใช้บริการใหม่หากค่าของพร็อพเพอร์ตี้ snippet.type คือ upload โปรดทราบว่าเราไม่รับประกันว่าคำตอบจะมีวิดีโอการติดตามใหม่จำนวนหนึ่งๆ

  • การรองรับฟีด RSS

  • ข้อความ Push สำหรับการอัปเดตฟีด – ข้อความ Push ที่รองรับ v2 API โดยใช้ Simple Update Protocol (SUP) หรือ PubSubHubbub เพื่อตรวจสอบฟีดกิจกรรมของผู้ใช้สำหรับผู้ใช้ YouTube การแจ้งเตือนมีให้สำหรับการติดตามช่องใหม่ และเมื่อมีการให้คะแนน แบ่งปัน ทำเครื่องหมายเป็นรายการโปรด แสดงความคิดเห็น หรืออัปโหลด

    v3 API จะรองรับข้อความ Push โดยใช้โปรโตคอล PubSubHubbub แต่การแจ้งเตือนจะครอบคลุมเฉพาะการอัปโหลดวิดีโอและการอัปเดตชื่อวิดีโอหรือคำอธิบายวิดีโอ

  • ตำแหน่งของช่อง – v2 API ใช้แท็ก <yt:location> เพื่อระบุตำแหน่งของผู้ใช้ตามที่ป้อนในโปรไฟล์สาธารณะของ YouTube ของช่อง แม้ว่านักพัฒนาแอปบางรายจะใช้ช่องนี้เพื่อเชื่อมโยงช่องกับประเทศหนึ่งๆ แต่ข้อมูลของช่องก็ไม่สามารถนําไปใช้เพื่อวัตถุประสงค์ดังกล่าวได้อย่างสอดคล้องกัน

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

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

  • แสดงรายการวิดีโอตามวันที่เผยแพร่ ยอดดู หรือการจัดประเภท – ใน API เวอร์ชัน 2 พารามิเตอร์ orderby จะช่วยให้คุณจัดเรียงวิดีโอในเพลย์ลิสต์ตามตำแหน่ง ระยะเวลา วันที่เผยแพร่ ชื่อ และค่าอื่นๆ ได้อีกมากมาย ใน API เวอร์ชัน 3 โดยทั่วไปแล้วรายการเพลย์ลิสต์จะจัดเรียงตามลำดับจากน้อยไปมาก และตัวเลือกการจัดเรียงอื่นๆ จะใช้งานไม่ได้

    แต่มีข้อยกเว้นบางประการ ระบบจะเพิ่มวิดีโอที่อัปโหลด วิดีโอโปรด วิดีโอที่ชอบ หรือวิดีโอที่ดูล่าสุดโดยอัตโนมัติเป็นรายการแรก (snippet.position=0) สำหรับเพลย์ลิสต์ประเภทต่อไปนี้ ดังนั้น รายการเหล่านี้จึงจัดเรียงอย่างมีประสิทธิภาพตามลำดับจากใหม่สุดไปเก่าสุด ตามเวลาที่มีการเพิ่มสินค้าลงในรายการ

    • การอัปโหลดของผู้ใช้
    • วิดีโอโปรด
    • วิดีโอที่ชอบ
    • ประวัติการดู

    อย่างไรก็ตาม โปรดทราบว่ารายการใหม่ที่เพิ่มลงในเพลย์ลิสต์ "ดูภายหลัง" จะเพิ่มเป็นรายการสุดท้ายในเพลย์ลิสต์นั้น ดังนั้นรายการดังกล่าวจะจัดเรียงจากรายการเก่าที่สุดไปยังรายการใหม่ล่าสุด

  • การประมวลผลแบบกลุ่ม – API v3 รองรับกรณีการใช้งานการประมวลผลเป็นกลุ่มรายการใดรายการหนึ่งที่ API v2 เคยรองรับ เมธอด channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list และ videos.list ของ v3 API ทั้งหมดรองรับพารามิเตอร์ id ซึ่งสามารถใช้เพื่อระบุรายการรหัสที่คั่นด้วยคอมมา (รหัสวิดีโอ รหัสช่อง ฯลฯ) เมื่อใช้วิธีการเหล่านี้ คุณจะเรียกข้อมูลรายการทรัพยากรหลายรายการได้ด้วยคำขอเดียว

  เมื่อใช้การเปลี่ยนแปลงเหล่านี้ คำแนะนำจะระบุฟังก์ชันการทำงานทั้งหมดที่รองรับใน API เก่า (v2) ที่จะเลิกใช้งานใน API ปัจจุบัน (v3)

4 มีนาคม 2015

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

• ขณะนี้เมธอด channelSections.delete และ channelSections.update รองรับพารามิเตอร์ onBehalfOfContentOwner แล้ว ซึ่งวิธีอื่นๆ นั้นรองรับอยู่แล้ว

• เราได้เลิกใช้งานพร็อพเพอร์ตี้ต่อไปนี้และพร็อพเพอร์ตี้ย่อยของพร็อพเพอร์ตี้ดังกล่าว

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  หมายเหตุ: พร็อพเพอร์ตี้เหล่านี้ไม่ได้อยู่ภายใต้นโยบายการเลิกใช้งาน API

• พร็อพเพอร์ตี้ contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons ใหม่ของแหล่งข้อมูล video จะระบุเหตุผลที่อธิบายว่าเหตุใดวิดีโอจึงได้รับการจัดประเภท DJCQT (บราซิล)

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

  ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
  notFound (404)	channelNotFound	เมธอด channels.update จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์ id ของคำขอระบุแชแนลที่ไม่พบ
  badRequest (400)	manualSortRequiredinvalidValue	เมธอด playlistItems.insert และ playlistItems.update จะแสดงข้อผิดพลาดนี้หากคำขอพยายามตั้งค่าตำแหน่งของรายการเพลย์ลิสต์ แต่เพลย์ลิสต์ไม่ได้ใช้การจัดเรียงด้วยตนเอง เช่น รายการในเพลย์ลิสต์อาจจัดเรียงตามวันที่หรือความนิยม คุณแก้ไขข้อผิดพลาดนี้ได้โดยการนําองค์ประกอบ snippet.position ออกจากแหล่งข้อมูลที่ส่งในเนื้อหาคําขอ หากต้องการให้รายการในเพลย์ลิสต์มีตำแหน่งที่เฉพาะเจาะจงในรายการ คุณต้องอัปเดตการตั้งค่าการจัดลำดับของเพลย์ลิสต์เป็นกำหนดเองก่อน คุณปรับการตั้งค่านี้ได้ในเครื่องมือจัดการวิดีโอของ YouTube
  forbidden (403)	channelClosed	เมธอด playlists.list จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์ channelId ของคำขอระบุแชแนลที่ปิดไปแล้ว
  forbidden (403)	channelSuspended	เมธอด playlists.list จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์ channelId ของคำขอระบุช่องที่ถูกระงับ
  forbidden (403)	playlistForbidden	เมธอด playlists.list จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์ id ของคำขอไม่รองรับคำขอหรือคำขอไม่ได้รับอนุญาตอย่างถูกต้อง
  notFound (404)	channelNotFound	เมธอด playlists.list จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์ channelId ของคําขอระบุแชแนลที่หาไม่พบ
  notFound (404)	playlistNotFound	เมธอด playlists.list จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์ id ของคำขอระบุเพลย์ลิสต์ที่หาไม่พบ
  notFound (404)	videoNotFound	เมธอด videos.list จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์ id ของคำขอระบุวิดีโอที่ไม่พบ
  badRequest (400)	invalidRating	เมธอด videos.rate จะแสดงผลข้อผิดพลาดนี้หากคำขอมีค่าที่ไม่คาดคิดสำหรับพารามิเตอร์ rating

2 มีนาคม 2015

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

• ตอนนี้เมธอด search.list รองรับพารามิเตอร์ relevanceLanguage แล้ว ซึ่งจะช่วยให้คุณขอผลการค้นหาที่เกี่ยวข้องกับภาษาใดภาษาหนึ่งมากที่สุดได้

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

• เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล YouTube Data API (v3) เพื่อระบุการเลิกใช้งานฟีดพิเศษและฟิลด์ข้อมูลเมตาที่ v2 มีให้ในการอธิบายภาพยนตร์ ตัวอย่าง รายการทีวี ซีซันรายการทีวี และตอนต่างๆ ของรายการโทรทัศน์

14 มกราคม 2015

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

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

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

• เอกสารประกอบสําหรับเมธอด videos.insert ได้รับการอัปเดตให้รวมตัวอย่างโค้ด JavaScript ใหม่ที่อธิบายไว้ข้างต้น มีการอัปเดตรายการตัวอย่างโค้ด JavaScript สำหรับ YouTube Data API (v3) ด้วย

11 พฤศจิกายน 2014

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

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

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

  • ต้นทุนโควต้า: 100 หน่วย

    เรียกใช้เมธอด search.list และค้นหา GoogleDevelopers

  • ต้นทุนโควต้า: 6 หน่วย

    เรียกใช้เมธอด channels.list เพื่อค้นหารหัสช่องที่ถูกต้อง ตั้งค่าพารามิเตอร์ forUsername เป็น GoogleDevelopers และพารามิเตอร์ part เป็น contentDetails ในคำตอบของ API พร็อพเพอร์ตี้ contentDetails.relatedPlaylists.uploads จะระบุรหัสเพลย์ลิสต์สำหรับวิดีโอที่อัปโหลดของช่อง

    จากนั้นเรียกเมธอด playlistItems.list และตั้งค่าพารามิเตอร์ playlistId เป็นรหัสที่บันทึกไว้และพารามิเตอร์ part เป็น snippet

8 ตุลาคม 2014

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

• แหล่งข้อมูล channel มีพร็อพเพอร์ตี้ใหม่ 2 รายการ ได้แก่

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

    • allowed – ช่องสามารถอัปโหลดวิดีโอที่มีความยาวเกิน 15 นาที
    • eligible – ช่องมีสิทธิ์อัปโหลดวิดีโอที่มีความยาวเกิน 15 นาที แต่ต้องเปิดใช้ฟีเจอร์นี้ก่อน
    • disallowed – ช่องไม่มีสิทธิ์หรือไม่สามารถอัปโหลดวิดีโอที่มีความยาวเกิน 15 นาที

    ดูข้อมูลเพิ่มเติมเกี่ยวกับค่าเหล่านี้ได้ที่คำจำกัดความพร็อพเพอร์ตี้ นอกจากนี้ ศูนย์ช่วยเหลือของ YouTube ยังมีข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับฟีเจอร์นี้

  • พร็อพเพอร์ตี้ invideoPromotion.useSmartTiming ระบุว่าแคมเปญโปรโมชันของช่องใช้ "การกำหนดเวลาที่เหมาะสม" หรือไม่ ฟีเจอร์นี้จะพยายามแสดงโปรโมชันในจุดของวิดีโอที่มีแนวโน้มที่จะได้รับคลิกมากกว่าและรบกวนประสบการณ์การรับชมน้อยลง ฟีเจอร์นี้ยังเลือกใช้โปรโมชันรายการเดียวเพื่อแสดงในวิดีโอแต่ละรายการด้วย

• ทั้งคำจำกัดความของพร็อพเพอร์ตี้ snippet.title และ snippet.categoryId ของทรัพยากร video ได้รับการอัปเดตเพื่ออธิบายวิธีที่ API จัดการการเรียกเมธอด videos.update หากคุณเรียกใช้เมธอดดังกล่าวเพื่ออัปเดตส่วน snippet ของทรัพยากร video คุณต้องตั้งค่าสำหรับพร็อพเพอร์ตี้ทั้ง 2 รายการดังกล่าว

  หากคุณพยายามอัปเดตส่วน snippet ของทรัพยากร video แต่ไม่ได้กำหนดค่าให้กับพร็อพเพอร์ตี้ทั้ง 2 รายการ API จะแสดงข้อผิดพลาด invalidRequest รายละเอียดของข้อผิดพลาดดังกล่าวได้รับการอัปเดตด้วย

• ตอนนี้พร็อพเพอร์ตี้ contentDetails.contentRating.oflcRating ของแหล่งข้อมูล video ซึ่งระบุการจัดประเภทของวิดีโอจากสำนักงานการจัดประเภทภาพยนตร์และวรรณกรรมของนิวซีแลนด์รองรับการจัดประเภทใหม่ 2 ประเภท ได้แก่ oflcRp13 และ oflcRp16 ซึ่งสอดคล้องกับการให้คะแนน RP13 และ RP16 ตามลำดับ

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

  ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
  badRequest	bannerAlbumFull	อัลบั้มหน้าปกช่อง YouTube ของเจ้าของช่องมีรูปภาพมากเกินไป เจ้าของช่องควรไปที่ http://photos.google.com, ไปที่หน้าอัลบั้ม และนำรูปภาพบางส่วนออกจากอัลบั้มนั้น

12 กันยายน 2014

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

• ต้นทุนโควต้าสำหรับการเรียกเมธอด search.list เปลี่ยนจาก 1 หน่วยเป็น 2 หน่วย นอกเหนือจากต้นทุนของส่วนทรัพยากรที่ระบุ

13 สิงหาคม 2014

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

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

  ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
  badRequest	subscriptionLimitExceeded	สมาชิกที่ระบุพร้อมคำขอเกินขีดจำกัดอัตราการสมัครใช้บริการแล้ว คุณลองสมัครใช้บริการอีกครั้งได้ภายใน 2-3 ชั่วโมง

12 สิงหาคม 2014

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

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

8 กรกฎาคม 2014

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

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

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

18 มิถุนายน 2014

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

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

  โปรดทราบว่าค่าใช้จ่ายตามโควต้าอาจมีการเปลี่ยนแปลงโดยไม่ต้องแจ้งเตือน

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

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 ต่อไปนี้ลงในรายการค่าที่ตั้งได้เมื่อแทรกหรืออัปเดตวิดีโอ

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• ตอนนี้เอกสารข้อผิดพลาดจะระบุโค้ดตอบกลับ 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

• รูปภาพแบนเนอร์ของช่องที่อัปโหลดมีขนาดต่ำสุด 2048px x 1152px (ก่อนหน้านี้ขนาดขั้นต่ำคือ 2120 x 1192 พิกเซล) นอกจากนี้ โปรดทราบว่าเอกสารประกอบchannelทรัพยากรจะระบุขนาดสูงสุดของรูปภาพแบนเนอร์ทั้งหมดที่แสดงจาก API ตัวอย่างเช่น ขนาดสูงสุดของรูปภาพ brandingSettings.image.bannerTvImageUrl สำหรับแอปพลิเคชันโทรทัศน์คือ 2120 x 1192 พิกเซล แต่รูปภาพจริงอาจมีขนาด 2048 x 1152 พิกเซล ศูนย์ช่วยเหลือของ YouTube มีคำแนะนำเพิ่มเติมในการเพิ่มประสิทธิภาพหน้าปกช่องเพื่อการแสดงผลบนอุปกรณ์ประเภทต่างๆ

• เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ทรัพยากร channel หลายรายการเพื่อให้สอดคล้องกับข้อมูลต่อไปนี้

  • ค่าของพร็อพเพอร์ตี้ brandingSettings.channel.description มีความยาวได้สูงสุด 1,000 อักขระ
  • พร็อพเพอร์ตี้ brandingSettings.channel.featuredChannelsTitle มีความยาวได้สูงสุด 30 อักขระ
  • ตอนนี้พร็อพเพอร์ตี้ brandingSettings.channel.featuredChannelsUrls[] แสดงช่องได้สูงสุด 100 ช่องแล้ว
  • ค่าพร็อพเพอร์ตี้ brandingSettings.channel.unsubscribedTrailer (หากมีการตั้งค่า) ต้องระบุรหัสวิดีโอ YouTube ของวิดีโอสาธารณะหรือวิดีโอไม่เป็นสาธารณะที่เจ้าของช่องเป็นเจ้าของ

• ตอนนี้เมธอด channels.update รองรับการอัปเดตพร็อพเพอร์ตี้ invideoPromotion.items[].promotedByContentOwner แล้ว พร็อพเพอร์ตี้ดังกล่าวระบุว่าชื่อของเจ้าของเนื้อหาจะแสดงเมื่อแสดงโปรโมชันหรือไม่ โดยจะตั้งค่าได้ต่อเมื่อมีการสร้างคำขอ API ที่ตั้งค่าพร็อพเพอร์ตี้ในนามของเจ้าของเนื้อหาโดยใช้พารามิเตอร์ onBehalfOfContentOwner

• ขณะนี้เมธอด playlistItems.list และ playlistItems.insert รองรับพารามิเตอร์ onBehalfOfContentOwner แล้ว ซึ่งวิธีอื่นๆ นั้นรองรับอยู่แล้ว

• ตอนนี้พร็อพเพอร์ตี้ contentDetails.contentRating.acbRating สามารถระบุการจัดประเภทจากคณะกรรมการการจัดประเภทของออสเตรเลีย (Australian Classification Board หรือ ACB) สำหรับภาพยนตร์ หรือจากหน่วยงานการสื่อสารและสื่อของออสเตรเลีย (Australian Communications and Media Authority หรือ ACMA) สำหรับรายการทีวีสำหรับเด็ก

• พร็อพเพอร์ตี้ contentDetails.contentRating.catvRating และ contentDetails.contentRating.catvfrRating ใหม่จะระบุการจัดประเภทที่วิดีโอได้รับภายใต้ระบบการจัดประเภททีวีของแคนาดาและระบบการจัดประเภทภาษาฝรั่งเศสของ Régie du cinéma ซึ่งใช้ในควิเบกตามลำดับ

• พร็อพเพอร์ตี้ snippet.assignable ใหม่ของทรัพยากร videoCategory จะระบุว่าวิดีโอที่อัปเดตหรือวิดีโอที่อัปโหลดใหม่เชื่อมโยงกับหมวดหมู่วิดีโอดังกล่าวได้หรือไม่

• เพิ่มตัวอย่างโค้ดสำหรับวิธีการต่อไปนี้แล้ว

  • activities.insert (Go)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Go)
  • search.list (ไป)
  • 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 แล้ว มีการรองรับพารามิเตอร์ทั้งสองสำหรับวิธีการอื่นๆ อยู่แล้ว

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

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

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

15 สิงหาคม 2013

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

• ออบเจ็กต์ invideoPromotion ของทรัพยากร channel มีพร็อพเพอร์ตี้ใหม่และที่อัปเดตต่อไปนี้

  • ตอนนี้ API รองรับความสามารถในการระบุเว็บไซต์เป็นรายการที่โปรโมตแล้ว ซึ่งทำได้โดยตั้งค่าพร็อพเพอร์ตี้ invideoPromotion.items[].id.type เป็น website และใช้พร็อพเพอร์ตี้ invideoPromotion.items[].id.websiteUrl ใหม่เพื่อระบุ URL นอกจากนี้ ให้ใช้พร็อพเพอร์ตี้ invideoPromotion.items[].customMessage ใหม่เพื่อกำหนดข้อความที่กำหนดเองที่จะแสดงสำหรับโปรโมชัน

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

    การเพิ่มลิงก์โปรโมชันหมายความว่าคุณยอมรับว่าจะไม่มีการนำลิงก์เหล่านั้นไปใช้เปลี่ยนเส้นทางการเข้าชมไปยังเว็บไซต์ที่ไม่ได้รับอนุญาต และลิงก์เหล่านั้นจะเป็นไปตามนโยบาย AdWords, นโยบายโฆษณาของ YouTube, หลักเกณฑ์ของชุมชน YouTube และข้อกำหนดในการให้บริการของ YouTube

  • มีการปรับโครงสร้างคุณสมบัติที่เกี่ยวข้องกับการตั้งค่าเวลาสำหรับแสดงรายการที่โปรโมตในระหว่างการเล่นวิดีโอใหม่ ดังนี้

    • ย้ายออบเจ็กต์ invideoPromotion.timing ไปที่ invideoPromotion.items[].timing แล้ว ตอนนี้ออบเจ็กต์นี้ช่วยให้คุณปรับแต่งข้อมูลช่วงเวลาสำหรับรายการที่โปรโมตแต่ละรายการในรายการ invideoPromotion.items[] ได้

    • ออบเจ็กต์ invideoPromotion.defaultTiming ใหม่จะระบุการตั้งค่าช่วงเวลาเริ่มต้นสำหรับโปรโมชัน การตั้งค่าดังกล่าวจะกำหนดว่ารายการที่โปรโมตจะแสดงเมื่อใดระหว่างการเล่นวิดีโอรายการใดรายการหนึ่งในช่องของคุณ คุณลบล้างเวลาเริ่มต้นสำหรับรายการที่โปรโมตที่กำหนดได้โดยใช้ออบเจ็กต์ invideoPromotion.items[].timing

    • พร็อพเพอร์ตี้ invideoPromotion.items[].timing.durationMs ใหม่จะระบุระยะเวลาเป็นมิลลิวินาทีที่โปรโมชันควรแสดง ออบเจ็กต์ invideoPromotion.defaultTiming ยังมีช่อง durationMs ที่ระบุระยะเวลาเริ่มต้นที่รายการที่โปรโมตจะแสดงด้วย

  • ย้ายทั้งพร็อพเพอร์ตี้ invideoPromotion.items[].type และ invideoPromotion.items[].videoId ไปยังออบเจ็กต์ invideoPromotion.items[].id แล้ว

• ตอนนี้เมธอด subscriptions.list รองรับพารามิเตอร์ onBehalfOfContentOwner และ onBehalfOfContentOwnerChannel แล้ว มีการรองรับพารามิเตอร์ทั้งสองสำหรับวิธีการอื่นๆ อยู่แล้ว

• ในการตอบกลับ API สำหรับคำขอ thumbnails.set ค่าพร็อพเพอร์ตี้ kind ได้เปลี่ยนจาก youtube#thumbnailListResponse เป็น youtube#thumbnailSetResponse

• เพิ่มตัวอย่างโค้ดสำหรับวิธีการต่อไปนี้แล้ว

  • channels.update (Java, Python)
  • playlists.insert (.NET, PHP)
  • subscriptions.insert (PHP, Python)
  • thumbnails.set (PHP, Python)
  • videos.insert (PHP)
  • videos.list (PHP)
  • videos.rate (Python)
  • videos.update (Java, PHP, Python)

  โปรดทราบว่าตัวอย่าง Python สำหรับเมธอด playlistItems.insert นั้นถูกนำออกด้วย เนื่องจากตอนนี้ฟังก์ชันการทำงานที่แสดงนั้นจัดการโดยเมธอด videos.rate แล้ว

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

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

8 สิงหาคม 2013

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

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

30 กรกฎาคม 2013

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

• ในทรัพยากร channelBanner ค่าของพร็อพเพอร์ตี้ kind เปลี่ยนจาก youtube#channelBannerInsertResponse เป็น youtube#channelBannerResource ทรัพยากรนี้จะแสดงผลตามคำขอ channelBanners.insert

• พร็อพเพอร์ตี้ brandingSettings.channel.profileColor ใหม่ของทรัพยากร channel ระบุสีที่โดดเด่นซึ่งส่งเสริมเนื้อหาของช่อง ค่าพร็อพเพอร์ตี้คือเครื่องหมายปอนด์ (#) ตามด้วยสตริงฐานสิบหก 6 อักขระ เช่น #2793e6

• ตอนนี้ API รองรับการกำหนดว่าการติดตามมีไว้สำหรับกิจกรรมทั้งหมดของช่องหรือสำหรับการอัปโหลดใหม่เท่านั้น พร็อพเพอร์ตี้ contentDetails.activityType ใหม่ของทรัพยากร subscription ระบุประเภทของกิจกรรมที่สมาชิกจะได้รับแจ้ง ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ all และ uploads

• เมธอด videos.list รองรับพารามิเตอร์ใหม่สำหรับการดึงข้อมูลชาร์ตวิดีโอที่ได้รับความนิยมสูงสุดบน YouTube ดังนี้

  • พารามิเตอร์ chart ระบุแผนภูมิที่คุณต้องการดึงข้อมูล ปัจจุบันค่าที่รองรับมีเพียง mostPopular ค่า โปรดทราบว่าพารามิเตอร์ chart คือพารามิเตอร์ตัวกรอง ซึ่งหมายความว่าจะใช้ในคำขอเดียวกับพารามิเตอร์ตัวกรองอื่นๆ (id และ myRating) ไม่ได้
  • พารามิเตอร์ videoCategoryId ระบุหมวดหมู่วิดีโอที่ควรดึงข้อมูลแผนภูมิ พารามิเตอร์นี้ใช้ได้เฉพาะร่วมกับพารามิเตอร์ chart เท่านั้น โดยค่าเริ่มต้น แผนภูมิจะไม่จำกัดเฉพาะหมวดหมู่ใดหมวดหมู่หนึ่ง

• พร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] ใหม่ของทรัพยากร video จะแสดงรายการรหัสหัวข้อ Freebase ที่เกี่ยวข้องกับวิดีโอหรือเนื้อหา เรื่องของหัวข้อเหล่านี้อาจกล่าวถึงหรือปรากฏในวิดีโอ

• พร็อพเพอร์ตี้ recordingDetails.location.elevation ของทรัพยากร video ได้เปลี่ยนชื่อเป็น recordingDetails.location.altitude และพร็อพเพอร์ตี้ fileDetails.recordingLocation.location.elevation ได้เปลี่ยนชื่อเป็น fileDetails.recordingLocation.location.altitude

• ออบเจ็กต์ contentDetails.contentRating ของทรัพยากร video ระบุการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ รวมถึงการจัดประเภทของ MPAA, การจัดประเภท TVPG และอื่นๆ สำหรับระบบการจัดประเภทแต่ละระบบ ตอนนี้ API รองรับค่าการจัดประเภทที่ระบุว่าวิดีโอยังไม่ได้รับการจัดประเภท โปรดทราบว่าสำหรับการจัดประเภทของ MPAA ระบบมักใช้การจัดประเภท "ไม่มีการจัดประเภท" เพื่อระบุภาพยนตร์เวอร์ชันเวอร์ชันเต็มซึ่งเวอร์ชันตัดต่อได้รับการจัดประเภทอย่างเป็นทางการ

• พร็อพเพอร์ตี้ contentDetails.contentRating.ytRating ใหม่ของทรัพยากร video จะระบุเนื้อหาที่จำกัดอายุผู้ชม ค่าพร็อพเพอร์ตี้จะเป็น ytAgeRestricted หาก YouTube ระบุว่าวิดีโอมีเนื้อหาที่ไม่เหมาะสมสำหรับผู้ใช้ที่มีอายุต่ำกว่า 18 ปี หากไม่มีพร็อพเพอร์ตี้หรือค่าพร็อพเพอร์ตี้ว่าง แสดงว่าเนื้อหาไม่ได้ระบุว่ามีการจำกัดอายุผู้ชม

• พารามิเตอร์ mySubscribers ของเมธอด channels.list เลิกใช้งานแล้ว ใช้เมธอด subscriptions.list และพารามิเตอร์ mySubscribers ของเมธอดเพื่อเรียกข้อมูลรายการสมาชิกของช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์แล้ว

• ตอนนี้เมธอด channelBanners.insert, channels.update, videos.getRating และ videos.rate ทั้งหมดรองรับพารามิเตอร์ onBehalfOfContentOwner แล้ว พารามิเตอร์ดังกล่าวระบุว่าผู้ใช้ที่ตรวจสอบสิทธิ์แล้วดำเนินการในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์

• เอกสารประกอบของเมธอด channels.update ได้รับการอัปเดตเพื่อแสดงข้อเท็จจริงที่ว่าเมธอดนั้นใช้เพื่ออัปเดตออบเจ็กต์ brandingSettings และพร็อพเพอร์ตี้ย่อยของทรัพยากร channel ได้ เอกสารประกอบยังแสดงรายการพร็อพเพอร์ตี้ที่อัปเดตแล้วซึ่งคุณตั้งค่าสำหรับออบเจ็กต์ invideoPromotion ของทรัพยากร channel ได้ด้วย

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

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

10 มิถุนายน 2013

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

• พารามิเตอร์ forUsername ใหม่ของเมธอด channels.list ช่วยให้คุณเรียกข้อมูลเกี่ยวกับช่องได้ด้วยการป้อนชื่อผู้ใช้ YouTube ของช่องนั้น

• ตอนนี้เมธอด activities.list รองรับพารามิเตอร์ regionCode แล้ว ซึ่งจะบอกให้ API แสดงผลลัพธ์ที่เกี่ยวข้องกับประเทศที่ระบุ YouTube จะใช้ค่านี้เมื่อกิจกรรมก่อนหน้าของผู้ใช้ที่ได้รับอนุญาตใน YouTube ไม่มีข้อมูลเพียงพอที่จะสร้างฟีดกิจกรรม

• ทรัพยากรสำหรับเพลย์ลิสต์มีพร็อพเพอร์ตี้ snippet.tags แล้ว ระบบจะแสดงพร็อพเพอร์ตี้ต่อผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับเพลย์ลิสต์ของตนเองเท่านั้น นอกจากนี้ ผู้ใช้ที่ได้รับอนุญาตยังตั้งค่าแท็กเพลย์ลิสต์ได้เมื่อเรียกใช้เมธอด playlists.insert หรือ playlists.update

• ตอนนี้พารามิเตอร์ onBehalfOfContentOwner ซึ่งก่อนหน้านี้รองรับเมธอด channels.list และ search.list ก็รองรับเมธอด videos.insert, videos.update และ videos.delete แล้วเช่นกัน โปรดทราบว่าเมื่อใช้พารามิเตอร์นี้ในการเรียกใช้เมธอด videos.insert คําขอต้องระบุค่าสําหรับพารามิเตอร์ onBehalfOfContentOwnerChannel ใหม่ด้วย ซึ่งระบุช่องที่จะเพิ่มวิดีโอ ช่องต้องลิงก์กับเจ้าของเนื้อหาที่พารามิเตอร์ onBehalfOfContentOwner ระบุ

  พารามิเตอร์นี้ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ 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 ต้องระบุพารามิเตอร์ที่แน่ชัด 1 รายการ (ก่อนหน้านี้พารามิเตอร์ id ต้องเป็นพารามิเตอร์ที่ต้องระบุสำหรับเมธอดนี้)

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

• เมื่อมีการแนะนำพารามิเตอร์ myRating ระบบจะอัปเดตเมธอด videos.list ให้รองรับการใส่เลขหน้า อย่างไรก็ตาม โปรดทราบว่าระบบรองรับพารามิเตอร์การแบ่งหน้าสําหรับคําขอที่ใช้พารามิเตอร์ myRating เท่านั้น (ระบบไม่รองรับพารามิเตอร์และข้อมูลการแบ่งหน้าสําหรับคําขอที่ใช้พารามิเตอร์ id)

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

  • ทรัพยากร youtube#videoListResponse ซึ่งแสดงผลตามคำขอ videos.list มีออบเจ็กต์ pageInfo ซึ่งมีรายละเอียด เช่น จำนวนผลลัพธ์ทั้งหมด และจำนวนผลลัพธ์ที่รวมอยู่ในชุดผลลัพธ์ปัจจุบัน แหล่งข้อมูล youtube#videoListResponse อาจมีพร็อพเพอร์ตี้ nextPageToken และ prevPageToken ด้วย โดยแต่ละรายการจะมีโทเค็นที่สามารถใช้ดึงข้อมูลหน้าเว็บที่เฉพาะเจาะจงในชุดผลลัพธ์

• เมธอด videos.insert รองรับพารามิเตอร์ใหม่ต่อไปนี้

  • autoLevels – ตั้งค่าพารามิเตอร์นี้เป็น true เพื่อสั่งให้ YouTube ปรับแสงและสีของวิดีโอโดยอัตโนมัติ
  • stabilize – ตั้งค่าพารามิเตอร์นี้เป็น true เพื่อสั่งให้ YouTube ปรับวิดีโอโดยนำการสั่นซึ่งเกิดจากการเคลื่อนไหวของกล้องออก

• เพิ่มพร็อพเพอร์ตี้ channelTitle ลงใน snippet สำหรับแหล่งข้อมูลต่อไปนี้แล้ว

  • playlistItem – พร็อพเพอร์ตี้ระบุชื่อของช่องที่เพิ่มรายการเพลย์ลิสต์
  • playlist – พร็อพเพอร์ตี้ระบุชื่อช่องที่สร้างเพลย์ลิสต์
  • subscription – พร็อพเพอร์ตี้ระบุชื่อของช่องที่ติดตาม

• เราได้เพิ่มตัวอย่างโค้ดสำหรับเมธอดต่อไปนี้

  • activities.insert (ทับทิม)
  • playlistItems.list (.NET)
  • search.list (.NET)
  • subscriptions.insert (Java, Ruby)
  • videos.insert (.NET, Ruby)

• พารามิเตอร์ mySubscribers ใหม่ของเมธอด subscriptions.list ช่วยให้คุณเรียกข้อมูลรายการสมาชิกของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบันได้ สามารถใช้พารามิเตอร์นี้ในคำขอที่ได้รับอนุญาตอย่างถูกต้องเท่านั้น

  หมายเหตุ: ฟังก์ชันนี้มีไว้เพื่อแทนที่พารามิเตอร์ mySubscribers ที่รองรับสําหรับเมธอด channels.list ในปัจจุบัน เราจะเลิกใช้งานพารามิเตอร์ดังกล่าว

• ในทรัพยากร video ค่าพร็อพเพอร์ตี้ unspecified จะไม่ได้เป็นค่าที่เป็นไปได้สำหรับพร็อพเพอร์ตี้ต่อไปนี้อีกต่อไป

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• ขณะนี้คำขอ 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 ฯลฯ ที่ระบุรหัสที่ระบุทรัพยากรนั้นแบบไม่ซ้ำ
  channel	status	object	ออบเจ็กต์นี้สรุปข้อมูลเกี่ยวกับสถานะความเป็นส่วนตัวของช่อง
  channel	status.privacyStatus	string	สถานะความเป็นส่วนตัวของช่อง ค่าที่ถูกต้องคือ private และ public
  playlist	contentDetails	object	ออบเจ็กต์นี้มีข้อมูลเมตาเกี่ยวกับเนื้อหาของเพลย์ลิสต์
  playlist	contentDetails.itemCount	unsigned integer	จำนวนวิดีโอในเพลย์ลิสต์
  playlist	player	object	วัตถุนี้มีข้อมูลที่คุณจะใช้เพื่อเล่นเพลย์ลิสต์ในโปรแกรมเล่นแบบฝัง
  playlist	player.embedHtml	string	แท็ก <iframe> ที่ฝังวิดีโอเพลเยอร์ซึ่งเล่นเพลย์ลิสต์
  video	recordingDetails	object	ออบเจ็กต์นี้สรุปข้อมูลที่ระบุหรืออธิบายสถานที่และเวลาที่มีการบันทึกวิดีโอ
  video	recordingDetails.location	object	วัตถุนี้มีข้อมูลตำแหน่งทางภูมิศาสตร์ที่เชื่อมโยงกับวิดีโอ
  video	recordingDetails.location.latitude	double	ละติจูด หน่วยเป็นองศา
  video	recordingDetails.location.longitude	double	ลองจิจูดเป็นองศา
  video	recordingDetails.location.elevation	double	ความสูงเหนือพื้นโลกเป็นเมตร
  video	recordingDetails.locationDescription	string	คำอธิบายแบบข้อความของสถานที่ถ่ายทำวิดีโอ
  video	recordingDetails.recordingDate	datetime	วันที่และเวลาที่บันทึกวิดีโอ ค่าที่ระบุอยู่ในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ)

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

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

  วิธีการ	พร็อพเพอร์ตี้
  activities.insert	พร็อพเพอร์ตี้ที่จำเป็น snippet.description พร็อพเพอร์ตี้ที่แก้ไขได้ snippet.description contentDetails.bulletin.resourceId
  playlists.update	พร็อพเพอร์ตี้ที่จำเป็น: id
  playlistItems.update	พร็อพเพอร์ตี้ที่จำเป็น id
  videos.update	พร็อพเพอร์ตี้ที่จำเป็น id

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

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

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