Instagram 미디어

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

다음 필드를 소개합니다.

• legacy_instagram_media_id

다음 마케팅 API Instagram 광고 엔드포인트 필드는 지원되지 않습니다.

• filter_name
• location
• location_name
• latitude
• longitude

만들기

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

읽기

GET /<IG_MEDIA_ID>

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

요구 사항

제한 사항

• comments_count, like_count와 같은 필드는 타겟 Instagram 미디어에서의 참여를 반환하고 다른 위치의 데이터는 포함하지 않습니다. 예를 들어 comments_count는 사진에 달린 댓글 수를 반환하지만 해당 사진이 포함된 광고에 달린 댓글 수는 포함하지 않습니다. total_comments_count 및 total_like_count를 사용하여 홍보/광고 미디어의 참여를 포함한 집계된 수를 가져옵니다. 세션 사용자가 교차 게시된 Facebook 게시물에 액세스할 수 있는 경우 그 게시물의 수가 포함될 수 있습니다.
• 앱 사용자가 앱에서 관리자 권한에 준하는 작업도 수행할 수 있는 경우를 제외하고 캡션에는 @ 기호가 포함되지 않습니다.
• permalink와 같은 일부 필드는 사진첩(하위) 내의 사진에 사용할 수 없습니다.
• 라이브 방송 Instagram 미디어는 방송 중일 때만 읽을 수 있습니다.
• 이 API는 Instagram 프로페셔널 계정에서 소유한 미디어에 대한 데이터만 반환합니다. 개인 Instagram 계정에서 소유한 미디어에 대한 데이터를 가져오는 데 사용할 수 없습니다.
• reposts_count, saved_count, shares_count, total_like_count, total_comments_count, total_views_count 필드는 슬라이드 하위 미디어에 제공되지 않으며 최상위 미디어 개체에 대해서만 반환됩니다. 미디어 소유자는 좋아요, 댓글, 조회수, 리포스트, 공유를 표시하지 않도록 비활성화할 수 있습니다. 이 경우 해당 필드는 반환되지 않습니다.

요청 구문

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

경로 매개변수

쿼리 문자열 매개변수

필드

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

에지

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

cURL 예시

요청 예시

curl -X GET \
  'https://graph.instagram.com/v26.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>

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

제한 사항

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

요청 구문

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

경로 매개변수

쿼리 문자열 매개변수

cURL 예시

요청 예시

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

응답 예시

{
  "success": true
}

삭제

DELETE /<IG_MEDIA_ID>

Instagram 미디어를 삭제합니다.

요구 사항

제한 사항

이 API는 Facebook 로그인을 통한 Instagram API만 지원합니다. 광고가 아닌 게시물, 스토리, 릴스 및 전체 슬라이드 사진첩이 지원됩니다. 슬라이드 사진첩 내의 미디어를 삭제하려면 슬라이드 컨테이너 미디어 ID를 지정하여 전체 슬라이드 사진첩을 삭제해야 합니다. 슬라이드 내에서 개별적으로 미디어를 삭제하는 것은 지원되지 않습니다.

요청 구문

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

경로 매개변수

쿼리 문자열 매개변수

cURL 예시

요청 예시

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

응답 예시(성공)

{
  "success": true,
  "deleted_id": "17918920912340654"
}

응답 예시(실패, 미디어 유형이 지원되지 않음)

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}