권한 참조 - Facebook 로그인

권한마다 고유한 요구 사항과 모범 이용 사례가 있습니다. 기본값인 public_profile을 제외한 모든 권한은 앱 대시보드의 Facebook 로그인 탭에서 앱에 대한 클라이언트 OAuth 로그인을 활성화해야 합니다. 검수하지 않아도 되는 권한도 있지만 대부분은 검수가 필요합니다. 각 권한의 상세 정보를 확인하여 앱에서 권한을 사용하는 방법에 대해 자세히 알아보세요. 이러한 권한의 사용은 모두 플랫폼 정책 및 해당 개인정보처리방침에 따라 달라집니다.

사용 중단된 권한

public_profile(기본 권한)

공개 프로필의 일부 정보에 대한 액세스를 제공합니다. 공개 프로필은 기본적으로 사용자 개체의 다음 속성을 참조합니다.

  • id
  • cover
  • name
  • first_name
  • last_name
  • age_range
  • link
  • gender
  • locale
  • picture
  • timezone
  • updated_time
  • verified

웹에서는 public_profile을 선언하는 것이 모범 사례이지만, 이 속성은 모든 요청에 암시되어 있으며 필수가 아닙니다. iOS와 Android에서는 로그인 플로의 일부로 이 속성을 수동으로 요청해야 합니다.

다음과 같은 경우에만 genderlocale에 액세스할 수 있습니다.

  • 검색된 사람은 앱 사용자입니다.
  • 검색된 사람은 앱 사용자이며 다른 앱 사용자의 친구입니다.
  • 검색된 사람은 앱 사용자지만 다른 앱 사용자의 친구는 아닙니다. 그러나 앱에는 호출과 함께 appsecret_proof 인수 또는 앱 액세스 토큰이 포함되어 있습니다.

다음과 같은 경우에만 timezoneverified에 액세스할 수 있습니다.

  • 검색된 사람이 요청하는 사람과 같습니다.

검수

Facebook에서 검수하지 않고 앱에서 이 권한을 사용할 수 있습니다.

user_friends

마찬가지로 앱 사용자인 친구 리스트에 대한 액세스를 제공합니다. 이러한 친구는 사용자 개체의 친구 에지에서 찾을 수 있습니다.

한 사람이 다른 한 사람의 친구 리스트에 표시되려면 사람 모두 앱과 친구 리스트를 공유하도록 결정하여 로그인 중에 해당 권한을 사용하지 않도록 설정하지 않아야 합니다. 또한 로그인 프로세스 중에 두 친구 모두에게 user_friends를 요청했어야 합니다.

검수

Facebook에서 검수하지 않고 앱에서 이 권한을 사용할 수 있습니다.

일반 사용

친구 리스트를 사용하여 앱에서 소셜 환경을 만듭니다.

email

user 개체에서 email 속성을 통해 기본 이메일 주소에 대한 액세스를 제공합니다.

사용자에게 스팸 메일을 보내지 마세요. Facebook 정책스팸 메일 규제법(CAN-SPAM Act) 둘 다를 준수하여 이메일을 사용해야 합니다.

email 권한을 요청하는 경우에도 이메일 주소를 받는다는 보장은 없습니다. 예를 들어, 이메일 주소 대신 전화번호를 사용하여 Facebook에 가입한 경우 이메일 필드는 비워둘 수 있습니다.

검수

Facebook에서 검수하지 않고 앱에서 이 권한을 사용할 수 있습니다.

확장 프로필 속성

로그인 플로 중에 표시되는 로그인 대화 상자에서 이러한 권한은 앱에 로그인한 사용자의 선택 사항이 아닙니다. 이러한 권한을 선택 사항으로 제공하려면 첫 로그인이 아니라 꼭 필요한 경우에 요청하도록 앱을 구성해야 합니다.

publish_actions

개발자의 앱을 사용하는 사용자 대신 게시물, 오픈 그래프 액션 및 기타 활동을 게시하기 위한 액세스 권한을 제공합니다.

이 권한을 통해 사용자 대신 게시할 수 있으므로, 플랫폼 정책을 참조하여 이 권한을 적절하게 사용하는 방법을 파악하세요.

