구성 요소
호스트 URL
https://graph-video.facebook.com— 페이지와 그룹에 동영상을 게시하는 데만 사용합니다.https://graph.facebook.com— 그 외의 모든 용도로 사용합니다(예: 설문조사 만들기, 인사이트 가져오기 등).
업로드 프로토콜
이 API는 재개 가능 업로드 프로토콜과 재개 불가능 업로드 프로토콜을 모두 지원합니다. 재개 가능 업로드 프로토콜은 동영상 청크를 순차적으로 업로드하는 데 사용하고 재개 불가능 프로토콜은 전체 동영상을 업로드하는 데 사용합니다. 재개 가능 업로드 프로토콜은 더 큰 용량의 동영상 파일을 지원하고 연결 중단을 더욱 효율적으로 처리할 수 있으므로 이를 사용하는 것이 좋습니다.
참고 자료
API는 다음과 같은 노드를 사용합니다.
동영상
동영상 노드는 API의 기본 리소스입니다. 기존 동영상을 업로드하면 API가 동영상 엔터티를 생성하고 게시 절차를 시작할 때 어떤 노드를 대상으로 삼았는지에 따라 페이지 또는 그룹에 게시합니다. 동영상을 타겟 노드에 게시해야 합니다.
페이지
앱에 적절한 권한과 기능이 있으면 그룹에 동영상을 게시할 수 있습니다. 또한 앱 사용자는 페이지에서 관리자와 동등한 작업을 수행할 수 있거나 비즈니스 관리자를 통해 페이지에 대한 관리자 역할을 부여받았어야 합니다.
그룹
앱에 적절한 권한과 기능이 있고 앱 사용자가 그룹 관리자이면 그룹에 동영상을 게시할 수 있습니다.
교차 게시 동영상
이미 게시된 동영상을 다시 업로드하지 않고도 앱 사용자가 관리하는 다른 페이지에 게시할 수 있습니다. 교차 게시 동영상에 대한 인사이트는 집계된 값(예: 모든 페이지의 모든 조회수 합계) 또는 페이지별 분석 데이터로 반환될 수 있습니다.
슬라이드쇼
API를 사용하여 공개 서버에서 호스팅되는 이미지 컬렉션에서 슬라이드쇼 동영상을 생성할 수 있습니다.
설문
API를 사용하여 게시된 동영상에 대한 설문을 만들고 결과를 가져올 수 있습니다.
광고
게시된 동영상은 마케팅 API의 광고 크리에이티브 엔드포인트와 함께 사용하여 동영상 광고를 만들 수 있습니다.
인사이트
게시된 모든 동영상에 대한 인사이트를 가져올 수 있습니다. 교차 게시 동영상에 대한 인사이트는 집계된 값 또는 페이지별 분석 데이터로 반환될 수 있습니다.
Webhooks
페이지에 게시된 동영상의 경우, 페이지 Webhooks를 설정하면 동영상 게시 상태 및 시청자 상호작용 변경에 대한 실시간 알림을 받을 수 있습니다. 알림을 수신하려면 콜백을 설정하고 페이지 주제의 feed와 videos 필드를 받아봅니다. secret 또는 no_story로 업로드된 동영상에 대해서는 알림이 전송되지 않습니다.
권리 관리
페이지에 게시된 동영상의 경우, 권리 관리 API를 사용하여 저작권 규칙을 만들고 적용하면 규칙을 위반한 다른 게시된 동영상을 발견하고 신고할 수 있습니다.
요구 사항
권한
페이지에 게시하려면 앱 사용자가 앱에 pages_show_list, pages_read_engagement, pages_manage_posts 권한을 부여해야 합니다.
그룹에 게시하려면 앱 사용자가 앱에 publish_to_groups 권한을 부여해야 합니다.
기능
페이지에 게시하는 데는 기능이 필요하지 않습니다. 그룹에 게시하려면 앱이 그룹 API 기능에 대한 승인을 받아야 합니다.
관리자 역할
앱 사용자는 대상 페이지에 ADMIN 작업과 동등한 작업을 수행할 수 있거나 대상 그룹의 관리자여야 합니다.
앱 검수
모든 권한과 기능은 앱 검수가 필요합니다.
원리
페이지 또는 그룹에 동영상을 게시하기 위한 일반 플로는 다음과 같습니다.
- 앱 사용자로부터 액세스 토큰과 적절한 권한을 받습니다.
- 앱 사용자가 관리자와 동등한 권한의 작업을 수행할 수 있는 페이지 또는 그룹 리스트를 가져옵니다.
- 앱 사용자가 동영상을 게시하고자 하는 페이지 또는 그룹을 선택할 수단을 제공합니다.
- 앱 사용자가 게시할 동영상을 선택할 수단을 제공합니다.
- 동영상을 더 작은 청크로 분할합니다.
- 업로드 세션을 시작하고 각 청크를 업로드합니다.
- 업로드 세션을 종료합니다.