API de video

API de Rights Manager

La API de Rights Manager permite a los editores solicitar la propiedad de los derechos de autor de videos y administrar reglas de coincidencia de derechos de autor con dos nuevos extremos: el extremo video_copyright_rule y el extremo video_copyright.

Permisos

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

Registrar los derechos de autor de un video

La API de Rights Manager solo se puede aplicar a los videos 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 video, es imprescindible crear contenido de este tipo en una página de Facebook. Los videos se pueden crear con la API de subida de video o la API de video en vivo.

Para los videos, sigue estos pasos:

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

Para los videos en vivo, sigue estos pasos:

  1. Crea un objeto "live_video" y obtén el identificador del video en vivo.
  2. Usa la API de Rights Manager para registrar los derechos de autor correspondientes de este video en vivo.
  3. Empieza a transmitir con el software de transmisión.

Videos solo de referencia

Si el video se usará solo como video de referencia y no para su consumo o distribución en Facebook, debes subirlo con el parámetro "reference_only". Asimismo, se debe realizar una llamada a la API de Rights Manager con el parámetro is_reference_video. Si transmitirás, asegúrate de realizar una llamada a Rights Manager con "is_reference_video" antes de iniciar el proceso. El video o el video en vivo no aparecerán en la videoteca y solo el administrador podrá verlo en la sección "Archivos de referencia" de la herramienta de Rights Manager.

Información sobre 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 un reporte de derechos de autor y qué medidas deberían tomarse en tal caso.

  • Extremo video_copyright: Este extremo permite registrar los derechos de autor de un video en concreto. También puedes especificar la propiedad de los derechos de autor y aplicar una regla a dicho caso.

El extremo video_copyright_rule

El extremo video_copyright_rule permite crear reglas de derechos de autos que determinan qué acciones se deben llevar a cabo en los videos que coincidan con dichas reglas. Por ejemplo, como propietario de los derechos de autor, puedes crear una regla que permita el uso de tu video durante menos de tres minutos.

Existen distintos tipos de condiciones:

  • GEO: Determina si el video está disponible en una ubicación determinada. Por ejemplo, si el video puede mostrarse en el Reino Unido y la condición geográfica especificada es "Reino Unido y Estados Unidos", se considera que el video cumple la condición indicada.
  • OVERLAP_DURATION: Determina durante cuánto tiempo se produce la coincidencia (más o menos de dos a tres minutos, por ejemplo).
  • MATCH_OVERLAP_PERCENTAGE: Determina el porcentaje de coincidencias del video (un porcentaje superior o inferior al 20% del video, 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 video, el audio o ambos elementos coinciden.
  • PUBLISHER_TYPE: Indica si el video coincidente es propiedad de una página, un perfil o cualquiera de los dos.
  • PRIVACY: Determina si el video coincidente era o no era público, o cualquiera de los dos. Los videos que no son públicos tienen un público limitado. Por ejemplo, un video no es público si solo pueden verlo los amigos de una persona o un grupo.

Hay cuatro tipos de acción disponibles:

  • TRACK: Esta acción te permite realizar el seguimiento del video coincidente, sin llevar a cabo ninguna acción en él. Más adelante también podrás ver estadísticas del video coincidente.
  • MONETIZE: Esta acción te permite compartir los ingresos publicitarios que genera un video. Para ello, debes configurar los pagos. Puedes hacerlo desde la sección "Rights Manager" de la configuración de la página.
  • BLOCK: Si bloqueas un video, no se podrá ver en ninguna de las configuraciones geográficas en las que seas el propietario 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 video 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 al perímetro video_copyright_rules de la ruta siguiente: 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 video en vivo realizando una solicitud DELETE /video_copyright_rule_id.

El extremo video_copyright

El extremo video_copyright te permite especificar el video para el que quieres registrar los derechos de autor. Desde este extremo, puedes agregar a otros usuarios o a otras páginas a la lista blanca para que puedan usar el video de referencia. Por ejemplo, si tienes tres páginas y quieres registrar los derechos de autor de un determinado video para que se pueda reproducir en todas tus páginas, puedes especificarlas en esta lista.

Crear un extremo video_copyright

Puedes realizar una solicitud POST al perímetro video_copyrights desde las rutas siguientes: /{page_id}/video_copyrights

** En este ejemplo, ten en cuenta que 576425449198708 es el identificador del video que hace referencia al video 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"}

Para el video que elijas, puedes realizar una consulta del campo "copyright" para obtener más información sobre el nodo video_copyright.

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 de extremos de derechos de autor de videos.