피드 대화 상자, 요청 대화 상자 또는 보내기 대화 상자를 사용하기 위해 publish_actions 권한을 요청하지 않아도 됩니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

앱 검수를 통해 이 권한을 요청하는 경우에는 Facebook 팀에서 쉽게 재현할 수 있도록 안내를 작성하세요.

모범 이용 사례

앱으로부터 맞춤 작성 도구의 Facebook으로 콘텐츠를 명시적으로 게시할 수 있습니다.

사용자에게 적절한 알림과 관리 권한을 제공한 경우 오픈 그래프 소식을 원활하게 게시할 수 있습니다.

사용자에게 알리지 않거나 관리 권한을 제공하지 않은 경우에는 자동으로 소식을 게시하는 데 사용하지 않습니다.

대화 상자나 소셜 플러그인을 통해 게시할 때는 이 권한이 필요하지 않습니다. 공유 대화 상자, 피드 대화 상자, 메시지 대화 상자 등이나 소셜 플러그인(예: 좋아요 버튼)만 사용하는 경우 이 권한의 검수를 요청하지 마세요.

사용자가 공유하기 전에 콘텐츠를 수정하거나 삭제할 수 있더라도 사용자가 만들지 않은 콘텐츠로 게시물의 사용자 메시지 매개변수를 미리 입력하는 데 사용하지 않습니다.

서비스 또는 제품에 대한 액세스 권한을 부여하거나 사용자, 그룹 또는 이벤트 타임라인에 대한 공유에 혜택을 제공합니다.

user_about_me

User 개체를 통해 개인 설명(프로필의 '내 정보' 섹션)에 대한 액세스를 제공합니다.

이 권한이 있어도 공개 프로필 데이터에는 액세스할 수 없습니다.public_profile 권한에는 기본적으로 이름, 프로필 사진, 언어, 연령대 및 성별이 포함됩니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

Facebook 프로필에서 '내 정보'를 공개하여 앱 내에서 프로필을 개선합니다.

기존 프로필 정보를 결정합니다. 이 정보는 앱에 로그인한 모든 사용자가 부여하는 public_profile에 포함되어 있습니다.

user_actions.books

사용자가 사용한 앱에서 게시한 모든 일반 도서 액션에 대한 액세스를 제공합니다. 여기에는 읽었거나, 읽고 싶거나, 평가했거나인용한 도서가 포함됩니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

일반 사용

읽었거나, 읽고 싶거나, 평가했거나 인용한 도서 정보를 기반으로 사용자의 환경을 맞춤 설정합니다.

이전에 읽은 도서를 기반으로 읽을 도서를 추천합니다.

user_actions.fitness

사용자가 사용한 앱에서 게시한 모든 일반 오픈 그래프 피트니스 액션에 대한 액세스를 제공합니다. 여기에는 달리기, 걷기자전거 액션이 포함됩니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

일반 사용

피트니스 활동을 기반으로 환경을 맞춤 설정합니다.

시간 흐름에 따른 피트니스 활동 집계를 표시합니다.

앱을 사용하는 다른 사람과 피트니스 활동을 비교하여 표시합니다.

개인적으로 피트니스 목표를 설정하여 달성하도록 지원합니다.

user_actions.music

사용자가 사용한 앱에서 게시한 모든 일반 오픈 그래프 음악 액션에 대한 액세스를 제공합니다. 여기에는 감상한 음악만든 재생 리스트가 포함됩니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

일반 사용

과거에 감상한 곡을 기반으로 음악을 추천합니다.

감상한 곡에 따라 콘서트/이벤트 및 기타 콘텐츠를 연결합니다.

가장 인기 있는 아티스트와 앨범이 무엇인지 알려줍니다.

user_actions.news

사용자가 사용했으며 해당 액션을 공개하는 앱에서 게시한 모든 일반 오픈 그래프 뉴스 액션에 대한 액세스를 제공합니다. 여기에는 읽은 뉴스 기사 또는 게시한 뉴스 기사가 포함됩니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

일반 사용

관련 도서, 기사 또는 이벤트를 공개하여 맞춤 조정된 콘텐츠 환경을 시각적으로 제공합니다.

