Video's plaatsen op een Facebook-pagina via de API
Een video bereikt een Facebook-pagina via POST /{page-id}/videos, met file_url, een URL die Meta zelf downloadt, of met een bestand dat de app eerst naar Meta uploadt. title geeft de video een naam en description is de tekst die Meta bij de post kan tonen. Meta verwerkt het bestand daarna, en GET /{video-id}?fields=status meldt video_status als processing totdat de waarde ready wordt.
easyCoexistence plaatst video's op Facebook-pagina's met publish_facebook_post vanuit Claude, ChatGPT of je eigen code, nu of ingepland tot 90 dagen vooruit.
Foutcode wanneer Meta het videobestand niet kan ophalen van de URL in file_url.
Foutcode voor een videobestand dat te klein is om te uploaden; Meta vraagt om een groter bestand.
Venster voor scheduled_publish_time op de videos-edge, geteld vanaf het moment dat de video wordt gepubliceerd.
Bereik van processing_progress, het deel van de verwerking van een video dat klaar is, naast video_status gemeld.
Host voor videouploads volgens het Video API-overzicht van Meta, dat graph-video.facebook.com hiervoor als verouderd markeert.
De handle die een upload teruggeeft, meegegeven aan /{page-id}/videos als fbuploader_video_file_chunk om de video te publiceren.
Hoe wordt een video op een Facebook-pagina geplaatst?
Met POST /{page-id}/videos en een toegangstoken van de pagina. Het bestand bereikt Meta op twee manieren: via file_url, een toegankelijke URL van de video die Meta zelf ophaalt, of via een upload, waarbij de app de bytes eerst verstuurt. file_url kan niet worden gecombineerd met upload_phase, de parameter van de chunked upload, dus een verzoek gebruikt de ene of de andere manier.
| file_url | Uploaded file | |
|---|---|---|
| Where the video is | At a URL Meta can reach | On your own system |
| On /{page-id}/videos | file_url | fbuploader_video_file_chunk with the upload's handle |
| Before publishing | Nothing: Meta fetches the file | An upload session, then the bytes |
| If it fails | Error 389 when Meta cannot fetch it | Resume from the offset Meta reports |
Hoe werkt de upload voor een bestand dat niet online staat?
De videopubliceringsgids van Meta gebruikt de Resumable Upload API. POST /{app-id}/uploads met file_name, file_length en file_type opent een sessie, en POST /upload:{session-id} met een file_offset-header en de bytes geeft een handle terug, h. De video wordt daarna gepubliceerd met POST /{page-id}/videos en fbuploader_video_file_chunk ingesteld op die handle, naast title en description. Deze uploadaanroepen gebruiken een gebruikerstoegangstoken.
- Een onderbroken upload hervat vanaf de
file_offsetdie GET /upload:{session-id} teruggeeft. - De videoreferentie documenteert ook een chunked upload op dezelfde edge:
upload_phasestart, transfer en finish, metstart_offset,file_sizeenvideo_file_chunk.
Wat doen title en description?
title is de titel van de video. description is, in de woorden van Meta, de tekst die een post beschrijft en mogelijk in een story erover wordt getoond, dus daar komt de tekst van de post te staan. Beide zijn optioneel op de videos-edge, en publish_facebook_post stuurt het bericht als description en laat title niet ingevuld.
Hoe weet je wanneer de video klaar is?
Meta verwerkt een video nadat die is aangekomen. GET /{video-id}?fields=status geeft video_status terug, dat processing toont terwijl Meta bezig is, ready zodra de video is geüpload, gecodeerd en de miniaturen heeft, of error als de verwerking mislukt, met processing_progress als het gedeelte dat klaar is, van 0 tot 100. Meta kan de publicatiestatus ook melden via webhooks op het veld videos, waarop easyCoexistence zich niet abonneert.
Hoe groot en hoe lang mag de video zijn?
De videoreferentie van Facebook-pagina's en de videopubliceringsgids van Meta vermelden geen maximale bestandsgrootte of lengte. De grootteregel die ze wel noemen is foutcode 382, voor een bestand dat te klein is om te uploaden. De richtlijnen van Meta voor Reels en Stories stellen eigen duur: 3 tot 90 seconden voor een Reel en maximaal 60 seconden voor een videostory. Wanneer easyCoexistence een video inplant, kopieert het het bestand op dat moment en weigert het een bestand van meer dan 1 GB.
Welke rechten en paginataak heeft het nodig?
pages_manage_posts, pages_read_engagement en pages_show_list, met een toegangstoken van de pagina van iemand die de taak CREATE_CONTENT kan uitvoeren, volgens de videoreferentie en de publicatiegids. Het Video API-overzicht van Meta formuleert het strikter: de persoon moet beheertaken op de pagina kunnen uitvoeren, of een Admin-rol hebben die via Business Manager is toegekend.
Welke fouten kan een videopost teruggeven?
De videoreferentie van Meta somt deze op voor POST /{page-id}/videos:
- 389: het videobestand kan niet van de URL worden opgehaald.
- 382: het videobestand is te klein; probeer het opnieuw met een groter bestand.
- 6000: een probleem bij het uploaden van het videobestand; probeer het opnieuw met een ander bestand.
- 6001: een probleem bij het uploaden van de video; probeer het opnieuw.
- 368: de actie werd als misbruik beschouwd of is anderszins niet toegestaan.
- 100: ongeldige parameter; 200: rechtenfout; 190: ongeldig OAuth 2.0-toegangstoken.
Hoe plaatst publish_facebook_post een video?
Het neemt video_url, een openbare HTTPS-link naar het bestand, en message, en stuurt ze naar /{page-id}/videos als file_url en description, zodat Meta de video zelf ophaalt. Een post bevat één video, en een link die ernaast wordt meegestuurd wordt geweigerd, dus zet de URL in de message. Het resultaat post_id bevat de ID die Meta heeft teruggegeven, voor een video de eigen ID van de video.
Hoe wordt een videopost ingepland?
Geef publish_facebook_post een scheduled_at in ISO 8601 met een tijdzone, van 1 minuut tot 90 dagen vooruit. easyCoexistence kopieert de video wanneer de post wordt ingepland en publiceert die op het moment zelf op de Facebook-pagina. list_scheduled_posts toont hem, update_scheduled_post verplaatst hem of wijzigt de tekst, en cancel_scheduled_post stopt hem. De eigen scheduled_publish_time van Meta op de videos-edge staat 10 minuten tot 6 maanden toe.
Veelgemaakte fouten
- file_url laten verwijzen naar een pagina die de video afspeelt in plaats van naar het bestand. Meta haalt het adres zelf op, en een adres dat het niet kan ophalen mislukt met foutcode 389.
- Uploaden naar graph-video.facebook.com. Het Video API-overzicht van Meta markeert die host als verouderd voor videouploads en vraagt om graph.facebook.com.
- De video aankondigen voordat die klaar is. Controleer de status tot video_status ready aangeeft, want de verwerking loopt door nadat de publicatieaanroep terugkeert.
- Een link meesturen met de video. publish_facebook_post weigert een link naast een bestand; zet de URL in plaats daarvan in de message.
Je platform kan hetzelfde doen met POST /channels/:id/posts op de Partner API. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Kan ik vanaf mijn computer een video uploaden naar een Facebook-pagina via de API?
Ja, via de Resumable Upload API van Meta, die een handle teruggeeft voor /{page-id}/videos, of via de chunked upload op die edge. publish_facebook_post neemt in plaats daarvan een openbare HTTPS-URL, dus host het bestand eerst.
Kan een video worden geüpload zonder dat hij in de feed van de pagina verschijnt?
Ja. Published op false zetten houdt de post tegen, no_story onderdrukt het verhaal in de feed en de tijdlijn, en secret houdt de video buiten Facebook en uit zoekresultaten.
Kan één video op meerdere pagina's worden geplaatst?
Ja, via crossposting: een gepubliceerde video kan naar andere pagina's die de persoon beheert zonder opnieuw te worden geüpload, en krijgt op elke pagina een eigen video-ID.
Hoeveel kost easyCoexistence voor een Facebook-pagina?
US$ 9 tot US$ 0,75 per verbinding per maand, bepaald door je totale aantal verbindingen, met een gratis proefperiode van 3 dagen. Elke pagina is één verbinding.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op