Skip to content

Commit 8fd7b17

Browse files
committed
simplify youtube api notes
1 parent d92ed33 commit 8fd7b17

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

docs/metadata/object-paths.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,20 @@ Use the API recipes below to fill in the "image_small" and "image_thumb" fields
5252
The "image_small" and "image_thumb" fields can be filled in using YouTube's image API.
5353
This API is not well documented by Google, but is used by many sites and JS libraries.
5454

55+
For most CB collections the recipes will look like:
56+
57+
- "object_location" = the full YouTube video link, https://youtu.be/`[youtubeid]`
58+
- e.g. https://youtu.be/CVXQ3X6Q8oU
59+
- "image_small" = max quality youtube image api, https://img.youtube.com/vi/`[youtubeid]`/maxresdefault.jpg
60+
- e.g. https://img.youtube.com/vi/CVXQ3X6Q8oU/maxresdefault.jpg
61+
- "image_thumb" = high quality youtube image api, https://img.youtube.com/vi/`[youtubeid]`/hqdefault.jpg
62+
- e.g. https://img.youtube.com/vi/CVXQ3X6Q8oU/hqdefault.jpg
63+
64+
### YouTube Image API
65+
66+
Below is more information about the YouTube image API incase the recipe suggestions above do not work for your collection.
67+
Keep in mind you can also manually create your own derivative images for the videos (using screenshots or exports) if the auto generated YouTube options don't meet your needs.
68+
5569
Basically, you can get four sizes of the default thumbnail, or four smaller thumbnails from different points in the video.
5670
You can use the domain "img.youtube.com" or "i3.ytimg.com"
5771

0 commit comments

Comments
 (0)