Instagram 플랫폼

공동 작업자

IG 미디어 개체에 공동 작업자로 추가된 사용자의 리스트를 나타냅니다.

Facebook 로그인을 통한 Instagram API에 사용할 수 있습니다.

만들기

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

읽기

공동 작업자로서 Instagram 사용자의 리스트와 함께 IG 미디어 개체에 대한 초대 상태를 가져옵니다.

GET /<IG_MEDIA_ID>

제한 사항

  • 최대 5개의 Instagram 계정을 공동 작업자로 추가할 수 있습니다.
  • 공동 작업자 태그 기능을 사용 설정한 Instagram 사용자만 응답에 반환됩니다.
  • 공동 작업자 태깅은 피드 이미지, 릴스, 슬라이드를 지원하고 스토리는 지원하지 않습니다.

요구 사항

유형설명

액세스 토큰

사용자 - 사용자는 IG 미디어 개체를 생성한 상태여야 합니다.

권한

instagram_basic
pages_read_engagement

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

ads_management
ads_read

요청 구문

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>/collaborators&<USER_ACCESS_TOKEN>

응답 샘플

{
  "data": [
    {
      "id": "90010775360791",
      "username": "realtest1",
      "invite_status": "Accpeted"
    },
    {
      "id": "17841449208283139",
      "username": "realtest2",
      "invite_status": "Pending"
    }
  ]
}

경로 매개변수

자리 표시자값

<API_VERSION>

API 버전.

<IG_MEDIA_ID>

필수 사항. 앱 사용자 Instagram 미디어의 ID입니다.

쿼리 문자열 매개변수

키자리 표시자값

access_token

<USER_ACCESS_TOKEN>

필수 사항. 앱 사용자의 사용자 액세스 토큰입니다.

응답 필드

필드 이름설명

id

예비 공동 작업자의 Instagram 계정의 앱 범위 ID입니다.

invite_status

예비 공동 작업자에게 보낸 초대의 상태입니다. 다음 중 하나일 수 있습니다.

  • Accepted
  • Pending

username

예비 공동 작업자의 Instagram 프로필 사용자 이름입니다.

업데이트

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

삭제

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