Instagram 사진첩, 사진 또는 동영상(업로드된 동영상, 라이브 방송, Instagram TV 앱으로 생성된 동영상, 릴스 또는 스토리)을 나타냅니다.
지원되지 않는 작업입니다.
GET /{ig-media-id}
comments_count
는 사진을 포함한 광고에 달린 댓글 수가 아니라 해당 사진에 달린 댓글 수를 반영합니다.@
기호를 포함하지 않습니다.permalink
와 같은 일부 필드는 사진첩(하위) 내의 사진에 사용할 수 없습니다.유형 | 설명 |
---|---|
비즈니스 관리자를 통해 앱 사용자에게 페이지에 대한 역할을 부여한 경우 다음 중 하나도 필요합니다. |
GET https://graph.facebook.com/{api-version}/{ig-media-id} ?fields={fields} &access_token={access-token}
자리 표시자 | 값 |
---|---|
| API 버전. |
| 필수 항목. IG 미디어 ID. |
키 | 자리 표시자 | 값 |
---|---|---|
|
| 필수 항목. 앱 사용자의 사용자 액세스 토큰입니다. |
|
| 반환하고자 하는 필드의 쉼표로 구분된 리스트입니다. |
공개 필드는 필드 확장을 통해 확인할 수 있습니다.
필드 | 설명 | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 캡션. 하위 사진첩은 제외합니다. | ||||||||||||||||
| 미디어의 댓글 개수. 사진첩 하위 미디어와 미디어 캡션의 댓글을 제외합니다. 댓글의 답글은 포함합니다. | ||||||||||||||||
|
동영상이 저작권을 위반할 경우, 저작권이 있는 자료와 더불어 동영상에서 위반이 발생한 시점, 위반을 완화하기 위해 취할 조치에 대한 개체로 구성된 배열을 포함하여
| ||||||||||||||||
| 미디어 ID. | ||||||||||||||||
| Instagram 미디어 ID. 기존 Instagram API와 사용되었으나 지금은 사용 중단되었습니다. 대신 | ||||||||||||||||
| 댓글의 활성화 여부를 나타냅니다. 하위 사진첩은 제외합니다. | ||||||||||||||||
| 릴스 전용. 어느 값도 릴스가 실제로 릴스 탭에 표시되는 여부를 결정하지 않습니다. 릴스가 자격 요건을 충족하지 않거나 알고리즘에서 선택되지 않을 수 있기 때문입니다. 자격 요건 기준에 대한 자세한 내용은 릴스 사양을 참조하세요. | ||||||||||||||||
| 미디어에 대한 좋아요 개수(댓글에 대한 답글 포함). 사진첩 하위 미디어의 좋아요와 미디어에서 생성한 홍보 게시물의 좋아요를 제외합니다. 다른 엔드포인트 또는 필드 확장을 통해 간접적으로 쿼리된 경우:
| ||||||||||||||||
| 미디어가 게시된 위치. | ||||||||||||||||
| 미디어 유형. | ||||||||||||||||
| 미디어의 URL.
| ||||||||||||||||
| 미디어를 만든 Instagram 사용자의 ID. 쿼리를 보낸 앱 사용자가 미디어를 생성한 경우에만 반환되고, 그렇지 않은 경우에는 | ||||||||||||||||
| 미디어의 영구 URL. | ||||||||||||||||
| 미디어의 단축 코드. | ||||||||||||||||
| 미디어 썸네일 URL. | ||||||||||||||||
| ISO 8601 형식의 UTC 기준 생성 날짜(기본값은 UTC ±00:00). | ||||||||||||||||
| 미디어를 만든 사용자의 사용자 이름. | ||||||||||||||||
| 사용 중단되었습니다. 응답에서 생략됩니다. |
전체 공개 에지는 필드 확장을 통해 반환될 수 있습니다.
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 미디어는 지원되지 않습니다.
유형 | 설명 |
---|---|
비즈니스 관리자를 통해 앱 사용자에게 페이지에 대한 역할을 부여한 경우 다음 중 하나도 필요합니다. |
POST https://graph.facebook.com/{api-version}/{ig-media-id} ?comment_enabled={comment-enabled} &access_token={access-token}
자리 표시자 | 값 |
---|---|
| API 버전. |
| 필수 항목. IG 미디어 ID. |
키 | 자리 표시자 | 값 |
---|---|---|
|
| 필수 항목. 앱 사용자의 사용자 액세스 토큰입니다. |
|
| 필수 항목. |
curl -i -X POST \
"https://graph.facebook.com/v19.0
/17918920912340654?comment_enabled=true&access_token=EAAOc..."
{ "success": true }
지원되지 않는 작업입니다.