API de Vídeo

API do Rights Manager

A API do Rights Manager permite que os publishers reivindiquem direitos autorais sobre vídeos e gerenciem regras de correspondência de direitos autorais com dois novos pontos de extremidade: video_copyright_rule e video_copyright.

Permissões

Para usar esta API, você precisará solicitar acesso à ferramenta Rights Manager (é necessário fazer login no Facebook para usar a ferramenta). Para saber mais sobre o Rights Manager, confira a página rightsmanager.fb.com.

Direitos autorais de vídeo

A API do Rights Manager pode ser aplicada apenas a vídeos em páginas. Todas as páginas precisam passar pelo processo de inscrição para poder usar a API.
Antes de obter os direitos autorais do vídeo, você deve criar conteúdo de vídeo em uma Página do Facebook. Isso pode ser feito por meio da API de carregamento de vídeo ou API de vídeo ao vivo.

Para vídeos, as etapas são:

  1. Carregue um vídeo no Facebook e obtenha a identificação do vídeo.
  2. Use a API do Rights Manager para obter os direitos autorais do vídeo.

Para vídeos ao vivo, as etapas são:

  1. Crie um objeto live_video e obtenha uma identificação de vídeo ao vivo.
  2. Use a API do Rights Manager para obter os direitos autorais do vídeo ao vivo.
  3. Comece a fazer um streaming usando seu software de streaming.

Somente para consulta

Se o vídeo deve ser usado apenas como um vídeo de referência, e não para consumo e distribuição no Facebook, ele deve ser carregado usando o parâmetro “reference_only” e a API do Rights Manager precisa ser chamada usando o parâmetro is_reference_video. Para fazer um streaming, basta chamar o Rights Manager com “is_reference_video” antes de começar o stream. O vídeo ou vídeo ao vivo não aparecerá na sua Biblioteca de Vídeos e estará visível apenas para o administrador, na seção Arquivos de referência da ferramenta Rights Manager.

Como entender os pontos de extremidade video_copyright_rule e video_copyright

  • Ponto de extremidade video_copyright_rule: este ponto de extremidade permite criar uma regra de direitos autorais. Por exemplo, você pode determinar sob quais tipos de condições um relatório de direitos autorais deve ser acionado e qual tipo de ação deve ser realizada.

  • Ponto de extremidade video_copyright: você pode usar este ponto de extremidade para obter direitos autorais de um vídeo específico. Você também pode especificar a propriedade dos direitos autorais e aplicar uma regra de direitos autorais aqui.

Ponto de extremidade video_copyright_rule

O ponto de extremidade video_copyright_rule permite criar regras de direitos autorais que determinam quais ações realizar em um vídeo que corresponde a essas regras. Por exemplo, você como proprietário do direito pode criar uma regra de direitos autorais que permite o uso de seu vídeo por menos de três minutos.

Há vários tipos de condições:

  • GEO: determina se o vídeo está disponível em um determinado local. Por exemplo, se um vídeo pode ser visualizado no Reino Unido e a condição geográfica é “Reino Unido e EUA”, o vídeo cumpre a condição.
  • OVERLAP_DURATION: determina por quanto tempo a correspondência ocorre (por exemplo, mais ou menos do que dois ou três minutos).
  • MATCH_OVERLAP_PERCENTAGE: determina qual é o percentual de correspondência do vídeo com correspondência (por exemplo, mais ou menos do que 20% do vídeo com correspondência).
  • REFERENCE_OVERLAP_PERCENTAGE: determina qual é o percentual do seu arquivo de referência (por exemplo, mais ou menos do que 50%).
  • MONITORING_TYPE: determina se o vídeo, o áudio ou ambos são correspondentes.
  • PUBLISHER_TYPE: indica se o vídeo correspondente é proveniente de uma Página, de um perfil ou de ambos.
  • PRIVACY: determina se o vídeo correspondente era público, não público ou ambos. Vídeos não públicos têm um público limitado. Por exemplo, um vídeo que é visível para um amigo de uma pessoa ou para um grupo é não público.

Há quatro tipos de ação disponíveis:

  • TRACK: esta ação permite acompanhar o vídeo com correspondência sem realizar nenhuma ação nele. No futuro, você também poderá ver informações sobre o vídeo com correspondência.
  • MONETIZE: esta ação permite compartilhar a receita do anúncio que um vídeo gera. Exige que você configure Pagamentos, que pode ser feito na seção do Rights Manager das Configurações da Página.
  • BLOCK: bloquear um vídeo significa que ele não estará visível em nenhuma região geográfica atribuída à sua propriedade.
  • MANUAL_REVIEW: esta ação enviará a correspondência para a seção Revisão manual do Rights Manager, para que você possa aplicar manualmente uma ação no vídeo correspondente. As correspondências na seção da sua revisão manual expirarão em 30 dias.

Como criar uma regra de direitos autorais

Você pode criar uma regra de direitos autorais fazendo uma solicitação POST à borda video_copyright_rules no seguinte caminho: 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"]}]}]'

Como ler uma regra de direitos autorais

Emita GET /video_copyright_rule_id request para obter mais informações sobre a regra de direitos autorais.

** Observe neste exemplo que 576407315867188 é o ID da regra de direitos autorais.

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

Como excluir uma regra de direitos autorais

Você pode excluir um vídeo ao vivo fazendo uma solicitação DELETE /video_copyright_rule_id.

Ponto de extremidade video_copyright

O ponto de extremidade video_copyright permite especificar de quais vídeos você deseja obter os direitos autorais. Neste ponto de extremidade, você pode adicionar outras páginas ou usuários à lista de liberação para usar o vídeo de referência. Por exemplo, se você tem três páginas e deseja obter os direitos autorais de um determinado vídeo para poder reproduzir em todas as suas páginas, é possível especificar essas páginas na lista de liberação.

Como criar um ponto de extremidade video_copyright

Você pode criar uma solicitação POST para a borda video_copyrights pelos seguintes caminhos: /{page_id}/video_copyrights

** Observe neste exemplo que 576425449198708 é o ID que representa o vídeo do qual você quer obter os direitos autorais.

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 qualquer vídeo específico, você pode consultar o campo “copyright” para obter mais informações sobre o nó video_copyright.

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

Os recursos Atualizar, Ler e Excluir também estão disponíveis para o ponto de extremidade video_copyright. Para obter mais informações, consulte a documentação do ponto de extremidade de direitos autorais de vídeo.