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

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

22 สิงหาคม 2022

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

5 สิงหาคม 2022

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

ระหว่างวันที่ปัจจุบันจนถึงวันที่ 1 ธันวาคม 2022 เมธอด captions.list, captions.update, captions.download และ captions.delete จะรองรับทั้งรหัสแทร็กคําบรรยายวิดีโอเก่าและใหม่ อย่างไรก็ตาม ตั้งแต่วันที่ 1 ธันวาคม 2022 เป็นต้นไป YouTube จะหยุดรองรับรหัสแทร็กคําบรรยายวิดีโอเก่า เมื่อถึงเวลานั้น การเรียกเมธอด API เหล่านั้นด้วยรหัสแทร็กคําบรรยายวิดีโอเก่าจะทําให้เกิดข้อผิดพลาด captionNotFound

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

12 กรกฎาคม 2022

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

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

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

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

12 พฤษภาคม 2021

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

28 มกราคม 2021

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

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

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

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

15 ตุลาคม 2020

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

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

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

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

8 ตุลาคม 2020

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

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

9 กันยายน 2020

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

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

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

29 กรกฎาคม 2020

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

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

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

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

28 กรกฎาคม 2020

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

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

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

21 กรกฎาคม 2020

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

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

7 กรกฎาคม 2020

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

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

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

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

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

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

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

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

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

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

9 กรกฎาคม 2018

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

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

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

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

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

22 มิถุนายน 2018

เราได้อัปเดตคู่มือการใช้งาน (ก่อนหน้านี้เรียกว่าคู่มือการใช้งานและการย้ายข้อมูล) เพื่อนําคําแนะนําในการย้ายข้อมูลจาก API v2 ไปยัง 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

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

    • ฟังก์ชัน removeEmptyParameters จะใช้รายการคู่คีย์-ค่าที่สอดคล้องกับพารามิเตอร์คําขอ API และนําพารามิเตอร์ที่ไม่มีค่าออก
    • ฟังก์ชัน createResource จะใช้รายการคู่คีย์-ค่าที่ตรงกับพร็อพเพอร์ตี้ในทรัพยากร API จากนั้นจะแปลงพร็อพเพอร์ตี้เป็นออบเจ็กต์ JSON ที่ใช้ได้ในการใช้งาน insert และ update ตัวอย่างด้านล่างแสดงชุดชื่อและค่าพร็อพเพอร์ตี้ รวมถึงออบเจ็กต์ JSON ที่โค้ดจะสร้างขึ้นมา
      # Key-value pairs:
      {'id': 'ABC123',
       'snippet.title': 'Resource title',
       'snippet.description': 'Resource description',
       'status.privacyStatus': 'private'}
      
      # JSON object:
      {
       'id': 'ABC123',
       'snippet': {
         'title': 'Resource title',
         'description': 'Resource description',
       },
       'status': {
         'privacyStatus': 'private'
       }
      }

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

25 ตุลาคม 2017

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

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

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

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

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

29 สิงหาคม 2017

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

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

24 กรกฎาคม 2017

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

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

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

1 มิถุนายน 2017

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

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

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

17 พฤษภาคม 2017

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

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

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

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

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

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

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

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

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

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

27 เมษายน 2017

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

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

30 มีนาคม 2017

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

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

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

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

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

  • เพิ่มหัวข้อต่อไปนี้เป็นหัวข้อย่อยของ Society แล้ว
    ชื่อรหัสหัวข้อ
    Business/m/09s1f
    สุขภาพ/m/0kt51
    การทหาร/m/01h6rj
    การเมือง/m/05qt0
    ศาสนา/m/06bvp
  • นําหัวข้อ Animated cartoon ซึ่งก่อนหน้านี้เป็นเด็กของ Entertainment ออกแล้ว
  • นําหัวข้อ Children's music ซึ่งก่อนหน้านี้เป็นเด็กของ Music ออกแล้ว

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

29 พฤศจิกายน 2016

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

  • การเปลี่ยนแปลงเล็กๆ น้อยๆ ในรายการรหัสหัวข้อที่ระบบรองรับตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 มีดังนี้

    • หมวดหมู่ Professional wrestling ซึ่งก่อนหน้านี้เป็นหมวดหมู่ย่อยของ Sports ปัจจุบันเป็นองค์ประกอบย่อยของ Entertainment
    • หมวดหมู่ TV shows ซึ่งเป็นรายการย่อยของ Entertainment เป็นรายการใหม่
    • นําหมวดหมู่ Health ที่ก่อนหน้านี้เป็นย่อยของ Lifestyle ออกแล้ว

    โปรดทราบว่ายังมีหมวดหมู่หลักอยู่ 2-3 หมวดหมู่ (Entertainment, Gaming, Lifestyle, Music และ Sports) วิดีโอใดก็ตามที่เชื่อมโยงกับหมวดหมู่ย่อย เช่น Tennis จะเชื่อมโยงกับหมวดหมู่หลักด้วย (Sports)

10 พฤศจิกายน 2016

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

  • ตามที่ประกาศครั้งแรกในวันที่ 11 สิงหาคม 2016 การเลิกใช้งาน Freebase และ API ของ Freebase จําเป็นต้องมีการเปลี่ยนแปลงหลายรายการที่เกี่ยวข้องกับรหัสหัวข้อ รหัสหัวข้อจะระบุหัวข้อที่เชื่อมโยงกับทรัพยากร 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 Topics ออกจากเอกสารประกอบ คําแนะนํานั้นให้ตัวอย่างโค้ดเพื่อแสดงวิธีที่แอปพลิเคชันจะทํางานร่วมกับ 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 รายการ มิติข้อมูลหนึ่งอาจยังน้อยกว่าจํานวนสูงสุดที่อนุญาตสําหรับมิติข้อมูลนั้น

      เช่น สมมติว่าวิดีโอมีอัตราส่วน 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 API และ 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 รายการกลับมาหลังจากการเลิกใช้งาน พร็อพเพอร์ตี้ทั้ง 2 รายการจึงถูกนําออกจากเอกสารประกอบของทรัพยากรที่เกี่ยวข้อง

31 พฤษภาคม 2016

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

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

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

  • อัปเดตคําจํากัดความของพร็อพเพอร์ตี้ snippet.thumbnails.(key) สําหรับทรัพยากรกิจกรรม playlistItem, เพลย์ลิสต์ ผลการค้นหา ภาพขนาดย่อ และวิดีโอโปรดทราบว่าขนาดภาพขนาดย่อเพิ่มเติมสําหรับบางวิดีโอ

    • รูปภาพ standard กว้าง 640 พิกเซลและสูง 480 พิกเซล
    • รูปภาพ maxres กว้าง 1280px และสูง 720px
  • อัปเดตคําจํากัดความของพารามิเตอร์ part ของวิธีการ channelSection.list แล้ว โปรดทราบว่าสามารถดึงข้อมูลส่วน targeting ได้โดยใช้ต้นทุนหน่วยโควต้า 2

  • ตอนนี้เมธอด videos.list แสดงผลข้อผิดพลาดต้องห้าม (403) เมื่อคําขอที่ได้รับอนุญาตอย่างไม่ถูกต้องพยายามเรียกข้อมูลส่วน fileDetails, processingDetails หรือ suggestions ของทรัพยากร video ส่วนดังกล่าวจะพร้อมใช้งานสําหรับเจ้าของวิดีโอเท่านั้น

