공동 작업자

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

만들기

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

읽기

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

GET /{ig-media-id}

제한 사항

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

요구 사항

유형설명

액세스 토큰

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

권한

instagram_basic
pages_read_engagement
pages_show_list


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


ads_management
business_management

요청 구문

GET https://graph.facebook.com/{appi-version}/{ig-media-id}/collaborators

응답 샘플

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

경로 매개변수

자리 표시자

{api-version}

API 버전.

{ig-user-id}

필수 항목. IG 사용자 ID.

쿼리 문자열 매개변수

자리 표시자

access_token

{access-token}

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

응답 필드

필드 이름설명

id

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

invite_status

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

  • Accepted
  • Declined
  • Pending

username

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

업데이트

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

삭제

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