미디어

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

이미지, 동영상 또는 사진첩을 나타냅니다.

만들기

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

읽기

GET /{media-id}

이미지, 동영상 또는 사진첩에 대한 필드와 에지를 가져옵니다.

요구 사항

유형	요구 사항
액세스 토큰	Instagram 사용자
권한	`instagram_graph_user_media`

요청 구문

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &access_token={access-token}

쿼리 문자열 매개변수

요청을 보강하기 위해 다음 쿼리 문자열 매개변수를 포함합니다.

키	값
`access_token` 필수 문자열	앱 사용자의 Instagram 사용자 액세스 토큰입니다.
`fields` 쉼표로 구분된 리스트	반환하고자 하는 필드와 에지의 쉼표로 구분된 리스트입니다. 생략할 경우 기본 필드가 반환됩니다.

필드

fields 쿼리 문자열 매개변수를 사용하여 미디어에 대해 다음의 필드를 요청할 수 있습니다.

필드 이름	설명
`caption`	미디어의 캡션 텍스트입니다. 사진첩의 미디어에 대해서는 반환되지 않습니다. 참고: 캡션에 이모티콘을 사용할 때 인코딩 형식은 UTF-8이어야 하며, 사용한 이모티콘에 따라 글자 길이가 영향을 받을 수 있습니다.
`id`	미디어의 ID입니다.
`is_shared_to_feed`	릴스 전용. `true`인 경우 릴스가 피드 및 릴스 탭에 모두 표시될 수 있다는 것을 의미합니다. `false`인 경우 릴스가 릴스 탭에만 표시될 수 있다는 것을 의미합니다. 어느 값도 릴스가 실제로 릴스 탭에 표시되는 여부를 결정하지 않습니다. 릴스가 자격 요건을 충족하지 않거나 알고리즘에서 선택되지 않을 수 있기 때문입니다. 자격 요건 기준에 대한 자세한 내용은 릴스 사양을 참조하세요.
`media_type`	미디어의 유형입니다. `IMAGE`, `VIDEO` 또는 `CAROUSEL_ALBUM`일 수 있습니다.
`media_url`	미디어의 URL입니다.
`permalink`	미디어의 영구 URL입니다. 미디어에 저작권이 있는 자료가 포함되어 있거나 저작권 위반 플래그가 지정된 경우 생략됩니다.
`thumbnail_url`	미디어의 썸네일 이미지 URL입니다. `VIDEO` 미디어에만 제공됩니다.
`timestamp`	ISO 8601 형식의 미디어 게시 날짜입니다.
`username`	미디어 소유자의 사용자 이름입니다.

에지

다음 에지를 경로 매개변수로 요청하거나 fields 쿼리 문자열 매개변수를 사용하여 요청할 수 있습니다.

에지	설명
`children`	미디어 사진첩에 대한 미디어 리스트를 가져옵니다. `CAROUSEL_ALBUM` 미디어에만 제공됩니다.

응답

기본 및 요청된 필드와 에지를 포함하는 JSON 형식의 개체입니다.

{
  "{field}":"{value}",
  ...
}

cURL 예시

요청

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

응답

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

업데이트

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

삭제

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