グラフAPIバージョン

オブジェクトに対するリアクション

このリファレンスでは、複数のグラフAPIノードに共通する/reactionsエッジについて説明します。各ノードにおける構造と操作は同じです。/reactionsエッジは以下のオブジェクトにあります:

読み取り

オブジェクトに対するリアクションを取得します。

ページと投稿に対するリアクションについて詳しくは、「インサイト」をご覧ください。

新しいページエクスペリエンス

このエンドポイントは、新しいページエクスペリエンスでサポートされています。

要件

マーケティングアプリ

  • ads_management
  • pages_read_engagement
  • pages_show_list

ページ管理アプリ

  • pages_show_list

リクエストの例

次の例は、自身のオブジェクトに対してリアクションしたユーザーによるGETリクエストを示しています。

curl -i -X GET \
 "https://graph.facebook.com/your-post-id/reactions?access_token=your-user-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
 accessToken,
 "/your-post-id/reactions",
 new GraphRequest.Callback() {
 @Override
 public void onCompleted(GraphResponse response) {
 // Insert your code here
 }
});
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
 initWithGraphPath:@"/your-post-id/reactions"
 parameters:nil
 HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
 // Insert your code here
}];
FB.api(
 '/your-post-id/reactions',
 'GET',
 {},
 function(response) {
 // Insert your code here
 }
);
try {
 // Returns a `FacebookFacebookResponse` object
 $response = $fb->get(
 '/your-post-id/reactions',
 '{access-token}'
 );
} catch(FacebookExceptionsFacebookResponseException $e) {
 echo 'Graph returned an error: ' . $e->getMessage();
 exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
 echo 'Facebook SDK returned an error: ' . $e->getMessage();
 exit;
}
$graphNode = $response->getGraphNode();

JSON応答

{
 "data": [
 {
 "id": "your-user-id",
 "name": "Your Name",
 "type": "HAHA"
 }
 ],
 "paging": {
 "cursors": {
 "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR",
 "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD"
 }
 }
}

ユーザーまたはページがリアクションしていないオブジェクトをクエリすると、dataは空白になります。

次の例は、1つのオブジェクトに対するリアクションの合計数を取得するGETリクエストを示しています。

curl -i -X GET \
 "https://graph.facebook.com/your-post-id
 ?fields=reactions.summary(total_count)
 &access_token=your-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
 accessToken,
 "/your-post-id",
 new GraphRequest.Callback() {
 @Override
 public void onCompleted(GraphResponse response) {
 // Insert your code here
 }
});
Bundle parameters = new Bundle();
parameters.putString("fields", "reactions.summary(total_count)");
request.setParameters(parameters);
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
 initWithGraphPath:@"/your-post-id"
 parameters:@{ @"fields": @"reactions.summary(total_count)",}
 HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
 // Insert your code here
}];
FB.api(
 '/your-post-id',
 'GET',
 {"fields":"reactions.summary(total_count)"},
 function(response) {
 // Insert your code here
 }
);
try {
 // Returns a `FacebookFacebookResponse` object
 $response = $fb->get(
 '/your-post-id',
 '{access-token}'
 );
} catch(FacebookExceptionsFacebookResponseException $e) {
 echo 'Graph returned an error: ' . $e->getMessage();
 exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
 echo 'Facebook SDK returned an error: ' . $e->getMessage();
 exit;
}
$graphNode = $response->getGraphNode();

次の例は、ユーザーまたはページが自身のオブジェクトに対してリアクションした場合のJSON応答を示しています。

{
 "reactions": {
 "data": [
 {
 "id": "your-user-id",
 "name": "Your Name",
 "type": "HAHA"
 }
 ],
 "paging": {
 "cursors": {
 "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR",
 "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD"
 }
 },
 "summary": {
 "total_count": 28
 }
 },
 "id": "your-post-id"
}

次の例は、ユーザーまたはページが自身のオブジェクトに対してリアクションしなかった場合のJSON応答を示しています。

{
 "reactions": {
 "data": [
 ],
 "paging": {
 "cursors": {
 "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR",
 "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD"
 }
 },
 "summary": {
 "total_count": 28
 }
 },
 "id": "your-post-id"
}

ユーザーまたはページは、自身のリアクションしかクエリできません。他のユーザーまたはページのリアクションは、プライバシー上の理由によりクエリできません。

「いいね!」リアクションの件数には、「いいね!」と「大切だね」の両方のリアクションが含まれます。

パラメーター

名前説明

type

enum {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

ページまたはユーザーがオブジェクトに対して示したリアクションのタイプ。

フィールド

このエッジから読み取ると、JSON形式の結果が返されます

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

data

クエリを実行したページまたはユーザーのプロフィール(クエリ対象のオブジェクトに対してページまたはユーザーがリアクションした場合)、およびリアクションタイプのリスト:

フィールド説明

type

enum {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

ページまたはユーザーがオブジェクトに対して示したリアクションのタイプ。

投稿に対するリアクションについては、ユーザーアクセストークンで読み取りを行った場合、このエッジは現在のユーザー以外のプロフィールは返しません。

個々のリアクション件数の表示

curl -i -X GET \
 "https://graph.facebook.com/your-object-id
 ?fields=reactions.type(LOVE).limit(0).summary(total_count)
 &access_token=your-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
 accessToken,
 "/your-object-id",
 new GraphRequest.Callback() {
 @Override
 public void onCompleted(GraphResponse response) {
 // Insert your code here
 }
});
Bundle parameters = new Bundle();
parameters.putString("fields", "reactions.type(LOVE).limit(0).summary(total_count)");
request.setParameters(parameters);
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
 initWithGraphPath:@"/your-object-id"
 parameters:@{ @"fields": @"reactions.type(LOVE).limit(0).summary(total_count)",}
 HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
 // Insert your code here
}];
FB.api(
 '/your-object-id',
 'GET',
 {"fields":"reactions.type(LOVE).limit(0).summary(total_count)"},
 function(response) {
 // Insert your code here
 }
);
try {
 // Returns a `FacebookFacebookResponse` object
 $response = $fb->get(
 '/your-object-id',
 '{access-token}'
 );
} catch(FacebookExceptionsFacebookResponseException $e) {
 echo 'Graph returned an error: ' . $e->getMessage();
 exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
 echo 'Facebook SDK returned an error: ' . $e->getMessage();
 exit;
}
$graphNode = $response->getGraphNode();

返されるJSONの例

{
 "reactions": {
 "data": [
 ],
 "summary": {
 "total_count": 3498
 }
 },
 "id": "your-object-id"
}

paging

ページネーションについて詳しくは、グラフAPIのページングに関するドキュメントをご覧ください。reactionsにlimit(0)を追加すると、出力からpagingが除外されます。

summary

エッジに関する集計情報(件数など)。取得するフィールドをsummaryパラメーターで指定します(例: summary=total_count)。

フィールド説明

total_count

符号なしint32

リアクションの合計数

viewer_reaction

enum {NONE, LIKE, LOVE, WOW, HAHA, SORRY, ANGRY}

ページまたはユーザーがオブジェクトに対して示したリアクションのタイプ。

エラーコード

エラー説明

100

無効なパラメーター

作成

この操作はサポートされていません。

更新

この操作はサポートされていません。

削除

この操作はサポートされていません。

AltStyle によって変換されたページ (->オリジナル) /