Phiên bản API Đồ thị

Video Poll

Đọc

Embedded video poll

Feature Permissions

TênMô tả
API Video trực tiếpThis feature permission may be required.

Ví dụ

Graph API Explorer
GET /v19.0/{video-poll-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{video-poll-id}',
    '{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(
    "/{video-poll-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{video-poll-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{video-poll-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Nếu bạn muốn tìm hiểu cách sử dụng API Đồ thị, hãy đọc Hướng dẫn sử dụng API Đồ thị của chúng tôi.

Thông số

Điểm cuối này không có bất kỳ thông số nào.

Trường

Trường thông tinMô tả
id
numeric string

The poll ID

question
string

The poll question text

show_results
bool

True if this is a Live poll and voting is open and the results show after voting

status
enum {closed, voting_open, results_open}

Live poll status

Đường viền

CạnhMô tả
Edge<VideoPollOption>

Options available on this poll

Mã lỗi

LỗiMô tả
100Invalid parameter

Tạo

Bạn có thể tạo yêu cầu POST đến cạnh polls từ các đường dẫn sau:
Khi đăng lên cạnh này, hệ thống sẽ tạo a VideoPoll.

Thông số

Thông sốMô tả
correct_option
int64

Number of the correct option (in order, starting from 1)

options
array<string>

Text options for users to select in order

Bắt buộc
question
string

Question text

Bắt buộc
show_results
boolean

True to show the results after voting, otherwise false

Kiểu trả về

This endpoint supports read-after-write and will read the node represented by id in the return type.
Struct {
id: numeric string,
option_ids: List [
numeric string
],
}

Mã lỗi

LỗiMô tả
200Permissions error
100Invalid parameter

Cập nhật

Bạn có thể cập nhật a VideoPoll bằng cách thực hiện yêu cầu POST đến /{video_poll_id}.

Thông số

Thông sốMô tả
action
enum {ATTACH_TO_VIDEO, CLOSE, SHOW_VOTING, SHOW_RESULTS, DELETE_POLL}

Change state for the poll

Bắt buộc
show_results
boolean

True if the viewer sees results after voting, false if they do not

Kiểu trả về

This endpoint supports read-after-write and will read the node represented by id in the return type.
Struct {
success: bool,
}

Mã lỗi

LỗiMô tả
100Invalid parameter

Xóa

Bạn không thể thực hiện thao tác này trên điểm cuối này.