Componenti
URL host
https://graph-video.facebook.com- Utilizzato esclusivamente per la pubblicazione di video su Pagine e gruppi.https://graph.facebook.com- Utilizzato per tutto il resto (creazione di sondaggi, acquisizione di dati statistici, ecc.).
Caricamento dei protocolli
L'API supporta sia protocolli di caricamento ripristinabili che non ripristinabili. Il protocollo di caricamento ripristinabile viene utilizzato per il caricamento sequenziale di porzioni di video, mentre il protocollo non ripristinabile viene utilizzato per il caricamento di video completi. È consigliabile utilizzare il protocollo di caricamento ripristinabile poiché supporta file video di dimensioni maggiori e consente di gestire le interruzioni di connessione in modo più efficiente.
Risorse
L'API utilizza i seguenti nodi.
Video
Il nodo Video è la risorsa principale dell'API. Quando carichi un video esistente, l'API genera un'entità video e la pubblica su una Pagina o un gruppo, a seconda del nodo scelto come destinazione nella fase iniziale del processo di pubblicazione. I video devono essere pubblicati su un nodo di destinazione.
Pagine
I video possono essere pubblicati su un gruppo a condizione che l'app disponga delle autorizzazioni e delle funzioni necessarie. Inoltre, l'utente dell'app deve essere in grado di eseguire attività equivalenti a un amministratore della Pagina oppure deve disporre del ruolo di amministratore sulla Pagina ricevuto tramite il Business Manager.
Gruppi
I video possono essere pubblicati su un gruppo a condizione che l'app disponga delle autorizzazioni e delle funzioni necessarie e che l'utente dell'app sia un amministratore del gruppo.
Video con cross-posting
Anche i video che sono già stati pubblicati possono essere pubblicati su altre Pagine gestite dall'utente dell'app senza dover essere ricaricati. I dati statistici sui video con cross-posting possono essere restituiti come valori aggregati (ad esempio la somma di tutte le visualizzazioni in tutte le Pagine) o suddivisi per Pagina.
Presentazioni
Puoi utilizzare l'API per generare un video di presentazione da una raccolta di immagini ospitate su un server pubblico.
Sondaggi
Puoi utilizzare l'API per creare sondaggi sui video pubblicati e ottenere i risultati.
Inserzioni
I video pubblicati possono essere utilizzati con l'endpoint Ad Creative dell'API Marketing per creare inserzioni video.
Dati statistici
Puoi acquisire dati statistici su qualsiasi video pubblicato. I dati statistici per i video con cross-posting possono essere restituiti come valori aggregati o suddivisi per Pagina.
Webhooks
Per i video pubblicati sulle Pagine, puoi ricevere notifiche in tempo reale sulle modifiche allo stato di pubblicazione di un video e sulle interazioni del pubblico impostando Webhook per le Pagine. Configura una callback e attiva l'iscrizione ai campi feed e videos dell'argomento della Pagina per ricevere notifiche. Tieni conto che non viene inviata alcuna notifica per i video caricati come secret o no_story.
Gestione dei diritti
Per i video pubblicati su una Pagina, puoi utilizzare l'API Rights Management per creare e applicare regole di copyright in modo da scoprire eventuali altri video pubblicati in violazione di tali regole e segnalarli.
Requisiti
Autorizzazioni
Per pubblicare su una Pagina, l'utente dell'app deve concedere all'app le autorizzazioni pages_show_list, pages_read_engagement e pages_manage_posts.
Per pubblicare su un gruppo, l'utente dell'app deve concedere all'app l'autorizzazione publish_to_groups.
Funzioni
Non sono richieste funzioni particolari per la pubblicazione su una Pagina. Per pubblicare su un gruppo, la tua app deve essere approvata per la funzione API Groups.
Ruolo amministratore
L'utente dell'app deve essere in grado di eseguire l'equivalente di attività ADMIN nella Pagina di destinazione o essere un amministratore del gruppo di destinazione.
Analisi dell'app
Tutte le autorizzazioni e le funzioni richiedono l'Analisi dell'app.
Funzionamento
Il flusso generale per la pubblicazione di un video su una Pagina o un gruppo è il seguente:
- Ottenere un token d'accesso e le autorizzazioni appropriate dall'utente dell'app.
- Ottenere una lista di Pagine o gruppi su cui l'utente dell'app è in grado di eseguire attività equivalenti a un amministratore.
- Fornire un modo all'utente dell'app per selezionare la Pagina o il gruppo in cui desidera che venga mostrato il video.
- Fornire un modo all'utente dell'app per selezionare un video da pubblicare.
- Suddividere il video in porzioni più piccole.
- Inizializzare una sessione di caricamento e caricare le singole porzioni.
- Terminare la sessione di caricamento.