YouTube: posztolási szabályok és beállítások
Mit fogad el a YouTube csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Basics
youtubePost types
The same channel accepts more than one kind of post, and each kind has different requirements. The table shows what you need for each.
| Type | Media | Notes |
|---|---|---|
| Video | 1 video, required | Title and visibility are required. They have no defaults. |
Rules
- The title is required, and must be between 2 and 100 characters.
- You must set the visibility. There is no default.
- The combined length of the tags can be at most 500 characters. YouTube puts tags that contain a space in quotes, so it counts two extra characters for each of those tags.
Settings fields
These fields go into the post's settings object, alongside the __type field. In the UI, you fill in the same ones in the channel's settings section.
| Field | Type | Required | What it does |
|---|---|---|---|
| title | string, between 2 and 100 characters | yes | The video title. |
| type | "public" | "unlisted" | "private" | yes | Public, unlisted, or private. |
| selfDeclaredMadeForKids | "yes" | "no" | no | Declares whether the content is made for kids. |
| thumbnail | media object | no | A custom thumbnail from the media library. |
| tags | array, each item { value, label } | no | Video tags, 500 characters in total. |
Allowed values
The fields below only accept these values. Any other value returns a 400, and the response names the field.
type
| Value | Meaning |
|---|---|
| public | Public. |
| unlisted | Unlisted: only available via a link. |
| private | Private. |
selfDeclaredMadeForKids
| Value | Meaning |
|---|---|
| yes | Made for kids. |
| no | Not made for kids. |
Examples
Each example is one item in the POST /public/v1/posts request's posts array. The envelope around it is always this:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Video, public
{
"integration": { "id": "<youtube-csatorna>" },
"value": [{
"content": "<p>A videó leírása.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/video.mp4" }]
}],
"settings": {
"__type": "youtube",
"title": "A videó címe",
"type": "public",
"selfDeclaredMadeForKids": "no"
}
}Video with tags and a thumbnail
The combined length of the tags is at most 500 characters. YouTube puts quotes around a tag that contains a space, which counts as two extra characters.
{
"integration": { "id": "<youtube-csatorna>" },
"value": [{
"content": "<p>A videó leírása.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/video.mp4" }]
}],
"settings": {
"__type": "youtube",
"title": "Így ütemezz egy hónapot előre",
"type": "unlisted",
"tags": [
{ "value": "utemezes", "label": "ütemezés" },
{ "value": "kozossegi-media", "label": "közösségi média" }
],
"thumbnail": { "id": "<media-borito>", "path": "https://uploads.posty.hu/borito.jpg" }
}
}The channel ID comes from the channel list, and the path values for images and videos from media upload. The exact schema for the connected account comes from the settings schema endpoint. From the command line, the same thing is the --settings flag. See the CLI examples.