Phiên bản API Đồ thị

Cạnh này đã ngừng hoạt động và không thể dùng được nữa.

Video về sự kiện /{event-id}/videos

Bạn có thể dùng điểm cuối này để đăng video lên một sự kiện. Để xóa hoặc cập nhật video hiện có, hãy sử dụng nút /{video-id}.

Tạo

Để đăng video lên sự kiện, hãy gửi yêu cầu POST đến cạnh /{event-id}/videos trên graph-video.facebook.com.

POST /v21.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
}];

Giới hạn

  • Video phải được mã hóa dưới dạng multipart/form-data.
  • Nếu bạn muốn tải video lên thông qua yêu cầu HTTP gồm nhiều phần hoặc bằng cách cung cấp URL đến video, video này không được có kích thước lớn hơn 1GB và thời lượng dài hơn 20 phút.
  • Khi bạn tải lên video nối tiếp, video có thể có kích thước tối đa là 1,75GB và thời lượng 45 phút.

Định dạng được hỗ trợ

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.

Quyền

Kể từ ngày 24/04/2018, chúng tôi đã thu hồi quyền pubish_actions. Vui lòng xem Nhật ký về các thay đổi quan trọng để biết thêm thông tin chi tiết. Để người dùng ứng dụng có cách chia sẻ nội dung lên Facebook, bạn nên sử dụng các sản phẩm Chia sẻ của chúng tôi.

Điểm cuối này yêu cầu mã truy cập dành cho người dùng cùng với quyền publish_actions.

Trường

Tên Mô tả Loại

id

ID mục tiêu nơi đăng video.

numeric string

title

Tiêu đề của video.

string

description

Nội dung mô tả video, được dùng làm thông báo trạng thái đi kèm trong mọi tin trên bảng feed. Thông số này có thể chứa nội dung nhắc đến của các Trang Facebook khác theo cú pháp sau đây:

@[page-id]

Ví dụ: nội dung mô tả sau đây sẽ nhắc đến trang Facebook Developers trong chính nội dung đó:

Test message @[19292868552] tag

Việc sử dụng tính năng này phải được xét duyệt. Tuy nhiên, bạn có thể tự thử nghiệm tính năng trước khi xét duyệt bằng cách sử dụng Trang mà bạn là quản trị viên (để thực hiện lệnh gọi API và để dùng trong nội dung nhắc đến) cũng như ứng dụng mà bạn là nhà phát triển.

string

source

Video, được mã hóa dưới dạng dữ liệu trong mẫu. Đây là trường bắt buộc.

multipart/form-data

file_url

URL có thể truy cập của file video. Không thể sử dụng với upload_phase.

string

thumb

Dữ liệu thô về hình thu nhỏ của video sẽ được tải lên và liên kết với video.

image

upload_phase

Loại yêu cầu tải lên theo phân đoạn.

enum{start, transfer, finish}

file_size

Kích thước của toàn bộ file video, tính bằng byte.

unsigned int32

start_offset

Vị trí bắt đầu (tính bằng byte) của phân đoạn file.

unsigned int32

video_file_chunk

Phân đoạn file video, được mã hóa dưới dạng dữ liệu trong mẫu. Đây là trường bắt buộc trong giai đoạn tải lên transfer.

multipart/form-data

upload_session_id

ID của phiên tải lên theo phân đoạn.

numeric string

Phản hồi

Nếu thành công:

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

Đọc

Bạn không thể dùng cạnh này để đọc video đã tải lên sự kiện.

Cập nhật

Bạn không thể cập nhật bằng cạnh này.

Xóa

Bạn không thể xóa bằng cạnh này.