หน้านี้จะแสดงรายการการเปลี่ยนแปลงของ 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 ซึ่งใช้ขั้นตอนการให้สิทธิ์ที่แตกต่างกันเล็กน้อย หากต้องการดูตัวอย่างทั้งหมด (และการเปลี่ยนแปลงนี้) ให้ทําดังนี้
- ไปที่เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟ หรือไปยังเอกสารประกอบสําหรับเมธอด API ใดก็ได้ เช่น วิธี
channels.list
- คลิกแท็บ
Python
เหนือตัวอย่างโค้ด - คลิกปุ่มสลับด้านบนแท็บเพื่อเปลี่ยนจากการดูข้อมูลโค้ดไปเป็นตัวอย่างแบบเต็ม
- ปัจจุบันแท็บควรแสดงตัวอย่างโค้ดที่สมบูรณ์ซึ่งใช้ขั้นตอนการให้สิทธิ์ของ
InstalledAppFlow
คําอธิบายเหนือตัวอย่างจะอธิบายข้อมูลนี้ และลิงก์ไปยังตัวอย่างสําหรับแอปพลิเคชันเว็บเซิร์ฟเวอร์ด้วย - คลิกลิงก์เพื่อเปลี่ยนเป็นตัวอย่างเว็บเซิร์ฟเวอร์ ตัวอย่างดังกล่าวใช้เฟรมเวิร์กเว็บแอปพลิเคชัน Flask และขั้นตอนการให้สิทธิ์อื่น
ตัวอย่างเหล่านี้ทั้งหมดออกแบบมาเพื่อดาวน์โหลดและเรียกใช้ในเครื่อง หากต้องการเรียกใช้ตัวอย่าง ให้ดูวิธีการเรียกใช้ตัวอย่างโค้ดแบบเต็มในเครื่องในวิธีการสําหรับข้อมูลโค้ด
- ไปที่เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟ หรือไปยังเอกสารประกอบสําหรับเมธอด API ใดก็ได้ เช่น วิธี
29 สิงหาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
- อัปเดตคําอธิบายของพารามิเตอร์
forContentOwner
ของวิธีการsearch.list
แล้ว โปรดทราบว่าหากพารามิเตอร์ดังกล่าวตั้งค่าเป็นtrue
ต้องตั้งค่าพารามิเตอร์type
เป็นvideo
- คําจํากัดความของพารามิเตอร์
regionCode
ของวิธีการsearch.list
ได้รับการอัปเดตเพื่อชี้แจงว่าพารามิเตอร์นี้จํากัดผลการค้นหาได้เฉพาะวิดีโอที่ดูในภูมิภาคที่ระบุได้ - YouTube ได้อัปเดตโลโก้และไอคอนการสร้างแบรนด์ ดาวน์โหลดโลโก้ "พัฒนาโดย YouTube" ใหม่ได้จากหน้าหลักเกณฑ์การสร้างแบรนด์ โลโก้และไอคอน YouTube ใหม่จะแสดงในหน้านั้นและดาวน์โหลดจากเว็บไซต์แบรนด์ YouTube ได้
24 กรกฎาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
- คู่มือเริ่มใช้งาน YouTube Data API ฉบับย่อใหม่สําหรับ iOS คู่มือนี้อธิบายวิธีใช้ YouTube Data API ในแอปพลิเคชัน iOS แบบง่ายที่เขียนด้วย Objective-C หรือ Swift
- ตอนนี้เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟสําหรับ YouTube Data API มีเอกสารประกอบที่อธิบายฟีเจอร์บางอย่างของเครื่องมือ ดังนี้
- การเรียกใช้คําขอ API
- การสลับระหว่างข้อมูลโค้ดและตัวอย่างโค้ดแบบเต็ม
- การใช้ฟังก์ชัน Boilerplate
- กําลังโหลดทรัพยากรที่มีอยู่ (สําหรับวิธีการอัปเดต)
หมายเหตุ: เครื่องมือยังฝังอยู่ในเอกสารอ้างอิง API สําหรับเมธอด API (ตัวอย่าง)
1 มิถุนายน 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
หมายเหตุ: นี่คือประกาศการเลิกใช้งาน
พร็อพเพอร์ตี้
video
รายการต่อไปนี้กําลังเลิกใช้งาน แม้ว่าเราจะรองรับพร็อพเพอร์ตี้เหล่านั้นจนถึงวันที่ 1 ธันวาคม 2017 ในทํานองเดียวกัน คําขอvideos.insert
และvideos.update
ที่ตั้งค่าพร็อพเพอร์ตี้เหล่านั้นจะไม่แสดงข้อผิดพลาดก่อนวันดังกล่าว แต่จะไม่มีการจัดเก็บข้อมูลที่เข้ามา
17 พฤษภาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เอกสารประกอบเกี่ยวกับ API ได้รับการอัปเดตเพื่อให้ข้อมูลโค้ดเป็นแบบอินเทอร์แอกทีฟมากขึ้นและเป็นแบบอินเทอร์แอกทีฟ หน้าที่อธิบายเมธอด API เช่น
channels.list
หรือvideos.rate
มีเครื่องมือแบบอินเทอร์แอกทีฟที่ช่วยให้คุณดูและปรับแต่งข้อมูลโค้ดใน Java, JavaScript, PHP, Python, Ruby, Apps Script และ Goไม่ว่าจะใช้วิธีใดก็ตาม เครื่องมือจะแสดงข้อมูลโค้ดสําหรับกรณีการใช้งานอย่างน้อย 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 กันยายน 2016contentDetails.relatedPlaylists.watchHistory
จะแสดงผลค่าHL
และพร็อพเพอร์ตี้contentDetails.relatedPlaylists.watchLater
จะแสดงค่าWL
สําหรับทุกช่องคําขอเรียกดูรายละเอียดของเพลย์ลิสต์ (
playlists.list
) สําหรับประวัติการดูของช่องหรือเพลย์ลิสต์ดูภายหลังจะแสดงรายการที่ว่างเปล่าหลังจากวันที่ 12 กันยายน 2016 คําขอเรียกดูรายการเพลย์ลิสต์ (playlistItems.list
) ในเพลย์ลิสต์รายการใดรายการหนึ่งจะแสดงรายชื่อดังกล่าวหลังจากช่วงเวลาดังกล่าวด้วย ซึ่งมักจะเป็นค่าใหม่HL
และWL
รวมถึงประวัติการดูหรือรหัสเพลย์ลิสต์ดูภายหลังที่ไคลเอ็นต์ API ของคุณอาจเก็บไว้แล้ว -
ออบเจ็กต์
fileDetails.recordingLocation
หรือทรัพยากรย่อยของทรัพยากรvideo
จะไม่ถูกส่งคืนหลังจากวันที่ 12 กันยายน 2016 ข้อมูลนี้สามารถเจ้าของเป็นเจ้าของวิดีโอเท่านั้นเนื่องจากออบเจ็กต์fileDetails
หลักจะเรียกใช้ได้โดยเจ้าของวิดีโอเท่านั้น
-
13 มิถุนายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้
contentDetails.googlePlusUserId
ของทรัพยากรchannel
เลิกใช้งานแล้ว ก่อนหน้านี้ ที่พักจะปรากฏก็ต่อเมื่อช่องเชื่อมโยงกับโปรไฟล์ Google+ เท่านั้น หลังจากการเลิกใช้งาน พร็อพเพอร์ตี้จะไม่รวมอยู่ในทรัพยากรของchannel
อีกต่อไป -
พร็อพเพอร์ตี้
snippet.authorGoogleplusProfileUrl
ของทรัพยากรcomment
เลิกใช้งานแล้ว ก่อนหน้านี้ ที่พักจะปรากฏก็ต่อเมื่อช่องเชื่อมโยงกับโปรไฟล์ Google+ เท่านั้น หลังจากการเลิกใช้งาน พร็อพเพอร์ตี้จะไม่รวมอยู่ในทรัพยากรของcomment
อีกต่อไป
เนื่องจากมีการส่งพร็อพเพอร์ตี้ทั้ง 2 รายการกลับมาหลังจากการเลิกใช้งาน พร็อพเพอร์ตี้ทั้ง 2 รายการจึงถูกนําออกจากเอกสารประกอบของทรัพยากรที่เกี่ยวข้อง
31 พฤษภาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พารามิเตอร์
myRecentSubscribers
ใหม่ของวิธีการsubscriptions.list
จะดึงรายชื่อสมาชิกของช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วตามลําดับเวลาจากเวลาที่ผู้ใช้ติดตามช่องโปรดทราบว่าพารามิเตอร์ใหม่จะรองรับเฉพาะการดึงข้อมูลสมาชิกล่าสุด 1,000 คนไปยังช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วเท่านั้น หากต้องการเรียกดูรายชื่อสมาชิกทั้งหมด ให้ใช้พารามิเตอร์
mySubscribers
พารามิเตอร์ดังกล่าวซึ่งไม่ได้แสดงผลสมาชิกในลําดับหนึ่งๆ จะไม่จํากัดจํานวนผู้ติดตามที่สามารถเรียกข้อมูลได้ -
อัปเดตคําจํากัดความของพร็อพเพอร์ตี้
snippet.thumbnails.(key)
สําหรับทรัพยากรกิจกรรม 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
แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์อยู่ในเพลย์ลิสต์ซีรีส์อื่นแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับเพลย์ลิสต์ซีรีส์ได้ที่ศูนย์ช่วยเหลือของ YouTubebadRequest (400)
subscriptionForbidden
เมธอด subscriptions.insert
จะแสดงผลข้อผิดพลาดนี้เพื่อแสดงว่าคุณได้สมัครใช้บริการถึงจํานวนสูงสุดแล้ว หรือสร้างการสมัครใช้บริการล่าสุดมากเกินไป หากเป็นกรณีหลังอยู่แล้ว คุณจะลองส่งคําขออีกครั้งได้หลังจากผ่านไป 2-3 ชั่วโมงbadRequest (400)
invalidCategoryId
เมธอด videos.update
แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.categoryId
ในทรัพยากรvideo
ที่อัปโหลดระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้วิธีการvideoCategories.list
เพื่อดึงข้อมูลหมวดหมู่ที่รองรับbadRequest (400)
invalidDescription
เมธอด videos.update
แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.description
ในทรัพยากรvideo
ที่อัปโหลดมีค่าที่ไม่ถูกต้องbadRequest (400)
invalidPublishAt
เมธอด videos.update
แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้status.publishAt
ในทรัพยากรvideo
ที่อัปโหลดระบุเวลาการเผยแพร่ที่กําหนดไว้ไม่ถูกต้องbadRequest (400)
invalidRecordingDetails
เมธอด videos.update
จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าออบเจ็กต์recordingDetails
ในทรัพยากรvideo
ที่อัปโหลดมีการระบุรายละเอียดการบันทึกที่ไม่ถูกต้องbadRequest (400)
invalidTags
เมธอด videos.update
แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.tags
ในทรัพยากรvideo
ที่อัปโหลดมีค่าที่ไม่ถูกต้องbadRequest (400)
invalidTitle
เมธอด videos.update
แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.title
ในทรัพยากรvideo
ที่อัปโหลดได้ระบุชื่อวิดีโอที่ไม่ถูกต้องหรือว่างเปล่าbadRequest (400)
invalidVideoMetadata
เมธอด videos.update
แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าข้อมูลเมตาของคําขอไม่ถูกต้อง ข้อผิดพลาดนี้จะเกิดขึ้นหากคําขออัปเดตส่วนsnippet
ของทรัพยากรvideo
แต่ไม่ได้กําหนดค่าสําหรับทั้งพร็อพเพอร์ตี้snippet.title
และsnippet.categoryId
18 ธันวาคม 2015
กฎหมายในสหภาพยุโรป (EU) กําหนดว่าต้องมีการเปิดเผยข้อมูลบางอย่างและต้องได้รับความยินยอมจากผู้ใช้ปลายทางในสหภาพยุโรป ดังนั้น สําหรับผู้ใช้ปลายทางในสหภาพยุโรป คุณต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU เราได้เพิ่มประกาศเกี่ยวกับข้อกําหนดนี้ในข้อกําหนดในการให้บริการของ 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
โค้ดตอบกลับ HTTP badRequest (400)
เหตุผล invalidMetadata
คำอธิบาย พร็อพเพอร์ตี้ kind
ไม่ตรงกับประเภทรหัสที่ระบุcommentThreads.update
comments.insert
comments.update
โค้ดตอบกลับ HTTP badRequest (400)
เหตุผล commentTextTooLong
คำอธิบาย ทรัพยากร comment
ที่แทรกหรืออัปเดตมีอักขระมากเกินไปในพร็อพเพอร์ตี้snippet.topLevelComment.snippet.textOriginal
playlistItems.insert
playlistItems.update
โค้ดตอบกลับ HTTP forbidden (403)
เหตุผล playlistItemsNotAccessible
คำอธิบาย คําขอไม่ได้รับอนุญาตอย่างถูกต้องให้แทรก อัปเดต หรือลบรายการเพลย์ลิสต์ที่ระบุ playlists.delete
playlists.insert
playlists.update
โค้ดตอบกลับ HTTP badRequest (400)
เหตุผล playlistForbidden
คำอธิบาย การดําเนินการนี้ไม่ได้รับอนุญาตหรือคําขอไม่ได้รับอนุญาตอย่างถูกต้อง search.list
โค้ดตอบกลับ HTTP badRequest (400)
เหตุผล invalidLocation
คำอธิบาย ค่าพารามิเตอร์ location
และ/หรือlocationRadius
มีรูปแบบที่ไม่ถูกต้องsearch.list
โค้ดตอบกลับ HTTP badRequest (400)
เหตุผล invalidRelevanceLanguage
คำอธิบาย ค่าพารามิเตอร์ relevanceLanguage
มีรูปแบบที่ไม่ถูกต้องsubscriptions.insert
โค้ดตอบกลับ HTTP badRequest (400)
เหตุผล subscriptionForbidden
คำอธิบาย ข้อผิดพลาดนี้เกิดขึ้นเมื่อข้อใดข้อหนึ่งต่อไปนี้เป็นจริง - มีการสมัครใช้บริการที่คุณพยายามสร้างอยู่แล้ว
- คุณมีการสมัครใช้บริการถึงจํานวนสูงสุดแล้ว
- คุณกําลังพยายามติดตามช่องของคุณเอง ซึ่งระบบไม่รองรับ
- คุณได้สร้างการสมัครใช้บริการมากเกินไปเมื่อเร็วๆ นี้ และต้องรอ 2-3 ชั่วโมงก่อนที่จะส่งคําขออีกครั้ง
videos.update
โค้ดตอบกลับ HTTP badRequest (400)
เหตุผล invalidDefaultBroadcastPrivacySetting
คำอธิบาย คําขอพยายามตั้งค่าความเป็นส่วนตัวที่ไม่ถูกต้องสําหรับการออกอากาศเริ่มต้น
-
28 สิงหาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตทรัพยากรและวิธีการที่มีอยู่
-
พร็อพเพอร์ตี้
statistics.favoriteCount
ของทรัพยากรvideo
เลิกใช้งานแล้วเพื่อให้เป็นไปตามนโยบายการเลิกใช้งาน พร็อพเพอร์ตี้นี้จะรวมอยู่ในทรัพยากร
video
ต่อไปอย่างน้อย 1 ปีหลังจากการประกาศนี้ แต่ตอนนี้ตั้งค่าพร็อพเพอร์ตี้เป็น0
เสมอ
-
7 สิงหาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตทรัพยากรและวิธีการที่มีอยู่
-
อัปเดตคําจํากัดความของพร็อพเพอร์ตี้
snippet.tags[]
ของทรัพยากรvideo
แล้วเพื่อให้ข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่เซิร์ฟเวอร์ API คํานวณความยาวของค่าพร็อพเพอร์ตี้ โปรดทราบว่าการอัปเดตนี้จะไม่ส่งผลต่อลักษณะการทํางานของ APIกล่าวอย่างเจาะจงคือ ตอนนี้คําจํากัดความจะอธิบายว่าหากแท็กมีการเว้นวรรค เซิร์ฟเวอร์ API จะจัดการค่าแท็กเสมือนว่าค่านั้นรวมอยู่ในเครื่องหมายคําพูด และเครื่องหมายคําพูดจะนับรวมในจํานวนอักขระสูงสุด ดังนั้น ตามวัตถุประสงค์ของจํานวนอักขระสูงสุด แท็ก Foo-Baz จะมีอักขระ 7 ตัว แต่แท็ก Foo Baz มีอักขระ 9 ตัว
-
เมธอด
commentThreads.insert
จะไม่รองรับพารามิเตอร์shareOnGooglePlus
อีกต่อไป ซึ่งก่อนหน้านี้จะระบุว่าควรโพสต์ความคิดเห็นและตอบกลับความคิดเห็นนั้นไปยังโปรไฟล์ Google+ ของผู้เขียนด้วย หากคําขอส่งพารามิเตอร์ เซิร์ฟเวอร์ API จะไม่สนใจพารามิเตอร์ แต่จะจัดการคําขอนั้น
-
18 มิถุนายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตทรัพยากรและวิธีการที่มีอยู่
-
พารามิเตอร์
order
ใหม่ของเมธอดcommentThreads.list
ระบุลําดับการตอบกลับของ API ควรแสดงชุดข้อความความคิดเห็น โดยจะจัดเรียงชุดข้อความตามเวลาหรือความเกี่ยวข้องได้ การดําเนินการเริ่มต้นคือการเรียงลําดับตามเวลา -
พร็อพเพอร์ตี้
snippet.defaultAudioLanguage
ใหม่ของทรัพยากรvideo
ระบุภาษาที่พูดในแทร็กเสียงเริ่มต้นของวิดีโอ -
อัปเดตคําจํากัดความของพร็อพเพอร์ตี้
contentDetails.licensedContent
ของทรัพยากรvideo
เพื่อชี้แจงว่าเดิมเนื้อหาต้องอัปโหลดไปที่ช่องที่ลิงก์กับพาร์ทเนอร์เนื้อหาของ YouTube แล้วอ้างสิทธิ์โดยพาร์ทเนอร์รายนั้น ซึ่งไม่ได้แสดงถึงการเปลี่ยนแปลงของพฤติกรรม API จริง -
ปัจจุบันเมธอด
captions.delete
,captions.download
,captions.insert
,captions.list
และcaptions.update
รองรับพารามิเตอร์onBehalfOfContentOwner
ซึ่งรองรับวิธีการอื่นๆ แล้ว คําขอที่ใช้วิธีการนั้นจําเป็นต้องได้รับอนุญาตจากโทเค็นที่ให้การเข้าถึงขอบเขตhttps://www.googleapis.com/auth/youtubepartner
ด้วย
-
-
ข้อผิดพลาดใหม่และอัปเดต
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
รายละเอียดข้อผิดพลาด videos.rate
โค้ดตอบกลับ HTTP badRequest (400)
เหตุผล emailNotVerified
คำอธิบาย ผู้ใช้ต้องยืนยันอีเมลก่อนจัดประเภทวิดีโอ videos.rate
โค้ดตอบกลับ HTTP badRequest (400)
เหตุผล videoPurchaseRequired
คำอธิบาย เฉพาะผู้ใช้ที่เช่าเท่านั้นที่สามารถจัดประเภทวิดีโอเช่า -
เมธอด
subscriptions.delete
และsubscriptions.insert
ไม่รองรับข้อผิดพลาดaccountClosed
และaccountSuspended
อีกต่อไป
-
27 เมษายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูลและวิธีการใหม่ๆ
-
ทรัพยากร
videoAbuseReportReason
ใหม่มีข้อมูลเกี่ยวกับเหตุผลที่วิดีโอจะถูกแจ้งว่าไม่เหมาะสมเนื่องจากมีเนื้อหาที่เป็นการละเมิด เมธอดvideoAbuseReportReasons.list
ช่วยให้คุณเรียกดูรายการเหตุผลทั้งหมดที่วิดีโออาจได้รับแจ้งว่าไม่เหมาะสม -
เมธอด
videos.reportAbuse
ใหม่ให้วิธีแจ้งว่าวิดีโอมีเนื้อหาที่ไม่เหมาะสมจริงๆ เนื้อหาของคําขอมีออบเจ็กต์ JSON ที่ระบุวิดีโอที่ถูกแจ้งว่าไม่เหมาะสม รวมถึงเหตุผลที่วิดีโอถือว่ามีเนื้อหาที่ไม่เหมาะสม คุณหาเหตุผลที่ถูกต้องได้จากเมธอดvideoAbuseReportReason.list
ที่อธิบายไว้ด้านบนนอกจากนี้เรายังอัปเดตคําแนะนําในการย้ายข้อมูลพร้อมตัวอย่างสําหรับการรายงานวิดีโอที่ละเมิดด้วย การเปลี่ยนแปลงนี้ทําให้ 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 ตัวเลือก ผู้ใช้ต้องเป็นไปตามการตั้งค่าการกําหนดเป้าหมายทั้งหมดเพื่อให้ส่วนแชแนลปรากฏ
-
targeting.languages[]
: รายการภาษาของแอปพลิเคชัน YouTube ผู้ใช้ที่เลือกภาษาใดภาษาหนึ่งข้างต้นจะเห็นส่วนช่องที่เกี่ยวข้อง -
targeting.regions[]
: รายการภูมิภาคเนื้อหาที่ต้องการของ YouTube ผู้ใช้ที่เลือกหนึ่งในภูมิภาคเหล่านั้น รวมถึงผู้ใช้ที่เลือกภูมิภาคใดภูมิภาคหนึ่งโดยอัตโนมัติจะเห็นส่วนช่อง -
targeting.countries[]
: รายชื่อประเทศที่แสดงส่วนช่อง ค่าแต่ละค่าในรายการคือรหัสประเทศ ISO 3166-1 alpha-2
-
-
คําจํากัดความของพร็อพเพอร์ตี้
contentDetails.duration
ของทรัพยากรvideo
ได้รับการแก้ไขเพื่อให้แสดงค่าเป็นชั่วโมง วัน ฯลฯ ได้ -
เอกสารประกอบสําหรับเมธอด
channelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
และvideos.delete
ได้รับการแก้ไขเพื่อแสดงว่าวิธีทั้งหมดส่งคืนโค้ดตอบกลับ HTTP204
(No Content
) เมื่อสําเร็จ
-
-
ข้อผิดพลาดใหม่และอัปเดต
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
targetInvalidCountry
เมธอด channelSections.insert
และchannelSections.update
จะแสดงผลข้อผิดพลาดนี้หากทรัพยากรchannelSection
ที่แทรกมีค่าที่ไม่ถูกต้องสําหรับพร็อพเพอร์ตี้targeting.countries[]
badRequest (400)
targetInvalidLanguage
เมธอด channelSections.insert
และchannelSections.update
จะแสดงผลข้อผิดพลาดนี้หากทรัพยากรchannelSection
ที่แทรกมีค่าที่ไม่ถูกต้องสําหรับพร็อพเพอร์ตี้targeting.languages[]
badRequest (400)
targetInvalidRegion
เมธอด channelSections.insert
และchannelSections.update
จะแสดงผลข้อผิดพลาดนี้หากทรัพยากรchannelSection
ที่แทรกมีค่าที่ไม่ถูกต้องสําหรับพร็อพเพอร์ตี้targeting.regions[]
badRequest (400)
operationNotSupported
เมธอด comments.insert
จะแสดงผลข้อผิดพลาดนี้หากผู้ใช้ API แทรกความคิดเห็นในการตอบกลับความคิดเห็นระดับบนสุดที่ระบุโดยพร็อพเพอร์ตี้snippet.parentId
ไม่ได้ ในทรัพยากรcommentThread
พร็อพเพอร์ตี้snippet.canReply
จะระบุว่าผู้ดูปัจจุบันตอบกลับชุดข้อความได้หรือไม่badRequest (400)
invalidChannelId
เมธอด search.list
จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์channelId
ในคําขอระบุรหัสช่องที่ไม่ถูกต้องbadRequest (400)
subscriptionForbidden
เมธอด subscriptions.insert
จะแสดงผลข้อผิดพลาดนี้หากผู้ใช้ API พยายามติดตามช่องของผู้ใช้ -
เมธอด
captions.update
นี้ไม่รองรับข้อผิดพลาดinvalidMetadata
และvideoNotFound
อีกต่อไป
-
16 เมษายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตคําแนะนําในการย้ายข้อมูลเพื่ออธิบายวิธีย้ายข้อมูลแอปพลิเคชันที่ยังใช้ฟังก์ชันความคิดเห็นจาก 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
โปรดทราบว่าไม่มีการรับประกันว่าการตอบกลับดังกล่าวจะมีวิดีโอการสมัครใช้บริการใหม่จํานวนเท่าใดก็ตาม -
ข้อความ 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
ออกจากทรัพยากรที่ส่งในส่วนเนื้อหาของคําขอ หากต้องการให้รายการเพลย์ลิสต์มีตําแหน่งที่เฉพาะเจาะจงในรายการ คุณต้องอัปเดตการตั้งค่าการจัดลําดับของเพลย์ลิสต์เป็นด้วยตนเอง คุณปรับการตั้งค่านี้ได้ในเครื่องมือจัดการวิดีโอ YouTubeforbidden (403)
channelClosed
เมธอด playlists.list
จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์channelId
ของคําขอระบุช่องที่ปิดไปแล้วforbidden (403)
channelSuspended
เมธอด playlists.list
จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์channelId
ของคําขอระบุช่องที่ถูกระงับforbidden (403)
playlistForbidden
เมธอด playlists.list
จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์id
ของคําขอไม่รองรับคําขอหรือคําขอไม่ได้รับอนุญาตอย่างถูกต้องnotFound (404)
channelNotFound
เมธอด playlists.list
จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์channelId
ของคําขอระบุช่องที่ไม่พบnotFound (404)
playlistNotFound
เมธอด playlists.list
จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์id
ของคําขอระบุเพลย์ลิสต์ที่ไม่พบnotFound (404)
videoNotFound
เมธอด videos.list
จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์id
ของคําขอระบุวิดีโอที่ไม่พบbadRequest (400)
invalidRating
เมธอด videos.rate
จะแสดงผลข้อผิดพลาดนี้หากคําขอมีค่าที่ไม่คาดคิดสําหรับพารามิเตอร์rating
2 มีนาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้เมธอด
search.list
รองรับพารามิเตอร์relevanceLanguage
แล้ว ซึ่งช่วยให้คุณขอผลการค้นหาที่เกี่ยวข้องกับภาษาหนึ่งๆ มากที่สุดได้นอกจากนี้ เรายังอัปเดตคําแนะนําในการย้ายข้อมูล YouTube Data API (v3) เพื่ออธิบายวิธีใช้พารามิเตอร์ใหม่นี้ด้วย พารามิเตอร์จะจัดการกับช่องว่างของฟีเจอร์ที่เคยมีอยู่ระหว่าง API เวอร์ชันปัจจุบัน (v3) กับเวอร์ชันก่อนหน้า (v2) ซึ่งเลิกใช้งานไปแล้ว
-
เรายังได้อัปเดตคําแนะนําในการย้ายข้อมูล YouTube Data API (v3) เพื่อระบุการเลิกใช้งานช่องฟีดและข้อมูลเมตาพิเศษที่ v2 API มีให้เพื่ออธิบายภาพยนตร์ ตัวอย่าง รายการทีวี ซีซันรายการทีวี และตอนของรายการทีวี
14 มกราคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตคําแนะนําในการย้ายข้อมูล YouTube Data API (v3) เพื่ออธิบายวิธีใช้ v3 API ในการอัปโหลดวิดีโอโดยใช้ JavaScript (โปรดดูรายละเอียดที่หัวข้ออัปโหลดวิดีโอ) ฟังก์ชันนี้เทียบได้กับฟังก์ชันการอัปโหลดบนเบราว์เซอร์ที่ 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
ซึ่งมีรหัสสถานะ HTTP400
-
ตอนนี้ทรัพยากร
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 ส่งคืนโค้ดตอบกลับ HTTP204
สําหรับคําขอที่ประสบความสําเร็จของเมธอดเหล่านั้น
2 พฤษภาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูลใหม่
i18nLanguage
ระบุภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ ภาษาของแอปพลิเคชันอาจเรียกว่าภาษา UI ได้เช่นกัน สําหรับเว็บไซต์ YouTube อาจมีการเลือกภาษาของแอปพลิเคชันโดยอัตโนมัติตามการตั้งค่าบัญชี Google, ภาษาของเบราว์เซอร์ หรือตําแหน่ง IP และผู้ใช้ก็สามารถเลือกภาษา UI ที่ต้องการด้วยตนเองจากส่วนท้ายของเว็บไซต์ YouTube ได้เช่นกันAPI รองรับวิธีระบุภาษาของแอปพลิเคชันที่รองรับ ภาษาที่รองรับจะใช้เป็นค่าของพารามิเตอร์
hl
เมื่อเรียกเมธอด API เช่นvideoCategories.list
และguideCategories.list
-
ทรัพยากร
i18nRegion
ใหม่จะระบุพื้นที่ทางภูมิศาสตร์ที่ผู้ใช้ YouTube เลือกเป็นภูมิภาคเนื้อหาที่ต้องการได้ ภูมิภาคของเนื้อหายังเรียกว่าภาษาของเนื้อหาได้อีกด้วย สําหรับเว็บไซต์ YouTube อาจมีการเลือกเขตเนื้อหาโดยอัตโนมัติโดยพิจารณาจากฮิวริสติก เช่น โดเมน YouTube หรือตําแหน่ง IP ของผู้ใช้ นอกจากนี้ผู้ใช้ยังเลือกเขตเนื้อหาที่ต้องการจากส่วนท้ายของเว็บไซต์ YouTube ด้วยตนเองได้ด้วยAPI รองรับวิธีระบุภูมิภาคเนื้อหาที่รองรับ รหัสภูมิภาคที่รองรับสามารถใช้เป็นค่าของพารามิเตอร์
regionCode
เมื่อเรียกใช้เมธอด API เช่นsearch.list
,videos.list
,activities.list
และvideoCategories.list
7 เมษายน 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ทรัพยากร
channelSection
ใหม่มีข้อมูลเกี่ยวกับชุดวิดีโอที่ช่องเลือกที่จะแสดง เช่น ส่วนอาจแสดงการอัปโหลดล่าสุดของช่อง การอัปโหลดยอดนิยม หรือวิดีโอจากเพลย์ลิสต์อย่างน้อย 1 รายการAPI รองรับเมธอดในการแสดงรายการ แทรก อัปเดต หรือลบส่วนช่อง คุณเรียกข้อมูลรายการส่วนช่องของช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์แล้ว โดยระบุรหัสช่องที่เฉพาะเจาะจง หรือระบุรายการรหัสส่วนช่องที่ไม่ซ้ํากัน
นอกจากนี้เอกสารประกอบเกี่ยวกับข้อผิดพลาดยังได้รับการอัปเดตเพื่ออธิบายข้อความแสดงข้อผิดพลาดที่ API รองรับสําหรับวิธีการใหม่เหล่านี้โดยเฉพาะ
-
อัปเดตคําจํากัดความของออบเจ็กต์
fileDetails
ของทรัพยากรvideo
แล้วเพื่ออธิบายว่าออบเจ็กต์ดังกล่าวจะแสดงผลเฉพาะเมื่อพร็อพเพอร์ตี้processingDetails.fileDetailsAvailability
ของวิดีโอมีค่าavailable
ในทํานองเดียวกัน มีการอัปเดตออบเจ็กต์ออบเจ็กต์
suggestions
ของทรัพยากรvideo
เพื่ออธิบายว่าออบเจ็กต์ดังกล่าวจะแสดงผลเฉพาะเมื่อพร็อพเพอร์ตี้processingDetails.tagSuggestionsAvailability
ของวิดีโอหรือพร็อพเพอร์ตี้processingDetails.editorSuggestionsAvailability
มีค่าavailable
-
อัปเดตเอกสารประกอบสําหรับเมธอด
videos.insert
และvideos.update
แล้วเพื่อแสดงว่าตั้งค่าพร็อพเพอร์ตี้status.publishAt
ได้เมื่อเรียกใช้เมธอดดังกล่าว -
อัปเดตคําจํากัดความของออบเจ็กต์
invideoPromotion
ของทรัพยากรchannel
เพื่ออธิบายว่าออบเจ็กต์สามารถเรียกได้โดยเจ้าของช่องเท่านั้น -
อัปเดตรายการพารามิเตอร์สําหรับเมธอด
videos.rate
แล้วเพื่อแสดงให้เห็นว่าวิธีการนั้นไม่รองรับพารามิเตอร์onBehalfOfContentOwner
จริงๆ เกิดข้อผิดพลาดเกี่ยวกับเอกสารประกอบเนื่องจากคําขอvideos.rate
ที่ตั้งค่าพารามิเตอร์นี้แสดงข้อผิดพลาด500
31 มีนาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้
status.publishAt
ใหม่ของทรัพยากรvideo
ช่วยให้คุณระบุวันที่และเวลาสําหรับการเผยแพร่วิดีโอส่วนตัวได้ คุณจะตั้งค่าพร็อพเพอร์ตี้นี้ได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอคือprivate
และวิดีโอยังไม่ได้รับการเผยแพร่ พร็อพเพอร์ตี้ใหม่นี้ไม่เป็นไปตามนโยบายการเลิกใช้งาน
13 มีนาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้ API รองรับส่วน
contentOwnerDetails
สําหรับทรัพยากรchannel
รายการแล้ว โดยส่วนใหม่ประกอบด้วยข้อมูลช่องที่เกี่ยวข้องกับพาร์ทเนอร์ YouTube ที่ลิงก์กับช่อง รวมถึงรหัสของเจ้าของเนื้อหาที่ลิงก์กับช่อง รวมถึงวันที่และเวลาที่มีการลิงก์เจ้าของเนื้อหากับช่อง โปรดทราบว่าส่วนใหม่นี้ไม่อยู่ภายใต้นโยบายการเลิกใช้งาน -
ตอนนี้เอกสารประกอบจะแสดงจํานวนอักขระสูงสุดที่รองรับสําหรับพร็อพเพอร์ตี้ต่อไปนี้
ทรัพยากร พร็อพเพอร์ตี้ ความยาวสูงสุด channel
invideoPromotion.items[].customMessage
40 อักขระ video
snippet.title
100 อักขระ video
snippet.description
5000 ไบต์ video
snippet.tags
500 อักขระ โปรดทราบว่าค่าพร็อพเพอร์ตี้เป็นรายการและคอมมาระหว่างรายการจะนับรวมในขีดจํากัด -
พร็อพเพอร์ตี้
brandingSettings.watch.featuredPlaylistId
ของทรัพยากรchannel
เลิกใช้งานแล้ว API จะแสดงผลข้อผิดพลาดหากคุณพยายามตั้งค่า -
มีการเพิ่มพร็อพเพอร์ตี้ทรัพยากร
video
ต่อไปนี้ลงในรายการค่าที่สามารถตั้งได้เมื่อแทรกหรืออัปเดตวิดีโอ -
ตอนนี้เอกสารประกอบเกี่ยวกับข้อผิดพลาดจะระบุโค้ดตอบกลับของ HTTP สําหรับข้อผิดพลาดแต่ละประเภท
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
invalidCriteria
เมธอด channels.list
จะแสดงผลข้อผิดพลาดนี้หากคําขอระบุพารามิเตอร์ตัวกรองที่เมื่อใช้ร่วมกันไม่ได้badRequest (400)
channelTitleUpdateForbidden
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากคุณพยายามอัปเดตส่วนbrandingSettings
ของช่องและเปลี่ยนค่าของพร็อพเพอร์ตี้brandingSettings.channel.title
(โปรดทราบว่า API จะไม่แสดงผลข้อผิดพลาดหากคุณละเว้นพร็อพเพอร์ตี้)badRequest (400)
invalidRecentlyUploadedBy
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากพร็อพเพอร์ตี้invideoPromotion.items[].id.recentlyUploadedBy
ระบุรหัสช่องที่ไม่ถูกต้องbadRequest (400)
invalidTimingOffset
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากส่วนinvideoPromotion
ระบุการชดเชยเวลาที่ไม่ถูกต้องbadRequest (400)
tooManyPromotedItems
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากส่วนinvideoPromotion
ระบุรายการที่โปรโมตเกินกว่าจํานวนที่อนุญาตforbidden (403)
promotedVideoNotAllowed
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากพร็อพเพอร์ตี้invideoPromotion.items[].id.videoId
ระบุรหัสวิดีโอที่ระบุหรือไม่สามารถใช้เป็นรายการที่โปรโมตได้forbidden (403)
websiteLinkNotAllowed
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากพร็อพเพอร์ตี้invideoPromotion.items[].id.websiteUrl
ระบุ URL ที่ไม่ได้รับอนุญาตrequired (400)
requiredTimingType
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากคําขอไม่ได้ระบุการตั้งค่าเวลาเริ่มต้นสําหรับเวลาที่ YouTube ควรแสดงรายการที่โปรโมตrequired (400)
requiredTiming
เมธอด channels.update
ต้องระบุออบเจ็กต์invideoPromotion.items[].timing
สําหรับแต่ละรายการที่โปรโมตrequired (400)
requiredWebsiteUrl
เมธอด channels.update
ต้องระบุพร็อพเพอร์ตี้invideoPromotion.items[].id.websiteUrl
สําหรับแต่ละรายการที่โปรโมตbadRequest (400)
invalidPublishAt
เมธอด videos.insert
จะแสดงผลข้อผิดพลาดนี้หากข้อมูลเมตาของคําขอระบุเวลาการเผยแพร่ที่กําหนดไว้ไม่ถูกต้อง
4 มีนาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้ YouTube Data API v3 อยู่ภายใต้นโยบายการเลิกใช้งานที่ระบุไว้ในข้อกําหนดในการให้บริการของ YouTube API โปรดทราบว่าหน้าที่แสดง API ที่อยู่ภายใต้นโยบายการเลิกใช้งานจะยกเว้นฟังก์ชันบางรายการของ v3 API ไม่ให้แสดงภายใต้นโยบาย
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
บ่งบอกว่าวิดีโอที่อัปเดตหรือวิดีโอที่เพิ่งอัปโหลดเชื่อมโยงกับหมวดหมู่วิดีโอนั้นได้หรือไม่ -
เพิ่มตัวอย่างโค้ดสําหรับวิธีการต่อไปนี้แล้ว
activities.insert
(ไป)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(ไป)search.list
(ไป)thumbnails.set
(Java)videos.insert
(ไป)
24 ตุลาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API มีฟีเจอร์เพิ่มเติม 2 อย่างที่ออกแบบมาเพื่อช่วยค้นหาและแสดงเนื้อหาการถ่ายทอดสด ได้แก่
พร็อพเพอร์ตี้
snippet.liveBroadcastContent
ใหม่ในผลการค้นหาระบุว่าทรัพยากรของวิดีโอหรือช่องมีเนื้อหาการถ่ายทอดสดหรือไม่ ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือupcoming
,active
และnone
-
พร็อพเพอร์ตี้
snippet.liveBroadcastContent
ใหม่ของทรัพยากรvideo
บ่งบอกว่าวิดีโอเป็นการถ่ายทอดสดที่กําลังจะเกิดขึ้นหรือทํางานอยู่ รายการด้านล่างจะอธิบายค่าที่เป็นไปได้ของพร็อพเพอร์ตี้upcoming
- วิดีโอเป็นการถ่ายทอดสดที่ยังไม่ได้เริ่มactive
– วิดีโอกําลังถ่ายทอดสดอย่างต่อเนื่องnone
- วิดีโอไม่ใช่การถ่ายทอดสดที่กําลังจะเผยแพร่หรือกําลังดําเนินอยู่ ตัวแปรนี้จะเป็นค่าพร็อพเพอร์ตี้สําหรับการออกอากาศที่เสร็จสมบูรณ์ซึ่งยังคงดูได้ใน YouTube
-
พร็อพเพอร์ตี้
liveStreamingDetails
ใหม่ของทรัพยากรvideo
คือออบเจ็กต์ที่มีข้อมูลเมตาเกี่ยวกับการออกอากาศวิดีโอแบบสด หากต้องการเรียกข้อมูลเมตานี้ ให้ใส่liveStreamingDetails
ในรายการส่วนทรัพยากรของค่าพารามิเตอร์part
โดยข้อมูลเมตาจะมีพร็อพเพอร์ตี้ใหม่ดังต่อไปนี้liveStreamingDetails.actualStartTime
– เวลาที่การออกอากาศเริ่มต้นขึ้นจริง (ค่านี้จะปรากฏเมื่อสถานะการออกอากาศเป็นactive
)liveStreamingDetails.actualEndTime
– เวลาที่การออกอากาศจริงสิ้นสุดลง (ค่านี้จะปรากฏเมื่อการออกอากาศสิ้นสุด)liveStreamingDetails.scheduledStartTime
– เวลาเริ่มออกอากาศliveStreamingDetails.scheduledEndTime
- เวลาที่การถ่ายทอดสดสิ้นสุดลง หากค่าพร็อพเพอร์ตี้ว่างเปล่าหรือไม่มีพร็อพเพอร์ตี้อยู่ การออกอากาศจะถูกตั้งเวลาให้ดําเนินการต่อแบบไม่มีกําหนดliveStreamingDetails.concurrentViewers
– จํานวนผู้ที่ดูการถ่ายทอดสด
หากต้องการเรียกข้อมูลเมตานี้ ให้ใส่
liveStreamingDetails
ในค่าพารามิเตอร์part
เมื่อเรียกใช้เมธอดvideos.list
,videos.insert
หรือvideos.update
โปรดทราบว่ามีการใช้อีก 2 ฟีเจอร์เพื่อระบุเนื้อหาการถ่ายทอดสดในวันที่ 1 ตุลาคม 2013 ซึ่งก็คือพารามิเตอร์
eventType
ของเมธอดsearch.list
และพร็อพเพอร์ตี้snippet.liveBroadcastContent
ของผลการค้นหา -
-
ตอนนี้เมธอด
videos.insert
รองรับพารามิเตอร์notifySubscribers
แล้ว ซึ่งจะระบุว่า YouTube ควรส่งการแจ้งเตือนเกี่ยวกับวิดีโอใหม่ให้แก่ผู้ใช้ที่ติดตามช่องของวิดีโอหรือไม่ ค่าเริ่มต้นของพารามิเตอร์คือTrue
ซึ่งระบุว่าผู้ติดตามจะได้รับการแจ้งเตือนเกี่ยวกับวิดีโอที่อัปโหลดใหม่ อย่างไรก็ตาม เจ้าของช่องที่กําลังอัปโหลดวิดีโอหลายรายการอาจต้องการตั้งค่าเป็นFalse
เพื่อหลีกเลี่ยงการส่งการแจ้งเตือนเกี่ยวกับวิดีโอใหม่แต่ละรายการไปยังผู้ติดตามของช่อง -
อัปเดตรายการพร็อพเพอร์ตี้ที่แก้ไขได้เมื่อเรียกใช้เมธอด
channels.update
ให้รวมพร็อพเพอร์ตี้invideoPromotion.items[].customMessage
และinvideoPromotion.items[].websiteUrl
นอกจากนี้ยังมีการแก้ไขรายการเพื่อระบุพร็อพเพอร์ตี้brandingSettings
ที่แก้ไขได้ มีการแก้ไขพร็อพเพอร์ตี้brandingSettings
เหล่านี้แล้ว การเปลี่ยนแปลงในเอกสารจึงไม่แสดงการเปลี่ยนแปลงฟังก์ชันการทํางานที่มีอยู่ของ API -
เมธอด
playlists.insert
,playlists.update
และplaylists.delete
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งระบบรองรับเมธอดอื่นๆ อีกหลายวิธีแล้ว -
ตอนนี้เมธอด
playlists.insert
รองรับพารามิเตอร์onBehalfOfContentOwnerChannel
แล้ว ซึ่งรองรับด้วยวิธีอื่นแล้ว -
ขณะนี้พร็อพเพอร์ตี้
contentDetails.contentRating.tvpgRating
ของทรัพยากรvideo
รองรับค่าpg14
ซึ่งสอดคล้องกับคะแนนTV-14
-
คําจํากัดความของพร็อพเพอร์ตี้
snippet.liveBroadcastContent
ซึ่งเป็นส่วนหนึ่งของผลการค้นหาได้รับการแก้ไขให้สอดคล้องกับlive
เป็นค่าพร็อพเพอร์ตี้ที่ถูกต้อง แต่active
ไม่ใช่ค่าพร็อพเพอร์ตี้ที่ถูกต้อง -
ตอนนี้พร็อพเพอร์ตี้
contentDetails.contentRating.mibacRating
ของทรัพยากรvideo
รองรับการให้คะแนนเพิ่มเติม 2 รายการแล้วmibacVap
(VAP) – เด็กควรมีผู้ใหญ่รวมอยู่ด้วยmibacVm6
(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
-
เพิ่มตัวอย่างโค้ดสําหรับวิธีการต่อไปนี้แล้ว
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(ฟิลิปปินส์)videos.list
(ฟิลิปปินส์)videos.rate
(Python)videos.update
(Java, PHP, Python)
โปรดทราบว่าตัวอย่าง Python สําหรับเมธอด
playlistItems.insert
ถูกนําออกด้วย เนื่องจากฟังก์ชันที่เมธอดนี้จัดการได้รับการจัดการโดยเมธอดvideos.rate
-
error documentation
อธิบายข้อผิดพลาดตามบริบทคําขอใหม่ต่อไปนี้ ซึ่งอาจเกิดขึ้นสําหรับเมธอด API ใดก็ได้ที่รองรับพารามิเตอร์คําขอmine
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
invalidMine
ใช้พารามิเตอร์ mine
ในคําขอที่ผู้ใช้ที่ตรวจสอบสิทธิ์เป็นพาร์ทเนอร์ YouTube ไม่ได้ คุณควรนําพารามิเตอร์mine
ออก ตรวจสอบสิทธิ์ในฐานะผู้ใช้ YouTube โดยนําพารามิเตอร์onBehalfOfContentOwner
ออก หรือดําเนินการเป็นหนึ่งในช่องของพาร์ทเนอร์โดยระบุพารามิเตอร์onBehalfOfContentOwnerChannel
หากมีอยู่ในเมธอดที่เรียกใช้
8 สิงหาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ส่วนการเริ่มต้นใช้งาน API ข้อมูลของ YouTube ส่วนการใช้งานโควต้า ได้รับการอัปเดตเกี่ยวกับการเปลี่ยนแปลงค่าใช้จ่ายโควต้าสําหรับการอัปโหลดวิดีโอจากประมาณ 16,000 หน่วยเป็น 1,600 หน่วยโดยประมาณ
30 กรกฎาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ในทรัพยากร
channelBanner
ค่าของค่าของพร็อพเพอร์ตี้kind
เปลี่ยนจากyoutube#channelBannerInsertResponse
เป็นyoutube#channelBannerResource
ทรัพยากรนี้ส่งคืนตามคําขอchannelBanners.insert
-
พร็อพเพอร์ตี้
brandingSettings.channel.profileColor
ใหม่ของทรัพยากรchannel
ระบุสีที่โดดเด่นซึ่งช่วยส่งเสริมเนื้อหาของช่อง ค่าพร็อพเพอร์ตี้คือเครื่องหมายปอนด์ (#
) ตามด้วยสตริงเลขฐานสิบหก 6 อักขระ เช่น#2793e6
-
ปัจจุบัน API รองรับความสามารถในการระบุว่าการติดตามมีไว้สําหรับกิจกรรมทั้งหมดของช่องหรือสําหรับการอัปโหลดใหม่เท่านั้น พร็อพเพอร์ตี้
contentDetails.activityType
ใหม่ของทรัพยากรsubscription
จะระบุประเภทของกิจกรรมที่ผู้ติดตามจะได้รับการแจ้งเตือน ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือall
และuploads
-
เมธอด
videos.list
รองรับพารามิเตอร์ใหม่สําหรับการดึงข้อมูลแผนภูมิของวิดีโอยอดนิยมบน YouTube- พารามิเตอร์
chart
จะระบุแผนภูมิที่คุณต้องการเรียกข้อมูล ปัจจุบันค่าที่รองรับเพียงค่าเดียวคือmostPopular
โปรดทราบว่าพารามิเตอร์chart
คือพารามิเตอร์ตัวกรอง ซึ่งหมายความว่าจะไม่สามารถใช้คําขอในคําขอเดียวกันกับพารามิเตอร์ตัวกรองอื่นๆ (id
และmyRating
) - พารามิเตอร์
videoCategoryId
จะระบุหมวดหมู่วิดีโอที่ควรดึงข้อมูลแผนภูมิ พารามิเตอร์นี้สามารถใช้ร่วมกับพารามิเตอร์chart
เท่านั้น โดยค่าเริ่มต้น แผนภูมิจะไม่จํากัดเฉพาะหมวดหมู่ใดหมวดหมู่หนึ่ง
- พารามิเตอร์
-
พร็อพเพอร์ตี้
topicDetails.relevantTopicIds[]
ใหม่ของทรัพยากรvideo
จะแสดงรายการรหัสหัวข้อ Freebase ที่เกี่ยวข้องกับวิดีโอหรือเนื้อหา หรืออาจมีการพูดถึงหัวข้อของหัวข้อเหล่านี้ในวิดีโอ -
เปลี่ยนชื่อพร็อพเพอร์ตี้
recordingDetails.location.elevation
ของทรัพยากรvideo
เป็นrecordingDetails.location.altitude
แล้ว และเปลี่ยนชื่อพร็อพเพอร์ตี้fileDetails.recordingLocation.location.elevation
เป็นfileDetails.recordingLocation.location.altitude
-
ออบเจ็กต์
contentDetails.contentRating
ของทรัพยากรvideo
ระบุการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ รวมถึงการจัดประเภท MPAA, การจัดประเภทของ TVPG เป็นต้น สําหรับระบบการจัดประเภทแต่ละระบบ API จะรองรับค่าการจัดประเภทที่บ่งบอกว่าวิดีโอยังไม่ได้รับการจัดประเภท โปรดทราบว่าสําหรับการจัดประเภท MPAA การจัดประเภท "ไม่มีการให้คะแนน" มักจะใช้เพื่อระบุภาพยนตร์ที่มีเวอร์ชันที่ยังไม่ได้ตัดที่ภาพยนตร์เวอร์ชันแบบตัดผ่านได้รับการจัดประเภทอย่างเป็นทางการ -
พร็อพเพอร์ตี้
contentDetails.contentRating.ytRating
ใหม่ของทรัพยากรvideo
ระบุเนื้อหาที่จํากัดอายุผู้ชม ค่าพร็อพเพอร์ตี้จะเป็นytAgeRestricted
หาก YouTube ระบุว่าวิดีโอมีเนื้อหาที่ไม่เหมาะสมสําหรับผู้ใช้ที่อายุต่ํากว่า 18 ปี หากไม่มีพร็อพเพอร์ตี้ หรือค่าของพร็อพเพอร์ตี้ว่างเปล่า ระบบจะไม่ระบุว่าเนื้อหามีการจํากัดอายุผู้ชม -
พารามิเตอร์
mySubscribers
ของวิธีchannels.list
เลิกใช้งานแล้ว ใช้วิธีการsubscriptions.list
และพารามิเตอร์mySubscribers
เพื่อดึงข้อมูลรายชื่อสมาชิกของช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว -
เมธอด
channelBanners.insert
,channels.update
,videos.getRating
และvideos.rate
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว พารามิเตอร์ดังกล่าวบ่งชี้ว่าผู้ใช้ที่ตรวจสอบสิทธิ์แล้วดําเนินการในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์ -
ระบบได้อัปเดตเอกสารประกอบของวิธี
channels.update
แล้วเพื่อแสดงข้อเท็จจริงว่าเมธอดนี้สามารถใช้เพื่ออัปเดตออบเจ็กต์brandingSettings
และพร็อพเพอร์ตี้ย่อยของทรัพยากรchannel
ได้ และเอกสารประกอบจะแสดงรายการพร็อพเพอร์ตี้ที่อัปเดตซึ่งคุณสามารถตั้งค่าสําหรับออบเจ็กต์invideoPromotion
ของทรัพยากรchannel
-
error documentation
อธิบายข้อผิดพลาดใหม่ต่อไปนี้ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย forbidden
accountDelegationForbidden
ข้อผิดพลาดนี้ไม่ได้เจาะจงวิธีการ API ที่เฉพาะเจาะจง เป็นการระบุว่าผู้ใช้ที่ตรวจสอบสิทธิ์แล้วไม่ได้รับอนุญาตให้ดําเนินการในนามของบัญชี Google ที่ระบุ forbidden
authenticatedUserAccountClosed
ข้อผิดพลาดนี้ไม่ได้เจาะจงวิธีการ API ที่เฉพาะเจาะจง ระบุว่าบัญชี YouTube ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วถูกปิด หากผู้ใช้ดําเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้จะบ่งบอกว่ามีการปิดบัญชีอื่น forbidden
authenticatedUserAccountSuspended
ข้อผิดพลาดนี้ไม่ได้เจาะจงวิธีการ API ที่เฉพาะเจาะจง ระบุว่าบัญชี YouTube ของผู้ใช้ที่ตรวจสอบสิทธิ์ถูกระงับแล้ว หากผู้ใช้ดําเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้จะบ่งบอกว่ามีการระงับบัญชีอื่น forbidden
authenticatedUserNotChannel
ข้อผิดพลาดนี้ไม่ได้เจาะจงวิธีการ API ที่เฉพาะเจาะจง ซึ่งระบุว่าเซิร์ฟเวอร์ API ระบุช่องที่เชื่อมโยงกับคําขอ API ไม่ได้ หากคําขอได้รับอนุญาตและใช้พารามิเตอร์ onBehalfOfContentOwner
คุณควรตั้งค่าพารามิเตอร์onBehalfOfContentOwnerChannel
ด้วยforbidden
cmsUserAccountNotFound
ข้อผิดพลาดนี้ไม่ได้เจาะจงวิธีการ API ที่เฉพาะเจาะจง ผู้ใช้ CMS ไม่ได้รับอนุญาตให้ดําเนินการในนามของเจ้าของเนื้อหาที่ระบุ notFound
contentOwnerAccountNotFound
ข้อผิดพลาดนี้ไม่ได้เจาะจงวิธีการ API ที่เฉพาะเจาะจง ไม่พบบัญชีเจ้าของเนื้อหาที่ระบุ badRequest
invalidPart
ข้อผิดพลาดนี้ไม่ได้เจาะจงวิธีการ API ที่เฉพาะเจาะจง พารามิเตอร์ part
ของคําขอระบุส่วนที่ไม่สามารถเขียนพร้อมกันได้badRequest
videoChartNotFound
เมธอด videos.list
จะแสดงผลข้อผิดพลาดนี้เมื่อคําขอระบุแผนภูมิวิดีโอที่ไม่รองรับหรือไม่พร้อมใช้งานnotFound
videoNotFound
เมธอด videos.update
แสดงผลข้อผิดพลาดนี้เพื่อระบุว่าไม่พบวิดีโอที่คุณพยายามอัปเดต ตรวจสอบค่าของพร็อพเพอร์ตี้id
ในส่วนเนื้อหาของคําขอเพื่อให้แน่ใจว่าข้อมูลถูกต้อง
10 มิถุนายน 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พารามิเตอร์
forUsername
ใหม่ของวิธีการchannels.list
ช่วยให้คุณเรียกข้อมูลเกี่ยวกับช่องได้โดยการระบุชื่อผู้ใช้ YouTube ของช่อง -
ตอนนี้เมธอด
activities.list
รองรับพารามิเตอร์regionCode
แล้ว ซึ่งจะสั่งให้ API แสดงผลการค้นหาที่เกี่ยวข้องกับประเทศที่ระบุ YouTube จะใช้ค่านี้เมื่อกิจกรรมก่อนหน้าของผู้ใช้ที่ได้รับอนุญาตบน YouTube มีข้อมูลไม่เพียงพอที่จะสร้างฟีดกิจกรรม -
ตอนนี้ทรัพยากรเพลย์ลิสต์มีพร็อพเพอร์ตี้
snippet.tags
แล้ว ที่พักจะถูกส่งคืนให้กับผู้ใช้ที่ได้รับอนุญาตซึ่งเรียกดูข้อมูลเกี่ยวกับเพลย์ลิสต์ของตัวเองเท่านั้น ผู้ใช้ที่ได้รับอนุญาตยังตั้งค่าแท็กเพลย์ลิสต์ได้เมื่อเรียกใช้เมธอดplaylists.insert
หรือplaylists.update
-
ระบบรองรับพารามิเตอร์
onBehalfOfContentOwner
ซึ่งก่อนหน้านี้รองรับเมธอดchannels.list
และsearch.list
แล้วสําหรับเมธอดvideos.insert
,videos.update
และvideos.delete
โปรดทราบว่าเมื่อมีการใช้พารามิเตอร์นี้ในการเรียกเมธอดvideos.insert
คําขอต้องระบุค่าสําหรับพารามิเตอร์onBehalfOfContentOwnerChannel
ใหม่ด้วย ซึ่งจะระบุช่องที่จะเพิ่มวิดีโอ ช่องต้องลิงก์กับเจ้าของเนื้อหาที่พารามิเตอร์onBehalfOfContentOwner
ระบุพารามิเตอร์จะระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคําขอระบุผู้ใช้ YouTube CMS ที่ทําหน้าที่ในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์ด้วยจะต้องลิงก์กับเจ้าของเนื้อหาของ YouTube ที่ระบุ
พารามิเตอร์นี้มีไว้สําหรับพาร์ทเนอร์เนื้อหาที่เป็นเจ้าของและจัดการช่อง YouTube ต่างๆ จํานวนมาก พารามิเตอร์นี้จะช่วยให้พาร์ทเนอร์ตรวจสอบสิทธิ์ได้เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดของช่องได้ โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบสําหรับแต่ละช่อง
กล่าวคือ ในรุ่นนี้ พารามิเตอร์จะช่วยให้พาร์ทเนอร์เนื้อหาแทรก อัปเดต หรือลบวิดีโอในช่อง YouTube ที่พาร์ทเนอร์เป็นเจ้าของได้
-
error documentation
อธิบายข้อผิดพลาดใหม่ต่อไปนี้ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย forbidden
insufficientCapabilities
ข้อผิดพลาดนี้ไม่ได้เจาะจงวิธีการ API ที่เฉพาะเจาะจง ซึ่งระบุว่าผู้ใช้ CMS ที่เรียกใช้ API มีสิทธิ์ไม่เพียงพอที่จะดําเนินการที่ขอ ข้อผิดพลาดนี้เกี่ยวข้องกับการใช้พารามิเตอร์ onBehalfOfContentOwner
ซึ่งรองรับเมธอด API ต่างๆunauthorized
authorizationRequired
เมธอด activities.list
จะแสดงผลข้อผิดพลาดนี้เมื่อคําขอใช้พารามิเตอร์home
แต่ไม่ได้รับอนุญาตอย่างถูกต้อง -
นําทรัพยากร
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
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
YouTube ไม่ได้ระบุฟีเจอร์และบริการ API ทดลองอีกต่อไป ตอนนี้เราจึงมีรายชื่อ YouTube API ที่ขึ้นอยู่กับนโยบายการเลิกใช้งานแทน
8 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ปัจจุบันทรัพยากรของช่องรองรับออบเจ็กต์
inVideoPromotion
ซึ่งสรุปข้อมูลเกี่ยวกับแคมเปญโปรโมชันที่เชื่อมโยงกับช่อง ช่องสามารถใช้แคมเปญการโปรโมตในวิดีโอเพื่อแสดงภาพขนาดย่อสําหรับวิดีโอที่โปรโมตภายในโปรแกรมเล่นวิดีโอระหว่างการเล่นวิดีโอของช่องคุณเรียกข้อมูลนี้ได้โดยการรวม
invideoPromotion
ในค่าพารามิเตอร์part
ในคําขอchannels.list
-
สามารถใช้เมธอด
channels.update
ใหม่เพื่ออัปเดตข้อมูลแคมเปญการโปรโมตในวิดีโอของช่อง โปรดทราบว่าวิธีนี้รองรับเฉพาะการอัปเดตส่วนinvideoPromotion
ของทรัพยากรchannel
และยังไม่รองรับการอัปเดตส่วนอื่นๆ ของทรัพยากรดังกล่าว
2 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ทรัพยากรของช่องรองรับพร็อพเพอร์ตี้
status.isLinked
แล้ว ซึ่งระบุว่าข้อมูลช่องระบุผู้ใช้ที่ลิงก์ไปยังชื่อผู้ใช้ YouTube หรือบัญชี Google+ อยู่แล้วหรือไม่ ผู้ใช้ที่มีลิงก์ใดลิงก์หนึ่งเหล่านี้มีข้อมูลประจําตัวสาธารณะของ YouTube อยู่แล้ว ซึ่งเป็นข้อกําหนดเบื้องต้นสําหรับการดําเนินการต่างๆ เช่น การอัปโหลดวิดีโอ -
ตอนนี้ทรัพยากรการสมัครใช้บริการรองรับส่วน
subscriberSnippet
แล้ว ออบเจ็กต์ดังกล่าวจะรวมข้อมูลของตัวอย่างข้อมูลลงในช่องของสมาชิก -
ตอนนี้ API รองรับเมธอด
videos.getRating
แล้ว ซึ่งระบบจะดึงคะแนนที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ออกจากรายการวิดีโออย่างน้อย 1 รายการ -
พารามิเตอร์
myRating
ใหม่ของวิธีการvideos.list
ช่วยให้คุณเรียกดูรายการวิดีโอที่ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วได้รับคะแนนlike
หรือdislike
ทั้งพารามิเตอร์
myRating
และพารามิเตอร์id
ถือว่าเป็นพารามิเตอร์ตัวกรอง ซึ่งหมายความว่าคําขอ API ต้องระบุพารามิเตอร์รายการใดรายการหนึ่ง (ก่อนหน้านี้ พารามิเตอร์id
เป็นพารามิเตอร์ที่จําเป็นสําหรับวิธีการนี้)เมธอดนี้จะแสดงข้อผิดพลาด
forbidden
สําหรับคําขอที่พยายามเรียกข้อมูลการจัดประเภทวิดีโอ แต่ไม่ได้รับอนุญาตอย่างถูกต้อง -
เมื่อมีการแนะนําพารามิเตอร์
myRating
เรายังได้อัปเดตเมธอดvideos.list
เพื่อรองรับการใส่เลขหน้า อย่างไรก็ตาม โปรดทราบว่าพารามิเตอร์การแบ่งหน้าจะรองรับเฉพาะคําขอที่ใช้พารามิเตอร์myRating
เท่านั้น (คําขอที่ใช้พารามิเตอร์และข้อมูลไม่รองรับการส่งคําขอที่ใช้พารามิเตอร์id
)-
พารามิเตอร์
maxResults
จะระบุจํานวนวิดีโอที่ API สามารถแสดงในชุดผลลัพธ์ได้สูงสุด และพารามิเตอร์pageToken
จะระบุหน้าเว็บที่เฉพาะเจาะจงในชุดผลลัพธ์ที่คุณต้องการเรียก -
ทรัพยากร
youtube#videoListResponse
ที่แสดงผลตามคําขอvideos.list
ตอนนี้มีออบเจ็กต์pageInfo
ที่มีรายละเอียด เช่น จํานวนผลลัพธ์ทั้งหมดและจํานวนผลลัพธ์ที่รวมอยู่ในชุดผลลัพธ์ปัจจุบัน ทรัพยากรyoutube#videoListResponse
ยังสามารถมีพร็อพเพอร์ตี้nextPageToken
และprevPageToken
ซึ่งแต่ละรายการมีโทเค็นที่สามารถใช้เพื่อดึงหน้าเว็บที่ต้องการในชุดผลลัพธ์ได้
-
-
เมธอด
videos.insert
รองรับพารามิเตอร์ใหม่ต่อไปนี้autoLevels
– ตั้งค่าพารามิเตอร์นี้เป็นtrue
เพื่อสั่งให้ YouTube เพิ่มประสิทธิภาพแสงและสีของวิดีโอโดยอัตโนมัติstabilize
– ตั้งค่าพารามิเตอร์นี้เป็นtrue
เพื่อสั่งให้ YouTube ปรับวิดีโอโดยการนําการสั่นออกที่เกิดจากการเคลื่อนไหวของกล้อง
-
เพิ่มพร็อพเพอร์ตี้
channelTitle
ในsnippet
สําหรับทรัพยากรต่อไปนี้แล้วplaylistItem
– พร็อพเพอร์ตี้ระบุชื่อของช่องที่เพิ่มรายการเพลย์ลิสต์playlist
– พร็อพเพอร์ตี้นั้นระบุชื่อช่องที่สร้างเพลย์ลิสต์subscription
– พร็อพเพอร์ตี้ระบุชื่อช่องที่ติดตาม
-
เพิ่มตัวอย่างโค้ดสําหรับวิธีการต่อไปนี้แล้ว
activities.insert
(ทับทิม)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, Ruby)
-
พารามิเตอร์
mySubscribers
ใหม่ของวิธีการsubscriptions.list
จะช่วยให้คุณสามารถเรียกรายชื่อสมาชิกปัจจุบันของผู้ใช้ที่ได้รับการตรวจสอบแล้วได้ พารามิเตอร์นี้ใช้ในคําขอที่ได้รับสิทธิ์อย่างเหมาะสมเท่านั้นหมายเหตุ: ฟังก์ชันนี้มีไว้เพื่อแทนที่พารามิเตอร์
mySubscribers
ที่รองรับสําหรับเมธอดchannels.list
ในขณะนี้ โดยจะเลิกใช้งานพารามิเตอร์ดังกล่าว -
ในทรัพยากร
video
ค่าพร็อพเพอร์ตี้unspecified
ไม่ใช่ค่าที่เป็นไปได้สําหรับพร็อพเพอร์ตี้ต่อไปนี้อีกต่อไป -
ตอนนี้คําขอ API ที่มีพารามิเตอร์ที่ไม่คาดคิดจะแสดงผลข้อผิดพลาด
badRequest
และเหตุผลที่แสดงข้อผิดพลาดดังกล่าวคือunexpectedParameter
-
ข้อผิดพลาดที่เมธอด
playlistItems.insert
แสดงผลเมื่อเพลย์ลิสต์มีรายการที่อนุญาตถึงจํานวนสูงสุดแล้ว ตอนนี้ระบบจะรายงานข้อผิดพลาดเป็นข้อผิดพลาดforbidden
และเหตุผลของข้อผิดพลาดคือplaylistContainsMaximumNumberOfVideos
19 เมษายน 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
วิธี
videos.rate
ใหม่ช่วยให้ผู้ใช้ตั้งค่าการจัดประเภทlike
หรือdislike
ในวิดีโอหรือนําคะแนนออกจากวิดีโอได้นอกจากนี้ เรายังอัปเดตเอกสารประกอบเกี่ยวกับข้อผิดพลาดเพื่อแสดงข้อผิดพลาดที่ API อาจส่งคืนกลับมาในการเรียกเมธอด
videos.rate
-
ตอนนี้ภาพขนาดย่อได้รับการระบุไว้ในเอกสารประกอบของ API ว่าเป็นทรัพยากรแยกต่างหาก และวิธีการ
thumbnails.set
ใหม่นี้จะช่วยให้คุณอัปโหลดภาพปกวิดีโอที่กําหนดเองไปยัง YouTube และตั้งค่าสําหรับวิดีโอได้นอกจากนี้ เรายังอัปเดตเอกสารประกอบเกี่ยวกับข้อผิดพลาดเพื่อแสดงข้อผิดพลาดที่ API อาจส่งคืนกลับมาในการเรียกเมธอด
thumbnails.set
โปรดทราบว่าการเปลี่ยนแปลงนี้จะไม่ส่งผลต่อทรัพยากรที่มีอยู่ซึ่งแสดงภาพขนาดย่อจริง ระบบจะส่งภาพขนาดย่อในทรัพยากรเหล่านั้นด้วยวิธีเดียวกับก่อนหน้านี้ แม้ว่าตอนนี้เอกสารจะแสดงชื่อขนาดภาพขนาดย่อต่างๆ ที่ API อาจแสดงผล
-
ส่วน
brandingSettings
ใหม่ของทรัพยากรchannel
จะระบุการตั้งค่า ข้อความ และรูปภาพสําหรับหน้าช่องและหน้าสําหรับดูของช่อง -
ทรัพยากร
playlistItem
มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้-
ออบเจ็กต์
status
ใหม่จะสรุปข้อมูลสถานะเกี่ยวกับรายการเพลย์ลิสต์ และพร็อพเพอร์ตี้status.privacyStatus
จะระบุสถานะความเป็นส่วนตัวของรายการเพลย์ลิสต์
-
-
ทรัพยากร
video
มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้-
พร็อพเพอร์ตี้
status.publicStatsViewable
ระบุว่าสถิติวิดีโอเพิ่มเติมในหน้าสําหรับดูเป็นแบบสาธารณะหรือไม่ โดยค่าเริ่มต้น สถิติดังกล่าวจะมองเห็นได้ และสถิติ เช่น จํานวนการดูและการให้คะแนนของวิดีโอจะยังคงปรากฏแบบสาธารณะได้ แม้ว่าจะตั้งค่าค่าของพร็อพเพอร์ตี้นี้เป็นfalse
ก็ตาม คุณจะตั้งค่าพร็อพเพอร์ตี้นี้ได้เมื่อเรียกใช้เมธอดvideos.insert
หรือvideos.update
-
ออบเจ็กต์
contentDetails.contentRating
จะสรุปคะแนนที่วิดีโอได้รับภายใต้แผนการจัดประเภทต่างๆ รายการด้านล่างระบุระบบการจัดประเภทที่รองรับและมีลิงก์ไปยังพร็อพเพอร์ตี้ที่เชื่อมโยงกับระบบการจัดประเภทแต่ละระบบ คําจํากัดความของพร็อพเพอร์ตี้จะระบุค่าคะแนนที่รองรับสําหรับแต่ละระบบประเทศ ระบบการจัดประเภท พร็อพเพอร์ตี้ สหรัฐอเมริกา สมาคมภาพยนตร์แห่งสหรัฐอเมริกา (MPAA) contentDetails.contentRating.mpaaRating
สหรัฐอเมริกา TV Parental Guidelines contentDetails.contentRating.tvpgRating
ออสเตรเลีย 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
สําหรับทรัพยากรต่อไปนี้แล้ว -
เมธอด
search.list
รองรับพารามิเตอร์ใหม่ต่อไปนี้-
พารามิเตอร์
channelType
ช่วยให้คุณจํากัดการค้นหาช่องเพื่อเรียกช่องทั้งหมดหรือเรียกข้อมูลรายการเท่านั้น -
พารามิเตอร์
videoType
ช่วยให้คุณจํากัดการค้นหาวิดีโอเพื่อดึงวิดีโอทั้งหมดหรือเรียกข้อมูลเฉพาะภาพยนตร์หรือเฉพาะตอนของรายการได้
-
-
อัปเดตคําจํากัดความของส่วน
recordingDetails
ของทรัพยากรvideo
แล้วเพื่อแจ้งให้ทราบว่าออบเจ็กต์จะแสดงผลสําหรับวิดีโอก็ต่อเมื่อมีการตั้งค่าข้อมูลตําแหน่งทางภูมิศาสตร์หรือเวลาบันทึกของวิดีโอเท่านั้น -
ตอนนี้เมธอด
playlistItems.update
จะแสดงผลข้อผิดพลาดinvalidSnippet
ซึ่งจะแสดงผลหากคําขอ API ไม่ได้ระบุข้อมูลโค้ดที่ถูกต้อง -
เมธอด API ต่างๆ รองรับพารามิเตอร์ใหม่ที่มีไว้สําหรับพาร์ทเนอร์เนื้อหา YouTube โดยเฉพาะ พาร์ทเนอร์ด้านเนื้อหาของ YouTube ได้แก่ สตูดิโอภาพยนตร์และรายการทีวี ค่ายเพลง และครีเอเตอร์เนื้อหารายอื่นๆ ที่เผยแพร่เนื้อหาของตนบน YouTube
-
พารามิเตอร์
onBehalfOfContentOwner
ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคําขอระบุผู้ใช้ YouTube CMS ที่ทําหน้าที่ในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์ด้วยจะต้องลิงก์กับเจ้าของเนื้อหาของ YouTube ที่ระบุพารามิเตอร์นี้มีไว้สําหรับพาร์ทเนอร์เนื้อหาที่เป็นเจ้าของและจัดการช่อง YouTube ต่างๆ จํานวนมาก พารามิเตอร์นี้จะช่วยให้พาร์ทเนอร์ตรวจสอบสิทธิ์ได้เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดของช่องได้ โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบสําหรับแต่ละช่อง
เมธอด
channels.list
,search.list
,videos.delete
,videos.list
และvideos.update
รองรับพารามิเตอร์นี้ทั้งหมด -
พารามิเตอร์
managedByMe
ที่รองรับโดยเมธอดchannels.list
จะสั่งให้ API แสดงผลช่องทั้งหมดที่เป็นของเจ้าของเนื้อหาซึ่งพารามิเตอร์onBehalfOfContentOwner
ระบุ -
พารามิเตอร์
forContentOwner
ที่รองรับโดยเมธอดsearch.list
จะสั่งให้ API จํากัดผลการค้นหาให้แสดงเฉพาะทรัพยากรที่เป็นของเจ้าของเนื้อหาซึ่งพารามิเตอร์onBehalfOfContentOwner
ระบุไว้
-
25 กุมภาพันธ์ 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API รองรับพร็อพเพอร์ตี้และพร็อพเพอร์ตี้ใหม่หลายรายการสําหรับทรัพยากร
video
รายการ-
ส่วน
fileDetails
,processingDetails
และsuggestions
ใหม่จะให้ข้อมูลแก่เจ้าของวิดีโอเกี่ยวกับวิดีโอที่อัปโหลด ข้อมูลนี้มีประโยชน์มากในแอปพลิเคชันที่เปิดใช้การอัปโหลดวิดีโอ ซึ่งรวมถึงข้อมูลต่อไปนี้- สถานะการประมวลผลและความคืบหน้า
- ข้อผิดพลาดหรือปัญหาอื่นๆ ที่พบขณะประมวลผลวิดีโอ
- ความพร้อมใช้งานของภาพขนาดย่อ
- คําแนะนําสําหรับการปรับปรุงคุณภาพวิดีโอหรือข้อมูลเมตา
- รายละเอียดเกี่ยวกับไฟล์ต้นฉบับที่อัปโหลดไปยัง YouTube
มีเพียงเจ้าของวิดีโอเท่านั้นที่สามารถเรียกข้อมูลส่วนต่างๆ เหล่านี้ได้ รายการด้านล่างอธิบายเกี่ยวกับชิ้นส่วนใหม่คร่าวๆ และเอกสารประกอบของทรัพยากร
video
จะกําหนดพร็อพเพอร์ตี้ทั้งหมดที่แต่ละส่วนมี-
ออบเจ็กต์
fileDetails
มีข้อมูลเกี่ยวกับไฟล์วิดีโอที่อัปโหลดไปยัง YouTube รวมถึงความละเอียด ระยะเวลา ตัวแปลงสัญญาณเสียงและวิดีโอ อัตราบิตของสตรีม และอื่นๆ ของไฟล์ -
ออบเจ็กต์
processingProgress
มีข้อมูลเกี่ยวกับความคืบหน้าของ YouTube ในการประมวลผลไฟล์วิดีโอที่อัปโหลด พร็อพเพอร์ตี้ของออบเจ็กต์จะระบุสถานะการประมวลผลปัจจุบัน และประเมินเวลาที่เหลือจนกว่า YouTube จะประมวลผลวิดีโอเสร็จสิ้น นอกจากนี้ ส่วนนี้ยังใช้ระบุว่าข้อมูลหรือเนื้อหาประเภทต่างๆ เช่น รายละเอียดไฟล์หรือภาพขนาดย่อ พร้อมใช้งานสําหรับวิดีโอหรือไม่ออบเจ็กต์นี้ออกแบบมาเพื่อให้มีแบบสํารวจเพื่อให้ผู้อัปโหลดติดตามความคืบหน้าที่ YouTube ดําเนินการในการประมวลผลไฟล์วิดีโอที่อัปโหลดได้
-
ออบเจ็กต์
suggestions
มีคําแนะนําที่ระบุโอกาสในการปรับปรุงคุณภาพหรือข้อมูลเมตาสําหรับวิดีโอที่อัปโหลด
-
ส่วน
contentDetails
มีพร็อพเพอร์ตี้ใหม่ 4 รายการ ระบบจะดึงข้อมูลพร็อพเพอร์ตี้เหล่านี้จากคําขอที่ไม่ผ่านการตรวจสอบสิทธิ์ได้dimension
– ระบุว่าวิดีโอพร้อมให้บริการในแบบ 2 มิติหรือ 3 มิติdefinition
– ระบุว่าวิดีโอมีให้บริการในแบบความละเอียดมาตรฐานหรือความละเอียดสูงcaption
– บ่งบอกว่ามีคําบรรยายสําหรับวิดีโอหรือไม่licensedContent
– ระบุว่าวิดีโอมีเนื้อหาที่มีการอ้างสิทธิ์โดยพาร์ทเนอร์เนื้อหาของ YouTube หรือไม่
-
ส่วน
status
มีพร็อพเพอร์ตี้ใหม่ 2 รายการ เจ้าของวิดีโอกําหนดค่าสําหรับพร็อพเพอร์ตี้ทั้ง 2 รายการได้เมื่อแทรกหรืออัปเดตวิดีโอ นอกจากนี้ คุณยังดึงข้อมูลที่พักเหล่านี้ได้ด้วยคําขอที่ไม่ได้ตรวจสอบสิทธิ์embeddable
– ระบุว่าวิดีโอสามารถฝังบนเว็บไซต์อื่นได้หรือไม่license
– ระบุใบอนุญาตของวิดีโอ ค่าที่ถูกต้องคือcreativeCommon
และyoutube
-
-
อัปเดตพารามิเตอร์ของ
part
สําหรับเมธอดvideos.list
,videos.insert
และvideos.update
เพื่อแสดงส่วนที่เพิ่มเข้ามาใหม่ตามที่อธิบายไว้ข้างต้น รวมถึงส่วนrecordingDetails
ซึ่งระบบละเลยโดยไม่ได้ตั้งใจ -
พร็อพเพอร์ตี้
contentDetails.googlePlusUserId
ใหม่ของทรัพยากรchannel
ระบุรหัสโปรไฟล์ Google+ ที่เชื่อมโยงกับช่อง คุณสามารถใช้ค่านี้เพื่อสร้างลิงก์ไปยังโปรไฟล์ Google+ ได้ -
ตอนนี้ออบเจ็กต์ภาพขนาดย่อแต่ละรูปจะระบุความกว้างและความสูงของรูปภาพ ขณะนี้ภาพขนาดย่อแสดงผลในทรัพยากร
activity
,channel
,playlist
,playlistItem
,search result
,subscription
และvideo
-
ตอนนี้
playlistItems.list
รองรับพารามิเตอร์videoId
แล้ว ซึ่งสามารถใช้ร่วมกับพารามิเตอร์playlistId
เพื่อดึงเฉพาะรายการเพลย์ลิสต์ที่แสดงวิดีโอที่ระบุเท่านั้นAPI จะแสดงข้อผิดพลาด
notFound
หากไม่พบวิดีโอที่พารามิเตอร์ระบุในเพลย์ลิสต์ -
เอกสารประกอบเกี่ยวกับข้อผิดพลาดอธิบายข้อผิดพลาด
forbidden
ใหม่ ซึ่งระบุว่าคําขอไม่ได้รับอนุญาตอย่างถูกต้องสําหรับการดําเนินการที่ขอ -
นําพร็อพเพอร์ตี้
snippet.channelId
ของทรัพยากรchannel
ออกแล้ว พร็อพเพอร์ตี้id
ของทรัพยากรมีค่าเดียวกัน
30 มกราคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
หน้าข้อผิดพลาดใหม่แสดงข้อผิดพลาดที่ API แสดงผลได้ หน้านี้มีข้อผิดพลาดทั่วไป ซึ่งอาจเกิดขึ้นสําหรับเมธอด API ต่างๆ ตลอดจนข้อผิดพลาดเฉพาะเมธอด
16 มกราคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตัวอย่างโค้ดใช้ได้กับเมธอดและภาษาที่แสดงในรายการด้านล่าง
activities.insert
– JavaplaylistItems.insert
– PythonplaylistItems.list
– Java, JavaScript, PHP, Python, Rubyplaylists.insert
– Java, JavaScript, Pythonsearch.list
– Java, JavaScript, Python, ทับทิมvideos.insert
– Java
-
ขณะนี้ทรัพยากร
activity
สามารถรายงานการดําเนินการchannelItem
ซึ่งเกิดขึ้นเมื่อ YouTube เพิ่มวิดีโอไปยังช่อง YouTube ที่สร้างขึ้นโดยอัตโนมัติ (YouTube จะใช้อัลกอริทึมเพื่อระบุหัวข้อที่มีตัวตนจํานวนมากบนเว็บไซต์ YouTube และสร้างช่องสําหรับหัวข้อเหล่านั้นโดยอัตโนมัติ) -
พารามิเตอร์
search.list
ต่อไปนี้ได้รับการอัปเดตแล้ว- พารามิเตอร์
q
ไม่ได้ระบุเป็นตัวกรองอีกต่อไป ซึ่งหมายความว่า .... - เปลี่ยนชื่อพารามิเตอร์
relatedToVideo
เป็นrelatedToVideoId
แล้ว - พารามิเตอร์
published
ถูกแทนที่ด้วยพารามิเตอร์ใหม่ 2 รายการ ได้แก่publishedAfter
และpublishedBefore
ตามที่อธิบายด้านล่าง
- พารามิเตอร์
-
เมธอด
search.list
รองรับพารามิเตอร์ใหม่ต่อไปนี้ชื่อพารามิเตอร์ ค่า คำอธิบาย channelId
string
แสดงผลทรัพยากรที่สร้างโดยช่องที่ระบุ publishedAfter
datetime
แสดงทรัพยากรที่สร้างขึ้นหลังจากเวลาที่ระบุ publishedBefore
datetime
แสดงทรัพยากรที่สร้างขึ้นก่อนเวลาที่ระบุ regionCode
string
แสดงทรัพยากรสําหรับประเทศที่ระบุ videoCategoryId
string
กรองผลการค้นหาวิดีโอให้รวมเฉพาะวิดีโอที่เชื่อมโยงกับหมวดหมู่วิดีโอที่ระบุไว้เท่านั้น videoEmbeddable
string
กรองผลการค้นหาวิดีโอให้รวมเฉพาะวิดีโอที่เล่นในโปรแกรมเล่นแบบฝังในหน้าเว็บได้ ตั้งค่าพารามิเตอร์เป็น true
เพื่อดึงเฉพาะวิดีโอที่ฝังได้videoSyndicated
string
กรองผลการค้นหาวิดีโอให้รวมเฉพาะวิดีโอที่เล่นนอก YouTube.com ได้ ตั้งค่าพารามิเตอร์เป็น true
เพื่อรับเฉพาะวิดีโอที่เผยแพร่เท่านั้น -
ทรัพยากร API หลายรายการรองรับพร็อพเพอร์ตี้ใหม่ ตารางด้านล่างระบุทรัพยากรและพร็อพเพอร์ตี้ใหม่
ทรัพยากร ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย activity
contentDetails.playlistItem.playlistItemId
string
รหัสรายการเพลย์ลิสต์ที่ YouTube กําหนดเพื่อระบุรายการในเพลย์ลิสต์ที่ไม่ซ้ํา activity
contentDetails.channelItem
object
ออบเจ็กต์ที่ประกอบด้วยข้อมูลเกี่ยวกับทรัพยากรที่เพิ่มลงในช่อง พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ snippet.type
เป็นchannelItem
activity
contentDetails.channelItem.resourceId
object
ออบเจ็กต์ที่ระบุทรัพยากรที่เพิ่มลงในช่อง ซึ่งมีพร็อพเพอร์ตี้ 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 เพื่อเรียกข้อมูลรายการค่าที่ถูกต้อง