Videos auf YouTube, Instagram, Facebook und Threads veröffentlichen

1. Ein bereites Video-Asset vorbereiten

Lade ein lokales Video hoch oder importiere eine öffentliche Video-URL in deinen Workspace. Prüfe Upload oder Import bis zur Bereitschaft und nutze dann registrierte asset_id und kanonische asset_url im Beitrag.

SosoAPI prüft den tatsächlichen Container, die Dauer, Abmessungen und Codecs des Videos, soweit die Plattform dies verlangt. Dateiname, vom Aufrufer angegebener MIME-Typ oder abspielbare Vorschau reichen nicht als Eignungsnachweis. Prüfe vor dem Planen deine Rechte an Video und Audio sowie erforderliche Kennzeichnungen.

• Behalte Originalvideo und Cover-Assets im selben autorisierten Workspace.
• Prüfe die Eignung des vollständigen Entwurfs für das genaue Konto und gewünschte Format.
• Prüfe bei fehlgeschlagener Vorbereitung den bestehenden Status; starte keine doppelten Importe, nur weil eine Antwort langsam ist.

2. Videoformat des Ziels wählen

Wähle Format und Optionen, die das Zielkonto unterstützt. Du kannst ein bereites Asset wiederverwenden, aber jede Plattform braucht ihr eigenes provider_payload.

3. Ein geprüftes YouTube-Video planen

Nutze den Server-Helper aus der API-Referenz. Ersetze asset_id durch die registrierte positive Ganzzahl und asset_url durch deren kanonische URL. Wähle die tatsächliche Konto-ID des Kanals und einen zukünftigen Veröffentlichungszeitpunkt.

Dieses Beispiel fordert eine öffentliche Veröffentlichung zum gewählten Zeitpunkt an. Bestätige diese Sichtbarkeit vor der Ausführung mit dem Nutzer. Setze contains_synthetic_media passend zum Video; false ist nur ein Beispiel. UNSCHEDULE_KEEP_PRIVATE fordert YouTube auf, einen unveröffentlichten nativen Zeitplan bei Abbruch privat zu halten.

await sosoPost("/studio-api/scheduled-posts/create", {
  "workspace_id": "<workspace-uuid>",
  "social_account_id": "<youtube-channel-account-uuid>",
  "caption": null,
  "hashtags": [],
  "media": [
    {
      "kind": "video",
      "asset_id": "<ready-video-asset-id>",
      "url": "<canonical-video-asset-url>"
    }
  ],
  "provider_payload": {
    "platform": "youtube",
    "publish_options": {
      "post_type": "VIDEO",
      "title": "A reviewed product walkthrough",
      "description": "Our team introduces the product in one short walkthrough.",
      "category_id": "24",
      "privacy_status": "public",
      "cancellation_mode": "UNSCHEDULE_KEEP_PRIVATE",
      "contains_synthetic_media": false
    }
  },
  "scheduled_at": "<future-ISO-8601-instant-with-offset>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<stable-key-for-this-one-video-intent>"
});

• Veröffentlichungs-API-Referenz

4. Datenschutz, Shorts und Anbietergrenzen klar benennen

Nutze für YouTube post_type VIDEO. Du kannst surface_expectation: SHORT setzen, aber YouTube entscheidet weiterhin, ob der Upload als Short gilt. Dateiname oder Hochformat allein belegen dies nicht.

Die Berechtigung zum Hochladen und die zum Verwalten nativer Zeitpläne sind getrennt. Prüfe, ob der Kanal optionale Funktionen wie Thumbnails unterstützt; die Verfügbarkeit kann unbekannt sein. Die Upload-Referenz von Google erklärt Anforderungen an Autorisierung und Metadaten; SosoAPI prüft zusätzlich die eigenen unterstützten Felder und das verbundene Konto.

YouTube und andere Plattformen können zur Verarbeitung oder Moderation eines Videos Zeit brauchen; ihre Kontingente gelten weiter. Ein angenommener Upload bedeutet nicht, dass das Video öffentlich sichtbar ist.

• Google: YouTube-videos.insert-Referenz
• Funktionsmatrix für Konten und Formate

5. Endgültiges Ergebnis desselben Beitrags prüfen

Speichere die Scheduled-Post-ID und prüfe Zustellung und endgültiges Ergebnis. Öffne verfügbare Anbieterlinks. Scheduled oder publishing bedeutet, dass das endgültige Ergebnis noch aussteht.

Ein angenommener Zeitplan läuft bei Client-Verbindungsabbruch auf dem Server weiter. Lies denselben Beitrag vor Änderungen. Nutze zum Abbrechen aktuelle Version und verfügbare Abbruchaktion. Für das Löschen bereits veröffentlichter Videos gelten andere Regeln.

Prüfe jedes Ziel, wenn du Videos plattformübergreifend wiederverwendest. Diese Beispiele zeigen Anfrageformate; sie werden auf dieser Seite weder ausgeführt noch veröffentlichen sie ein Video.

• Prüfablauf mit eigenem Agenten
• Veröffentlichungs-API-Referenz