グラフAPIバージョン

このエッジは廃止され、今後は使用できません。

イベント動画/{event-id}/videos

このエンドポイントを使って、動画をイベントに公開します。既存の動画を削除または更新する場合は、代わりに/{video-id}ノードを使ってください。

作成

動画をイベントに公開するには、graph-video.facebook.comの/{event-id}/videosエッジにPOSTリクエストを送信してください。

POST /v26.0/{event-id}/videos HTTP/1.1
Host: graph-video.facebook.com

source=%7Bvideo-data%7D
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{event-id}/videos',
    array (
      'source' => '{video-data}',
    ),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{event-id}/videos",
    "POST",
    {
        "source": "{video-data}"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
Bundle params = new Bundle();
params.putString("source", "{video-data}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{event-id}/videos",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
NSDictionary *params = @{
  @"source": @"{video-data}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{event-id}/videos"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

制限

  • 動画はmultipart/form-dataとしてエンコーディングする必要があります。
  • 動画をマルチパートHTTPリクエストとしてアップロードする場合や、URLを入力してアップロードする場合、その動画のサイズは1GBを超えてはならず、長さは20分を超えてはなりません。
  • 再開可能な動画アップロードのサイズは最大1.75GBで、長さは最大45分です。

サポートされているフォーマット

3g2、3gp、3gpp、asf、avi、dat、divx、dv、f4v、flv、m2ts、m4v、mkv、mod、mov、mp4、mpe、mpeg、mpeg4、mpg、mts、nsv、ogm、ogv、qt、tod、ts、vob、wmv。

アクセス許可

2018年4月24日以降、pubish_actionsアクセス許可は廃止されています。詳しくは重要な変更の更新履歴をご覧ください。アプリユーザーがFacebookにコンテンツをシェアできるようにするため、代わりにMetaのシェア製品を使うことをおすすめします。

このエンドポイントには、publish_actionsアクセス許可を持つユーザーアクセストークンが必要です。

フィールド

名前 説明 型

id

動画の投稿先 ID。

numeric string

title

動画のタイトル。

string

description

動画の説明。フィードストーリーのステータスメッセージとして使われます。次の構文を使って、このパラメーターに他のFacebookページのメンションを含めることができます。

@[page-id]

例えば、次の説明には、Facebook Developersページへのメンションが含められます。

Test message @[19292868552] tag

この機能の使用方法はレビュー対象ですが、(API呼び出しを行うこと、メンションで使うことの両方を目的とした)自分が管理者であるページと、自分が開発者であるアプリを使うことで、レビュー前に自分でこの機能をテストすることができます。

string

source

フォームデータとしてエンコーディングされる動画。このフィールドは必須です。

multipart/form-data

file_url

動画ファイルのアクセス可能なURL。upload_phaseと併用することはできません。

string

thumb

アップロードして動画に関連付けられる、動画サムネイルの未加工データ。

image

upload_phase

分割されたアップロードリクエストのタイプ。

enum{start, transfer, finish}

file_size

動画ファイル全体のサイズ(バイト単位)。

unsigned int32

start_offset

ファイルチャンクの開始バイト位置。

unsigned int32

video_file_chunk

フォームデータとしてエンコーディングされる動画ファイルチャンク。このフィールドは、transferアップロードフェーズで必須です。

multipart/form-data

upload_session_id

分割されたアップロードセッションのID。

numeric string

応答

成功した場合は、次のようになります。

Struct {
  id: numeric string,
  upload_session_id: numeric string,
  video_id: numeric string,
  start_offset: numeric string,
  end_offset: numeric string,
  success: bool,
  skip_upload: bool,
}

読み取り

このエッジを使ってイベントにアップロードされた動画は読み込めません、

更新

このエッジを使ってコメントを更新することはできません。

削除

このエッジを使って削除することはできません。