API Video

API Rights Manager

L'API Rights Manager consente agli editori di richiedere la proprietà del copyright per i video e gestirne le regole di corrispondenza con due nuovi endpoint: video_copyright_rule e video_copyright.

Autorizzazioni

Per utilizzare questa API, devi richiedere l'accesso allo strumento Gestione della proprietà intellettuale (per utilizzare questo strumento, devi aver effettuato l'accesso a Facebook). Per maggiori informazioni e per scoprire di più su Rights Manager, visita rightsmanager.fb.com.

Copyright dei video

L'API Rights Manager può essere applicata solo ai video nelle Pagine. Tutte le Pagine devono eseguire il processo di iscrizione per poter utilizzare l'API.
Prima di poter tutelare i video con il diritto d'autore, devi creare contenuti video su una Pagina Facebook. Puoi farlo con l'API Video Upload o l'API Live Video.

La procedura per i video è la seguente:

  1. Carica un video su Facebook e ottieni il relativo ID.
  2. Usa l'API Rights Manager per tutelare i video con il diritto d'autore.

La procedura per i video in diretta è la seguente:

  1. Crea un oggetto live_video e ottieni l'ID del video in diretta.
  2. Usa l'API Rights Manager per tutelare i video in diretta con il diritto d'autore.
  3. Avvia lo streaming con il tuo software di streaming.

Solo per riferimento

Se il video deve essere usato solo come video di riferimento e non per l'uso e la distribuzione su Facebook, caricalo usando il parametro "reference_only". Dovrai chiamare l'API Rights Manager usando il parametro is_reference_video. In caso di streaming, assicurati di chiamare Rights Manager con "is_reference_video" prima dell'avvio dello streaming. Il video o il video in diretta non verrà visualizzato nella tua Libreria video e sarà visualizzabile solo dall'amministratore, nella sezione File di riferimento dello strumento Rights Manager.

Informazioni sugli endpoint video_copyright_rule e video_copyright

  • Endpoint video_copyright_rule: questo endpoint ti consente di creare una regola di copyright. Ad esempio, puoi determinare quale tipo di condizione attiva una segnalazione sul copyright e quale tipo di azione occorre intraprendere.

  • Endpoint video_copyright: puoi usare questo endpoint per applicare il copyright a un video specifico. Puoi anche specificare la proprietà del copyright e applicare una relativa regola.

Endpoint video_copyright_rule

L'endpoint video_copyright_rule ti consente di creare regole di copyright per determinare le azioni da intraprendere per i video che vi corrispondono. Ad esempio, in qualità di proprietario dei diritti, puoi creare una regola di copyright che consente l'uso del tuo video per meno di 3 minuti.

Esistono diversi tipi di condizioni:

  • GEO: determina se il video è disponibile in un determinato luogo. Ad esempio, se è possibile visualizzare un video nel Regno Unito e la condizione geografica è "Regno Unito e Stati Uniti", il video soddisfa la condizione.
  • OVERLAP_DURATION: determina la durata della corrispondenza (ad es. più o meno di 2 o 3 minuti).
  • MATCH_OVERLAP_PERCENTAGE: determina la percentuale di corrispondenza del video corrispondente (ad es. superiore o inferiore del 20% del video corrispondente).
  • REFERENCE_OVERLAP_PERCENTAGE: determina la percentuale di corrispondenza del file di riferimento (ad es. superiore o inferiore al 50%).
  • MONITORING_TYPE: determina se video, audio o entrambi corrispondono.
  • PUBLISHER_TYPE: indica se il video per cui sono state trovate corrispondenze appartiene a una Pagina, a un profilo o a entrambi.
  • PRIVACY: determina se il video per cui sono state trovate corrispondenze era pubblico, privato o altro. I video non pubblici presentano un pubblico con restrizioni. Ad esempio, un video che è visibile agli amici di una persona o in un gruppo non pubblico.

Sono previsti quattro tipi di azioni disponibili:

  • TRACK: questa azione ti consente di tenere traccia dei video corrispondenti senza intraprendere azioni in merito. In futuro, potrai anche visualizzare dati statistici sui video corrispondenti.
  • MONETIZE: questa azione ti consente la condivisione nei ricavi pubblicitari generati da un video. Devi configurare Pagamenti (puoi effettuare l'operazione dalla sezione Rights Manager delle impostazioni della Pagina).
  • BLOCK: bloccando un video, questo non sarà visualizzabile nelle aree geografiche in cui ne sei proprietario.
  • MANUAL_REVIEW: l'azione invia la corrispondenza alla sezione Analisi manuale di Rights Manager consentendoti di applicare un'azione al video corrispondente in modo manuale. Le corrispondenze nella sezione di analisi manuale scadono dopo 30 giorni.

Creazione di una regola di copyright

Puoi creare una regola di copyright effettuando una richiesta POST al segmento video_copyright_rules nel seguente percorso: POST/{pageid}/video_copyright_rules.

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyright_rules' \
 -F 'access_token=XXXXXXXX' \
 -F 'name="testrule"' \
 -F 'condition_groups=[{action:"MANUAL_REVIEW",conditions:[{type:"MONITORING_TYPE",operator:"IS",value:"VIDEO_ONLY"},{type:"OVERLAP_DURATION",operator:"LESS_THAN",value:120000},{type:"GEO",operator:"IN_SET",value:["AR","AU"]}]}]'

Lettura di una regola di copyright

Invia GET /video_copyright_rule_id request per ottenere maggiori informazioni sulla regola di copyright.

** Tieni presente che nell'esempio, 576407315867188 è l'ID della regola di copyright.

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?&access_token=XXXXXXXX' \

Eliminazione di una regola di copyright

Puoi eliminare un video in diretta effettuando una richiesta DELETE /video_copyright_rule_id.

Endpoint video_copyright

L'endpoint video_copyright ti consente di specificare a quale video intendi applicare il copyright. Da questo endpoint, puoi aggiungere alla whitelist altre Pagine o utenti per l'uso del video di riferimento. Ad esempio, se hai 3 Pagine e vuoi applicare il copyright a un determinato video per riprodurlo su tutte, puoi specificare quelle Pagine nella whitelist.

Creazione di un endpoint video_copyright

Puoi effettuare una richiesta POST al segmento video_copyrights dai seguenti percorsi: /{page_id}/video_copyrights

** Tieni presente che nell'esempio, 576425449198708 è l'ID del video che indica il video a cui applicare il copyright.

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyrights' \
-F  'access_token=XXXXXXXX' \
-F  'copyright_content_id=576425449198708' \
-F  'is_reference_video=true' \
-F  'monitoring_type=VIDEO_ONLY' \
-F  'rule_id=576407315867188' \
-F  'whitelisted_ids=[139577256378818]' \
-F  'ownership_countries=[“us”,”ca”]' \
Return values: Video copyright id.
{"id":"576425925865327"}

Per un determinato video, puoi eseguire una query nel campo "copyright" per ottenere maggiori informazioni sul nodo video_copyright.

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?fields=copyright&access_token=XXXXXXXX' \

Le funzioni di aggiornamento, lettura ed eliminazione sono anche disponibili per l'endpoint video_copyright. Per maggiori informazioni, consulta la sezione relativa alla documentazione sull'endpoint per il copyright dei video.