17 พฤษภาคม 2016

เครื่องมือข้อมูลโค้ด API ข้อมูลใหม่จะมีข้อมูลโค้ดสั้นๆ สําหรับ Use Case ของ YouTube Data API ที่พบได้ทั่วไป ปัจจุบันข้อมูลโค้ดใช้ได้กับเมธอด API แบบอ่านอย่างเดียวทั้งหมดใน Apps Script, Go, JavaScript, PHP, Python และ Ruby

สําหรับแต่ละวิธี เครื่องมือจะแสดงตัวอย่างโค้ดสําหรับกรณีการใช้งานอย่างน้อย 1 รายการ เช่น ระบุข้อมูลโค้ด 5 รายการสําหรับเมธอด search.list ดังนี้

  • แสดงวิดีโอตามคีย์เวิร์ด
  • แสดงรายการวิดีโอตามสถานที่ตั้ง
  • แสดงรายการการถ่ายทอดสด
  • ค้นหาวิดีโอของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
  • แสดงรายการวิดีโอที่เกี่ยวข้อง

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

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

28 เมษายน 2016

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

  • พร็อพเพอร์ตี้ contentDetails.projection ใหม่ของทรัพยากร video ระบุรูปแบบการคาดการณ์ของวิดีโอ ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ 360 และ rectangular

  • ทั้งพร็อพเพอร์ตี้ recordingDetails.location และ fileDetails.recordingLocation ของทรัพยากร video ได้รับการอัปเดตความแตกต่างระหว่างพร็อพเพอร์ตี้ 2 รายการแล้ว

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

  • อัปเดตคําจํากัดความของพร็อพเพอร์ตี้ contentDetails.relatedPlaylists.favorites ของทรัพยากร channel แล้วเพื่อบอกให้ทราบว่าค่าพร็อพเพอร์ตี้อาจมีรหัสเพลย์ลิสต์ที่อ้างอิงถึงเพลย์ลิสต์ว่างเปล่าและไม่สามารถดึงข้อมูลได้ เนื่องจากระบบเลิกใช้งานฟังก์ชันวิดีโอโปรดแล้ว โปรดทราบว่าพร็อพเพอร์ตี้นี้ไม่ได้อยู่ภายใต้นโยบายการเลิกใช้งาน API

  • คําจํากัดความของข้อผิดพลาด ineligibleAccount ซึ่งแสดงผลโดยเมธอด comments.insert, comments.update, commentThreads.insert หรือ commentThreads.update ได้รับการอัปเดตเพื่อแสดงข้อผิดพลาดที่เกิดขึ้นเมื่อบัญชี YouTube ที่ใช้ให้สิทธิ์คําขอ API ไม่ได้รวมเข้ากับบัญชี Google ของผู้ใช้

20 เมษายน 2016

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

  • อัปเดตคําอธิบายของพารามิเตอร์ part ของเมธอด channels.update แล้วเพื่อแจ้งว่า localizations เป็นค่าที่ถูกต้องสําหรับพารามิเตอร์ดังกล่าวด้วย

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

16 มีนาคม 2016

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

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

    • เอกสารประกอบของแหล่งข้อมูล channelBanner ได้รับการอัปเดตให้มีขนาดที่แนะนําสําหรับรูปภาพแบนเนอร์ของช่องที่อัปโหลดคือ 2560 x 1440 พิกเซล ขนาดขั้นต่ํา (2048 x 1152 พิกเซล) จะไม่เปลี่ยนแปลง

    • พร็อพเพอร์ตี้ snippet.customUrl ใหม่ของทรัพยากร channel ระบุ URL ที่กําหนดเองที่เชื่อมโยงกับช่อง (บางช่องเท่านั้นที่มี URL ที่กําหนดเอง) ศูนย์ช่วยเหลือของ YouTube อธิบายข้อกําหนดของการได้รับสิทธิ์รับ URL ที่กําหนดเองพร้อมวิธีตั้งค่า URL

    • ออบเจ็กต์ brandingSettings.watch ของทรัพยากร channel และพร็อพเพอร์ตี้ย่อยทั้งหมดเลิกใช้งานแล้ว

    • ตอนนี้การตอบกลับ API สําหรับคําขอ search.list มีพร็อพเพอร์ตี้ regionCode พร็อพเพอร์ตี้จะระบุรหัสภูมิภาคที่ใช้สําหรับคําค้นหา รหัสภูมิภาคจะสั่งให้ API แสดงผลการค้นหาสําหรับประเทศที่ระบุ

      ค่าพร็อพเพอร์ตี้คือรหัสประเทศ ISO แบบ 2 ตัวอักษรที่ระบุภูมิภาค เมธอด i18nRegions.list จะแสดงรายการภูมิภาคที่รองรับ ค่าเริ่มต้นคือ US หากระบุภูมิภาคที่ไม่รองรับ YouTube อาจยังคงเลือกภูมิภาคอื่นแทนค่าเริ่มต้นเพื่อจัดการกับการค้นหา

    • คําจํากัดความของคําจํากัดความของพร็อพเพอร์ตี้ snippet.label และ snippet.secondaryReasons[].label ของทรัพยากร videoAbuseReportReason ได้รับการอัปเดตให้ทราบว่าพร็อพเพอร์ตี้มีข้อความป้ายกํากับที่แปลแล้วเนื่องจากเหตุผลด้านการละเมิด

      นอกจากนี้ วิธีการ videoAbuseReportReasons.list ยังรองรับพารามิเตอร์ hl ซึ่งระบุภาษาที่ควรใช้สําหรับข้อความป้ายกํากับในการตอบกลับของ API ด้วย ค่าพารามิเตอร์เริ่มต้นคือ en_US

    • พร็อพเพอร์ตี้ contentDetails.contentRating.ecbmctRating ใหม่ของทรัพยากร video ระบุการจัดประเภทวิดีโอจากการประเมินและคณะกรรมการการประเมินของกระทรวงวัฒนธรรมและการท่องเที่ยวของตุรกี

      นอกจากนี้ พร็อพเพอร์ตี้ API สําหรับระบบการให้คะแนนอื่นๆ ยังรองรับค่าพร็อพเพอร์ตี้ใหม่ต่อไปนี้ด้วย

      • contentDetails.contentRating.fpbRating (แอฟริกาใต้)
        คะแนน: 10; ค่าที่พัก: fpb10
      • contentDetails.contentRating.moctwRating (ไต้หวัน)
        คะแนน: R-12; ค่าพร็อพเพอร์ตี้: moctwR12
      • contentDetails.contentRating.moctwRating (ไต้หวัน)
        คะแนน: R-15; ค่าพร็อพเพอร์ตี้: moctwR15
    • พร็อพเพอร์ตี้ liveStreamingDetails.activeLiveChatId ของทรัพยากร video มีรหัสของแชทสดที่ใช้งานอยู่ซึ่งเชื่อมโยงกับวิดีโอ ค่าพร็อพเพอร์ตี้จะปรากฏขึ้นเฉพาะในกรณีที่วิดีโอเป็นการถ่ายทอดสดปัจจุบันที่เปิดใช้แชทสด หลังจากการออกอากาศสิ้นสุดลงและแชทสดสิ้นสุดลง ระบบจะไม่ส่งที่พักสําหรับวิดีโออีกต่อไป

    • พร็อพเพอร์ตี้ status.rejectionReason ของทรัพยากร video รองรับค่าพร็อพเพอร์ตี้ใหม่ legal

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

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    badRequest (400) notEditable เมธอด channelSections.insert, channelSections.update และ channelSections.delete จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าไม่สามารถสร้าง อัปเดต หรือลบส่วนช่องที่ระบุ
    badRequest (400) styleRequired เมธอด channelSections.insert และ channelSections.update จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากร channelSection ที่ส่งในคําขอ API ต้องระบุค่าของพร็อพเพอร์ตี้ snippet.style
    badRequest (400) typeRequired เมธอด channelSections.insert และ channelSections.update จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากร channelSection ที่ส่งในคําขอ API ต้องระบุค่าของพร็อพเพอร์ตี้ snippet.type
    badRequest (400) processingFailure เมธอด commentThreads.list แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าเซิร์ฟเวอร์ API ประมวลผลคําขอไม่สําเร็จ แม้ว่านี่อาจเป็นข้อผิดพลาดที่เกิดขึ้นชั่วคราว แต่มักจะระบุว่าอินพุตของคําขอไม่ถูกต้อง ตรวจสอบโครงสร้างของทรัพยากร commentThread ในส่วนเนื้อหาของคําขอเพื่อให้แน่ใจว่าถูกต้อง
    forbidden (403) commentsDisabled เมธอด commentThreads.list จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่ระบุโดยพารามิเตอร์ videoId ได้ปิดใช้ความคิดเห็น
    badRequest (400) commentTextTooLong เมธอด commentThreads.insert แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากร comment ที่แทรกมีอักขระมากเกินไปในพร็อพเพอร์ตี้ snippet.topLevelComment.snippet.textOriginal
    invalidValue (400) videoAlreadyInAnotherSeriesPlaylist เมธอด playlistItems.insert แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์อยู่ในเพลย์ลิสต์ซีรีส์อื่นแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับเพลย์ลิสต์ซีรีส์ได้ที่ศูนย์ช่วยเหลือของ YouTube
    badRequest (400) subscriptionForbidden เมธอด subscriptions.insert จะแสดงผลข้อผิดพลาดนี้เพื่อแสดงว่าคุณได้สมัครใช้บริการถึงจํานวนสูงสุดแล้ว หรือสร้างการสมัครใช้บริการล่าสุดมากเกินไป หากเป็นกรณีหลังอยู่แล้ว คุณจะลองส่งคําขออีกครั้งได้หลังจากผ่านไป 2-3 ชั่วโมง
    badRequest (400) invalidCategoryId เมธอด videos.update แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.categoryId ในทรัพยากร video ที่อัปโหลดระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้วิธีการ videoCategories.list เพื่อดึงข้อมูลหมวดหมู่ที่รองรับ
    badRequest (400) invalidDescription เมธอด videos.update แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.description ในทรัพยากร video ที่อัปโหลดมีค่าที่ไม่ถูกต้อง
    badRequest (400) invalidPublishAt เมธอด videos.update แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ status.publishAt ในทรัพยากร video ที่อัปโหลดระบุเวลาการเผยแพร่ที่กําหนดไว้ไม่ถูกต้อง
    badRequest (400) invalidRecordingDetails เมธอด videos.update จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าออบเจ็กต์ recordingDetails ในทรัพยากร video ที่อัปโหลดมีการระบุรายละเอียดการบันทึกที่ไม่ถูกต้อง
    badRequest (400) invalidTags เมธอด videos.update แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.tags ในทรัพยากร video ที่อัปโหลดมีค่าที่ไม่ถูกต้อง
    badRequest (400) invalidTitle เมธอด videos.update แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.title ในทรัพยากร video ที่อัปโหลดได้ระบุชื่อวิดีโอที่ไม่ถูกต้องหรือว่างเปล่า
    badRequest (400) invalidVideoMetadata เมธอด videos.update แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าข้อมูลเมตาของคําขอไม่ถูกต้อง ข้อผิดพลาดนี้จะเกิดขึ้นหากคําขออัปเดตส่วน snippet ของทรัพยากร video แต่ไม่ได้กําหนดค่าสําหรับทั้งพร็อพเพอร์ตี้ snippet.title และ snippet.categoryId

