IG 컨테이너

Instagram 게시물을 게시하기 위한 미디어 컨테이너를 나타냅니다. 전체적인 게시 절차에 대한 자세한 내용은 콘텐츠 게시 가이드를 참조하세요.

만들기

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

읽기

GET /{instagram-container-id}

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

요구 사항

유형설명

액세스 토큰

사용자

권한

instagram_basic
instagram_content_publish
pages_read_engagement


또한 비즈니스 관리자를 통해 앱 사용자에게 페이지에 대한 역할을 부여한 경우 다음 중 하나의 권한이 필요합니다.


ads_management
business_management

요청 구문

GET https://graph.facebook.com/{instagram-container-id}
  ?fields={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입니다(코드 예시에서 {instagram-container-id}로 표시됨).

status

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

status_code

컨테이너의 게시 상태입니다. 가능한 값은 다음과 같습니다.


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

에지

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

응답

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

{
  "{field}":"{value}",
  ...
}

요청 샘플

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

응답 샘플

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

업데이트

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

삭제

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