mitodl / odl-video-service

building blocks for a basic video service for ODL
BSD 3-Clause "New" or "Revised" License
4 stars 1 forks source link

Video captions API change #988

Open mbertrand opened 2 years ago

mbertrand commented 2 years ago

Test that Youtube video caption API calls will work as expected with new caption IDs during the transition period for the changes described below.

Hi YouTube API developer, ‌ We would like to inform you of upcoming changes to YouTube that will impact the data available via the YouTube Data Captions API starting December 2022. ‌ On December 1, 2022, YouTube will update how caption_id values are generated. Caption ID parameters identify the caption track that is being retrieved. ‌ Here are details on how this will and will not affect the API: Once these changes are rolled out, queries using previously stored old caption ID strings will no longer work, but you can simply replace them with new ones Performing a new captions.list request will provide the updated caption IDs All other YouTube Data Captions API functionality, including the captions.list, captions.update, captions.download, and captions.delete endpoints, will be unaffected and should continue to work as expected Developers who do not store caption ID strings for future use should not be impacted ‌ Starting today, August 2, 2022, there will be a 120-day transition period where both the old and new caption track IDs will be supported. After December 1, 2022, the old caption IDs will no longer be valid. ‌ To prepare for this change, you should plan to fully replace all stored caption track data between now and December 1, 2022. This means that for any video for which you store caption track data, you should delete the currently stored data, then call the captions.list method to retrieve the new set of caption tracks for the video and store the data in the API response as you would normally. ‌ As a reminder, you must agree to the terms and policies to access or use any YouTube API Services. ‌ Thank you for being a YouTube API developer. ‌ Sincerely, The YouTube API Services team