Skip to content

YouTube settings

YouTube publishes video, so its settings carry the metadata that goes with the upload.

Field Required Description
title Yes The video title. Between 2 and 100 characters.
type Yes Visibility: public, private or unlisted.
selfDeclaredMadeForKids No yes or no. YouTube’s made-for-kids declaration.
thumbnail No A media object with id and path, used as the custom thumbnail.
tags No An array of { "value": "...", "label": "..." } objects.

YouTube caps all tags combined at 500 characters, and Sharek enforces it before upload. Two things count toward that total:

  • every tag’s label length, and
  • two extra characters for any tag containing a space, because YouTube wraps those in quotes.

Exceed it and the post is refused with The maximum allowed is 500 characters in total for all tags.

"settings": {
"title": "How we built the Sharek calendar",
"type": "public",
"selfDeclaredMadeForKids": "no",
"thumbnail": {
"id": "media-id",
"path": "https://media.example.com/thumb.png"
},
"tags": [
{ "value": "product", "label": "product" },
{ "value": "behind the scenes", "label": "behind the scenes" }
]
}

That second tag contains a space, so it counts as 20 characters, not 18.

  • The video itself goes in the post’s value[].image array, uploaded first through upload a file. Only MP4 is accepted, up to 1 GB.
  • YouTube asks a follow-up question when you connect the channel, because one Google account can own several YouTube channels. A channel that has not finished that step cannot publish.