개요

페이지 API는 앱이 페이지의 설정과 콘텐츠를 만들고 관리하는 데 사용할 수 있는 Facebook 그래프 API 엔드포인트의 집합입니다.

구성 요소

액세스 토큰

API 인증은 액세스 토큰을 통해 처리됩니다. 대부분 엔드포인트는 각 페이지, 앱 사용자와 앱에 고유한 페이지 액세스 토큰이 필요하며, 각각 만료 시간이 있습니다. 앱 사용자로부터 토큰을 가져오려면 앱 사용자가 페이지를 소유하거나 작업을 수행할 수 있어야 합니다.

Facebook 로그인을 구현하여 앱 사용자에게 액세스 토큰을 받을 수 있습니다.

새 페이지 경험으로 이전한 페이지의 경우, 다음의 예외 사항을 제외하고 모든 사용 가능한 엔드포인트에 페이지 액세스 토큰이 필요합니다.

그래프 API

그래프 API에 익숙하지 않을 경우 이 문서를 읽은 후 Meta 소셜 그래프에 대해 자세히 알아보세요.

Facebook 로그인

Facebook 로그인을 사용하면 앱 사용자가 앱에 로그인하여 사용자에게 데이터에 액세스할 권한을 요청할 수 있습니다.

비즈니스용 Facebook 로그인

비즈니스용 Facebook 로그인은 기술 제공업체와 비즈니스 클라이언트의 자산에 액세스해야 하는 비즈니스 앱 개발자를 위해 고안된 인증 및 승인 솔루션입니다.

기능

일부 엔드포인트에는 기능이 필요하며, 이러한 기능은 앱 검수 절차를 거쳐 승인을 받아야 앱이 라이브 모드일 때 사용할 수 있습니다. 이러한 기능을 사용하면 권한이나 페이지에서 작업을 수행할 능력이 없어도 전체 공개 페이지 데이터에 액세스할 수 있습니다. 각 엔드포인트의 참고 문서를 참조하여 필요한 페이지 기능을 확인하세요.

언급

@언급을 사용하면 페이지에서 페이지에 게시물을 게시했거나 페이지 게시물에 댓글을 단 특정 사용자에게 댓글이나 답글을 통해 공개적으로 답할 수 있습니다.

페이지 범위 사용자 ID

페이지와 상호작용하는 사용자는 페이지 범위 사용자 ID(PSID)로 식별됩니다. PSID는 각 사용자-페이지 쌍에 고유한 ID입니다. 페이지 API와 Messenger 플랫폼 엔드포인트는 PSID를 사용하므로 PSID를 사용하여 페이지와 사용자 간의 상호작용과 해당 페이지와 사용자의 전체 공개 Messenger 대화를 식별할 수 있습니다.

권한

대부분 엔드포인트는 하나 이상의 권한이 필요합니다. 이러한 권한은 앱 사용자가 앱에 부여해야 합니다. 일반적으로 Facebook 로그인으로 권한을 부여할 수 있지만, 비즈니스에서 앱을 요청한 경우 비즈니스 관리자에서도 가능합니다.

모든 권한은 앱 검수를 거쳐야 앱 사용자가 라이브 모드인 앱에 권한을 부여할 수 있습니다. 앱 모드가 없는 비즈니스 앱의 경우, 고급 액세스에 대해 권한을 승인받아야 앱 자체나 앱을 요청한 비즈니스에서 역할을 부여받지 않은 앱 사용자도 앱에 권한을 부여할 수 있습니다.

페이지 검색

이름, 위치를 포함한 Facebook 페이지 정보와 @언급할 페이지, 페이지 위치를 찾아서 브랜디드 콘텐츠를 표시할 페이지를 태그합니다.

사용 제한

모든 페이지 엔드포인트 요청에 사용 제한이 적용됩니다. 앱 대시보드에서 앱의 기존 호출 사용 횟수를 확인할 수 있습니다.

작업

사용자는 작업을 통해 페이지에서 특정 행동을 수행할 수 있습니다. 사용자가 앱을 사용하여 페이지와 상호작용하면 Facebook에서는 사용자가 시도한 행동에 따라 먼저 해당 유형의 행동을 허용하는 작업에 대해 사용자가 승인되었는지 확인합니다.

개별 사용자를 승인할 수 있는 작업은 다음과 같습니다.

작업	허용된 행동
`ADVERTISE`	광고 만들기 비공개 페이지 게시물 작성 Instagram 계정이 페이지에 연결되어 있을 경우 광고 생성
`ANALYZE`	페이지 인사이트 확인 어느 페이지 관리자가 게시물 또는 댓글을 게시했는지 확인
`CREATE_CONTENT`	페이지에 페이지 이름으로 콘텐츠 게시
`MANAGE`	페이지 작업 할당 및 관리
`MANAGE_LEADS`	잠재 고객 조회 및 관리
`MESSAGING`	페이지 이름으로 메시지 보내기
`MODERATE`	페이지 게시물에 페이지 이름으로 댓글에 응답 페이지 게시물의 댓글 삭제 Instagram 계정이 페이지에 연결되어 있는 경우 Facebook에서 Instagram으로 콘텐츠를 게시하고 댓글에 응답하고 댓글을 삭제하고 Direct 메시지를 전송하고 비즈니스 연락처 정보를 동기화하고 광고를 만들 수 있습니다.
`VIEW_MONETIZATION_INSIGHTS`	수익화 인사이트 확인

사용자가 UI에서 페이지에 대한 관리자 액세스 권한을 부여받은 경우 해당 페이지에서 모든 작업을 수행할 수 있습니다.

Messenger 플랫폼

Messenger에서 고객 또는 페이지에 관심이 있는 사용자와 대화를 나누세요.

페이지용 Meta Webhooks

사용자가 페이지 게시물에 댓글을 달거나 공감했을 때 실시간 알림을 받습니다.

앱 검수

모든 페이지 관련 권한과 기능은 앱 검수 절차를 거쳐 승인을 받아야 앱이 라이브 모드일 때 사용할 수 있습니다.

개발 모드의 앱은 앱에서 역할이 부여된 모든 앱 사용자에게 권한을 요청할 수 있습니다.

사용 방법

페이지 API에 액세스하기 위한 일반적인 플로는 다음과 같습니다.

Facebook 로그인을 통해 앱 사용자로부터 사용자 액세스 토큰을 가져옵니다.
/me/accounts 엔드포인트를 쿼리하여 앱 사용자가 앱이 액세스하도록 허용한 페이지의 페이지 액세스 토큰과 ID를 가져옵니다.
반환된 페이지 ID와 페이지 액세스 토큰을 캡처합니다.
이 ID와 토큰을 사용하여 페이지 노드를 쿼리합니다.

경우에 따라 앱 사용자는 2개 이상의 페이지에 액세스할 권한을 앱에 부여할 수 있습니다. 이 경우 각 페이지 ID와 각 토큰을 캡처하고 앱 사용자가 해당 페이지 각각을 타게팅할 수 있는 수단을 제공해야 합니다.

다음 단계

시작하기 가이드에서 페이지 API를 사용하여 페이지 게시물을 게시하는 방법을 알아보세요.

개요