18 ธันวาคม 2015

กฎหมายในสหภาพยุโรป (EU) กําหนดว่าต้องมีการเปิดเผยข้อมูลบางอย่างและต้องได้รับความยินยอมจากผู้ใช้ปลายทางในสหภาพยุโรป ดังนั้น สําหรับผู้ใช้ปลายทางในสหภาพยุโรป คุณต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU เราได้เพิ่มประกาศเกี่ยวกับข้อกําหนดนี้ในข้อกําหนดในการให้บริการของ YouTube API

19 พฤศจิกายน 2015

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

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

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

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

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

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

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

      {
        "kind": "youtube#video",
        ...
        "snippet": {
          "title": "Playing soccer",
          "description": "We play soccer in the park on Sundays.",
          "defaultLanguage": "en",
          ...
        },
        "localizations":
          "de": {
            "title": "Fußball spielen",
            "description": "Wir spielen Fußball im Park am Sonntag"
          },
          "es": {
            "title": "Jugar al fútbol",
            "description": "Nosotros jugamos fútbol en el parque los domingos",
          }
        }
      }
    • สําคัญ: โปรดทราบว่าเมื่อคุณอัปเดตข้อมูลที่แปลแล้วสําหรับทรัพยากร คําขอ API ของคุณต้องมีข้อมูลเวอร์ชันแปลทั้งหมดที่มีอยู่ ตัวอย่างเช่น หากคุณส่งคําขอที่ตามมาเพื่อเพิ่มข้อมูลภาษาโปรตุเกสลงในวิดีโอตามตัวอย่างข้างต้น คําขอดังกล่าวจะต้องรวมข้อมูลที่แปลเป็นภาษาเยอรมัน สเปน และโปรตุเกสด้วย

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

    API รองรับการเรียกค่าที่แปลแล้วสําหรับทรัพยากร 2 วิธี ดังนี้

    • เพิ่มพารามิเตอร์ hl ในคําขอ channels.list, channelSections.list, playlists.list หรือ videos.list เพื่อดึงข้อมูลที่แปลแล้วสําหรับภาษาแอปพลิเคชันที่เฉพาะเจาะจงที่เว็บไซต์ YouTube รองรับ หากมีรายละเอียดทรัพยากรที่แปลเป็นภาษาดังกล่าว ออบเจ็กต์ snippet.localized ของทรัพยากรจะมีค่าที่แปลแล้ว อย่างไรก็ตาม หากไม่มีรายละเอียดที่แปลเป็นภาษาท้องถิ่น ออบเจ็กต์ snippet.localized จะมีรายละเอียดทรัพยากรอยู่ในภาษาเริ่มต้นของทรัพยากรนั้นๆ

      ตัวอย่างเช่น สมมติว่าคําขอ videos.list ดึงข้อมูลสําหรับวิดีโอที่อธิบายไว้ข้างต้นด้วยข้อมูลภาษาเยอรมันและภาษาสเปนที่แปลแล้ว หากตั้งพารามิเตอร์ hl เป็น de ทรัพยากรจะมีข้อมูลต่อไปนี้

      {
        "kind": "youtube#video",
        ...
        "snippet": {
          "title": "Playing soccer",
          "description": "We play soccer in the park on Sundays.",
          "defaultLanguage": "en",
          "localized": {
            "title": "Fußball spielen",
            "description": "Wir spielen Fußball im Park am Sonntag"
          }
          ...
        }
      }

      อย่างไรก็ตาม หากตั้งค่าพารามิเตอร์ hl เป็น fr ออบเจ็กต์ snippet.localized จะมีชื่อและคําอธิบายภาษาอังกฤษเนื่องจากภาษาอังกฤษเป็นภาษาเริ่มต้นของทรัพยากรดังกล่าว และจะไม่มีรายละเอียดภาษาฝรั่งเศสที่แปลแล้ว

      สําคัญ: พารามิเตอร์ hl รองรับเฉพาะค่าที่ระบุภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ หากต้องการทราบว่าข้อความแปลพร้อมใช้งานสําหรับภาษาอื่นๆ หรือไม่ คุณต้องดึงข้อมูลส่วน localizations สําหรับทรัพยากรและตัวกรองเพื่อระบุว่ามีข้อความแปลหรือไม่

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

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

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

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

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

