Publicera video till YouTube, Instagram, Facebook och Threads

1. Förbered en färdig videomediefil

Ladda upp en lokal video eller importera en offentlig video-URL till din arbetsyta. Kontrollera uppladdningen eller importen tills den är klar och använd sedan registrerat asset_id och kanonisk asset_url i inlägget.

SosoAPI kontrollerar videons faktiska container, längd, mått och kodekar när plattformen kräver det. Ett filnamn, en MIME-typ som anroparen anger eller en spelbar förhandsvisning räcker inte för att fastställa behörighet. Kontrollera dina rättigheter till video och ljud samt eventuella krav på upplysningar före schemaläggning.

• Behåll ursprunglig video och omslagsmediefiler i samma behöriga arbetsyta.
• Kontrollera hela utkastets behörighet för exakt konto och avsett format.
• Om förberedelsen misslyckas, kontrollera dess befintliga status. Starta inte dubbla importer bara för att ett svar dröjer.

2. Välj destinationens videoformat

Välj format och alternativ som destinationskontot stöder. Du kan återanvända en färdig mediefil men varje plattform behöver egen provider_payload.

3. Schemalägg en granskad YouTube-video

Använd serverhjälparen från API-referensen. Ersätt asset_id med det registrerade positiva heltalet och asset_url med dess kanoniska URL. Välj kanalens faktiska konto-ID och en framtida publiceringstid.

Exemplet begär offentlig publicering vid den valda tiden. Bekräfta den synligheten med användaren före körning. Ange contains_synthetic_media så att det stämmer med videon; false är bara ett exempel. UNSCHEDULE_KEEP_PRIVATE ber YouTube hålla en opublicerad inbyggd schemaläggning privat om den avbryts.

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

• Publicerings-API-referens

4. Var tydlig med integritet, Shorts och leverantörsgränser

Använd post_type VIDEO för YouTube. Du kan ange surface_expectation: SHORT, men YouTube avgör fortfarande om uppladdningen är en Short. Ett filnamn eller stående format räcker inte för att fastställa det.

Behörighet att ladda upp och behörighet att hantera inbyggda schemaläggningar är separata. Kontrollera om kanalen stöder valfria funktioner som miniatyrbilder; tillgängligheten kan vara okänd. Uppladdningsreferensen från Google förklarar kraven på auktorisering och metadata, medan SosoAPI även kontrollerar sina egna fält och det anslutna kontot.

YouTube och andra plattformar kan behöva tid för att bearbeta eller moderera en video, och deras kvoter gäller fortfarande. En accepterad uppladdning betyder inte att videon är offentligt synlig.

• Google: Referens för YouTube videos.insert
• Funktionsmatris för konto och format

5. Verifiera samma inläggs slutresultat

Spara Scheduled Post-ID:t och kontrollera leverans och slutresultat. Öppna leverantörslänken när den finns. Scheduled eller publishing betyder att slutresultatet fortfarande väntar.

En accepterad schemaläggning fortsätter på servern om klienten kopplas från. Läs samma inlägg innan du ändrar något. Använd aktuell version och tillgänglig avbrytandeåtgärd för att avbryta. Radering av en redan publicerad video följer andra regler.

Kontrollera varje destinations krav när du återanvänder en video mellan plattformar. Exemplen visar anropsformat; de körs inte och publicerar ingen video från denna sida.

• Granskningsflöde med egen agent
• Publicerings-API-referens