뉴스 활동을 기반으로 환경을 맞춤 설정합니다.

user_actions.video

사용자가 사용했으며 해당 액션을 게시하는 앱에서 공개한 모든 일반 오픈 그래프 동영상 액션에 대한 액세스를 제공합니다. 여기에는 시청한 동영상, 평가한 동영상시청하고 싶은 동영상이 포함됩니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

일반 사용

사용자가 액션을 취한 동영상, 영화 및 TV 프로그램을 공개하여 맞춤 조정된 콘텐츠 환경을 시각적으로 제공합니다.

시청한 동영상, TV 프로그램 및 동영상을 기반으로 환경을 맞춤 설정합니다.

user_actions:{app_namespace}

지정된 앱의 모든 맞춤 오픈 그래프 액션에 대한 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

다른 앱에서 게시한 오픈 그래프 액션을 기반으로 환경을 맞춤 설정합니다.

user_birthday

생년월일의 월과 날짜 정보에 액세스합니다. 이 필드를 검색하는 데 사용 중인 액세스 토큰과 공개 범위 설정에 따라 여기에는 출생연도가 포함되거나 포함되지 않을 수 있습니다.

대부분의 통합에서는 public_profile 권한의 일부로 제공되는 age_range만 필요합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

검수를 위해 제출할 때 age_range외에도 이 정보가 함께 필요한 이유를 명확히 설명하세요.

모범 이용 사례

생년월일 정보에 따라 연령에 맞는 콘텐츠를 제공합니다.

연령대 정보만으로 충분하지 않은 내용에 대해 연령에 맞는 콘텐츠를 제공합니다.

사용자의 연령을 판별(만 19세 미만, 만 19세 이상, 만 22세 이상 등)하기 위해 사용하지 않습니다. 사용하기 전에 확인할 필요가 없는 경우에는 public_profile 권한의 일부로 제공되는 age_range 필드를 사용합니다.

user_education_history

사용자 개체education 필드를 통해 학력에 대한 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

동창과 관련된 콘텐츠를 공개합니다.

같은 학교를 졸업한 다른 사람들과 연결하도록 지원합니다.

앱에 명시적으로 표시되지 않는 분석을 수행하는 데는 사용하지 않습니다.

user_events

사용자가 주최하거나 참석한 이벤트에 대한 읽기 전용 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

달력 및 이벤트 정보(예: 기기 앱, 일정 앱, 콘서트 앱) 조회에 관한 문제를 줄입니다.

이벤트 만들기는 허용되지 않습니다. 그래프 API를 통해 이벤트를 만들 수 없습니다.

앱을 사용하여 이벤트에 참석 여부를 보내는 데 사용할 수 없습니다. 이를 위해서는 rsvp_event 권한을 요청하세요.

user_games_activity

사용자가 이용한 모든 게임에서 게임 활동(점수, 기록)을 확인할 수 있도록 액세스 권한을 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

간단한 게임 기록 리스트나 게임 API에 대한 일반적인 액세스 권한을 제공합니다.

앱에 명시적으로 표시되지 않는 분석을 수행하기 위해 사용하지 않습니다.

user_groups


이 권한은 그래프 API 버전 v2.3 이상을 사용하는 앱에서만 사용할 수 있습니다.


사용자 개체그룹 에지를 통해 앱에서 사용자가 구성원으로 속한 그룹을 읽을 수 있습니다.

이 권한을 통해서는 사용자 대신 그룹을 만들 수 없습니다. 그래프 API를 통한 그룹 만들기는 가능하지 않습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

제한된 사용

이 권한은 아직 Facebook을 사용할 수 없는 플랫폼에서 Facebook 브랜디드 클라이언트를 빌드하는 앱에 부여됩니다. 예를 들어, Android와 iOS 앱은 이 권한을 사용하도록 승인되지 않습니다. 웹, 데스크톱, 자동차 장착 및 TV 앱에도 이 권한이 부여되지 않습니다.

user_hometown

사용자 개체hometown 필드를 통해 출신지에 대한 액세스를 제공합니다. 이는 사용자의 프로필 정보에 따라 설정됩니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

사용자의 거주지나 출신지에 따라 환경을 맞춤 설정합니다.