4 พฤศจิกายน 2015

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

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

    • พารามิเตอร์ order ของ search.list ได้รับการอัปเดตแล้ว โปรดทราบว่าหากคุณจัดเรียงการถ่ายทอดสดตาม viewCount ผลลัพธ์ API จะจัดเรียงตามจํานวนผู้ชมที่ดูพร้อมกันไม่ได้ระหว่างการออกอากาศ

    • พารามิเตอร์ relatedToVideoId ของ search.list ได้รับการอัปเดตให้ทราบว่าหากตั้งค่าพารามิเตอร์ พารามิเตอร์อีกรายการที่รองรับคือ part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (ซึ่งต้องตั้งค่าเป็น video) และ fields การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงของลักษณะการทํางานของ API

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

      การเปลี่ยนแปลงนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงของลักษณะการทํางานของ API

    • อัปเดตคําจํากัดความของพร็อพเพอร์ตี้ status.publishAt ของทรัพยากร video เป็นหมายเหตุแล้ว

      • หากคุณกําหนดค่าพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด videos.update คุณต้องตั้งค่าพร็อพเพอร์ตี้ status.privacyStatus เป็น private ด้วย แม้ว่าวิดีโอจะเป็นแบบส่วนตัวอยู่แล้ว
      • หากคําขอตั้งเวลาให้เผยแพร่วิดีโอในอดีต วิดีโอจะเผยแพร่ทันที ด้วยเหตุนี้ ผลของการตั้งค่าพร็อพเพอร์ตี้ status.publishAt เป็นวันที่และเวลาที่ผ่านมาจะเหมือนกับการเปลี่ยน privacyStatus ของวิดีโอจาก private เป็น public
    • พร็อพเพอร์ตี้ contentDetails.contentRating.cncRating ของทรัพยากร video ระบุการจัดประเภทวิดีโอจากค่าคอมมิชชันของการแยกประเภทภาพยนตร์ของฝรั่งเศส พร็อพเพอร์ตี้นี้จะแทนที่พร็อพเพอร์ตี้ contentDetails.contentRating.fmocRating ซึ่งตอนนี้เลิกใช้งานแล้ว

    • คําจํากัดความของ brandingSettings.channel.keyword ของทรัพยากร channel ได้รับการอัปเดตอย่างถูกต้องเพื่อให้ค่าพร็อพเพอร์ตี้มีรายการสตริงที่คั่นด้วยช่องว่าง และไม่ใช่รายการที่คั่นด้วยคอมมา ตามที่ได้บันทึกไว้ก่อนหน้านี้ การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงของลักษณะการทํางานของ API

    • อัปเดตเอกสารประกอบสําหรับเมธอด thumbnails.set ให้แสดงอย่างถูกต้องว่าเนื้อหาของคําขอมีภาพขนาดย่อที่คุณกําลังอัปโหลดและเชื่อมโยงกับวิดีโอ เนื้อหาของคําขอไม่มีทรัพยากร thumbnail ก่อนหน้านี้ เอกสารระบุว่าคุณไม่ควรให้เนื้อหาคําขอเมื่อเรียกใช้วิธีการนี้ การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงของลักษณะการทํางานของ API

    • อัปเดตรายละเอียดของทรัพยากร activity แล้วเพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าเมธอด activities.list ในปัจจุบันไม่ได้รวมทรัพยากรที่เกี่ยวข้องกับความคิดเห็นวิดีโอใหม่ snippet.type และ contentDetails.comment ของทรัพยากรได้รับการอัปเดตแล้วเช่นกัน

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

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

      รายละเอียดข้อผิดพลาด
      activities.insert
      โค้ดตอบกลับ HTTPbadRequest (400)
      เหตุผลinvalidMetadata
      คำอธิบายพร็อพเพอร์ตี้ kind ไม่ตรงกับประเภทรหัสที่ระบุ
      commentThreads.update
      comments.insert
      comments.update
      โค้ดตอบกลับ HTTPbadRequest (400)
      เหตุผลcommentTextTooLong
      คำอธิบายทรัพยากร comment ที่แทรกหรืออัปเดตมีอักขระมากเกินไปในพร็อพเพอร์ตี้ snippet.topLevelComment.snippet.textOriginal
      playlistItems.insert
      playlistItems.update
      โค้ดตอบกลับ HTTPforbidden (403)
      เหตุผลplaylistItemsNotAccessible
      คำอธิบายคําขอไม่ได้รับอนุญาตอย่างถูกต้องให้แทรก อัปเดต หรือลบรายการเพลย์ลิสต์ที่ระบุ
      playlists.delete
      playlists.insert
      playlists.update
      โค้ดตอบกลับ HTTPbadRequest (400)
      เหตุผลplaylistForbidden
      คำอธิบายการดําเนินการนี้ไม่ได้รับอนุญาตหรือคําขอไม่ได้รับอนุญาตอย่างถูกต้อง
      search.list
      โค้ดตอบกลับ HTTPbadRequest (400)
      เหตุผลinvalidLocation
      คำอธิบายค่าพารามิเตอร์ location และ/หรือ locationRadius มีรูปแบบที่ไม่ถูกต้อง
      search.list
      โค้ดตอบกลับ HTTPbadRequest (400)
      เหตุผลinvalidRelevanceLanguage
      คำอธิบายค่าพารามิเตอร์ relevanceLanguage มีรูปแบบที่ไม่ถูกต้อง
      subscriptions.insert
      โค้ดตอบกลับ HTTPbadRequest (400)
      เหตุผลsubscriptionForbidden
      คำอธิบายข้อผิดพลาดนี้เกิดขึ้นเมื่อข้อใดข้อหนึ่งต่อไปนี้เป็นจริง
      • มีการสมัครใช้บริการที่คุณพยายามสร้างอยู่แล้ว
      • คุณมีการสมัครใช้บริการถึงจํานวนสูงสุดแล้ว
      • คุณกําลังพยายามติดตามช่องของคุณเอง ซึ่งระบบไม่รองรับ
      • คุณได้สร้างการสมัครใช้บริการมากเกินไปเมื่อเร็วๆ นี้ และต้องรอ 2-3 ชั่วโมงก่อนที่จะส่งคําขออีกครั้ง
      videos.update
      โค้ดตอบกลับ HTTPbadRequest (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
      โค้ดตอบกลับ HTTPbadRequest (400)
      เหตุผลemailNotVerified
      คำอธิบายผู้ใช้ต้องยืนยันอีเมลก่อนจัดประเภทวิดีโอ
      videos.rate
      โค้ดตอบกลับ HTTPbadRequest (400)
      เหตุผลvideoPurchaseRequired
      คำอธิบายเฉพาะผู้ใช้ที่เช่าเท่านั้นที่สามารถจัดประเภทวิดีโอเช่า
    • เมธอด subscriptions.delete และ subscriptions.insert ไม่รองรับข้อผิดพลาด accountClosed และ accountSuspended อีกต่อไป

27 เมษายน 2015

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

  • แหล่งข้อมูลและวิธีการใหม่ๆ

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

    • เมธอด videos.reportAbuse ใหม่ให้วิธีแจ้งว่าวิดีโอมีเนื้อหาที่ไม่เหมาะสมจริงๆ เนื้อหาของคําขอมีออบเจ็กต์ JSON ที่ระบุวิดีโอที่ถูกแจ้งว่าไม่เหมาะสม รวมถึงเหตุผลที่วิดีโอถือว่ามีเนื้อหาที่ไม่เหมาะสม คุณหาเหตุผลที่ถูกต้องได้จากเมธอด videoAbuseReportReason.list ที่อธิบายไว้ด้านบน

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

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

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

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

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

      ฟีเจอร์ใหม่นี้มีฟังก์ชันการทํางานที่คล้ายกันแต่มีฟังก์ชันการทํางานเหมือนแท็กนักพัฒนาซอฟต์แวร์ที่ API เวอร์ชัน 2 รองรับ

    • พร็อพเพอร์ตี้ snippet.country ใหม่ของทรัพยากร channel ช่วยให้เจ้าของช่องเชื่อมโยงช่องกับประเทศที่ต้องการได้

      หมายเหตุ: หากต้องการตั้งค่าพร็อพเพอร์ตี้ snippet.country สําหรับทรัพยากร channel คุณจะต้องอัปเดตพร็อพเพอร์ตี้ brandingSettings.channel.country จริงๆ

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

      API แสดงตัวเลือกการกําหนดเป้าหมาย 3 ตัวเลือก ผู้ใช้ต้องเป็นไปตามการตั้งค่าการกําหนดเป้าหมายทั้งหมดเพื่อให้ส่วนแชแนลปรากฏ

    • คําจํากัดความของพร็อพเพอร์ตี้ 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

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

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

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

  • ขอบเขต 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) มีแท็บใหม่ชื่อ New in the v3 API ซึ่งแสดงรายการฟีเจอร์ที่ v3 API รองรับและที่ v2 API ไม่รองรับ ฟีเจอร์เดิมเคยแต่ปรากฏในแท็บอื่นๆ ในคําแนะนํา เช่น ฟีเจอร์ใหม่ที่อธิบายวิธีอัปเดตข้อมูลแคมเปญการโปรโมตในวิดีโอของช่องจะแสดงอยู่ในแท็บช่อง (โปรไฟล์) ด้วย

  • มีการอัปเดตคําแนะนําในการย้ายข้อมูล YouTube Data API (v3) โปรดทราบว่า v3 API จะรองรับฟีเจอร์ v2 API ดังต่อไปนี้

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

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

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

    • เรียกข้อมูลคําแนะนําของช่อง

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4 มีนาคม 2015

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

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

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

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

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

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

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

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

