IG 미디어

Instagram 사진첩, 사진 또는 동영상(업로드된 동영상, 라이브 방송, Instagram TV 앱으로 생성된 동영상, 릴스 또는 스토리)을 나타냅니다.

만들기

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

읽기

GET /{ig-media-id}

IG 미디어에서 필드에지를 가져옵니다.

제한 사항

  • 집계된 값을 반환하는 필드에는 광고에서 발생한 데이터가 포함되지 않습니다. 예를 들어 comments_count는 사진을 포함한 광고에 달린 댓글 수가 아니라 해당 사진에 달린 댓글 수를 반영합니다.
  • 앱 사용자가 앱에서 관리자 권한의 작업도 수행할 수 있는 경우를 제외하고 캡션은 @ 기호를 포함하지 않습니다.
  • permalink와 같은 일부 필드는 사진첩(하위) 내의 사진에 사용할 수 없습니다.
  • API를 통해 Instagram TV 미디어에 액세스하려면 게시 시점(미리 보기 게시 또는 미리 보기를 피드에 공유 활성화됨)에 해당 미디어가 Instagram에 공유된 상태여야 합니다.
  • 라이브 방송 IG 미디어는 방송 중일 때만 읽을 수 있습니다.

요구 사항

유형설명

액세스 토큰

사용자

권한

instagram_basic
pages_read_engagement
pages_show_list


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


ads_management
business_management

요청 구문

GET https://graph.facebook.com/{api-version}/{ig-media-id}
  ?fields={fields}
  &access_token={access-token}

경로 매개변수

자리 표시자

{api-version}

API 버전.

{ig-media-id}

필수 항목. IG 미디어 ID.

쿼리 문자열 매개변수

자리 표시자

access_token

{access-token}

필수 항목. 앱 사용자의 사용자 액세스 토큰입니다.

fields

{fields}

반환하고자 하는 필드의 쉼표로 구분된 리스트입니다.

필드

공개 필드는 필드 확장을 통해 확인할 수 있습니다.

필드설명

caption
전체 공개

캡션. 하위 사진첩은 제외합니다. @ 기호가 제외됩니다. 단, 앱 사용자가 캡션을 만드는 데 사용한 Instagram 계정과 연결된 Facebook 페이지에서 관리자 권한의 작업을 수행할 수 있는 경우는 예외입니다.

comments_count
전체 공개

미디어의 댓글 개수. 사진첩 하위 미디어와 미디어 캡션의 댓글을 제외합니다. 댓글의 답글은 포함합니다.

copyright_check_information.status

statusmatches_found 개체를 반환합니다.

상태 개체설명

status

  • completed – 탐지 과정이 완료되었습니다.
  • error – 탐지 과정에서 오류가 발생했습니다.
  • in_progress – 탐지 과정이 진행 중입니다.
  • not_started – 탐지 과정이 시작되지 않았습니다.

matches_found

다음 중 하나로 설정합니다.

  • false 동영상이 저작권을 위반하지 않을 경우입니다.
  • true 동영상이 저작권을 위반할 경우입니다.

동영상이 저작권을 위반할 경우, 저작권이 있는 자료와 더불어 동영상에서 위반이 발생한 시점, 위반을 완화하기 위해 취할 조치에 대한 개체로 구성된 배열을 포함하여 copyright_matches가 반환됩니다.

copyright_matches 개체설명

author

저작권이 있는 동영상의 작성자입니다.

content_title

저작권이 있는 동영상의 이름입니다.

matched_segments

다음과 같은 키-값 쌍을 포함한 개체의 배열: * duration_in_seconds – 콘텐츠가 저작권을 위반한 시간(초) * segment_typeAUDIO 또는 VIDEO * start_time_in_seconds – 동영상의 시작 시간으로 설정

owner_copyright_policy

반환되는 개체에는 다음 항목이 포함되어 있습니다.

  • name – 저작권 소유자 정책의 이름입니다.
  • actions – 저작권 소유자의 정책에서 규정한 완화 단계가 포함된 action 개체의 배열입니다. 위치마다 다른 완화 단계가 포함될 수 있습니다.

    • action – 저작권을 위반하는 동영상에 대해 취한 완화 조치입니다. 국가마다 다른 완화 조치를 취할 수 있습니다. 다음 값 중 하나일 수 있습니다.
      • BLOCK – 동영상이 geos 배열에 나열된 타겟에 대해 차단됩니다.
      • MUTE – 동영상이 geos 배열에 나열된 타겟에 대해 음소거됩니다.