고향이 같은 다른 사용자와 연결하도록 지원합니다.

user_likes

사용자가 좋아요를 클릭한 모든 Facebook 페이지와 오픈 그래프 개체 리스트에 대한 액세스를 제공합니다. 이 리스트는 사용자 개체에서 좋아요 에지를 통해 사용할 수 있습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

사용자의 활동과 관련된 콘텐츠를 공개하여 맞춤 설정된 환경을 만듭니다.

상호 관심이 있는 다른 사용자와 시각적으로 연결할 수 있게 합니다.

페이지 좋아요를 클릭했는지에 따라 앱 또는 앱 내 콘텐츠에 대한 액세스 권한을 부여하기 위해 사용할 수 없습니다.

user_location

사용자 개체location 필드를 통해 거주지에 대한 액세스를 제공합니다. 거주지는 사용자가 프로필에서 설정합니다.

거주지는 출신지와 다를 수 있습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

거주지를 기반으로 환경을 맞춤 설정합니다.

거주지와 관련된 콘텐츠를 공개합니다.

거주지가 같은 다른 사용자와 연결하도록 지원합니다.

user_managed_groups

사용자 개체그룹 에지를 통해 앱에서 사용자가 관리자인 그룹의 콘텐츠를 읽을 수 있습니다.

이 권한을 통해서는 사용자 대신 그룹을 만들 수 없습니다. 그래프 API를 통한 그룹 만들기는 가능하지 않습니다. 사용자가 구성원으로만 속해 있는 그룹은 읽을 수 없습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

제한된 사용

여러 그룹을 관리할 수 있도록 지원하는 인터페이스를 제공합니다.

사용자가 관리(publish_actions 권한도 필요)하는 그룹에 게시물을 올립니다.

이 데이터를 비가시적으로 사용(예: 반응 분석 또는 스팸 봇으로부터 보호)하지 않습니다.

user_photos

사용자가 업로드하거나 태그된 사진에 대한 액세스를 제공합니다. 이 기능은 사용자 개체에서 사진 에지를 통해 사용할 수 있습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

디지털 사진 프레임에 사진을 표시합니다.

인쇄를 위해 사진을 내보낼 수 있게 지원합니다. 개인적이고 비상업적인 용도로만 이 서비스를 제공합니다.

앱 내 환경을 시각적으로 향상하는 방식으로 사용하기 위해 사진에 액세스합니다(예: 사진 수정, 콜라주, 슬라이드쇼 및 face-in-hole 앱).

이전 프로필 사진에 액세스합니다.

사용자 대신 사진첩을 만듭니다(사진을 게시하려면 publish_actions 권한이 필요함).

user_posts

타임라인의 게시물에 대한 액세스를 제공합니다. 고유 게시물, 태깅된 게시물 및 다른 사용자가 타임라인에 만든 게시물이 포함됩니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

타임라인 게시물에서 창의적인 콘텐츠를 제공합니다.

타임라인에 있는 게시물의 콘텐츠를 시각적으로 분석하여 사용자에게 값을 제공합니다.

이 데이터를 비가시적으로 사용(예: 반응 분석 또는 스팸 봇으로부터 보호)하지 않습니다.

user_relationships

사용자 개체의 필드로 제공되는 개인의 결혼/연애 상태, 배우자/연애 상대 및 가족에 대한 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

가족 연결 관계와 관련된 콘텐츠를 공개합니다. 예를 들어, 가족 관계가 아버지로 등록되어 있다면, 아버지에게 관련된 콘텐츠를 표시합니다.

가계도 앱과 같은 가족 관계 정보가 필요한 유틸리티 앱의 문제를 줄입니다.

user_relationship_details

사용자 개체interested_in 필드로 제공되는 관계 관심사에 대한 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

'관심사' 상세 정보를 기반으로 맞춤 지정된 콘텐츠를 제공합니다.

user_religion_politics

종교 및 정치적 성향에 대한 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

신념 또는 정치 단체와 관련된 콘텐츠를 공개합니다.

비슷한 관심사를 기반으로 다른 사용자와의 연결을 최적화합니다.

user_status


