개요
Instagram 그래프 API는 앱이 Instagram 프로페셔널 계정(비즈니스 및 크리에이터 계정)에서 데이터에 액세스할 수 있도록 하는 Facebook 그래프 API 엔드포인트의 컬렉션입니다. Facebook 그래프 API에 익숙하지 않을 경우 이 문서를 읽기 전에 그래프 API 문서를 참조하세요.
기본 URL
모든 엔드포인트는 graph.facebook.com 호스트를 통해 액세스할 수 있습니다.
앱 사용자
Instagram 프로페셔널 계정에는 Facebook 계정을 통해 간접적으로 액세스하므로 앱 사용자는 Facebook 계정이 있어야 하고 앱에 로그인할 때 해당 계정을 사용해야 합니다. 또한, Facebook 계정은 액세스하려는 Instagram 계정과 연결된 Facebook 페이지에서 관리자에 준하는 작업을 수행할 수 있어야 합니다.
이러한 요구 사항은 앱에서 역할이 부여되거나 앱을 요청한 비즈니스에서 역할이 지정된 사용자를 포함한 모든 앱 사용자에게 적용됩니다.
인증
앱 사용자 인증은 액세스 토큰을 통해 처리됩니다. Instagram 프로페셔널 계정은 Facebook 계정을 통해 간접적으로 액세스합니다. 모든 API 요청에는 앱 사용자의 Facebook 사용자 액세스 토큰을 포함해야 합니다. Facebook 로그인을 구현하면 앱 사용자로부터 액세스 토큰을 가져올 수 있습니다. Facebook 로그인은 Instagram 자격 증명을 지원하지 않으므로 앱 사용자는 Facebook 계정을 사용하여 로그인해야 합니다.
권한 부여
엔드포인트 권한 부여는 권한과 기능을 통해 처리됩니다. 앱이 엔드포인트를 사용하여 앱 사용자의 Instagram 데이터에 액세스하기 전에 먼저 앱 사용자에게 해당 엔드포인트에 필요한 모든 권한을 요청해야 합니다. 앱 사용자는 요청된 권한을 앱에 부여해야 합니다. 권한이 부여되면 엔드포인트를 쿼리하여 사용자 데이터에 액세스할 수 있습니다.
권한을 부여한 사용자가 생성한 데이터에만 액세스가 허용됩니다. 앱에서 앱 사용자가 생성하지 않은 데이터에 액세스할 수 있는 엔드포인트가 몇 개 있지만 액세스 가능한 데이터는 제한적이고 전체 공개됩니다.
Facebook 로그인을 구현하면 앱 사용자에게 권한을 요청할 수 있습니다. 앱에서 역할이 지정된 앱 사용자는 요청된 모든 권한을 부여할 수 있습니다. 앱에서 역할이 지정되지 않은 사용자는 앱 검수 절차에서 승인된 권한과 기능만 부여할 수 있습니다.
이 API는 다음의 권한과 기능을 사용합니다.
앱에서 앱 사용자에게 요청해야 하는 권한과 기능에 대해 알아보려면 엔드포인트 참고 자료를 참조하세요.
Instagram 메시지
Messenger 플랫폼에서 Instagram 메시지를 구현하고자 하는 경우 instagram_manage_messages 권한을 포함해야 합니다. Instagram 메시지에 대해 자세히 알아보세요. 
공동 작업자
Instagram 콜라보 기능을 사용하는 Instagram 앱 사용자는 다른 계정(공동 작업자)과 함께 콘텐츠를 공동으로 작성할 수 있습니다(즉, 미디어 게시).
몇 가지 예외를 제외하고 공동으로 작성된 미디어 자체나 그와 관련된 데이터는 미디어를 게시한 사용자가 API를 통해서만 액세스할 수 있습니다. 공동 작업자는 API를 통해 이 데이터에 액세스할 수 없습니다. 성과가 가장 좋은 미디어나 최근에 특정 해시태그를 태그로 지정하여 게시한 미디어를 검색하는 경우에만 예외입니다. 자세한 내용은 해시태그 검색을 참조하세요.
페이지
Instagram 프로페셔널 계정을 Facebook 페이지에 연결해야 API를 통해 데이터에 액세스할 수 있습니다. 계정이 연결되면 해당 페이지에서 작업을 수행할 수 있는 모든 Facebook 사용자가 앱에 액세스 토큰을 부여할 수 있습니다. 그러면 이를 API 요청에 사용할 수 있습니다.
Instagram 프로페셔널 계정에 연결된 Facebook 페이지 추가 또는 변경하기 도움말 문서에서 Facebook 페이지를 Instagram 프로페셔널 계정에 연결하는 방법을 설명합니다.
작업
앱 사용자가 앱 권한을 부여하려면 액세스하려는 Instagram 계정에 연결된 Facebook 페이지에서 작업을 수행할 수 있어야 합니다. 앱 사용자는 다음과 같이 수행 가능한 작업에 따라 앱 권한을 부여할 수 있습니다.
| 권한 | MANAGE | CREATE_CONTENT | MODERATE | ADVERTISE | ANALYZE |
|---|---|---|---|---|---|
instagram_basic | ✔ | ✔ | ✔ | ✔ | ✔ |
instagram_content_publish | ✔ | ✔ | |||
instagram_manage_comments | ✔ | ✔ | ✔ | ||
instagram_manage_insights | ✔ | ✔ | ✔ | ✔ | ✔ |
앱 사용자의 사용자 액세스 토큰으로 GET /me/accounts 엔드포인트를 쿼리하면 앱 사용자가 페이지에서 수행할 수 있는 작업을 확인할 수 있습니다. 이 엔드포인트는 앱 사용자가 작업을 수행할 수 있는 페이지 리스트를 반환하고 각 페이지에서 사용자가 수행 가능한 작업을 표시합니다.
각 엔드포인트에 필요한 권한은 참고 문서를 참조하세요. 이 API는 비즈니스 관리자 시스템 사용자 또는 라이브 방송 진행자로 역할이 지정된 앱 사용자를 지원하지 않습니다.
작업의 지칭
앱 사용자에게 작업(및 앱을 적절히 사용하는 데 필요한 작업)에 대해 알려야 하는 경우 여러 UI에서 작업을 지칭하는 방법은 다음과 같습니다.
이전 페이지
이전 페이지는 작업을 역할로 지칭합니다. 페이지에서 관리자 역할이 지정된 앱 사용자는 앱에 모든 권한을 부여할 수 있습니다. 다른 역할이 지정된 앱 사용자는 다음과 같이 권한을 부여할 수 있습니다.
| 역할 | 부여 가능한 권한 |
|---|---|
편집자 | instagram_basic |
중재자 | instagram_basic |
광고주 | instagram_basic |
분석가 | instagram_basic |
새로운 환경 페이지
새로운 환경 페이지에서는 작업을 Facebook 액세스 또는 작업 액세스로 지칭합니다. 페이지에서 Facebook 액세스 권한이 있는 앱 사용자는 앱에 모든 권한을 부여할 수 있습니다. 작업 액세스 권한이 있는 앱 사용자는 다음과 같이 권한을 부여할 수 있습니다.
| 작업 액세스 권한 | 부여 가능한 권한 |
|---|---|
광고 | instagram_basic |
콘텐츠 | instagram_basic |
인사이트 | instagram_basic |
메시지 및 커뮤니티 활동 | instagram_basic |
페이지가 새로운 환경을 사용 중인지 확인하려면 has_transitioned_to_new_page_experience 필드를 요청하세요. 페이지가 새로운 환경을 사용하면 이 값은 true를 반환합니다.
앱 검수
앱이 앱 검수를 완료해야 앱에서 역할을 부여받지 못했거나 앱을 요청한 비즈니스에서 역할이 지정되지 않은 앱 사용자가 앱을 사용할 수 있습니다. 앱이나 비즈니스에서 역할이 부여된 앱 사용자만 앱을 사용할 경우 앱 검수를 완료할 필요가 없습니다.
Facebook 로그인을 구현했고 앱이 공개적으로 제공된 경우 앱 검수 제출에 Facebook 테스트 사용자 자격 증명을 포함할 필요가 없습니다. 그러나 Facebook 검수자가 Facebook 외의 계정에 로그인해서 Facebook 로그인의 구현을 트리거해야 할 경우 제출에 Facebook 외의 계정 자격 증명을 포함해야 합니다.
비공개 앱
검수자가 비공개 인트라넷 뒤에 있거나 사용자 인터페이스가 없거나 Facebook 로그인을 구현하지 않아서 앱을 테스트할 수 없을 경우, 다음의 권한에 대한 승인만 요청할 수 있습니다.
비즈니스 인증
앱 자체 또는 앱을 요청한 비즈니스에서 역할을 부여받지 않은 앱 사용자가 앱을 사용할 경우 비즈니스 인증을 완료해야 합니다.
사용 제한
모든 엔드포인트는 Instagram Business 사용 사례 사용 제한이 적용됩니다. 단, 비즈니스 검색과 해시태그 검색 엔드포인트는 예외적으로 플랫폼 사용 제한이 적용됩니다.
Webhooks
Webhooks를 사용하여 누군가가 내 앱 사용자의 미디어 개체에 댓글을 남기거나 해당 사용자의 스토리가 만료될 때마다 알림을 받을 수 있습니다. Webhooks 문서를 참조하여 Webhooks 사용 방법을 익힌 다음, Instagram 주제에 대한 Webhooks를 설정하고 comments 및 story_insights 필드를 구독하세요.
Instagram 메시지
앱 사용자가 자신의 Instagram 프로페셔널 계정으로 전송된 direct 메시지와 상호작용할 수 있도록 Messenger 플랫폼 엔드포인트와 함께 여러 가지 Instagram 그래프 API 엔드포인트가 사용됩니다. Instagram 비즈니스 계정의 메시지에 액세스하는 방법을 알아보려면 Messenger 플랫폼의 Instagram 메시지 문서를 참조하세요.