언급된 미디어

다른 Instagram 사용자가 캡션에서 IG 사용자를 @언급한 IG 미디어에 대한 데이터를 반환합니다.

만들기

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

읽기

GET /{ig-user-id}?fields=mentioned_media.media_id

다른 Instagram 사용자가 캡션에서 IG 사용자를 @언급한 IG 미디어에 대한 데이터를 반환합니다.

제한 사항

스토리의 언급은 지원되지 않습니다.
자신이 태그된 사진의 댓글은 지원되지 않습니다.
댓글 또는 @언급이 나타나는 미디어가 비공개로 설정된 계정에서 생성된 경우 Webhook가 전송되지 않습니다.

요구 사항

유형 설명

유형	설명
액세스 토큰	사용자
권한	`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_media.media_id({media-id}){{fields}}
  &access_token={access-token}

쿼리 문자열 매개변수

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

필드

필드	설명
`caption` 문자열	캡션 텍스트. IG 사용자를 @언급하는 캡션에는 `@` 기호가 포함되지 않습니다. 단, 앱 사용자가 캡션을 적용한 대상인 IG 미디어 개체를 생성한 경우는 예외입니다.
`comments` 개체	IG 미디어에 대한 IG 댓글 리스트. 필드 확장을 사용하여 댓글 텍스트를 가져올 경우, IG 사용자를 @언급하는 캡션에는 `@` 기호가 포함되지 않습니다. 단, 앱 사용자가 캡션을 적용한 대상인 IG 미디어 개체를 생성한 경우는 예외입니다.
`comments_count` 문자열	IG 미디어에 대한 IG 댓글 수.
`id` 기본 문자열	IG 미디어의 ID.
`like_count` 문자열	미디어의 좋아요 개수. 사진첩 하위 미디어의 좋아요와 미디어에서 생성한 홍보 게시물의 좋아요를 제외합니다. 댓글의 답글은 포함합니다. v10.0 이전 호출: 미디어 소유자가 미디어의 좋아요 개수를 숨겼을 경우 값은 `0`이 됩니다. v11.0 이상 호출: 미디어 소유자가 좋아요 개수를 숨겼을 경우 필드가 생략됩니다. 미디어 소유자가 미디어의 좋아요 개수를 숨겼을 경우 값은 `0`이 됩니다.
`media_type` 문자열	IG 미디어 유형: `CAROUSEL_ALBUM`, `IMAGE`, `STORY` 또는 `VIDEO`.
`media_url` 문자열	게시된 IG 미디어의 URL.
`owner` 문자열	IG 미디어를 생성한 IG 사용자의 ID. 앱 사용자가 IG 미디어 개체를 생성한 경우에만 반환되고 그렇지 않을 경우에는 `username` 필드가 대신 반환됩니다.
`timestamp` 문자열	ISO 8601 형식의 IG 미디어 생성 날짜.
`username` 문자열	IG 미디어를 생성한 IG 사용자의 사용자 이름.

요청 샘플

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

응답 샘플

{
  "mentioned_media": {
    "caption": "metricsaurus headquarters!",
    "media_type": "IMAGE",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

위의 샘플에서 API는 원래 캡션(@metricsaurus headquarters!)에서 앞에 있던 @ 기호를 제거했습니다. 앱 사용자가 캡션을 생성하지 않았기 때문입니다.

페이지 매김

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

업데이트

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

삭제

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