(OpenAPI)Notion API 사용: 데이터 입수 2(파이썬 활용)
데이터 불러오기 및 데이터 확인
노션(Notion)에서 데이터를 불러오는 코드의 구조는 간단하다. 내 API키를 이용한 Client 객체를 먼저 만든다. Client 객체의 databases라는 속성에 있는 query라는 함수를 사용해서 데이터를 받는다. 이때 query라는 함수를 수행하기 위해서는 database id 가 필요하다. 노션(Notion)의 어느 페이지의 데이터를 갖고 올지를 정해주어야 하는 것이다. 이를 코드로 나타내면 아래와 같다.
# 노션 및 판다스 라이브러리 가져오기
from notion_client import Client
import pandas as pd
# Notion API 키 변수 생성
NOTION_API_KEY = "나의 API 키"
# Notion 클라이언트 객체만들기
notion = Client(auth=NOTION_API_KEY)
db_id = "나의 페이지 아이디"
# 데이터베이스에서 데이터 가져오기 함수
def getNotionData(database_id):
try:
# API 결과값을 response 변수에 담기
response = notion.databases.query(database_id=database_id)
# 결과출력
print(response)
# 예외처리
except Exception as e:
print(f"데이터 불러오기 에러 발생: {e}")
# 함수 실행
getNotionData(db_id)
여기서 문제는 나의 페이지 아이디와 나의 API 키 값을 찾는 것이다. 나의 API 키 값은 (OpenAPI)Notion API 사용: 인증키 발급에서 확인한 것처럼 아래 그림 1의 왼쪽처럼 "내 API 통합"에서 확인할 수 있다. 나의 데이터 베이스 아이디는 아래 그림 1의 오른쪽처럼 홈페이지 URL에서 확인할 수 있는데, notion.so/ 뒤의 알파벳과 숫자로 이루어진 문자열이다. 주의해야 할 점은 ?v= 뒤에 있는 부분은 뷰 페이지에 대한 주소이기 때문에 앞쪽 문자열을 사용해야 연결이 된다.
입수된 데이터 재처리
데이터를 입수하면 아래 그림 2와 같이 알 수 없는 문자열이 결과로 나올 것이다. 이 결과를 우리가 노션 화면에서 보던 표로 정리 해주어야 한다.
먼저 이 데이터가 도대체 어떤 구조인지 파악해야 하는데, 이런 형식의 데이터를 JSON 형식이라고 한다. 데이터를 알아보기 쉽게 정리하면 대강 아래와 같은 모양이 된다.
{
'object': 'list',
'results': [
{
...(중략)...
},
{
'object': 'page',
'id': '~',
...(중략)...
'properties': {
'비고': {
'id': '~', 'type': 'rich_text', 'rich_text': [
{'type': 'text', 'text': {'content': '투자못함', 'link': None},
'annotations': {~},
'plain_text': '투자못함', 'href': None}
]
},
'나이': {
'id': '~', 'type': 'multi_select', 'multi_select': [
{'id': '~', 'name': '38', 'color': 'red'}
]
},
'이름': {
'id': 'title', 'type': 'title', 'title': [
{'type': 'text', 'text': {'content': '투자자', 'link': None},
'annotations': {~},
'plain_text': '투자자', 'href': None}
]
}
},
...(후략)...위 항목의 구조는 크게 results 라는 리스트로 결과가 묶여있고, 각 항목은 page라는 이름의 object이다. page의 properties 속성에 비고, 나이, 이름 항목의 값을 가져오면 된다. 예를 들어 나이를 가져오려면 나이 항목의 ['multi_select'] 리스트의 [0] 번째 항목의 ['name'] 값을 설정해 주는 방식이다. 이를 코드로 짜면 아래와 같다.
# 노션 및 판다스 라이브러리 가져오기
from notion_client import Client
import pandas as pd
# Notion API 키 변수 생성
NOTION_API_KEY = "나의 API 키"
# Notion 클라이언트 객체만들기
notion = Client(auth=NOTION_API_KEY)
db_id = "나의 페이지 아이디"
# 데이터베이스에서 데이터 가져오기 함수
def getNotionData(database_id):
try:
# API 결과값을 response 변수에 담기
response = notion.databases.query(database_id=database_id)
data = []
# results 항목을 page 변수에 넣어서 for 문 실행
for page in response['results']:
properties = page['properties']
# properties 에서 이름 값 가져오기
name = properties['이름']['title'][0]['text']['content']
# properties 에서 나이 값 가져오기
age = properties['나이']['multi_select'][0]['name']
# properties 에서 비고 값 가져오기
remark = properties['비고']['rich_text'][0]['text']['content']
# name, age, remark 로 하나의 row 추가
data.append([name, age, remark])
# dataframe 만들기
df = pd.DataFrame(data, columns=['이름', '나이', '비고'])
print(df)
# 예외처리
except Exception as e:
print(f"데이터 불러오기 에러 발생: {e}")
# 함수 실행
getNotionData(db_id)