YouTube: Posting-Regeln und Einstellungen
Was der Kanal YouTube in Posty annimmt: Medien, Limits, Pflichtfelder, und die Felder des settings-Objekts für die API.
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": [ /* das Element unten */ ]
}Video, öffentlich
{
"integration": { "id": "<youtube-kanal>" },
"value": [{
"content": "<p>Die Beschreibung des Videos.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/video.mp4" }]
}],
"settings": {
"__type": "youtube",
"title": "Der Titel des Videos",
"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-kanal>" },
"value": [{
"content": "<p>Die Beschreibung des Videos.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/video.mp4" }]
}],
"settings": {
"__type": "youtube",
"title": "So planst du einen Monat im Voraus",
"type": "unlisted",
"tags": [
{ "value": "planung", "label": "Planung" },
{ "value": "social-media", "label": "Social Media" }
],
"thumbnail": { "id": "<media-cover>", "path": "https://uploads.posty.hu/cover.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.