2 มีนาคม 2015

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

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

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

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

14 มกราคม 2015

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

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

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

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

11 พฤศจิกายน 2014

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

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

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

    • ต้นทุนโควต้า: 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 แล้ว โปรดทราบว่าโดยปกติแล้วคุณจะตั้งค่ารายการที่โปรโมตได้เพียง 1 รายการสําหรับช่อง หากคุณพยายามแทรกรายการที่โปรโมตมากเกินไป 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

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

13 มีนาคม 2014

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

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

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

    ทรัพยากร พร็อพเพอร์ตี้ ความยาวสูงสุด
    channel invideoPromotion.items[].customMessage 40 อักขระ
    video snippet.title 100 อักขระ
    video snippet.description 5000 ไบต์
    video snippet.tags 500 อักขระ โปรดทราบว่าค่าพร็อพเพอร์ตี้เป็นรายการและคอมมาระหว่างรายการจะนับรวมในขีดจํากัด
  • พร็อพเพอร์ตี้ brandingSettings.watch.featuredPlaylistId ของทรัพยากร channel เลิกใช้งานแล้ว API จะแสดงผลข้อผิดพลาดหากคุณพยายามตั้งค่า

  • มีการเพิ่มพร็อพเพอร์ตี้ทรัพยากร video ต่อไปนี้ลงในรายการค่าที่สามารถตั้งได้เมื่อแทรกหรืออัปเดตวิดีโอ

  • ตอนนี้เอกสารประกอบเกี่ยวกับข้อผิดพลาดจะระบุโค้ดตอบกลับของ HTTP สําหรับข้อผิดพลาดแต่ละประเภท

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

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

4 มีนาคม 2014

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

5 ธันวาคม 2013

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

  • เอกสารประกอบของวิธีการ search.list ได้รับการอัปเดตเพื่อแสดงอย่างถูกต้องว่าไม่จําเป็นต้องระบุค่าสําหรับพารามิเตอร์ตัวกรองเพียง 1 รายการเมื่อส่งคําขอการค้นหา แต่คุณจะกําหนดค่าสําหรับพารามิเตอร์ตัวกรองเป็น 0 หรือพารามิเตอร์ตัวกรอง 1 รายการก็ได้

  • อัปเดตพารามิเตอร์ของเมธอด search.list ให้ระบุว่าคุณต้องตั้งค่าของพารามิเตอร์ type เป็น video หากคุณระบุค่าของพารามิเตอร์ต่อไปนี้ด้วย

    • eventType
    • videoCaption
    • videoCategoryId
    • videoDefinition
    • videoDimension
    • videoDuration
    • videoEmbeddable
    • videoLicense
    • videoSyndicated
    • videoType

  • ขนาดขั้นต่ําของรูปภาพแบนเนอร์ของช่องที่อัปโหลดลดลงเหลือ 2,048 x 1152 พิกเซล (ก่อนหน้านี้ ขนาดขั้นต่ําคือ 2120x1192 พิกเซล) นอกจากนี้ โปรดทราบว่าเอกสารประกอบของทรัพยากร channel จะระบุขนาดสูงสุดของรูปภาพแบนเนอร์ทั้งหมดที่แสดงจาก API เช่น ขนาดสูงสุดของรูปภาพ brandingSettings.image.bannerTvImageUrl สําหรับแอปพลิเคชันทีวีคือ 2120x1192 พิกเซล แต่รูปภาพจริงอาจมีขนาด 2048x1152 พิกเซล ศูนย์ช่วยเหลือของ 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 ใหม่ระบุการจัดประเภทที่วิดีโอได้รับภายใต้ระบบการจัดประเภทของ Canada TV และระบบการจัดประเภท Régie du cinéma ในภาษาฝรั่งเศสซึ่งใช้ในควิเบกตามลําดับ

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

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

