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.
Základní údaje
youtubeTypy příspěvků
Stejný kanál přijímá víc druhů příspěvků. Každý má jiné požadavky. Tabulka ukáže, co k čemu potřebujete.
| Typ | Média | Poznámka |
|---|---|---|
| Video | 1 video, povinné | Název a viditelnost jsou povinné. Výchozí hodnotu nemají. |
Pravidla
- Název je povinný a musí mít 2 až 100 znaků.
- Viditelnost musíte zadat, výchozí hodnotu nemá.
- Štítky dohromady smí mít nejvýše 500 znaků. Štítky s mezerou dává YouTube do uvozovek, proto u každého takového štítku počítá o dva znaky víc.
Pole nastavení
Tato pole jdou do objektu settings příspěvku, vedle pole __type. V rozhraní je vyplníte v rozbalovací sekci nastavení kanálu.
| Pole | Typ | Povinné | Co dělá |
|---|---|---|---|
| title | string, 2 až 100 znaků | ano | Název videa. |
| type | "public" | "unlisted" | "private" | ano | Veřejné, neuvedené, nebo soukromé. |
| selfDeclaredMadeForKids | "yes" | "no" | ne | Prohlášení, zda je obsah určený dětem. |
| thumbnail | objekt média | ne | Vlastní náhledový obrázek z knihovny médií. |
| tags | pole, u každé položky { value, label } | ne | Štítky videa, dohromady nejvýše 500 znaků. |
Povolené hodnoty
Uvedená pole přijímají jen tyto hodnoty. U jakékoli jiné hodnoty dostanete chybu 400 a odpověď pojmenuje pole.
type
| Hodnota | Co znamená |
|---|---|
| public | Veřejné. |
| unlisted | Neuvedené: dostupné jen přes odkaz. |
| private | Soukromé. |
selfDeclaredMadeForKids
| Hodnota | Co znamená |
|---|---|
| yes | Určeno pro děti. |
| no | Není určeno pro děti. |
Příklady
Každý příklad je jedna položka v poli posts požadavku POST /public/v1/posts. Obálka kolem něj je vždy tato:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Video veřejně
{
"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 se štítky a náhledovým obrázkem
Celková délka štítků je nejvýše 500 znaků. Štítek s mezerou YouTube dá do uvozovek, což se počítá jako dva znaky navíc.
{
"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" }
}
}Identifikátor kanálu získáte ze seznamu kanálů. Hodnoty path u obrázků a videí z nahrání médií. Přesné schéma platné pro propojený účet vrací endpoint se schématem nastavení. Z příkazové řádky to samé uděláte přepínačem --settings, viz příklady CLI.