Permissions Reference for Meta Technologies APIs
Permissions are a form of granular, user-granted Graph API authorization. Before your app can use an endpoint to access an app user's data, the app user must grant your app all permissions required by that endpoint.
You may also use any permission granted to your app to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).
Requirements
- App Review
is required for all permissions except for emailandpublic_profileif your app needs access to data that you do not own or manage - Business Verification
is required for all apps making requests for
Advanced Access
- Only select permissions that your app needs to function as intended. Selecting unneeded permissions is a common reason for rejection during app review
- If your app requests permission to use an endpoint to access an app user’s data, you may need to complete data handling questions.
- You may also be required to complete an annual Data Use Checkup.
Ways to ask for a permission
When users log onto your app, they receive a request to grant the permissions your app has requested. Users can grant or deny the requested permissions or any subset of them.
If your app does not use a permission for 90 days, usually due to user inactivity, the app user must regrant your app that permission.
Remove a permission
You can use the app dashboard to remove a permission your app no longer uses or to remove a permission that has been deprecated.
A
| Permission | Description |
|---|---|
| ads_management 권한은 앱이 소유하거나 광고 계정 소유자가 액세스를 권한을 부여한 광고 계정을 읽고 관리하도록 허용합니다. Allowed Usage
|
| ads_read 권한은 본인이 소유하거나 다른 광고 계정의 소유자가 이 권한을 통해 액세스 권한을 부여한 광고 계정의 광고 보고서 정보를 가져올 수 있도록 광고 인사이트 API에 앱이 액세스하도록 허용합니다. 이 권한은 앱에 광고주가 서버에서 웹 이벤트를 Facebook으로 직접 보내도록 허용하는 서버측 API에 대한 액세스 권한을 부여합니다. Allowed Usage
|
| attribution_read 권한은 앱에 광고 성과 기여 API에 대한 액세스 권한을 부여하여 본인이 소유하거나 다른 비즈니스 라인의 소유자가 액세스 권한을 부여한 비즈니스 라인의 성과 기여 보고서 데이터를 가져오도록 합니다. Allowed Usage
|
C
I
| Permission | Description |
|---|---|
| instagram_basic 권한은 앱이 Instagram 계정 프로필의 정보와 미디어를 읽도록 허용합니다. Allowed Usage
|
| instagram_branded_content_ads_brand 권한은 앱 사용자의 Instagram 계정이 협찬 광고 파트너로 태그된 곳에서 앱이 Instagram 게시물을 읽고, 앱 사용자가 파트너십 광고를 게재하기 위한 권한을 읽고, 요청하고, 취소할 수 있도록 허용합니다. Allowed Usage
|
| instagram_branded_content_brand 권한을 사용하면 앱이 특정 브랜드의 승인된 크리에이터 리스트에서 크리에이터를 추가, 삭제 및 확인할 수 있습니다. 이 권한의 허용되는 사용 방법은 특정 브랜드의 Instagram 크리에이터 콘텐츠 설정을 관리하는 것입니다. 집계되고 비식별화되거나 익명화된 정보(해당 데이터가 재식별화될 수 없는 경우에 한해)를 사용하여 앱을 개선하고 마케팅과 광고를 진행하기 위해 분석 인사이트를 요청하는 데도 이 권한을 사용할 수 있습니다. Allowed Usage
|
| instagram_branded_content_creator 권한을 사용하면 앱에서 크리에이터가 만든 각 콘텐츠의 홍보 상태를 읽고 변경할 수 있습니다. 이 권한의 허용되는 사용 방법은 Instagram 크리에이터 콘텐츠 설정을 관리하는 것입니다. 집계되고 비식별화되거나 익명화된 정보(해당 데이터가 재식별화될 수 없는 경우에 한해)를 사용하여 앱을 개선하고 마케팅과 광고를 진행하기 위해 분석 인사이트를 요청하는 데도 이 권한을 사용할 수 있습니다. Allowed Usage
|
| instagram_business_basic 권한은 앱이 Instagram 비즈니스 계정 프로필의 정보와 미디어를 읽도록 허용합니다. 이 권한의 허용되는 사용 방법은 사용자 이름, ID와 같은 Instagram 비즈니스 계정 프로필의 기본 메타데이터를 가져오는 것입니다. Allowed Usage
|
| The instagram_business_content_publish permission allows an app to create organic feed photo and video posts on behalf of a business user. The allowed usage of this permission is to allow an app to manage the organic content creation process for Instagram (for example, post photos and videos) on behalf of an Instagram business account. 집계되고 비식별화되거나 익명화된 정보(해당 데이터가 재식별화될 수 없는 경우에 한해)를 사용하여 앱을 개선하고 마케팅과 광고를 진행하기 위해 분석 인사이트를 요청하는 데도 이 권한을 사용할 수 있습니다. Allowed Usage
|
| instagram_business_manage_comments 권한이 부여된 앱은 해당 계정이 태그되거나 댓글에 언급된 공개 게시물과 Instagram 스토리뿐만 아니라 Instagram 프로페셔널 계정의 댓글에 액세스할 수 있습니다. 이 권한의 허용되는 사용 방법은 Instagram 프로페셔널 계정의 댓글을 작성하고, 업데이트하고, 삭제하는 것입니다. Allowed Usage
|
| instagram_business_manage_messages 권한은 앱이 Instagram 프로페셔널 계정 메시지에 액세스하도록 허용합니다. 이 권한의 허용되는 사용 방법은 메시지를 보고, 관리하고, 응답하며 타사 고객 관계 관리(CRM) 도구를 사용하여 메시지를 관리하는 것입니다. Allowed Usage
|
| instagram_content_publish 권한은 앱이 비즈니스 사용자를 대신하여 일반 피드 사진과 동영상 게시물을 만들도록 허용합니다. Allowed Usage
|
| instagram_graph_user_media 권한은 앱이 이미지, 동영상, 사진첩이나 노드 에지를 보여주는 미디어 노드를 읽도록 허용합니다. Allowed Usage
|
| instagram_graph_user_profile 권한은 앱이 앱 사용자의 프로필을 읽도록 허용합니다. Allowed Usage
|
| instagram_manage_comments 권한은 앱이 페이지에 연결된 Instagram 계정을 대신하여 댓글을 작성하고 삭제하고 숨기도록 허용합니다. 또한 앱이 비즈니스가 사진에 태그되거나 @ 기호로 언급된 전체 공개 미디어나 댓글을 읽고 응답할 수 있습니다. Allowed Usage
|
| The instagram_manage_events permission allows an app permission to log events (e.g., purchase, add-to-cart, leads) on behalf of Instagram accounts administered by the app’s users. The allowed usage for this permission is to log events on Instagram accounts and send this activity data to Meta for ads targeting, optimization and reporting; and to provide marketing and advertising analytics insights. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified). Allowed Usage
|
| instagram_manage_insights 권한은 앱이 Facebook 페이지에 연결된 Instagram 계정의 인사이트에 액세스하도록 허용합니다. 또한 앱이 다른 비즈니스 프로필의 프로필 정보와 미디어를 둘러보고 읽을 수 있습니다. Allowed Usage
|
| instagram_manage_messages 권한은 비즈니스 사용자가 Instagram Direct 메시지를 읽고 답장하도록 허용합니다. Allowed Usage
|
| instagram_shopping_tag_products 권한을 사용하면 앱에서 제품 태그로 Instagram 미디어를 태그하고 제품 거부에 대해 재고를 요청할 수 있습니다. Allowed Usage
|
| The instagram_manage_upcoming_events permission allows an app to read, create, and update upcoming events on behalf of Instagram accounts administered by people using the app. The allowed usage for this permission is to manage upcoming events on Instagram accounts administered by the people using the app. 집계되고 비식별화되거나 익명화된 정보(해당 데이터가 재식별화될 수 없는 경우에 한해)를 사용하여 앱을 개선하고 마케팅과 광고를 진행하기 위해 분석 인사이트를 요청하는 데도 이 권한을 사용할 수 있습니다. Allowed Usage
|
L
M
P
| Permission | Description |
|---|---|
| page_events 권한은 앱이 앱 사용자가 관리하는 Facebook 페이지를 대신하여 이벤트를 로깅하고 이 이벤트를 광고 타게팅, 최적화, 보고를 위해 Facebook에 전송하도록 허용합니다. Allowed Usage
|
| pages_manage_ads 권한은 앱이 페이지와 연결된 광고를 관리하도록 허용합니다. Allowed Usage
|
| pages_manage_cta 권한은 앱이 Facebook 페이지의 행동 유도 버튼을 관리하기 위해 사용되는 엔드포인트의 POST와 DELETE 기능을 수행하도록 허용합니다. Allowed Usage
|
| pages_manage_instant_articles 권한은 앱이 앱 사용자가 관리하는 Facebook 페이지를 대신하여 인스턴트 아티클을 관리하도록 허용합니다. Allowed Usage
|
| pages_manage_engagement 권한은 앱이 페이지에 댓글을 작성하거나 페이지에 게시된 댓글을 수정하거나 삭제하도록 허용합니다. Allowed Usage
|
| pages_manage_metadata 권한은 앱이 페이지에서의 활동에 관한 Webhook을 구독하고 받도록 허용하며 페이지의 설정을 업데이트하도록 허용합니다. Allowed Usage
|
| pages_manage_posts 권한은 앱이 본인 페이지에 게시물을 작성하거나 수정하거나 삭제하도록 허용합니다. Allowed Usage
|
| pages_messaging 권한은 앱이 Messenger에서 페이지 대화를 관리하고 액세스하도록 허용합니다. Allowed Usage
|
| pages_read_engagement 권한은 앱이 페이지가 게시한 콘텐츠(게시물, 사진, 동영상, 이벤트)와 팔로워 데이터(예: 이름, PSID), 프로필 사진, 메타데이터와 기타 페이지 관련 인사이트를 읽도록 허용합니다. Allowed Usage
|
| pages_read_user_content 권한은 앱이 페이지의 사용자 생성 콘텐츠(예: 게시물, 댓글, 사용자나 다른 페이지의 평가)를 읽고 페이지 게시물의 사용자 댓글을 삭제하도록 허용합니다. Allowed Usage
|
| pages_show_list 권한은 앱이 사용자가 관리하는 페이지의 리스트를 액세스하도록 허용합니다. Allowed Usage
|
| pages_user_gender 권한은 앱과 연결된 페이지를 통해 앱이 사용자의 성별에 액세스하도록 허용합니다. Allowed Usage
|
| pages_user_locale 권한은 앱과 연결된 페이지를 통해 앱이 사용자의 언어에 액세스하도록 허용합니다. Allowed Usage
|
| pages_user_timezone 권한은 앱과 연결된 페이지를 통해 앱이 사용자의 시간대에 액세스하도록 허용합니다. Allowed Usage
|
| The private_computation_access permission allows an app to access the Meta Private Computation products. Allowed Usage
|
| public_profile 권한이 부여된 앱은 사용자 노드에서 기본 공개 프로필 필드를 읽을 수 있습니다. 이 권한은 자동으로 모든 앱에 부여됩니다. Allowed Usage
|
| publish_video 권한은 앱이 앱 사용자의 타임라인, 그룹, 이벤트 또는 페이지에 라이브 방송을 게시하도록 허용합니다. Allowed Usage
|
T
U
W
| 권한 | 종속성 | 설명 |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|