Publiceer video op YouTube, Instagram, Facebook en Threads

1. Bereid één gereed videobestand voor

Upload een lokale video of importeer een openbare video-URL in je werkruimte. Controleer die upload of import tot deze gereed is en gebruik daarna de geregistreerde asset_id en canonieke asset_url in je bericht.

SosoAPI controleert de werkelijke container, duur, afmetingen en codecs van de video waar het platform die vereist. Een bestandsnaam, een door de aanroeper opgegeven MIME-type of een afspeelbaar voorbeeld volstaat niet om geschiktheid vast te stellen. Controleer vóór het inplannen je rechten op video en audio en eventuele verplichte vermeldingen.

• Bewaar de oorspronkelijke video en omslagmedia in dezelfde toegestane werkruimte.
• Controleer het volledige concept op geschiktheid voor het exacte account en bedoelde formaat.
• Bekijk bij een mislukte voorbereiding de bestaande status; start geen dubbele imports alleen omdat een antwoord traag is.

2. Kies het videoformaat van de bestemming

Kies het formaat en de opties die het doelaccount ondersteunt. Je kunt gereedstaande media hergebruiken, maar elk platform heeft een eigen provider_payload nodig.

3. Plan een beoordeelde YouTube-video in

Gebruik de serverhelper uit de API-naslag. Vervang asset_id door het geregistreerde positieve gehele getal en asset_url door de canonieke URL. Selecteer de echte account-ID van het kanaal en een toekomstig publicatietijdstip.

Dit voorbeeld vraagt om openbare publicatie op het gekozen tijdstip. Bevestig die zichtbaarheid met de gebruiker vóór uitvoering. Stel contains_synthetic_media in overeenkomstig de video; false is slechts een voorbeeld. UNSCHEDULE_KEEP_PRIVATE vraagt YouTube om een ongepubliceerde platformeigen planning privé te houden als deze wordt geannuleerd.

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>"
});

• Naslag voor de publicatie-API

4. Houd privacy, Shorts en providerlimieten duidelijk

Gebruik post_type VIDEO voor YouTube. Je kunt surface_expectation: SHORT instellen, maar YouTube bepaalt nog steeds of de upload als Short kwalificeert. Alleen een bestandsnaam of staand beeld bewijst dit niet.

Toestemming voor uploaden en voor het beheren van platformeigen planningen staan los van elkaar. Controleer of het kanaal optionele functies zoals miniaturen ondersteunt; de beschikbaarheid kan onbekend zijn. De uploadnaslag van Google beschrijft de vereisten voor autorisatie en metadata; SosoAPI controleert daarnaast de eigen ondersteunde velden en het verbonden account.

YouTube en andere platforms kunnen tijd nodig hebben om een video te verwerken of beoordelen; hun quota blijven gelden. Een geaccepteerde upload betekent niet dat de video openbaar zichtbaar is.

• Google: naslag voor YouTube videos.insert
• Matrix van account- en formaatmogelijkheden

5. Verifieer het definitieve resultaat van hetzelfde bericht

Bewaar de Scheduled Post-ID en controleer aflevering en definitief resultaat. Open de providerlink indien beschikbaar. Scheduled of publishing betekent dat het definitieve resultaat nog niet vaststaat.

Een geaccepteerde planning loopt op de server door als je clientverbinding wordt verbroken. Lees hetzelfde bericht voordat je iets wijzigt. Gebruik voor annulering de huidige versie en een beschikbare annuleringsactie. Voor het verwijderen van een reeds gepubliceerde video gelden andere regels.

Controleer bij hergebruik van een video op meerdere platforms de vereisten per bestemming. Deze voorbeelden tonen verzoekformaten; ze worden niet uitgevoerd en publiceren geen video vanaf deze pagina.

• Beoordelingsproces met eigen agent
• Naslag voor de publicatie-API