IG 사용자의 언급된 댓글

다른 Instagram 사용자가 IG 사용자를 @언급한 IG 댓글에 대한 데이터를 반환합니다.

만들기

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

읽기

GET /{ig-user-id}?fields=mentioned_comment.comment_id

다른 Instagram 사용자가 IG 사용자를 @언급한 IG 댓글에 대한 데이터를 반환합니다.

제한 사항

IG 사용자가 @언급된 IG 미디어에 비활성화된 경우 이 엔드포인트는 오류를 반환합니다.

요구 사항

유형 설명

유형	설명
액세스 토큰	사용자
권한	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` 비즈니스 관리자를 통해 앱 사용자에게 페이지에 대한 역할을 부여한 경우 다음 중 하나도 필요합니다. `ads_management` `business_management`
작업	`MANAGE`, `CREATE_CONTENT` 또는 `MODERATE`

액세스 토큰

사용자

권한

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list

비즈니스 관리자를 통해 앱 사용자에게 페이지에 대한 역할을 부여한 경우 다음 중 하나도 필요합니다.

ads_management
business_management

작업

MANAGE, CREATE_CONTENT 또는 MODERATE

요청 구문

GET https://graph.facebook.com/v19.0/{ig-user-id}
  ?fields=mentioned_comment.comment_id({comment-id}){{fields}}
  &access_token={access-token}

쿼리 문자열 매개변수

매개변수	값
`{access_token}` 필수 문자열	앱 사용자의 사용자 액세스 토큰.
`{comment-id}` 필수 문자열	IG 사용자가 @언급된 IG 댓글의 ID. ID는 Webhooks 알림 페이로드에 포함됩니다.
`{fields}` 쉼표로 구분된 리스트	반환하고자 하는 IG 댓글 필드의 쉼표로 구분된 리스트. 생략할 경우 기본 필드가 반환됩니다.

필드

필드	설명
`id` 기본 문자열	IG 댓글의 ID.
`like_count` 문자열	IG 댓글에 좋아요가 눌린 횟수.
`media` 문자열	IG 댓글을 남긴 IG 미디어의 ID. 반환된 IG 미디어 엔터티에 대한 추가 필드를 가져오려면 필드 확장을 사용하세요.
`text` 기본 문자열	IG 댓글의 텍스트.
`timestamp` 기본 문자열	ISO 8601 형식의 IG 댓글 생성 날짜.

응답

요청 샘플

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,id}&access_token=IGQVJ...'

응답 샘플

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

필드 확장

IG 미디어 필드 리스트로 media 필드를 확장하여 댓글이 작성된 IG 미디어 엔터티에 대한 추가 데이터를 가져올 수 있습니다. 예를 들면 다음과 같습니다.

media{id,media_url}

2021년 9월 7일까지 v10.0 이전 호출: IG 미디어의 like_count 필드는 미디어 소유자가 미디어의 좋아요 개수를 숨겼을 경우0을 반환합니다.

2021년 9월 7일에 v11.0 이상 호출 및 모든 버전: 다른 엔드포인트 또는 필드 확장을 통해 IG 미디어를 간접적으로 쿼리할 경우 미디어 소유자가 미디어의 좋아요 개수를 숨겼다면 like_count 필드는 API 응답에서 생략됩니다. IG 미디어를 직접 쿼리하면(IG 미디어 소유자만 가능) 좋아요 개수가 숨겨져 있더라도 실제 좋아요 개수가 반환됩니다.

샘플 필드 확장 요청

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,media{id,media_url}}&access_token=IGQVJ...'

샘플 필드 확장 응답

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021",
    "media": {
      "id": "17895695668004550",
      "media_url": "https://scont..."
    }
  },
  "id": "17841405309211844"
}

페이지 매김

필드 확장을 사용하여 커서 기반 페이지 매김을 지원하는 에지에 액세스할 경우 응답에 여러 페이지의 데이터가 포함되어 있으면 응답에 before와 after 커서가 포함됩니다. 그러나 표준 커서 기반 페이지 매김과 달리 응답에는 previous 또는 next 필드가 포함되지 않으므로 before와 after 커서를 사용하여 수동으로 previous와 next 쿼리 문자열을 구성하고 반환된 데이터 세트에 페이지를 지정해야 합니다.

업데이트

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

삭제

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