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.
Alapadatok
youtubeBejegyzéstípusok
Ugyanaz a csatorna többféle alakú bejegyzést fogad el, és mindegyik mást követel meg. A táblázatból kiderül, melyikhez mi kell.
| Típus | Média | Megjegyzés |
|---|---|---|
| Videó | 1 videó, kötelező | A cím és a láthatóság kötelező, alapértékük nincs. |
Szabályok
- A cím kötelező, és 2 és 100 karakter között kell lennie.
- A láthatóságot meg kell adni, alapértéke nincs.
- A címkék együttes hossza legfeljebb 500 karakter lehet. A szóközt tartalmazó címkéket a YouTube idézőjelbe teszi, ezért címkénként két karakterrel többet számol.
Beállításmezők
Ezek a mezők a bejegyzés settings objektumába kerülnek, a __type mező mellé. A felületen ugyanezeket a csatorna lenyíló beállításszakaszában töltöd ki.
| Mező | Típus | Kötelező | Mit csinál |
|---|---|---|---|
| title | string, 2 és 100 karakter között | igen | A videó címe. |
| type | "public" | "unlisted" | "private" | igen | Nyilvános, nem listázott vagy privát. |
| selfDeclaredMadeForKids | "yes" | "no" | nem | Gyerekeknek készült tartalom bejelentése. |
| thumbnail | médiaobjektum | nem | Egyéni borítókép a médiatárból. |
| tags | tömb, elemenként { value, label } | nem | Videócímkék, együtt legfeljebb 500 karakterben. |
Választható értékek
A felsorolt mezők csak ezeket az értékeket fogadják el. Bármilyen más értékre 400-as hibát kapsz, a válasz pedig megnevezi a mezőt.
type
| Érték | Mit jelent |
|---|---|
| public | Nyilvános. |
| unlisted | Nem listázott: csak linkkel érhető el. |
| private | Privát. |
selfDeclaredMadeForKids
| Érték | Mit jelent |
|---|---|
| yes | Gyerekeknek készült. |
| no | Nem gyerekeknek készült. |
Példák
Minden példa egy elem a POST /public/v1/posts kérés posts tömbjében. A körülötte lévő boríték minden esetben ez:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Videó nyilvánosan
{
"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"
}
}Videó címkékkel és borítóképpel
A címkék együttes hossza legfeljebb 500 karakter. A szóközt tartalmazó címkét a YouTube idézőjelbe teszi, ami két karakterrel többet számít.
{
"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" }
}
}A csatorna azonosítóját a csatornalista adja, a képek és videók path értékét pedig a médiafeltöltés. A bekötött fiókra érvényes, pontos sémát a beállítássémát visszaadó végpont adja vissza. Parancssorból ugyanez a --settings kapcsolóval megy, lásd a CLI-példákat.