グラフAPIバージョン

Video Comments

読み取り

Comments for this object

New Page Experience

このエンドポイントは新デザインのページに対応しています。

例

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

グラフAPIを使用する方法については、グラフ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`

ページネ―ションについて詳しくは、グラフAPIガイドをご覧ください。

`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

エラーコード

エラー	詳細
100	Invalid parameter
368	The action attempted has been deemed abusive or is otherwise disallowed
200	Permissions error
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.
2500	Error parsing graph query

作成

commentsのエッジにPOSTリクエストを以下のパスで送信できます:

/{video_id}/comments

このエッジにPOSTする場合、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,

}

エラーコード

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

更新中…

このエンドポイントではこの操作を実行できません。

削除中です

このエンドポイントではこの操作を実行できません。