이 권한은 그래프 API 버전 v2.3 이상을 사용하는 앱에서만 사용할 수 있습니다.

엔드포인트 /{user-id}/posts 또는 /{user-id}/feed를 호출하는 경우 user_posts 권한을 대신 요청합니다(v2.3 이전만 해당).


사용자의 상태에 대한 액세스를 제공합니다. 이것은 링크, 동영상 또는 사진을 포함하지 않는 Facebook 게시물입니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

상태 업데이트에서 창의적인 콘텐츠를 제공합니다.

과거 상태의 콘텐츠를 시각적으로 분석하여 사용자에게 값을 제공합니다.

이 데이터를 비가시적으로 사용(예: 반응 분석 또는 스팸 봇으로부터 보호)하지 않습니다.

user_tagged_places

사진, 동영상, 상태 및 링크에서 사용자가 태그된 위치에 대한 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

사용자가 있던 장소를 기반으로 맞춤 지정된 콘텐츠를 제공합니다.

사용자가 이전에 태그된 장소를 기반으로 방문할 장소를 추천합니다.

지도에 체크인 내역을 표시합니다.

user_videos

사용자가 업로드하거나 태그된 동영상에 대한 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

앱 내 환경을 시각적으로 향상하는 방식으로 사용하기 위해 동영상에 액세스합니다(예: 동영상 편집, 콜라주, 포트폴리오, 슬라이드쇼 앱).

셋톱 박스를 통해 TV에 동영상을 표시하거나 디지털 사진 프레임에 동영상을 표시합니다.

user_website

사용자 개체website 필드를 통해 개인 웹사이트 URL에 대한 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

개인 웹사이트 정보를 사용하는 포트폴리오, 이력서 또는 비즈니스 앱의 문제를 줄입니다.

user_work_history

사용자 개체work 필드를 통해 개인의 직장 이력 및 고용주 리스트에 대한 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

업종, 직위 등을 기반으로 관련 콘텐츠를 공개합니다.

공통된 직장 이력을 기반으로 다른 사람들과 연결하도록 지원합니다.

앱에 명시적으로 표시되지 않는 분석을 수행하기 위해 사용하지 않습니다.


확장된 권한

확장된 권한은 더욱 민감한 정보에 대한 액세스를 제공하고, 앱에서 데이터를 게시 및 삭제하는 기능을 제공합니다. 확장된 권한 모두 로그인 플로 중에 별도의 화면에 표시되므로 해당 권한을 부여할지 선택할 수 있습니다.

read_custom_friendlists

친구 리스트를 정리하기 위해 만든 맞춤 설정 리스트 이름에 대한 액세스를 제공합니다. 개발자의 앱에서 Facebook에 소식을 게시할 때 공개 대상 선택 도구를 렌더링하는 데 유용합니다.

이 권한이 있어도 사용자의 친구 리스트에 액세스할 수는 없습니다. 마찬가지로 개발자의 앱을 사용하는 친구에도 액세스하려면 user_friends 권한을 사용해야 합니다.

이 권한이 있어도 앱을 사용하도록 사용자의 친구를 초대하는 데는 도움이 되지 않습니다. 앱에 친구를 초대하는 방법에 대한 자세한 내용은 FAQ를 참조하세요.

이 권한이 있어도 friendlist에 포함된 친구의 리스트가 제공되지 않습니다. 리스트 이름에 대한 액세스만 제공합니다.

v2.3 이전에 이 권한은 read_friendlists라고 했습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

앱에서 공개한 특정 소식이 표시될 대상을 선택할 수 있도록 맞춤 공개 대상 선택 도구를 빌드합니다.

read_insights

사용자가 소유하는 페이지, 앱 및 웹 도메인의 인사이트 데이터에 대한 읽기 전용 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

Facebook 앱, 페이지 또는 도메인 인사이트를 고유 분석 도구에 통합합니다.

인사이트 데이터를 타사에 전송 또는 판매하기 위한 목적으로 사용하지 않습니다.

비가시적인 인사이트 사용을 제공하기 위해 사용하지 않습니다.

read_audience_network_insights

사용자가 소유하는 앱의 Audience Network 인사이트 데이터에 대한 읽기 전용 액세스를 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

