Rights Manager API

퍼블리셔는 Rights Manager API를 사용하여 동영상 저작권의 소유권을 주장하고 video_copyright_rule 엔드포인트와 video_copyright 엔드포인트로 저작권에 관한 일치 규칙을 관리할 수 있습니다.

권한

이 API를 사용하려면 Rights Manager 도구에 대한 액세스를 신청해야 합니다(이 도구를 사용하려면 Facebook에 로그인해야 합니다). rightsmanager.fb.com에서 Rights Manager에 대해 자세히 알아볼 수 있습니다.

동영상 저작권 등록

Rights Manager API는 페이지에 게시된 동영상에만 적용할 수 있습니다. API를 사용할 수 있는 자격 요건을 충족하려면 모든 페이지에서 등록 절차를 완료해야 합니다.
동영상에 대한 저작권을 등록하려면 먼저 Facebook 페이지에서 동영상 콘텐츠를 만들어야 합니다. 이 작업은 동영상 업로드 API 또는 라이브 방송 API를 사용하여 완료할 수 있습니다.

동영상의 저작권을 등록하려면 다음 단계를 따르세요.

Facebook에 동영상을 업로드하고 동영상 ID를 얻습니다.
Rights Manager API를 사용하여 동영상의 저작권을 등록합니다.

라이브 방송의 저작권을 등록하려면 다음 단계를 따르세요.

live_video 개체를 만들고 라이브 방송 ID를 얻습니다.
Rights Manager API를 사용하여 라이브 방송의 저작권을 등록합니다.
스트리밍 소프트웨어를 사용하여 스트리밍을 시작합니다.

참조용으로만 사용

동영상을 Facebook에서 소비 및 배포를 위한 용도가 아닌참조용으로만 사용해야 하는 경우 해당 동영상은 'reference_only' 매개변수를 사용하여 업로드해야 하며 is_reference_video 매개변수를 사용하여 Rights Manager API를 호출해야 합니다. 스트리밍하기 전에 'is_reference_video'를 사용하여 Rights Manager를 호출했는지 확인하세요. 동영상 또는 라이브 방송은 동영상 라이브러리에 표시되지 않으며 관리자만 Rights Manager 도구의 참조 파일 섹션에서 볼 수 있습니다.

`video_copyright_rule` 및 `video_copyright` 엔드포인트에 대한 이해

video_copyright_rule 엔드포인트: 이 엔드포인트를 사용하여 저작권 규칙을 만들 수 있습니다. 예를 들어 어떤 조건에서 저작권 신고를 트리거해야 하는지 및 어떤 행동을 취해야 하는지 결정할 수 있습니다.
video_copyright 엔드포인트: 이 엔드포인트를 사용하여 특정 동영상의 저작권을 등록할 수 있습니다. 여기에서 저작권 소유권을 지정하고 저작권 규칙을 적용할 수도 있습니다.

`video_copyright_rule` 엔드포인트

video_copyright_rule 엔드포인트를 통해 저작권 규칙을 만들어 해당 규칙과 일치하는 동영상에 대해 취할 행동을 결정할 수 있습니다. 예를 들어 저작권 소유자는 동영상을 3분 미만까지만 사용할 수 있도록 허용하는 저작권 규칙을 만들 수 있습니다.

조건의 유형은 다음과 같습니다.

GEO: 특정 위치에서 동영상을 사용할 수 있는지 결정합니다. 예를 들어 지역 조건이 '영국 및 미국'으로 설정된 동영상이 영국에서 조회되는 경우 해당 동영상은 조건을 충족하게 됩니다.
OVERLAP_DURATION: 일치 길이를 결정합니다(예: 2~3분 초과 또는 미만).
MATCH_OVERLAP_PERCENTAGE: 일치하는 동영상의 일치율을 결정합니다(예: 일치하는 동영상의 20% 초과 또는 미만).
REFERENCE_OVERLAP_PERCENTAGE: 참조 파일의 일치율을 결정합니다(예: 50% 초과 또는 미만).
MONITORING_TYPE: 동영상, 오디오 또는 두 가지 모두의 일치 여부를 모니터링할지 결정합니다.
PUBLISHER_TYPE: 일치하는 동영상이 페이지 또는 프로필의 소유인지를 나타냅니다.
PRIVACY: 일치하는 동영상의 공개 범위(예: 공개 또는 비공개)를 결정합니다. 비공개 동영상은 공개 범위가 제한된 동영상을 말합니다. 예를 들어 사용자의 친구 또는 그룹이 볼 수 있는 동영상은 비공개 동영상입니다.

4가지 행동 유형은 다음과 같습니다.

TRACK: 아무런 행동을 취하지 않고 일치하는 동영상을 추적할 수 있습니다. 앞으로 일치하는 동영상의 인사이트도 볼 수 있습니다.
MONETIZE: 동영상에서 발생한 광고 수익을 배분할 수 있습니다. 이 행동을 취하기 전에 결제를 설정해야 하며 페이지 설정의 Rights Manager 섹션에서 설정할 수 있습니다.
BLOCK: 동영상을 차단하면 모든 지역에서 동영상을 볼 수 없습니다.
MANUAL_REVIEW: 이 행동 유형을 사용하면 Rights Manager의 수동 검토 섹션에 일치 동영상을 전송하여 일치하는 동영상에 적용할 행동을 직접 선택할 수 있습니다. 수동 검토 섹션의 일치 동영상은 30일 후 만료됩니다.

저작권 규칙 만들기

POST/{pageid}/video_copyright_rules 경로에서 video_copyright_rules 에지에 POST 요청을 전송하여 저작권 규칙을 만들 수 있습니다.

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

저작권 규칙 읽기

GET /video_copyright_rule_id request를 보내 저작권 규칙에 대한 자세한 정보를 알아보세요.

** 이 예시의 576407315867188은 저작권 규칙 ID입니다.

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

저작권 규칙 삭제

DELETE /video_copyright_rule_id 요청을 하여 라이브 방송을 삭제할 수 있습니다.

`video_copyright` 엔드포인트

video_copyright 엔드포인트를 사용하여 저작권을 등록할 동영상을 지정할 수 있습니다. 이 엔드포인트에서 다른 페이지 또는 사용자를 화이트리스트에 추가하여 참조 동영상을 사용할 수 있습니다. 예를 들어 3개의 페이지를 보유하고 있으며, 모든 페이지에서 조회할 수 있는 특정 동영상의 저작권을 등록하려는 경우 화이트리스트에 해당 페이지를 추가할 수 있습니다.

`video_copyright` 엔드포인트 만들기

/{page_id}/video_copyrights 경로에서 video_copyrights 에지에 POST 요청을 전송할 수 있습니다.

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

모든 동영상에 대해 'copyright' 필드를 쿼리하여 video_copyright 노드에 대한 자세한 정보를 확인할 수 있습니다.

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