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.
Eckdaten
youtubeBeitragstypen
Derselbe Kanal akzeptiert mehrere Beitragstypen. Jeder verlangt etwas anderes. Die Tabelle zeigt, was du wofür brauchst.
| Typ | Medien | Hinweis |
|---|---|---|
| Video | 1 Video, Pflicht | Titel und Sichtbarkeit sind Pflicht, Standardwerte gibt es nicht. |
Regeln
- Der Titel ist Pflicht und muss zwischen 2 und 100 Zeichen liegen.
- Die Sichtbarkeit musst du angeben, einen Standardwert gibt es nicht.
- Die Tags dürfen zusammen höchstens 500 Zeichen lang sein. Tags mit Leerzeichen setzt YouTube in Anführungszeichen, deshalb zählt es pro solchem Tag zwei Zeichen extra.
Einstellungsfelder
Diese Felder kommen in das settings-Objekt des Beitrags, neben das Feld __type. In der Oberfläche füllst du dieselben im Einstellungsbereich des Kanals aus.
| Feld | Typ | Pflicht | Was es tut |
|---|---|---|---|
| title | string, zwischen 2 und 100 Zeichen | ja | Der Titel des Videos. |
| type | "public" | "unlisted" | "private" | ja | Öffentlich, nicht gelistet oder privat. |
| selfDeclaredMadeForKids | "yes" | "no" | nein | Angabe, ob der Inhalt für Kinder gemacht ist. |
| thumbnail | Medienobjekt | nein | Ein eigenes Vorschaubild aus der Mediathek. |
| tags | Array, je Element { value, label } | nein | Video-Tags, zusammen höchstens 500 Zeichen. |
Zulässige Werte
Die aufgeführten Felder akzeptieren nur diese Werte. Bei jedem anderen Wert bekommst du einen 400er-Fehler. Die Antwort nennt das Feld.
type
| Wert | Bedeutung |
|---|---|
| public | Öffentlich. |
| unlisted | Nicht gelistet: nur über einen Link erreichbar. |
| private | Privat. |
selfDeclaredMadeForKids
| Wert | Bedeutung |
|---|---|
| yes | Für Kinder gemacht. |
| no | Nicht für Kinder gemacht. |
Beispiele
Jedes Beispiel ist ein Element im posts-Array der Anfrage POST /public/v1/posts. Der Rahmen darum ist immer dieser:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Video, öffentlich
{
"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 mit Tags und Vorschaubild
Die Tags dürfen zusammen höchstens 500 Zeichen lang sein. YouTube setzt Tags mit Leerzeichen in Anführungszeichen. Das zählt als zwei Zeichen extra.
{
"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" }
}
}Die Kanalliste liefert die Kanal-ID, der Medien-Upload den path-Wert für Bilder und Videos. Das genaue Schema für das verbundene Konto gibt der Endpunkt für das Einstellungsschema zurück. Von der Kommandozeile aus geht dasselbe mit dem Flag --settings, siehe die CLI-Beispiele.