그래프 API 탐색기 가이드

일반적인 사례

• 액세스 토큰을 빠르게 생성
• 쿼리에 대한 코드 샘플 가져오기
• 지원 요청에 포함할 디버그 정보 생성
• 사용 사례에 대한 권한, 기능 및 설정을 포함하여 프로덕션 앱의 설정으로 API 쿼리 테스트
• 테스트 사용자 또는 테스트 데이터에 대해 권한과 기능을 사용하여 테스트 또는 개발 앱으로 API 쿼리 테스트

요구 사항

• Facebook 개발자 계정
• 역할(예: 관리자, 개발자 또는 테스터 역할)을 배정받은 앱

구성 요소

액세스 토큰

받은 액세스 토큰은 도구의 오른쪽 상단에 표시됩니다. 이 토큰이 그래프 API 쿼리에 포함됩니다. 이 토큰을 복사하고 앱 내에서 사용하여 코드를 테스트할 수 있습니다.

정보 아이콘을 클릭하면 현재 토큰에 대한 정보가 표시됩니다(예: 해당 토큰에 연결된 앱, 앱을 사용하고 있는 사용자(개발자)가 부여한 권한 등).

토큰이 만료되었거나 새로운 권한을 추가하는 경우 새로운 액세스 토큰을 생성할 수 있습니다.

Meta 앱

오른쪽 상단의 Meta 앱 드롭다운 메뉴에는 관리자, 개발자 또는 테스터 역할이 배정된 모든 앱이 표시됩니다. 드롭다운을 사용하여 테스트할 앱 설정을 선택하세요.

사용자 또는 페이지

사용자 또는 페이지 드롭다운 메뉴를 이용하면 현재 선택한 앱에 대해 앱, 사용자 및 페이지 액세스 토큰을 가져오고 교환할 수 있습니다. 또한 이 메뉴를 이용해 사용자 노드에서 앱을 삭제하여 현재의 액세스 토큰을 폐기할 수 있습니다.

권한

사용자 액세스 토큰을 요청할 때마다 기본적으로 하나의 권한, 즉 public_profile만 부여됩니다. 권한 드롭다운 메뉴에서는 사용자 데이터 권한(예: email, user_photos), 이벤트, 그룹, 페이지 권한(예: manage_pages, ads_management) 및 기타 권한(예: instagram_basic, publish_video)을 선택할 수 있습니다. 이를 통해 현재 앱 사용자(개발자)가 앱별 권한을 부여할 수 있습니다. 앱에 실제로 필요한 권한만 부여합니다.

앱을 개발 중인 경우 앱에 모든 권한을 부여할 수 있으며 쿼리를 하면 앱에서 역할이 배정된 사람들이 소유한 데이터에 대해 해당 권한을 준수합니다. 그러나 앱이 라이브 상태일 경우 앱 검수 절차에서 앱에 승인되지 않은 권한을 부여하면 쿼리를 제출할 때마다 실패합니다.

쿼리 문자열 필드

처음으로 도구에 진입하면 기본 쿼리가 나타납니다. 새 쿼리를 입력하거나 쿼리를 실행한 다음 필드 뷰어에서 필드를 검색하여 선택하는 방법으로 쿼리를 수정할 수 있습니다. 또한 드롭다운 메뉴를 사용하여 운영 방법을 전환하고 그래프 API의 서로 다른 버전을 타게팅할 수도 있습니다.

쿼리 필드 끝에 있는 별 모양 아이콘을 클릭하면 쿼리가 즐겨찾기에 저장됩니다. 책 모양 아이콘을 클릭하여 즐겨찾는 쿼리를 확인할 수 있습니다.

노드 필드 뷰어

노드에서 GET 쿼리를 제출하면 창 왼쪽에 있는 필드 뷰어가 노드 이름과 그래프 API에서 반환하는 필드를 표시합니다. 새 필드를 검색 및 선택하고, + 아이콘을 클릭하고, 이용 가능한 필드 중에서 선택하거나, 불필요한 필드를 선택 해제하여 쿼리를 수정할 수 있습니다. 이러한 작업은 쿼리 문자열 필드의 쿼리를 동적으로 업데이트합니다.

응답 창

쿼리 문자열 아래에 있는 응답은 마지막으로 제출한 쿼리에서 반환한 결과를 표시합니다.

코드 가져오기

쿼리에 만족하는 경우, 응답 아래의 하단 중앙에 위치한 코드 가져오기 버튼을 클릭하여 쿼리에 기반한 샘플 코드를 생성합니다. 일반적으로 샘플 코드를 복사해서 코드 베이스에 바로 붙여넣을 수는 없지만 유용한 시작점 역할은 할 수 있습니다.

디버그 정보 복사하기

쿼리가 계속 실패하는 이유를 알 수 없어서 개발자 지원에 문의하고자 할 경우, 하단 중앙에 있는 이 버튼을 클릭해서 쿼리와 응답 세부 정보를 클립보드에 복사합니다. 지원 요청과 함께 이 정보를 제출하면 당사에서 어떤 상황인지 파악하는 데 도움이 됩니다.

세션 저장하기

하단 중앙에 있는 세션 저장 버튼을 클릭하면 액세스 토큰이 삭제된 채로 쿼리 상태가 저장됩니다. 개발자 지원에 문의할 때 이 세션에 대한 링크를 포함하세요.

쿼리 샘플

처음 그래프 API 탐색기를 읽어들일 때 나타나는 기본 쿼리를 실행해 보세요. 아직 실행해 보지 않았다면 새 창에서 그래프 API 탐색기를 열고 앱 드롭다운 메뉴에서 테스트할 앱을 선택한 다음 사용자 액세스 토큰을 가져옵니다.

다음과 같이 쿼리 문자열 필드에 기본 쿼리가 나타납니다.

GET https://developers.facebook.com/v19.0/me?fields=id,name

기본 쿼리는 /me 노드에서 id 및 name 필드를 요청합니다. 이 노드는 토큰에서 식별된 /User 또는 /Page 노드에 매핑되는 특수 노드입니다. 지금은 사용자 액세스 토큰을 사용하기 때문에 사용자 노드에 매핑됩니다.

id 및 name 필드는 사용자가 앱에 default 또는 public_profile 권한을 부여했다면 공개적으로 제공되고 반환이 가능합니다. 이러한 권한은 모든 앱에 대해 사전 승인됩니다(액세스 토큰 필드의 정보 아이콘을 클릭하면 확인할 수 있습니다). 따라서 앱에 추가적인 권한을 부여하지 않더라도 쿼리가 작동합니다. 액세스 토큰 가져오기를 클릭하고 앱에 공개적으로 제공되는 사용자 정보에 대한 액세스 권한을 부여하겠다고 확인하세요.

쿼리를 제출하면 앱 범위 사용자 ID와 이름이 응답 창에 나타날 것입니다.