Videó közzététele YouTube, Instagram, Facebook és Threads felületen

1. Készíts elő egy kész videómédiát

Tölts fel helyi videót, vagy importálj nyilvános videó-URL-t a munkaterületedre. A feltöltést vagy importot készenlétig ellenőrizd, majd a regisztrált asset_id és kanonikus asset_url értékét használd a bejegyzésben.

A SosoAPI ellenőrzi a videó tényleges konténerét, hosszát, méreteit és kodekjeit, ahol ezt a platform megköveteli. A fájlnév, a hívó által megadott MIME-típus vagy a lejátszható előnézet nem igazolja a jogosultságot. Időzítés előtt ellenőrizd a videóhoz és hanghoz fűződő jogaidat, valamint a kötelező jelöléseket.

• Az eredeti videót és borítómédiát ugyanabban az engedélyezett munkaterületben tartsd.
• Ellenőrizd a teljes piszkozat jogosultságát a pontos fiókhoz és kívánt formátumhoz.
• Ha az előkészítés sikertelen, vizsgáld meg a meglévő állapotát; pusztán a lassú válasz miatt ne indíts ismételt importálásokat.

2. Válaszd ki a célhely videóformátumát

Válaszd a célfiók által támogatott formátumot és beállításokat. Kész médiát újrahasználhatsz, de minden platform saját provider_payload értéket igényel.

3. Ellenőrzött YouTube-videó időzítése

Használd az API-referencia szerversegédjét. Az asset_id helyére a regisztrált pozitív egész számot, az asset_url helyére a kanonikus URL-t írd. Válaszd ki a csatorna tényleges fiókazonosítóját és egy jövőbeli közzétételi időpontot.

Ez a példa nyilvános közzétételt kér a kiválasztott időpontban. Futtatás előtt erősíttesd meg ezt a láthatóságot a felhasználóval. A contains_synthetic_media értékét a videónak megfelelően állítsd be; a false csak példa. Az UNSCHEDULE_KEEP_PRIVATE arra kéri a YouTube-ot, hogy visszavonás esetén a még közzé nem tett natív időzítést tartsa privátként.

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

• Közzétételi API-referencia

4. Tedd egyértelművé az adatvédelmi, Shorts- és szolgáltatói korlátokat

YouTube-hoz VIDEO post_type értéket használj. Megadhatsz surface_expectation: SHORT értéket, de a YouTube dönti el, hogy a feltöltés Shortnak számít-e. A fájlnév vagy az álló tájolás önmagában nem igazolja ezt.

A feltöltési és a natív időzítések kezelésére szóló engedély különbözik. Ellenőrizd, támogatja-e a csatorna az opcionális funkciókat, például a bélyegképeket; az elérhetőség ismeretlen is lehet. A Google feltöltési referenciája ismerteti az engedélyezési és metaadatkövetelményeket; a SosoAPI a saját támogatott mezőit és az összekapcsolt fiókot is ellenőrzi.

A YouTube és más platformok feldolgozási vagy moderálási időt igényelhetnek a videóhoz, és kvótáik továbbra is érvényesek. Az elfogadott feltöltés nem jelenti, hogy a videó nyilvánosan látható.

• Google: YouTube videos.insert referencia
• Fiók- és formátumképesség-mátrix

5. Ellenőrizd ugyanannak a bejegyzésnek a végső eredményét

Mentsd el a Scheduled Post azonosítóját, és ellenőrizd kézbesítését és végső eredményét. Ha van, nyisd meg a szolgáltatói linket. A scheduled vagy publishing azt jelenti, hogy a végső eredmény még függőben van.

Az elfogadott időzítés a kliens szétkapcsolása után is folytatódik a szerveren. Módosítás előtt ugyanazt a bejegyzést olvasd. Visszavonáshoz az aktuális verziót és elérhető visszavonási műveletet használd. Már közzétett videó törlésére más szabályok vonatkoznak.

Videó több platformon történő újrahasználatakor ellenőrizd minden célhely követelményeit. Ezek a példák kérésformátumokat mutatnak; nem futtatnak és nem tesznek közzé videót erről az oldalról.

• Saját ügynökkel végzett ellenőrzési folyamat
• Közzétételi API-referencia