AccediInizia la prova gratuita
easyCoexistence API ufficiali

Pubblicare video su una Pagina Facebook tramite l'API

Un video arriva a una Pagina Facebook con POST /{page-id}/videos, sia con file_url, un URL che Meta scarica da sola, sia con un file che l'app carica prima su Meta. title dà il nome al video, e description è il testo che Meta può mostrare insieme al post. Meta poi elabora il file, e GET /{video-id}?fields=status riporta video_status come processing finché non risulta ready.

easyCoexistence pubblica video su Pagine Facebook con publish_facebook_post da Claude, ChatGPT o dal tuo codice, subito o programmati fino a 90 giorni in anticipo.

389

Codice di errore quando Meta non riesce a recuperare il file video dall'URL indicato in file_url.

382

Codice di errore per un file video troppo piccolo da caricare; Meta chiede un file più grande.

10 min to 6 months

Finestra per scheduled_publish_time sull'edge videos, calcolata a partire dal momento in cui il video viene pubblicato.

0 to 100

Intervallo di processing_progress, la quota dell'elaborazione del video completata, riportata accanto a video_status.

graph.facebook.com

Host per i caricamenti video, secondo la panoramica della Video API di Meta, che segna graph-video.facebook.com come deprecato per questo uso.

h

L'handle restituito da un caricamento, passato a /{page-id}/videos come fbuploader_video_file_chunk per pubblicare il video.

Come si pubblica un video su una Pagina?

Con POST /{page-id}/videos e un token di accesso della Pagina. Il file arriva a Meta in uno di due modi: file_url, un URL accessibile del video che Meta recupera da sola, oppure un caricamento, in cui l'app invia prima i byte. file_url non può essere combinato con upload_phase, il parametro del caricamento a blocchi, quindi una richiesta usa l'uno o l'altro.

file_urlUploaded file
Where the video isAt a URL Meta can reachOn your own system
On /{page-id}/videosfile_urlfbuploader_video_file_chunk with the upload's handle
Before publishingNothing: Meta fetches the fileAn upload session, then the bytes
If it failsError 389 when Meta cannot fetch itResume from the offset Meta reports

Come funziona il caricamento per un file che non è online?

La guida alla pubblicazione video di Meta usa la Resumable Upload API. POST /{app-id}/uploads con file_name, file_length e file_type apre una sessione, e POST /upload:{session-id} con un header file_offset e i byte restituisce un handle, h. Il video viene poi pubblicato con POST /{page-id}/videos e fbuploader_video_file_chunk impostato su quell'handle, insieme a title e description. Queste chiamate di caricamento usano un token di accesso utente.

  • Un caricamento interrotto riprende dal file_offset restituito da GET /upload:{session-id}.
  • Il riferimento videos documenta anche un caricamento a blocchi sullo stesso edge: upload_phase start, transfer e finish, con start_offset, file_size e video_file_chunk.

Cosa fanno title e description?

title è il titolo del video. description è, nelle parole di Meta, il testo che descrive un post e che può essere mostrato in una storia dedicata, quindi è il punto in cui va il testo del post. Entrambi sono facoltativi sull'edge videos, e publish_facebook_post invia il suo message come description e lascia title non impostato.

Come si sa quando il video è pronto?

Meta elabora un video dopo che è arrivato. GET /{video-id}?fields=status restituisce video_status, che indica processing mentre Meta lavora, ready una volta che il video è caricato, codificato e ha le miniature, oppure error se l'elaborazione è fallita, con processing_progress che indica la quota completata da 0 a 100. Meta può anche riportare lo stato di pubblicazione tramite webhook della Pagina sul campo videos, a cui easyCoexistence non si iscrive.

Quanto può essere grande e lungo il video?

Il riferimento videos della Pagina e la guida alla pubblicazione video di Meta non indicano una dimensione massima né una durata massima del file; la regola sulla dimensione che citano è l'errore 382, per un file troppo piccolo da caricare. Le guide di Meta per Reels e Stories fissano durate proprie: da 3 a 90 secondi per un Reel e al massimo 60 per una storia video. Quando easyCoexistence programma un video, ne copia il file in quel momento e rifiuta quello superiore a 1 GB.

