Graph API 版本

Video Comments

閱讀中

Comments for this object

新版專頁體驗

This endpoint is supported for 新版專頁體驗.

例子

GET /v19.0/{video-id}/comments 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-id}/comments',
    '{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-id}/comments",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{video-id}/comments",
    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-id}/comments"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

如果想了解如何使用 Graph API，請參閱我們的使用 Graph API 指南。

參數

參數	描述
`filter` enum{stream, toplevel}	預設值：`toplevel` SELF_EXPLANATORY
`live_filter` enum{filter_low_quality, no_filter}	預設值：`filter_low_quality` For comments on a Live streaming video, this determines whether low quality comments will be filtered out of the results (filtering is enabled by default). In all other circumstances this parameter is ignored.
`order` enum{chronological, reverse_chronological}	Preferred ordering of the comments. Accepts chronological (oldest first) and reverse chronological (newest first). If the comments can be ranked, then the order will always be ranked regardless of this modifier. The best practice for querying comments on a Live video is to continually poll for comments in the reversechronological ordering mode.
`since` datetime	Lower bound of the time range to consider

欄位

由此關係連線進行的閱讀將回傳 JSON 格式結果：

{
    "data": [],
    "paging": {},
    "summary": {}
}

`data`

Comment 節點的清單。

`paging`

如需更多有關分頁的詳細資料，請參閱 Graph API 指南。

`summary`

與關係連線相關的彙總資訊，例如次數等。請在摘要參數中指定要擷取的欄位（例如 summary=order）。

欄位說明

欄位	說明
`order` enum	Order of returned comments
`total_count` unsigned int32	Total number of people who commented
`can_comment` bool	Can the viewer comment

order

enum

Order of returned comments

total_count

unsigned int32

Total number of people who commented

can_comment

bool

Can the viewer comment

Error Codes

錯誤	說明
100	Invalid parameter
200	Permissions error
368	The action attempted has been deemed abusive or is otherwise disallowed
190	Invalid OAuth 2.0 Access Token
283	That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata
104	Incorrect signature
80001	There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.

建立中

You can make a POST request to comments edge from the following paths:

/{video_id}/comments

發佈到此關係連線時，會建立 a Comment 。

參數

參數	描述
`attachment_id` numeric string or integer	ID for a photo attachment to associate with this
`attachment_share_url` URL	Link to set the comment attachment to. Does not include the url in the message
`attachment_url` URL	Link to set the comment attachment to
`is_offline` boolean	Whether the comment was originally made while offline
`message` UTF-8 string	Same as the text param 支援表情符號
`text` UTF-8 string	The text of the comment that allows emoji 支援表情符號

傳回類型

此端點支援寫入後讀取功能，並將讀取傳回類型表示為 id 的節點。

Struct {

id: token with structure: Comment ID,

}

Error Codes

錯誤	說明
190	Invalid OAuth 2.0 Access Token
368	The action attempted has been deemed abusive or is otherwise disallowed
100	Invalid parameter
200	Permissions error
459	The session is invalid because the user has been checkpointed
104	Incorrect signature
1705	There was an error during posting.

更新中

你無法在此端點執行此操作。

正在刪除

你無法在此端點執行此操作。