id
전체 공개

미디어 ID.

ig_id
전체 공개

Instagram 미디어 ID. 기존 Instagram API와 사용되었으나 지금은 사용 중단되었습니다. 대신 id를 사용하세요.

is_comment_enabled

댓글의 활성화 여부를 나타냅니다. 하위 사진첩은 제외합니다.

is_shared_to_feed
전체 공개

릴스 전용. true인 경우 릴스는 피드릴스 탭에 모두 표시될 수 있다는 것을 의미합니다. false인 경우 릴스가 릴스 탭에만 표시될 수 있다는 것을 의미합니다.

어느 값도 릴스가 실제로 릴스 탭에 표시되는 여부를 결정하지 않습니다. 릴스가 자격 요건을 충족하지 않거나 알고리즘에서 선택되지 않을 수 있기 때문입니다. 자격 요건 기준에 대한 자세한 내용은 릴스 사양을 참조하세요.

like_count

미디어에 대한 좋아요 개수(댓글에 대한 답글 포함). 사진첩 하위 미디어의 좋아요와 미디어에서 생성한 홍보 게시물의 좋아요를 제외합니다.


다른 엔드포인트 또는 필드 확장을 통해 간접적으로 쿼리된 경우:


  • v10.0 이전 호출: 미디어 소유자가 미디어의 좋아요 개수를 숨겼을 경우 값은 0이 됩니다.
  • v11.0 이상 호출: 미디어 소유자가 좋아요 개수를 숨겼을 경우 like_count 필드가 생략됩니다.

media_product_type
전체 공개

미디어가 게시된 위치. AD, FEED, STORY 또는 REELS일 수 있습니다.

media_type
전체 공개

미디어 유형. CAROUSEL_ALBUM, IMAGE 또는 VIDEO일 수 있습니다.

media_url
전체 공개

미디어의 URL.

media_url 필드는 미디어에 저작권이 있는 자료가 포함되거나 미디어가 저작권 위반으로 플래그된 경우 응답에서 생략됩니다. 저작권이 있는 자료의 예에는 릴스의 오디오가 포함될 수 있습니다.

owner
전체 공개

미디어를 만든 Instagram 사용자의 ID. 쿼리를 보낸 앱 사용자가 미디어를 생성한 경우에만 반환되고, 그렇지 않은 경우에는 username 필드가 대신 반환됩니다.

permalink
전체 공개

미디어의 영구 URL.

shortcode
전체 공개

미디어의 단축 코드.

thumbnail_url
전체 공개

미디어 썸네일 URL. VIDEO 미디어에만 제공됩니다.

timestamp
전체 공개

ISO 8601 형식의 UTC 기준 생성 날짜(기본값은 UTC ±00:00).

username
전체 공개

미디어를 만든 사용자의 사용자 이름.

video_title
전체 공개

사용 중단되었습니다. 응답에서 생략됩니다.

에지

전체 공개 에지는 필드 확장을 통해 반환될 수 있습니다.

에지설명

children
전체 공개.

사진첩 IG 미디어에 대한 IG 미디어 개체의 컬렉션을 나타냅니다.

collaborators

IG 미디어 개체에서 공동 작업자로 추가된 사용자의 리스트를 나타냅니다.

comments

IG 미디어 개체에 대한 IG 댓글의 컬렉션을 나타냅니다.

insights

IG 미디어 개체에 대한 소셜 상호작용 지표를 나타냅니다.

cURL 예시

요청

curl -X GET \
  'https://graph.facebook.com/v19.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'

응답

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

업데이트

POST /{ig-media-id}

IG 미디어에 대한 댓글을 활성화하거나 비활성화합니다.

제한 사항

라이브 방송 IG 미디어는 지원되지 않습니다.

요구 사항

유형설명

액세스 토큰

사용자

권한

instagram_basic
instagram_manage_comments
pages_show_list


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


ads_management
business_management

요청 구문

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &access_token={access-token}

경로 매개변수

자리 표시자

{api-version}

API 버전.

{ig-media-id}

필수 항목. IG 미디어 ID.

쿼리 문자열 매개변수

자리 표시자

access_token

{access-token}

필수 항목. 앱 사용자의 사용자 액세스 토큰입니다.

comment_enabled

{comment-enabled}

필수 항목.true로 설정하면 댓글이 활성화되고, false로 설정하면 댓글이 비활성화됩니다.

cURL 예시

요청

curl -i -X POST \
 "https://graph.facebook.com/v19.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

응답

{
  "success": true
}

삭제

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