Notes

Miscellaneous design notes, reference links, test data, and ideas for future work.

API Quota

The YouTube Data API v3 has a 10,000 API calls/day quota limit. If you hit it, wait a day to continue working.

References:

• https://developers.google.com/youtube/v3/getting-started

Design Notes

• Marking all elements of a list as "seen" appears to be impossible via the YouTube API.
• Deleted video: A video with the title "Deleted video", or one whose details request returns an empty items array.
• Private video: A video with the title "Private video".

Reference Links

YouTube API documentation:

Resource	URL
Home	https://developers.google.com/youtube/v3
Python quickstart	https://developers.google.com/youtube/v3/quickstart/python
Reference docs	https://developers.google.com/youtube/v3/docs
Getting started	https://developers.google.com/youtube/v3/getting-started

Other useful references:

• Gist: remove videos from Watch Later

Test Video IDs

For manual testing:

Type	Video ID
Regular video	xL_sMXfzzyA
Deleted video	6k2nFwVqQFw
Private video	MZnlL8uCCU0

TODO / Future Ideas

• Implement a single playlist dump that includes video metadata (not just IDs).
• Investigate "saw1" playlist showing unavailable videos in the YouTube UI even after cleanup.
• Since the Watch Later playlist can't be accessed via the API, explore browser-based scraping approaches.
  • Reference: https://github.com/longpdo/youtube-dl-watch-later-playlist
• Implement argument-free dump.
• Find how to list "builtin" playlists (e.g. "Watch Later") and clean them up.
• Download a channel's full video list so you can subtract already-watched videos and get a "left to see" list.

Features to implement:

• Download Watch Later
• Clear Watch Later
• Add list to list
• Add file to list
• Clear list