API de vídeo

API de Rights Manager

La API de Rights Manager permite a los editores solicitar la titularidad de los derechos de autor de vídeos y administrar las reglas de coincidencia relativas a estos derechos con dos nuevos extremos: video_copyright_rule y video_copyright.

Permisos

Para usar esta API, deberás solicitar acceso a la herramienta de Rights Manager. Para utilizar esta herramienta, debes iniciar sesión en Facebook. Puedes obtener más información sobre Rights Manager en rightsmanager.fb.com.

Registrar los derechos de autor de un vídeo

La API de Rights Manager solo se puede aplicar a los vídeos de las páginas. Para poder usar la API, todas las páginas deben someterse al proceso de inscripción.
Para registrar los derechos de autor de un vídeo, es imprescindible crear contenido de este tipo en una página de Facebook. Los vídeos se pueden crear con las API de carga de vídeo o de vídeo en directo.

En el caso de los vídeos, estos son los pasos que se deben seguir:

  1. Sube un vídeo a Facebook y obtén su identificador.
  2. Usa la API de Rights Manager para registrar los derechos de autor correspondientes.

En el caso de los vídeos en directo, estos son los pasos que se deben seguir:

  1. Crea un objeto “live_video” y obtén su identificador.
  2. Usa la API de Rights Manager para registrar los derechos de autor correspondientes.
  3. Empieza a transmitir en directo con el software de transmisión en directo que utilices habitualmente.

Vídeos de referencia

Si el vídeo solo va a usarse como vídeo de referencia y no para su consumo y distribución en Facebook, debes subirlo con el parámetro “reference_only”; asimismo, se debe realizar una llamada a la API de Rights Manager usando el parámetro is_reference_video. Al transmitir en directo, asegúrate de realizar una llamada a Rights Manager con “is_reference_video” antes de iniciar el proceso. El vídeo o el vídeo en directo no aparecerán en tu videoteca y solo el administrador podrá ver el contenido en la sección “Archivos de referencia” de la herramienta de Rights Manager.

Funciones de los extremos video_copyright_rule y video_copyright

  • Extremo video_copyright_rule: este extremo permite crear una regla de derechos de autor. Por ejemplo, puedes determinar en qué circunstancias se debe activar una denuncia por infracción de los derechos de autor y qué medidas deberían tomarse en tal caso.

  • Extremo video_copyright: este extremo permite registrar los derechos de autor del vídeo que elijas. También puedes especificar la titularidad de los derechos de autor y aplicar una regla de derechos de autor a dicho caso.

Extremo video_copyright_rule

El extremo video_copyright_rule permite crear reglas de derechos de autor que determinan qué acciones se deben llevar a cabo en los vídeos que coincidan con dichas reglas. Por ejemplo, como titular de los derechos de autor, puedes crear una regla que permita el uso de tu vídeo durante un período inferior a los tres minutos.

Existen distintos tipos de condiciones:

  • GEO: determina si el vídeo está disponible en una ubicación determinada. Por ejemplo, si el vídeo puede mostrarse en el Reino Unido y la condición geográfica especificada es “Reino Unido y Estados Unidos”, se considera que el vídeo cumple la condición indicada.
  • OVERLAP_DURATION: determina durante cuánto tiempo se produce la coincidencia (más o menos de dos o tres minutos, por ejemplo).
  • MATCH_OVERLAP_PERCENTAGE: determina el porcentaje de correspondencia del vídeo (un porcentaje superior o inferior al 20 % del vídeo, por ejemplo).
  • REFERENCE_OVERLAP_PERCENTAGE: determina el porcentaje de coincidencia del archivo de referencia (un porcentaje superior o inferior al 50 %, por ejemplo).
  • MONITORING_TYPE: determina si el vídeo, el audio o ambos elementos coinciden.
  • PUBLISHER_TYPE: en caso de que el vídeo coincidente sea propiedad de una página, un perfil o de ambos.
  • PRIVACY: determina si el vídeo coincidente era público, no público o ambos. Los vídeos que no son públicos tienen un público limitado. Por ejemplo, un vídeo que solo es visible para los amigos de una persona o para un grupo no es público.

Hay cuatro tipos de acción disponibles:

  • TRACK: esta acción te permite realizar el seguimiento del vídeo coincidente, sin llevar a cabo ninguna acción en él. Más adelante también podrás ver estadísticas del vídeo coincidente.
  • MONETIZE: esta acción te permite recibir parte de los ingresos publicitarios que genera un vídeo. Para ello, deberás configurar los pagos. Puedes hacerlo desde la sección “Rights Manager” de la configuración de la página.
  • BLOCK: si bloqueas un vídeo, no se podrá ver en ninguna de las configuraciones geográficas en las que seas el titular de los derechos de autor correspondientes.
  • MANUAL_REVIEW: esta acción enviará la coincidencia a la sección “Revisión manual” de Rights Manager para que puedas aplicar manualmente una acción en el vídeo coincidente. Las coincidencias de la sección “Revisión manual” caducarán en un plazo de 30 días.

Crear una regla de derechos de autor

Para crear una regla de derechos de autor, realiza una solicitud POST en el extremo video_copyright_rules mediante la siguiente ruta: 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"]}]}]'

Leer una regla de derechos de autor

Emite una solicitud GET /video_copyright_rule_id request para obtener más información sobre la regla de derechos de autor.

** En este ejemplo, ten en cuenta que 576407315867188 es el identificador de la regla de derechos de autor.

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

Eliminar una regla de derechos de autor

Puedes eliminar un vídeo en directo realizando una solicitud DELETE /video_copyright_rule_id.

Extremo video_copyright

El extremo video_copyright te permite especificar el vídeo para el que quieres registrar los derechos de autor. Desde este extremo puedes añadir a la lista de autorizados otros usuarios o páginas para que puedan usar el vídeo de referencia. Por ejemplo, si dispones de tres páginas y quieres registrar los derechos de autor de un vídeo y que este se pueda reproducir en todas tus páginas, puedes especificar dichas páginas en la lista de autorizados.

Crear un extremo video_copyright

Puedes realizar una solicitud POST al extremo video_copyrights mediante la siguiente ruta: /{page_id}/video_copyrights.

** En este ejemplo, ten en cuenta que 576425449198708 es el identificador de vídeo que hace referencia al vídeo cuyos derechos de autor quieres registrar.

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"}

Puedes realizar una consulta del campo “copyright” para obtener más información sobre el nodo video_copyright de cualquier vídeo.

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

Las capacidades de actualización, lectura y eliminación también están disponibles para el extremo video_copyright. Para obtener más información, consulta la documentación sobre extremos de derechos de autor de vídeos.