Facebook 앱 Audience Network 인사이트를 고유 분석 도구에 통합합니다.

인사이트 데이터를 타사에 전송 또는 판매하기 위한 목적으로 사용하지 않습니다.

비가시적인 인사이트 사용을 제공하기 위해 사용하지 않습니다.

read_mailbox


이 권한은 그래프 API 버전 v2.3 이상을 사용하는 앱에서만 사용할 수 있습니다.


받은 메시지함 에지스레드 노드를 통해 Facebook 받은 메시지함의 메시지를 읽을 수 있는 기능을 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

제한된 사용

이 권한은 아직 Facebook을 사용할 수 없는 플랫폼에서 Facebook 브랜디드 클라이언트를 빌드하는 앱에 부여됩니다. 예를 들어, Android와 iOS 앱은 이 권한을 사용하도록 승인되지 않습니다. 웹, 데스크톱, 자동차 장착 및 TV 앱에도 이 권한이 부여되지 않습니다.

read_page_mailboxes

사용자가 관리하는 페이지의 페이지 받은 메시지함에서 읽는 기능을 제공합니다. 이 권한은 종종 manage_pages 권한과 함께 사용됩니다.

이 권한이 있어도 앱에서 페이지 소유자의 사서함을 읽을 수 없습니다. 이것은 페이지의 사서함에만 적용됩니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

개발자의 앱을 통해 페이지의 사서함을 관리할 수 있게 합니다.

read_stream


이 권한은 그래프 API 버전 v2.3 이상을 사용하는 앱에서만 사용할 수 있습니다.user_posts를 가능한 대안으로 참조하세요.


뉴스피드의 게시물 또는 프로필의 게시물을 읽는 액세스 권한을 제공합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

제한된 사용

이 권한은 아직 Facebook을 사용할 수 없는 플랫폼에서 Facebook 브랜디드 클라이언트를 빌드하는 앱에 부여됩니다. 예를 들어, Android와 iOS 앱은 이 권한을 사용하도록 승인되지 않습니다. 웹, 데스크톱, 자동차 장착 및 TV 앱에도 이 권한이 부여되지 않습니다.

instagram_basic

액세스 권한이 있는 Instagram 계정을 읽을 수 있는 기능을 제공합니다. 자세한 내용은 Instagram의 시작하기 가이드를 참조하세요.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

Instagram Business 계정의 기본 메타데이터 얻기.

instagram_manage_comments

액세스 권한이 있는 Instagram 계정을 읽을 수 있는 기능을 제공합니다. 자세한 내용은 Instagram의 시작하기 가이드를 참조하세요.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

Instagram Business 계정의 댓글을 읽고 업데이트하고 삭제합니다.

Instagram Business 계정의 미디어 개체(예: 스토리)를 읽습니다.

instagram_manage_insights

액세스 권한이 있는 Instagram 계정의 인사이트를 읽을 수 있는 기능을 제공합니다. 자세한 내용은 Instagram의 시작하기 가이드를 참조하세요.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

Instagram Business 계정의 메타데이터를 얻습니다.

Instagram Business 계정의 데이터 인사이트를 얻습니다.

Instagram Business 계정의 스토리 인사이트를 얻습니다.

manage_notifications


이 권한은 그래프 API 버전 v2.3 이상을 사용하는 앱에서만 사용할 수 있습니다.


앱에서 사용자의 알림을 읽은 다음 읽음으로 표시할 수 있습니다.

이 권한이 있어도 사용자에게 알림을 보낼 수 없습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

제한된 사용

이 권한은 아직 Facebook을 사용할 수 없는 플랫폼에서 Facebook 브랜디드 클라이언트를 빌드하는 앱에 부여됩니다. 예를 들어, Android와 iOS 앱은 이 권한을 사용하도록 승인되지 않습니다. 웹, 데스크톱, 자동차 장착 및 TV 앱에도 이 권한이 부여되지 않습니다.

manage_pages

사용자가 관리하는 페이지와 앱의 페이지 액세스 토큰을 앱에서 검색할 수 있습니다.

페이지로 공개하려면 앱에 manage_pagespublish_pages가 둘 다 필요합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다. Facebook에서 검수하지 않고 앱 대시보드의 역할 섹션에 나열되는 사용자 대신 이 권한을 부여할 수 있습니다.

