Instagram(IG) 컨테이너

Instagram 미디어 개체를 게시하기 위한 미디어 컨테이너를 나타냅니다.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User user access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_basic
  • instagram_content_publish
  • pages_read_engagement

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • ads_read

만들기

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

읽기

GET <HOST_URL>/<IG_CONTAINER_ID>

IG 컨테이너에서 필드에지를 가져옵니다.

요청 구문

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

쿼리 문자열 매개변수

매개변수

access_token
필수
문자열

앱 사용자의 사용자 액세스 토큰.

fields
쉼표로 구분된 리스트

반환하고자 하는 필드에지의 쉼표로 구분된 리스트. 생략할 경우 기본 필드가 반환됩니다.

필드

필드 이름설명

copyright_check_status

업로드된 동영상이 저작권을 위반하는지 확인하는 데 사용합니다. 키-값 쌍이 다음 항목과 함께 반환됩니다.

  • 다음 중 하나로 설정된 matches_found:
    • true – 동영상이 저작권을 위반합니다.
    • false – 동영상이 저작권을 위반하지 않습니다.
  • 다음 중 하나로 설정된 status:
    • completed – 탐지 과정이 완료되었습니다.
    • error – 탐지 과정에서 오류가 발생했습니다.
    • in_progress – 탐지 과정이 진행 중입니다.
    • not_started – 탐지 과정이 시작되지 않았습니다.

id

Instagram 컨테이너 ID입니다(코드 예시에서 <IG_CONTAINER_ID>로 표시됨).

status

게시 상태입니다. status_codeERROR일 경우 이 값은 오류 하위 코드가 됩니다.

status_code

컨테이너의 게시 상태입니다. 가능한 값:


  • EXPIRED — 컨테이너가 24시간 이내에 게시되지 않아서 만료되었습니다.
  • ERROR — 컨테이너가 게시 프로세스를 완료하지 못했습니다.
  • FINISHED — 컨테이너와 해당 미디어 개체를 게시할 준비가 되었습니다.
  • IN_PROGRESS — 컨테이너가 아직 게시 절차 중에 있습니다.
  • PUBLISHED — 컨테이너의 미디어 개체가 게시되었습니다.

에지

이 노드에는 에지가 없습니다.

응답

기본 및 요청된 필드를 포함한 JSON 형식 개체.

{
  "<FIELD>":"<VALUE>",
  ...
}

요청 예시

curl -X GET \
  'https://graph.instagram.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

응답 샘플

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

업데이트

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

삭제

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