미디어

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

만들기

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

읽기

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`	미디어의 캡션 텍스트. 사진첩의 미디어에 대해서는 반환되지 않습니다.
`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"
}

업데이트

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

삭제

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