24 ตุลาคม 2013

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

  • API มีฟีเจอร์เพิ่มเติม 2 อย่างที่ออกแบบมาเพื่อช่วยค้นหาและแสดงเนื้อหาการถ่ายทอดสด ได้แก่

    พร็อพเพอร์ตี้ snippet.liveBroadcastContent ใหม่ในผลการค้นหาระบุว่าทรัพยากรของวิดีโอหรือช่องมีเนื้อหาการถ่ายทอดสดหรือไม่ ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ upcoming, active และ none

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

      • upcoming - วิดีโอเป็นการถ่ายทอดสดที่ยังไม่ได้เริ่ม
      • active – วิดีโอกําลังถ่ายทอดสดอย่างต่อเนื่อง
      • none - วิดีโอไม่ใช่การถ่ายทอดสดที่กําลังจะเผยแพร่หรือกําลังดําเนินอยู่ ตัวแปรนี้จะเป็นค่าพร็อพเพอร์ตี้สําหรับการออกอากาศที่เสร็จสมบูรณ์ซึ่งยังคงดูได้ใน YouTube

    • พร็อพเพอร์ตี้ liveStreamingDetails ใหม่ของทรัพยากร video คือออบเจ็กต์ที่มีข้อมูลเมตาเกี่ยวกับการออกอากาศวิดีโอแบบสด หากต้องการเรียกข้อมูลเมตานี้ ให้ใส่ liveStreamingDetails ในรายการส่วนทรัพยากรของค่าพารามิเตอร์ part โดยข้อมูลเมตาจะมีพร็อพเพอร์ตี้ใหม่ดังต่อไปนี้

      • liveStreamingDetails.actualStartTime – เวลาที่การออกอากาศเริ่มต้นขึ้นจริง (ค่านี้จะปรากฏเมื่อสถานะการออกอากาศเป็น active)
      • liveStreamingDetails.actualEndTime – เวลาที่การออกอากาศจริงสิ้นสุดลง (ค่านี้จะปรากฏเมื่อการออกอากาศสิ้นสุด)
      • liveStreamingDetails.scheduledStartTime – เวลาเริ่มออกอากาศ
      • liveStreamingDetails.scheduledEndTime - เวลาที่การถ่ายทอดสดสิ้นสุดลง หากค่าพร็อพเพอร์ตี้ว่างเปล่าหรือไม่มีพร็อพเพอร์ตี้อยู่ การออกอากาศจะถูกตั้งเวลาให้ดําเนินการต่อแบบไม่มีกําหนด
      • liveStreamingDetails.concurrentViewers – จํานวนผู้ที่ดูการถ่ายทอดสด

      หากต้องการเรียกข้อมูลเมตานี้ ให้ใส่ liveStreamingDetails ในค่าพารามิเตอร์ part เมื่อเรียกใช้เมธอด videos.list, videos.insert หรือ videos.update

    โปรดทราบว่ามีการใช้อีก 2 ฟีเจอร์เพื่อระบุเนื้อหาการถ่ายทอดสดในวันที่ 1 ตุลาคม 2013 ซึ่งก็คือพารามิเตอร์ eventType ของเมธอด search.list และพร็อพเพอร์ตี้ snippet.liveBroadcastContent ของผลการค้นหา

  • ตอนนี้เมธอด videos.insert รองรับพารามิเตอร์ notifySubscribers แล้ว ซึ่งจะระบุว่า YouTube ควรส่งการแจ้งเตือนเกี่ยวกับวิดีโอใหม่ให้แก่ผู้ใช้ที่ติดตามช่องของวิดีโอหรือไม่ ค่าเริ่มต้นของพารามิเตอร์คือ True ซึ่งระบุว่าผู้ติดตามจะได้รับการแจ้งเตือนเกี่ยวกับวิดีโอที่อัปโหลดใหม่ อย่างไรก็ตาม เจ้าของช่องที่กําลังอัปโหลดวิดีโอหลายรายการอาจต้องการตั้งค่าเป็น False เพื่อหลีกเลี่ยงการส่งการแจ้งเตือนเกี่ยวกับวิดีโอใหม่แต่ละรายการไปยังผู้ติดตามของช่อง

  • อัปเดตรายการพร็อพเพอร์ตี้ที่แก้ไขได้เมื่อเรียกใช้เมธอด channels.update ให้รวมพร็อพเพอร์ตี้ invideoPromotion.items[].customMessage และ invideoPromotion.items[].websiteUrl นอกจากนี้ยังมีการแก้ไขรายการเพื่อระบุพร็อพเพอร์ตี้ brandingSettings ที่แก้ไขได้ มีการแก้ไขพร็อพเพอร์ตี้ brandingSettings เหล่านี้แล้ว การเปลี่ยนแปลงในเอกสารจึงไม่แสดงการเปลี่ยนแปลงฟังก์ชันการทํางานที่มีอยู่ของ API

  • เมธอด playlists.insert, playlists.update และ playlists.delete รองรับพารามิเตอร์ onBehalfOfContentOwner แล้ว ซึ่งระบบรองรับเมธอดอื่นๆ อีกหลายวิธีแล้ว

  • ตอนนี้เมธอด playlists.insert รองรับพารามิเตอร์ onBehalfOfContentOwnerChannel แล้ว ซึ่งรองรับด้วยวิธีอื่นแล้ว

  • ขณะนี้พร็อพเพอร์ตี้ contentDetails.contentRating.tvpgRating ของทรัพยากร video รองรับค่า pg14 ซึ่งสอดคล้องกับคะแนน TV-14

  • คําจํากัดความของพร็อพเพอร์ตี้ snippet.liveBroadcastContent ซึ่งเป็นส่วนหนึ่งของผลการค้นหาได้รับการแก้ไขให้สอดคล้องกับ live เป็นค่าพร็อพเพอร์ตี้ที่ถูกต้อง แต่ active ไม่ใช่ค่าพร็อพเพอร์ตี้ที่ถูกต้อง

  • ตอนนี้พร็อพเพอร์ตี้ contentDetails.contentRating.mibacRating ของทรัพยากร video รองรับการให้คะแนนเพิ่มเติม 2 รายการแล้ว

    • mibacVap (VAP) – เด็กควรมีผู้ใหญ่รวมอยู่ด้วย
    • mibacVm6 (V.M.6) – จํากัดสําหรับผู้ที่มีอายุตั้งแต่ 6 ปีขึ้นไป
    • mibacVm12 (V.M.12) – จํากัดสําหรับผู้ที่มีอายุตั้งแต่ 12 ปีขึ้นไป

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