Quali permessi e attività della Pagina servono?

pages_manage_posts, pages_read_engagement e pages_show_list, con un token della Pagina di qualcuno che può eseguire l'attività CREATE_CONTENT, secondo il riferimento videos e la guida alla pubblicazione. La panoramica della Video API di Meta lo formula in modo più rigoroso: la persona deve poter svolgere attività equivalenti a quelle di amministratore sulla Pagina, oppure avere un ruolo di Admin concesso tramite Business Manager.

Quali errori può restituire una pubblicazione video?

Il riferimento videos di Meta elenca questi per POST /{page-id}/videos:

  • 389: impossibile recuperare il file video dall'URL.
  • 382: il file video è troppo piccolo; riprova con un file più grande.
  • 6000: problema nel caricamento del file video; riprova con un altro file.
  • 6001: problema nel caricamento del video; riprova.
  • 368: l'azione è stata considerata abusiva o è comunque non consentita.
  • 100: parametro non valido; 200: errore di permessi; 190: token di accesso OAuth 2.0 non valido.

Come pubblica un video publish_facebook_post?

Riceve video_url, un link HTTPS pubblico al file, e message, e li invia a /{page-id}/videos come file_url e description, così Meta recupera il video da sola. Un post contiene un solo video, e un link inviato insieme viene rifiutato, quindi scrivi l'URL nel message. Il post_id del risultato contiene l'ID restituito da Meta, che per un video coincide con l'ID del video stesso.

Come si programma la pubblicazione di un post video?

Passa a publish_facebook_post il valore scheduled_at, in ISO 8601 con fuso orario, da 1 minuto a 90 giorni in anticipo. easyCoexistence copia il video al momento della programmazione e lo pubblica sulla Pagina a quell'ora; list_scheduled_posts lo mostra, update_scheduled_post lo sposta o ne cambia il testo, e cancel_scheduled_post lo annulla. Lo scheduled_publish_time nativo di Meta sull'edge videos ammette da 10 minuti a 6 mesi.

Errori comuni

  • Puntare file_url a una pagina che riproduce il video invece che al file. Meta scarica l'indirizzo da sola, e uno che non riesce a recuperare fallisce con l'errore 389.
  • Caricare su graph-video.facebook.com. La panoramica della Video API di Meta segna quell'host come deprecato per i caricamenti video e chiede graph.facebook.com.
  • Annunciare il video prima che sia pronto. Controlla lo stato finché video_status non riporta ready, perché l'elaborazione prosegue anche dopo che la chiamata di pubblicazione è terminata.
  • Inviare un link insieme al video. publish_facebook_post rifiuta un link accanto a un file; scrivi invece l'URL nel message.
Farlo con EasyCoexistence

La tua piattaforma può fare lo stesso con POST /channels/:id/posts sulla Partner API. Da US$ 9 a US$ 0,75 per connessione al mese, con calo man mano che aggiungi connessioni e con i primi 3 giorni di prova gratuita.

Domande frequenti

Posso caricare un video dal mio computer su una Pagina Facebook tramite API?

Sì, con la Resumable Upload API di Meta, che restituisce un handle per /{page-id}/videos, oppure con il caricamento a blocchi su quell'edge. publish_facebook_post accetta invece un URL HTTPS pubblico, quindi ospita prima il file.

Un video può essere caricato senza comparire nel feed della Pagina?

Sì. published impostato su false trattiene il post, no_story sopprime la storia nel feed e nella timeline, e secret tiene il video fuori da Facebook e dalla ricerca.

Un solo video può essere pubblicato su più Pagine?

Sì, tramite crossposting: un video pubblicato può andare su altre Pagine che la persona amministra senza essere caricato di nuovo, e ottiene un proprio ID video su ogni Pagina.

Quanto costa easyCoexistence per una Pagina Facebook?

Da US$ 9 a US$ 0,75 per connessione al mese, in base al numero totale di connessioni, con i primi 3 giorni di prova gratuita. Ogni Pagina è una connessione.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il