Tömeges videóütemezés CSV-ből: tesztelt munkafolyamat 2026-ra

A CSV-ből történő tömeges videóütemezéshez egyértelmű megfeleltetésre van szükség az egyes sorok, a videók, a célcsatornák és a közzétételi időpontok között. Ez az útmutató bemutatja ezt a megfeleltetést a már regisztrált médiatárbeli videók esetében, majd minden kiválasztott sorhoz külön API-ütemezést küld be és ellenőriz. Maga a táblázatszöveg beolvasása önmagában még nem hoz létre ütemezést és nem tölt fel videófájlt.

A médiafájlokat készítsd elő az egy videó több platformra történő adaptálásáról szóló útmutatónk alapján. A CSV-fájl a tervet rendszerezi, de nem változtatja meg a videófájlok műszaki kompatibilitását.

Határozd meg a bemenetet és a tesztelt eredményt

A munkafolyamathoz szükséged lesz egy munkaterületi API-kulcsra, előkészített médiatárbeli videókra, azok azonosítóira (video ID), a pontos célcsatorna-azonosítókra (channel ID), valamint egy jövőbeli időpontra minden olyan elemhez, amelyet közzé kívánsz tenni. Az integrációdban tarts fenn egy fájlnév–videóazonosító megfeleltetési táblát. A fájlnév csupán egy párosítási címke, nem pedig szerveroldali videóazonosító.

Készítsd elő és vizsgáld meg a CSV-fájlt

Használd a tömeges ütemezési CSV-validátort a táblázatod ellenőrzéséhez és a sablon letöltéséhez. Használat előtt cseréld le a példában szereplő fájlneveket, csatornaneveket és dátumokat. A fejlesztői ellenőrzésünk során pontosan ezt a mintát futtattuk le; a benne szereplő 2030-as dátumok szándékosan távoli tesztértékek, amelyeket 2026. október 19-én ellenőriztünk.

file;title;description;hashtags;channels;scheduledFor
clip-01.mp4;First demo;"A caption; with punctuation";#demo;Demo YouTube;2030-01-15T17:00:00.000Z
clip-02.mp4;Second demo;Review before release;;Demo YouTube;2030-01-16T17:00:00.000Z

Az implementáció elfogadja a vessző, a pontosvessző és a tabulátor elválasztójeleket, és felismeri a támogatott fejléc-alternatívákat (aliasokat). A fenti minta pontosvesszőt használ. Ha egy mezőn belül elválasztójel szerepel, a mezőt idézőjelek közé kell tenni, ahogy a fenti leírásban is látható. A CSV-idézőjelezési szabályok hátteréhez lásd az RFC 4180 szabványt (ellenőrizve: 2026. október 19.); a vesszőn túli elválasztójelek támogatása a saját implementációnkból származik.

Mindig kezeld explicit módon a munkához használt időzónát. Az értelmező (parser) az időzóna-eltolást tartalmazó ISO-időbélyeget helyi dátum-idő értékké alakítja az adott sorhoz. A tesztkörnyezetünk ezt a helyi értéket visszaalakította ISO-időponttá az API-kérés beküldésekor. Mindig ellenőrizd az értelmezett időpontot ahelyett, hogy feltételeznéd, a látható óraérték mindig UTC-ben van. A kívánt időpont áttekintésében segít a posztolási időzóna-átváltó.

Oldj fel minden sort a beküldés előtt

A CSV-párosító fájlnév alapján rendeli össze a sorokat. Minden egyes megtalált fájlt oldj fel a tényleges médiatárbeli videóazonosítójára (video ID), a kiválasztott fiókot pedig a megfelelő csatornaazonosítóra (channel ID). A tesztünkben az idézőjelezett leírás sértetlenül átment az értelmezésen, a megnevezett csatorna pedig feloldódott a várt azonosítóra.

Ha egy csatornanév több csatlakoztatott fiókra is illeszkedik, az eredmény kétértelmű. Az értelmező ilyenkor hibát jelzett ahelyett, hogy találomra választott volna egy fiókot, és az ismeretlen csatornanevet is külön jelezte. Mindig a pontos fiókazonosítót részesítsd előnyben, ha ugyanazon a platformon több csatornát is kezelsz. Egy puszta platformnév az alapértelmezett kapcsolatra oldódhat fel, ezért nem szabad feltételezni, hogy automatikusan a kívánt ügyfélfiókot választja ki.

A kérések létrehozása előtt szűrd ki a nem párosítható CSV-sorokat, a duplikált fájlneveket és a sorhibákat. Az üres metaadat-cellák nem írják felül a meglévő sorértékeket az átvizsgált párosítóban. Hiányzó közzétételi időpont vagy célcsatorna esetén explicit döntést kell hoznod arról, hogy az adott elem csak előkészítés alatt áll, vagy ténylegesen ütemezni kell.

Hozd létre és ellenőrizd az egyes ütemezéseket

Minden érvényes sorhoz küldj egy POST /uploads/schedule kérést a munkaterületi kulccsal az x-api-key fejlécben. Az integráció a párosított videóazonosítót, a feloldott csatornaazonosítót és az értelmezett időbélyeget használta:

{
 "videoId": "MATCHED_VIDEO_ID",
 "platforms": ["youtube"],
 "channels": ["RESOLVED_CHANNEL_ID"],
 "scheduledFor": "2030-01-15T17:00:00.000Z",
 "title": "First demo",
 "description": "A caption; with punctuation",
 "privacyStatus": "public"
}

Ezt a kérésformátumot és időbélyeget 2026. október 19-én próbáltuk ki. A bemutató mindkét mintasorhoz létrehozott egy-egy ütemezést, majd a GET /uploads/scheduled?status=scheduled végponton keresztül megerősítette mindkét bejegyzés meglétét. Mentsd el a visszaadott ütemezés-azonosítót és publikálási kérés-azonosítót az eredeti fájlnév mellé. Soha ne számolj el egy pusztán beolvasott CSV-sort sikeresen beküldött kérésként.

A bemutatónk YouTube-tesztadatokat használt. Más célplatformok saját jogosultságokat és platformspecifikus metaadatokat igényelnek. Egy CSV-sor nem helyettesíti a TikTok által megkövetelt felhasználói választásokat vagy hozzájárulást; ez az ellenőrzés nem igazol működő TikTok-beküldést.

Kezeld a részleges eredményeket, és töröld a nem kívánt terveket

Ha egy kérés meghiúsul, az újrapróbálkozás előtt vizsgáld meg az adott sort és a szerver válaszát. Őrizd meg a már sikeresen létrehozott ütemezés-azonosítókat. Ha az összes sort újra beküldöd, duplikált terveket hozhatsz létre a már elfogadott elemekhez.

Egy még ütemezett elem visszavonásához használd a DELETE /uploads/scheduled/SCHEDULE_ID végpontot. A tesztkörnyezetünk mindkét mintatervet törölte, majd megerősítette, hogy az ütemezett lista üres. Ez a végrehajtás előtti helyi tervtörlést igazolja, nem pedig a közösségi hálózaton már közzétett tartalom eltávolítását.