1 ตุลาคม 2013

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

  • ออบเจ็กต์ auditDetails ใหม่ของทรัพยากร channel มีข้อมูลแชแนลที่เครือข่ายแบบหลายช่อง (MCN) ประเมินขณะตัดสินว่าจะยอมรับหรือปฏิเสธช่องใดช่องหนึ่ง โปรดทราบว่าคําขอ API ที่ดึงส่วนของทรัพยากรนี้ต้องระบุโทเค็นการให้สิทธิ์ที่มีขอบเขต https://www.googleapis.com/auth/youtubepartner-channel-audit นอกจากนี้ คุณต้องเพิกถอนโทเค็นที่ใช้ขอบเขตนั้นเมื่อ MCN ตัดสินใจยอมรับหรือปฏิเสธช่อง หรือภายใน 2 สัปดาห์นับจากวันที่ออกโทเค็น

  • ขณะนี้พร็อพเพอร์ตี้ invideoPromotion.items[].id.type ของทรัพยากร channel รองรับค่า recentUpload ซึ่งระบุว่ารายการที่โปรโมตเป็นวิดีโอที่อัปโหลดล่าสุดจากช่องที่ระบุ

    โดยค่าเริ่มต้น ช่องจะเหมือนกับช่องที่ตั้งค่าไว้ข้อมูลโปรโมชันในวิดีโอ อย่างไรก็ตาม คุณสามารถโปรโมตวิดีโอที่อัปโหลดล่าสุดจากช่องอื่นได้โดยกําหนดมูลค่าของพร็อพเพอร์ตี้ invideoPromotion.items[].id.recentlyUploadedBy ใหม่เป็นรหัสช่องของช่องนั้น

  • ทรัพยากร channel มีพร็อพเพอร์ตี้ใหม่ 3 รายการ ได้แก่ brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl, brandingSettings.image.bannerTvHighImageUrl ซึ่งจะระบุ URL สําหรับรูปภาพแบนเนอร์ที่แสดงในหน้าช่องในแอปพลิเคชันโทรทัศน์

  • พร็อพเพอร์ตี้ snippet.liveBroadcastContent ใหม่ในผลการค้นหาระบุว่าทรัพยากรของวิดีโอหรือช่องมีเนื้อหาการถ่ายทอดสดหรือไม่ ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ upcoming, active และ none

    • สําหรับทรัพยากร video ค่า upcoming บ่งบอกว่าวิดีโอเป็นการถ่ายทอดสดที่ยังไม่ได้เริ่ม ขณะที่ค่า active บ่งบอกว่าวิดีโอเป็นการถ่ายทอดสดที่กําลังดําเนินอยู่
    • สําหรับทรัพยากร channel ค่า upcoming บ่งบอกว่าช่องมีการออกอากาศตามกําหนดการที่ยังไม่ได้เริ่ม ในขณะที่ค่า acive ระบุว่าช่องมีการถ่ายทอดสดอย่างต่อเนื่อง

  • ในทรัพยากร watermark พร็อพเพอร์ตี้ targetChannelId ได้เปลี่ยนจากออบเจ็กต์เป็นสตริง ตอนนี้พร็อพเพอร์ตี้ targetChannelId จะระบุค่านั้นแทนพร็อพเพอร์ตี้ย่อยที่ระบุรหัสช่อง YouTube ของช่องที่รูปภาพลายน้ําลิงก์อยู่ ด้วยเหตุนี้ พร็อพเพอร์ตี้ targetChannelId.value ของทรัพยากรจึงถูกนําออก

  • ตอนนี้เมธอด thumbnails.set รองรับพารามิเตอร์ onBehalfOfContentOwner แล้ว ซึ่งรองรับด้วยวิธีอื่นแล้ว

  • ตอนนี้เมธอด search.list รองรับพารามิเตอร์ eventType แล้ว ซึ่งจํากัดการค้นหาให้แสดงเฉพาะกิจกรรมการออกอากาศที่ใช้งานอยู่ ที่กําลังจะเกิดขึ้น หรือที่เสร็จสมบูรณ์แล้วเท่านั้น

  • พร็อพเพอร์ตี้ contentDetails.contentRating.mibacRating ใหม่ระบุการจัดประเภทที่วิดีโอจาก Ministero dei Beni e delle Attivita Culturali e del Turismo ของอิตาลี

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

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    badRequest invalidImage เมธอด thumbnails.set จะแสดงผลข้อผิดพลาดนี้หากเนื้อหารูปภาพที่ระบุไม่ถูกต้อง
    forbidden videoRatingDisabled เมธอด videos.rate จะแสดงผลข้อผิดพลาดนี้หากเจ้าของวิดีโอที่กําลังจัดประเภทได้ปิดใช้การจัดประเภทสําหรับวิดีโอนั้น

27 สิงหาคม 2013

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

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

    วิธี watermarks.set จะอัปโหลดและตั้งค่ารูปภาพลายน้ําของช่อง เมธอด watermarks.unset จะลบรูปภาพลายน้ําของช่อง

    เอกสารประกอบเกี่ยวกับข้อผิดพลาดจะอธิบายข้อความแสดงข้อผิดพลาดที่ API รองรับเมธอด watermarks.set และ watermarks.unset โดยเฉพาะ

  • พร็อพเพอร์ตี้ statistics.hiddenSubscriberCount ใหม่ของทรัพยากร channel มีค่าบูลีนที่ระบุว่าจํานวนสมาชิกของช่องซ่อนอยู่หรือไม่ ดังนั้น พร็อพเพอร์ตี้จะเป็น false หากจํานวนผู้ติดตามของช่องเป็นแบบสาธารณะ

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

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

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

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

15 สิงหาคม 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

8 สิงหาคม 2013

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

30 กรกฎาคม 2013

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

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

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

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

  • เมธอด videos.list รองรับพารามิเตอร์ใหม่สําหรับการดึงข้อมูลแผนภูมิของวิดีโอยอดนิยมบน YouTube

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

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

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

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

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

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

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

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

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

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

10 มิถุนายน 2013

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

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

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

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

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

    พารามิเตอร์จะระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคําขอระบุผู้ใช้ YouTube CMS ที่ทําหน้าที่ในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์ด้วยจะต้องลิงก์กับเจ้าของเนื้อหาของ YouTube ที่ระบุ

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

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

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

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    forbidden insufficientCapabilities ข้อผิดพลาดนี้ไม่ได้เจาะจงวิธีการ API ที่เฉพาะเจาะจง ซึ่งระบุว่าผู้ใช้ CMS ที่เรียกใช้ API มีสิทธิ์ไม่เพียงพอที่จะดําเนินการที่ขอ ข้อผิดพลาดนี้เกี่ยวข้องกับการใช้พารามิเตอร์ onBehalfOfContentOwner ซึ่งรองรับเมธอด API ต่างๆ
    unauthorized authorizationRequired เมธอด activities.list จะแสดงผลข้อผิดพลาดนี้เมื่อคําขอใช้พารามิเตอร์ home แต่ไม่ได้รับอนุญาตอย่างถูกต้อง
  • นําทรัพยากร invideoPromotion.channelId ในทรัพยากร channels ออกแล้วเนื่องจากมีการระบุรหัสช่องโดยใช้พร็อพเพอร์ตี้ 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

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

8 พฤษภาคม 2013

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

  • ปัจจุบันทรัพยากรของช่องรองรับออบเจ็กต์ inVideoPromotion ซึ่งสรุปข้อมูลเกี่ยวกับแคมเปญโปรโมชันที่เชื่อมโยงกับช่อง ช่องสามารถใช้แคมเปญการโปรโมตในวิดีโอเพื่อแสดงภาพขนาดย่อสําหรับวิดีโอที่โปรโมตภายในโปรแกรมเล่นวิดีโอระหว่างการเล่นวิดีโอของช่อง

    คุณเรียกข้อมูลนี้ได้โดยการรวม invideoPromotion ในค่าพารามิเตอร์ part ในคําขอ channels.list

  • สามารถใช้เมธอด channels.update ใหม่เพื่ออัปเดตข้อมูลแคมเปญการโปรโมตในวิดีโอของช่อง โปรดทราบว่าวิธีนี้รองรับเฉพาะการอัปเดตส่วน invideoPromotion ของทรัพยากร channel และยังไม่รองรับการอัปเดตส่วนอื่นๆ ของทรัพยากรดังกล่าว

