動映像 스토리
Facebook 페이지에 動映像 스토리를 揭示하려면, Meta 서버로 動映像 업로드 세션을 初期化하고 Meta 서버에 動映像을 업로드한 다음 動映像 스토리를 揭示합니다.
1段階: 세션 初期化
업로드 세션을 初期化하려면
/page_id/video_stories
엔드포인트로
POST
要請을 보냅니다. 이때
page_id
는 Facebook 페이지의 ID이며
upload_phase
媒介變數는
start
로 設定합니다.
要請 例示
curl -X POST "https://graph.facebook.com/
v20.0
/page_id
/video_stories" \
-d '{
"upload_phase":"start",
}'
要請에 成功하면 앱이 動映像 ID와 動映像을 업로드할 Facebook URL을 包含한 JSON 應答을 받게 됩니다.
應答 例示
{
"video_id": "
video_id
",
"upload_url": "https://rupload.facebook.com/video-upload/
v20.0
/video_id
",
}
2段階: 動映像 업로드
업로드 세션을 初期化하고 업로드 URL을 받았으므로 이제 動映像을 업로드할 수 있습니다. 다음 中 한 가지를 업로드할 수 있습니다.
호스팅된 파일 업로드
호스팅된 파일을 업로드하려면 다음 媒介變數를 包含하여
初期化 段階
에서 받은
upload_url
엔드포인트로
POST
要請을 보냅니다.
要請 例示
curl -X POST "https://rupload.facebook.com/video-upload/
v20.0
/video_id
" \
-H "file_url:
https://some.cdn.url/video.mp4
"
로컬 파일 업로드
로컬 파일을 업로드하려면 다음 媒介變數를 包含하여
初期化 段階
에서 받은
upload_url
엔드포인트로
POST
要請을 보냅니다.
要請 例示
curl -X POST "https://rupload.facebook.com/video-upload/
v20.0
/video_id
" \
-H "offset: 0" \
-H "file_size:
file_size_in_bytes
" \
--data-binary "@
/path/to/file/my_video_file.mp4
"
업로드에 成功하면 앱은
success
가
true
로 設定된 JSON 應答을 받게 됩니다.
업로드 應答 例示
{
"success": true
}
中斷된 업로드
動映像 업로드가 中斷된 境遇 업로드를 다시 始作하거나 끊어진 部分부터 再開할 수 있습니다.
업로드 狀態 가져오기
업로드나 揭示 中에 動映像 狀態를 確認하려면 다음 媒介變數를 包含하여
/video_id
엔드포인트로
GET
要請을 보내세요.
要請 例示
curl -X GET "https://graph.facebook.com/
v20.0
/video_id
" \
-d "fields=status"
要請에 成功하면 앱은 다음을 包含한 JSON 應答을 받게 됩니다.
應答 例示
다음 應答은 成功的으로 업로드된 파일을 보여줍니다.
{
"status": {
"video_status": "processing",
"uploading_phase": {
"status": "in_progress",
"bytes_transfered": 50002
},
"processing_phase": {
"status": "not_started"
}
"publishing_phase": {
"status": "not_started",
"publish_status": "published",
"publish_time": 234523452
}
}
}
|
다음 應答은 處理 段階에서 發生한 誤謬를 보여줍니다.
{
"status": {
"video_status": "processing",
"uploading_phase": {
"status": "complete"
},
"processing_phase": {
"status": "not_started",
"error": {
"message": "Resolution too low. Video must have a minimum resolution of 540p."
}
}
"publishing_phase": {
"status": "not_started"
}
}
}
|
3段階. 動映像 스토리 揭示
動映像 스토리를 페이지에 揭示하려면 다음 媒介變數를 包含하여
/page_id
/video_stories
엔드포인트로
POST
要請을 보냅니다.
要請 例示
curl -X POST "https://graph.facebook.com/
v20.0
/page_id
/video_stories" \
-d '{
"video_id": "
video_id
",
"upload_phase": "finish"
}'
要請에 成功하면 앱이 다음 키-값 雙을 包含하는 JSON 應答을 받게 됩니다.
true
로 設定된
success
스토리 揭示物의 ID로 設定된
post_id
應答 例示
{
"success": true,
"post_id": 1234
}
