IG 미디어

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

만들기

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

읽기

GET /<IG_MEDIA_ID>

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

제한 사항

• 집계된 값을 반환하는 필드에는 광고에서 발생한 데이터가 포함되지 않습니다. 예를 들어 comments_count는 사진을 포함한 광고에 달린 댓글 수가 아니라 해당 사진에 달린 댓글 수를 반영합니다.
• 앱 사용자가 앱에서 관리자 권한의 작업도 수행할 수 있는 경우를 제외하고 캡션은 @ 기호를 포함하지 않습니다.
• permalink와 같은 일부 필드는 사진첩 내의 사진(하위)에 사용할 수 없습니다.
• 라이브 방송 IG 미디어는 방송 중일 때만 읽을 수 있습니다.
• 이 API는 Instagram 프로페셔널 계정에서 소유한 미디어에 대한 데이터만 반환합니다. 개인 Instagram 계정에서 소유한 미디어에 대한 데이터를 가져오는 데 사용할 수 없습니다.

요청 구문

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

경로 매개변수

쿼리 문자열 매개변수

필드

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

에지

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

cURL 예시

요청 예시

curl -X GET \
  'https://graph.instagram.com/v21.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 미디어는 지원되지 않습니다.

요청 구문

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

경로 매개변수

쿼리 문자열 매개변수

cURL 예시

요청 예시

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

응답 예시

{
  "success": true
}

삭제

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