2 พฤษภาคม 2013

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

  • ทรัพยากรของช่องรองรับพร็อพเพอร์ตี้ status.isLinked แล้ว ซึ่งระบุว่าข้อมูลช่องระบุผู้ใช้ที่ลิงก์ไปยังชื่อผู้ใช้ YouTube หรือบัญชี Google+ อยู่แล้วหรือไม่ ผู้ใช้ที่มีลิงก์ใดลิงก์หนึ่งเหล่านี้มีข้อมูลประจําตัวสาธารณะของ YouTube อยู่แล้ว ซึ่งเป็นข้อกําหนดเบื้องต้นสําหรับการดําเนินการต่างๆ เช่น การอัปโหลดวิดีโอ

  • ตอนนี้ทรัพยากรการสมัครใช้บริการรองรับส่วน subscriberSnippet แล้ว ออบเจ็กต์ดังกล่าวจะรวมข้อมูลของตัวอย่างข้อมูลลงในช่องของสมาชิก

  • ตอนนี้ API รองรับเมธอด videos.getRating แล้ว ซึ่งระบบจะดึงคะแนนที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ออกจากรายการวิดีโออย่างน้อย 1 รายการ

  • พารามิเตอร์ myRating ใหม่ของวิธีการ videos.list ช่วยให้คุณเรียกดูรายการวิดีโอที่ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วได้รับคะแนน like หรือ dislike

    ทั้งพารามิเตอร์ myRating และพารามิเตอร์ id ถือว่าเป็นพารามิเตอร์ตัวกรอง ซึ่งหมายความว่าคําขอ API ต้องระบุพารามิเตอร์รายการใดรายการหนึ่ง (ก่อนหน้านี้ พารามิเตอร์ id เป็นพารามิเตอร์ที่จําเป็นสําหรับวิธีการนี้)

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

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

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

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

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

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

  • เพิ่มพร็อพเพอร์ตี้ channelTitle ใน snippet สําหรับทรัพยากรต่อไปนี้แล้ว

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

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

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

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

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

  • ตอนนี้คําขอ API ที่มีพารามิเตอร์ที่ไม่คาดคิดจะแสดงผลข้อผิดพลาด badRequest และเหตุผลที่แสดงข้อผิดพลาดดังกล่าวคือ unexpectedParameter

  • ข้อผิดพลาดที่เมธอด playlistItems.insert แสดงผลเมื่อเพลย์ลิสต์มีรายการที่อนุญาตถึงจํานวนสูงสุดแล้ว ตอนนี้ระบบจะรายงานข้อผิดพลาดเป็นข้อผิดพลาด forbidden และเหตุผลของข้อผิดพลาดคือ playlistContainsMaximumNumberOfVideos

19 เมษายน 2013

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

  • วิธี videos.rate ใหม่ช่วยให้ผู้ใช้ตั้งค่าการจัดประเภท like หรือ dislike ในวิดีโอหรือนําคะแนนออกจากวิดีโอได้

    นอกจากนี้ เรายังอัปเดตเอกสารประกอบเกี่ยวกับข้อผิดพลาดเพื่อแสดงข้อผิดพลาดที่ API อาจส่งคืนกลับมาในการเรียกเมธอด videos.rate

  • ตอนนี้ภาพขนาดย่อได้รับการระบุไว้ในเอกสารประกอบของ API ว่าเป็นทรัพยากรแยกต่างหาก และวิธีการ thumbnails.set ใหม่นี้จะช่วยให้คุณอัปโหลดภาพปกวิดีโอที่กําหนดเองไปยัง YouTube และตั้งค่าสําหรับวิดีโอได้

    นอกจากนี้ เรายังอัปเดตเอกสารประกอบเกี่ยวกับข้อผิดพลาดเพื่อแสดงข้อผิดพลาดที่ API อาจส่งคืนกลับมาในการเรียกเมธอด thumbnails.set

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

  • ส่วน brandingSettings ใหม่ของทรัพยากร channel จะระบุการตั้งค่า ข้อความ และรูปภาพสําหรับหน้าช่องและหน้าสําหรับดูของช่อง

  • ทรัพยากร playlistItem มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

    • ออบเจ็กต์ status ใหม่จะสรุปข้อมูลสถานะเกี่ยวกับรายการเพลย์ลิสต์ และพร็อพเพอร์ตี้ status.privacyStatus จะระบุสถานะความเป็นส่วนตัวของรายการเพลย์ลิสต์

  • ทรัพยากร video มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

    • พร็อพเพอร์ตี้ status.publicStatsViewable ระบุว่าสถิติวิดีโอเพิ่มเติมในหน้าสําหรับดูเป็นแบบสาธารณะหรือไม่ โดยค่าเริ่มต้น สถิติดังกล่าวจะมองเห็นได้ และสถิติ เช่น จํานวนการดูและการให้คะแนนของวิดีโอจะยังคงปรากฏแบบสาธารณะได้ แม้ว่าจะตั้งค่าค่าของพร็อพเพอร์ตี้นี้เป็น false ก็ตาม คุณจะตั้งค่าพร็อพเพอร์ตี้นี้ได้เมื่อเรียกใช้เมธอด videos.insert หรือ videos.update

    • ออบเจ็กต์ contentDetails.contentRating จะสรุปคะแนนที่วิดีโอได้รับภายใต้แผนการจัดประเภทต่างๆ รายการด้านล่างระบุระบบการจัดประเภทที่รองรับและมีลิงก์ไปยังพร็อพเพอร์ตี้ที่เชื่อมโยงกับระบบการจัดประเภทแต่ละระบบ คําจํากัดความของพร็อพเพอร์ตี้จะระบุค่าคะแนนที่รองรับสําหรับแต่ละระบบ

      ประเทศ ระบบการจัดประเภท พร็อพเพอร์ตี้
      สหรัฐอเมริกา สมาคมภาพยนตร์แห่งสหรัฐอเมริกา (MPAA) contentDetails.contentRating.mpaaRating
      สหรัฐอเมริกา TV Parental Guidelines contentDetails.contentRating.tvpgRating
      ออสเตรเลีย Australian Classification Board (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
      เยอรมนี Frei Willige 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
      นิวซีแลนด์ การจําแนกประเภทภาพยนตร์และวรรณกรรม 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

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

  • ตัวอย่างโค้ดใช้ได้กับเมธอดและภาษาที่แสดงในรายการด้านล่าง

  • ขณะนี้ทรัพยากร 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 ออบเจ็กต์ที่ระบุทรัพยากรที่เพิ่มลงในช่อง ซึ่งมีพร็อพเพอร์ตี้ kind ที่ระบุประเภททรัพยากร เช่น วิดีโอหรือเพลย์ลิสต์ เช่นเดียวกับพร็อพเพอร์ตี้ resourceId อื่นๆ นอกจากนี้ยังประกอบด้วยพร็อพเพอร์ตี้ใดพร็อพเพอร์ตี้หนึ่งอย่าง 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 ระบุ ใช้เมธอด guideCategory.list เพื่อเรียกข้อมูลรายการค่าที่ถูกต้อง
    playlistItems.delete forbidden playlistItemsNotAccessible คําขอไม่ได้รับอนุญาตให้ลบรายการเพลย์ลิสต์ที่ระบุอย่างถูกต้อง
    videoCategories.list notFound videoCategoryNotFound ไม่พบหมวดหมู่วิดีโอที่ระบุโดยพารามิเตอร์ id ใช้เมธอด videoCategory.list เพื่อเรียกข้อมูลรายการค่าที่ถูกต้อง