Versi Graph API

Edge ini sudah dihentikan dan tidak dapat digunakan lagi.

Video Acara /{event-id}/videos

Gunakan endpoint ini untuk menerbitkan video ke acara. Untuk menghapus atau memperbarui video yang sudah ada, gunakan node /{video-id} sebagai gantinya.

Membuat

Untuk menerbitkan video ke acara, kirim permintaan POST ke edge /{event-id}/videos pada graph-video.facebook.com.

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
}];

Batasan

  • Video harus dienkode sebagai multipart/form-data.
  • Jika Anda mengunggah video dengan permintaan HTTP multi-bagian atau dengan menyediakan URL ke video, ukuran video tidak boleh melebihi 1 GB dan durasi maksimal 20 menit.
  • Unggahan video yang dapat dilanjutkan dapat mencapai 1,75GB dan durasi maksimal 45 menit.

Format yang Didukung

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.

Izin

Sejak 24 April 2018, izin pubish_actions sudah dihapus. Harap lihat Catatan Perubahan Sela untuk informasi selengkapnya. Guna memberikan cara bagi para pengguna aplikasi Anda untuk membagikan konten ke Facebook, kami menyarankan Anda untuk menggunakan produk Berbagi kami.

Endpoint ini memerlukan token akses pengguna dengan izin publish_actions.

Kolom

Nama Deskripsi Jenis

id

ID target tempat video diposting.

numeric string

title

Judul video.

string

description

Deskripsi video, digunakan sebagai pesan status penyerta dalam cerita kabar apa pun. Parameter ini dapat berisi penyebutan Halaman Facebook lain menggunakan sintaksis berikut:

@[page-id]

Misalnya, deskripsi berikut akan menyebutkan halaman Developer Facebook secara inline:

Test message @[19292868552] tag

Penggunaan fitur ini tunduk pada tinjauan, tetapi dengan menggunakan Halaman yang Anda kelola (untuk membuat panggilan API, dan untuk digunakan dalam penyebutan), serta aplikasi yang Anda kembangkan, Anda dapat mengujinya sendiri sebelum ditinjau.

string

source

Video, dienkode sebagai data formulir. Kolom ini wajib diisi.

multipart/form-data

file_url

URL file video yang dapat diakses. Tidak dapat digunakan dengan upload_phase.

string

thumb

Data mentah gambar mini video yang akan diunggah dan dikaitkan dengan video.

image

upload_phase

Jenis permintaan unggahan potongan.

enum{start, transfer, finish}

file_size

Ukuran keseluruhan file video dalam bita.

unsigned int32

start_offset

Posisi mulai bita dari potongan file.

unsigned int32

video_file_chunk

Potongan file video, dienkode sebagai data formulir. Kolom ini wajib diisi selama fase unggahan transfer.

multipart/form-data

upload_session_id

ID sesi unggahan potongan.

numeric string

Tanggapan

Jika berhasil:

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

Membaca

Anda tidak dapat membaca video yang diunggah ke acara menggunakan edge ini.

Memperbarui

Anda tidak dapat memperbarui dengan edge ini.

Menghapus

Anda tidak dapat menghapus dengan edge ini.