검수를 위해 제출하는 경우에는 Facebook 팀에서 쉽게 재현할 수 있게 안내를 작성하세요. 예를 들어, 페이지 관리 도구에 고유 인증 시스템이 있으면 검수 팀에서 개발자의 도구를 사용하여 이 기능을 테스트할 수 있도록 유효한 로그인 정보(예: 사용자 이름/비밀번호)를 제공하세요.

일반 사용

앱을 사용하는 사용자가 소유한 페이지에 콘텐츠를 게시합니다. 게시할 때는 publish_pages 권한도 필요합니다.

사용자가 페이지에 올린 게시물, 댓글 및 좋아요를 관리하는 데 도움을 줍니다.

publish_pages

manage_pages 권한도 있는 경우, 앱에서 앱 사용자가 관리하는 페이지로 게시하고, 댓글을 달며 좋아요를 클릭할 수 있습니다.

페이지로 공개하려면 앱에 manage_pagespublish_pages가 둘 다 필요합니다.

이 권한으로는 개별 개인 계정에서 게시할 수 없습니다. 개별적으로 게시하려면 publish_actions 권한을 참조하세요.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

앱 검수를 통해 이 권한을 요청하는 경우에는 Facebook 팀에서 쉽게 재현할 수 있도록 안내를 작성하세요.

모범 이용 사례

앱으로부터 맞춤 작성 도구 내에서 관리하는 Facebook 페이지로 콘텐츠를 명시적으로 게시할 수 있습니다.

사용자가 관리하는 페이지 대신 원활하게 좋아요를 클릭하고 댓글을 답니다.

사용자에게 알리지 않거나 관리 권한을 제공하지 않은 경우에는 자동으로 소식을 게시하는 데 사용하지 않습니다.

페이지 관리자가 공유하기 전에 콘텐츠를 수정하거나 삭제할 수 있더라도 사용자나 비즈니스가 만들지 않은 콘텐츠로 게시물의 메시지 매개변수를 미리 입력하는 데 사용하지 않습니다.

rsvp_event

Facebook 이벤트에 대한 참석자 상태(예: 참석, 미정 또는 거절)를 설정하는 기능을 제공합니다.

이 권한이 있어도 이벤트에 사용자를 초대할 수 없습니다.

이 권한이 있어도 이벤트 상세 정보를 업데이트할 수 없습니다.

이 권한이 있어도 이벤트를 만들 수 없습니다. API를 통해서는 이벤트를 만들 수 없습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

이벤트 및 달력 정보(예: 기기 앱, 일정 앱, 콘서트 앱)를 관리하는 데 관한 문제를 줄입니다.

pages_show_list

관리하는 페이지 리스트를 표시하기 위한 액세스 권한을 제공합니다.

모범 이용 사례

관리하는 페이지 리스트를 표시하기 위해 계정에 대한 API 액세스를 제공합니다.

pages_manage_cta

관리하는 페이지의 액션 유도를 관리하기 위한 액세스 권한을 제공합니다.

검수

Facebook에서 검수하지 않고 앱에서 이 권한을 사용할 수 있습니다.

모범 이용 사례

관리하는 페이지의 액션 유도를 관리하기 위한 API 액세스를 제공합니다.

pages_manage_instant_articles

앱에서 앱 사용자가 관리하는 Facebook 페이지 대신 인스턴트 아티클을 관리하도록 합니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다. Facebook에서 검수할 필요 없이 앱 대시보드의 역할 섹션에 나열되는 사용자 대신 이 권한을 부여할 수 있습니다.

WordPress용 인스턴트 아티클 플러그인(또는 비슷한 도구)을 사용하여 인스턴트 아티클 페이지에 블로그 게시물을 올리려는 경우, 이러한 게시물이 표시될 대상이 모두 앱 대시보드의 역할 섹션에 나열되어 있는 한 검수를 위해 제출하지 않아도 됩니다.

