docs: complete the quota cost overview (playlists, search)#32
Merged
Conversation
- api-quota cheatsheet: add playlists.list/items, search.list (100u), and the playlist/playlistItems write operations; reorder by cost - mention playlist edits and the 100-unit search.list exception in the intro - readme: add a scannable read/write/search/upload cost table linking to the full breakdown
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Inspired by a competing tool's clear quota overview, I checked ours and tightened the gaps. A solid overview already existed in
docs/api-quota.md(default 10,000 units + a per-operation cheatsheet), but it predated the playlists feature and the README only had prose.Changes
docs/api-quota.md: the cheatsheet was missing the playlist and search operations. Addedplaylists.list/playlistItems.list(1 unit),search.list(100 units), and theplaylists.*/playlistItems.*writes (50 units), and ordered the table by cost. The intro now mentions playlist edits and calls outsearch.list(behindplaylists add --from-search) as the 100-unit exception.README.md: added a compact read/write/search/upload cost table to the API quota section (it was prose only), with a link to the full per-operation breakdown.mkdocs buildpasses with no warnings of our own.