그래프 API
그래프 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는 비어 있습니다.

다음의 예시는 개체에 대한 전체 공감에 보낸 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=total_count)에서 가져오려면 이 필드를 지정하세요.

필드설명

total_count

unsigned int32

공감의 총 개수

viewer_reaction

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

페이지 또는 사용자가 개체에 표시한 공감의 유형.

오류 코드

오류설명

100

잘못된 매개변수

만들기

지원되지 않는 작업입니다.

업데이트

지원되지 않는 작업입니다.

삭제

지원되지 않는 작업입니다.