검수를 위해 제출하는 경우에는 Facebook 팀에서 쉽게 재현할 수 있도록 안내를 작성하세요. 예를 들어, 앱에 고유 인증 시스템이 있으면 검수 팀에서 개발자의 도구를 사용하여 이 기능을 테스트할 수 있도록 유효한 로그인 정보(예: 사용자 이름/비밀번호)를 제공하세요.

모범 이용 사례

앱 사용자가 소유한 페이지용 인스턴트 아티클을 만들고 업데이트합니다.

ads_read

액세스 권한이 있는 광고 계정의 광고 보고서 정보를 가져오기 위해 광고 인사이트 API에 대한 액세스를 제공합니다.

이 권한을 사용하여 구매 업데이트, 광고 업데이트 또는 광고를 수정할 수 없습니다.

모범 이용 사례

맞춤 대시보드 및 데이터 분석에서 사용할 광고 성과 데이터에 대한 API 액세스를 제공합니다.

ads_management

개발자에게 액세스 권한이 있는 광고 계정의 광고를 읽고 관리하는 기능을 모두 제공합니다. 상세 정보는 광고 관리를 참조하세요.

모범 이용 사례

프로그래밍 방식으로 캠페인을 만들고 광고를 관리하며 지표를 가져옵니다.

광고주를 위해 혁신적인 솔루션과 차별화된 가치를 제공하는 광고 관리 도구를 빌드합니다.

business_management

비즈니스 관리 API로 읽고 씁니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

일반 사용

비즈니스 자산(예: 광고 계정)을 관리합니다. 광고 계정의 소유권을 요청합니다.

일반 페이지 관리 및 운영 작업만 수행합니다.

pages_messaging(보내기/받기 API)

Facebook 페이지를 통해 메시지를 보내고 받을 수 있지만 사용자 액션 후 24시간 이내에만 가능합니다. 24시간 이후 메시지에 대해서는 다음 권한을 참조하세요. 이 API를 통한 대화는 사용자가 Messenger 플러그인을 사용하거나 직접 메시지를 보내 개발자로부터 메시지를 받고자 함을 나타낼 때만 시작할 수 있습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

사용자가 시작하는 인터랙티브한 환경을 만듭니다.

예약, 구매, 주문 등을 확인합니다.

고객 지원 메시지를 보냅니다.

사용자 동의 없이 메시지를 보내는 데는 사용하지 않습니다.

pages_messaging_subscriptions(보내기/받기 API)

사용자 액션이 실행된 지 24시간 이후에 Facebook 페이지를 통해 메시지를 보내고 받을 수 있습니다. 이 권한을 사용하여 홍보나 광고 콘텐츠를 보낼 수 없습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

소식을 보냅니다.

생산성 업데이트를 보냅니다.

개인적인 추적 관련 알림을 보냅니다.

제품이나 서비스를 상향 판매 또는 교차 판매하는 데 사용하지 않습니다.

브랜드 광고, 뉴스레터, 소식 또는 스팸을 보내는 데 사용하지 않습니다.

pages_messaging_payments(보내기/받기 API)

페이지 대신 Messenger 대화에서 사용자에게 비용을 청구할 수 있습니다. 실제 상품에만 사용할 수 있으며 가상 상품이나 받아보기에는 사용할 수 없습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

제품을 판매합니다.

티켓을 판매합니다.

호텔 예약 및 자동차 렌트에 사용합니다.

가상 통화를 판매하는 데 사용하지 않습니다.

사용자가 콘텐츠 업데이트를 받아보도록 하는 데 사용하지 않습니다.

pages_messaging_phone_number(고객 매칭)

Facebook 페이지를 통해 메시지를 보내고 받을 수 있습니다. 이 권한을 사용하여 홍보나 광고 콘텐츠를 보낼 수 없습니다. 이 API를 통한 대화는 사용자가 Messenger 플러그인을 사용하거나 직접 메시지를 보내 개발자로부터 메시지를 받고자 함을 나타낼 때만 시작할 수 있습니다.

검수

앱에서 이 권한을 요청하면 앱에서 이 권한을 어떻게 사용하는지 Facebook에서 검수해야 합니다.

모범 이용 사례

SMS를 통해 일반적인 콘텐츠를 보냅니다.

사용자 동의 없이 메시지를 보내는 데는 사용하지 않습니다.