Notion API: Table CRUD: 1탄 테이블 데이터를 API로 자유자재로

작성일 : 2024-06-12

Notion API: Table CRUD: 1탄 테이블 데이터를 API로 자유자재로

Notion은 개인과 팀 모두에게 강력한 조직화 도구를 제공합니다. 이를 통해 작업 공간을 체계적으로 관리하고, 다양한 정보를 한 곳에 모아 생산성을 높일 수 있습니다. 특히 Notion API의 도입으로, 개발자들은 Notion의 기능을 외부 애플리케이션과 통합하고, 작업을 자동화할 수 있는 새로운 가능성을 열게 되었습니다. 이 글에서는 Notion API를 활용하여 테이블 데이터를 자유자재로 다루는 방법을 다룹니다. 기본적인 CRUD(Create, Read, Update, Delete) 작업을 통해 Notion API의 활용 방법을 자세히 설명합니다.

Notion API 활용 용도

Notion API는 다양한 용도로 활용될 수 있습니다. 다음은 Notion API의 주요 활용 용도입니다:

작업 자동화: 반복적인 작업을 자동화하여 시간을 절약할 수 있습니다. 예를 들어, 특정 조건이 충족될 때마다 Notion 데이터베이스에 새로운 항목을 자동으로 추가하거나 업데이트할 수 있습니다.
외부 애플리케이션과의 통합: Notion 데이터를 다른 애플리케이션과 쉽게 통합할 수 있습니다. 예를 들어, 슬랙과 연동하여 Notion 데이터베이스의 변경 사항을 실시간으로 알림 받을 수 있습니다.
데이터 분석 및 보고서 생성: Notion 데이터베이스의 데이터를 추출하여 분석하고, 보고서를 자동으로 생성할 수 있습니다.
사용자 정의 인터페이스 구축: Notion API를 사용하여 사용자 정의 웹 애플리케이션이나 모바일 애플리케이션을 구축할 수 있습니다. 이를 통해 Notion의 데이터를 보다 효율적으로 관리할 수 있습니다.

Notion의 Table과 Page 개념

Notion에서 Table과 Page는 데이터를 조직화하는 기본 단위입니다. 이 두 가지 개념을 이해하는 것은 Notion API를 효과적으로 사용하는 데 매우 중요합니다.

Table

Notion의 Table은 데이터베이스의 한 형태입니다. 테이블은 여러 개의 행과 열로 구성되며, 각 열은 특정 속성을 나타냅니다. 테이블의 각 행은 고유한 데이터 항목을 나타내며, 이 항목은 여러 속성을 가질 수 있습니다. 예를 들어, 프로젝트 관리 테이블은 각 행이 개별 프로젝트를 나타내고, 열은 프로젝트 이름, 시작일, 마감일, 상태 등의 속성을 나타낼 수 있습니다.

Page

Notion의 Page는 하나의 문서나 노트처럼 작동합니다. 페이지는 텍스트, 이미지, 테이블, 리스트 등 다양한 콘텐츠를 포함할 수 있습니다. 또한, 페이지는 다른 페이지를 포함할 수 있어 계층 구조를 형성할 수 있습니다. 데이터베이스 내의 각 행도 Notion에서는 페이지로 간주됩니다. 즉, 테이블의 각 행은 해당 데이터 항목에 대한 세부 정보를 담고 있는 페이지로 볼 수 있습니다.

Notion API를 사용한 기본적인 CRUD 작업

Notion API를 사용하면 테이블 데이터를 자유자재로 다룰 수 있습니다. 여기서는 기본적인 CRUD 작업을 통해 Notion API의 활용 방법을 살펴보겠습니다.

준비 작업

먼저, Notion API를 사용하기 위한 준비 작업이 필요합니다.

Notion API 키 생성: Notion 웹사이트에서 로그인 후, 🔗 My Integrations 페이지로 이동하여 새 통합을 생성하고, 생성된 통합의 API 키를 복사합니다.
접근 권한 설정: 수정하려는 데이터베이스나 페이지를 열고, 오른쪽 상단의 "공유" 버튼을 클릭하여 생성한 통합을 페이지에 초대합니다.

데이터 생성 (Create)

데이터베이스에 새로운 항목을 생성하려면 POST 요청을 사용합니다. 예를 들어, Python에서 requests 라이브러리를 사용하여 새로운 항목을 추가할 수 있습니다.


python
import requests
import json

# Notion API 키와 데이터베이스 ID 설정
NOTION_API_KEY = 'your_notion_api_key'
DATABASE_ID = 'your_database_id'

# API 엔드포인트 URL 설정
url = f"<https://api.notion.com/v1/pages>"

# HTTP 요청 헤더 설정
headers = {
    "Authorization": f"Bearer {NOTION_API_KEY}",
    "Content-Type": "application/json",
    "Notion-Version": "2022-06-28"
}

# 생성할 데이터 설정
data = {
    "parent": { "database_id": DATABASE_ID },
    "properties": {
        "Name": {
            "title": [
                {
                    "text": {
                        "content": "새 항목 제목"
                    }
                }
            ]
        },
        "Description": {
            "rich_text": [
                {
                    "text": {
                        "content": "새 항목 설명"
                    }
                }
            ]
        }
    }
}

# 데이터 생성 요청
response = requests.post(url, headers=headers, data=json.dumps(data))

# 응답 확인
if response.status_code == 200:
    print("데이터가 성공적으로 생성되었습니다.")
else:
    print(f"데이터 생성에 실패했습니다. 응답 코드: {response.status_code}")
    print(response.json())

데이터 읽기 (Read)

데이터베이스의 항목을 읽으려면 GET 요청을 사용합니다. 다음은 Python을 사용하여 데이터베이스의 항목을 읽는 예제입니다.


python
# API 엔드포인트 URL 설정
url = f"<https://api.notion.com/v1/databases/{DATABASE_ID}/query>"

# 데이터 읽기 요청
response = requests.post(url, headers=headers)

# 응답 확인
if response.status_code == 200:
    data = response.json()
    print("데이터를 성공적으로 읽어왔습니다.")
    print(json.dumps(data, indent=2))
else:
    print(f"데이터 읽기에 실패했습니다. 응답 코드: {response.status_code}")
    print(response.json())

데이터 수정 (Update)

기존 항목을 수정하려면 PATCH 요청을 사용합니다. 예를 들어, 특정 페이지의 제목을 변경할 수 있습니다.


python
# 수정할 페이지 ID 설정
PAGE_ID = 'your_page_id'

# API 엔드포인트 URL 설정
url = f"<https://api.notion.com/v1/pages/{PAGE_ID}>"

# 수정할 데이터 설정
data = {
    "properties": {
        "Name": {
            "title": [
                {
                    "text": {
                        "content": "수정된 제목"
                    }
                }
            ]
        }
    }
}

# 데이터 수정 요청
response = requests.patch(url, headers=headers, data=json.dumps(data))

# 응답 확인
if response.status_code == 200:
    print("데이터가 성공적으로 수정되었습니다.")
else:
    print(f"데이터 수정에 실패했습니다. 응답 코드: {response.status_code}")
    print(response.json())

데이터 삭제 (Delete)

Notion에서 데이터를 삭제하는 것은 해당 항목을 아카이브하는 것입니다. 이를 위해 PATCH 요청을 사용하여 archived 속성을 True로 설정합니다.


python
# 삭제할 페이지 ID 설정
PAGE_ID = 'your_page_id'

# API 엔드포인트 URL 설정
url = f"<https://api.notion.com/v1/pages/{PAGE_ID}>"

# 페이지 아카이브 설정
data = {
    "archived": True
}

# 데이터 삭제 요청 (아카이브)
response = requests.patch(url, headers=headers, data=json.dumps(data))

# 응답 확인
if response.status_code == 200:
    print("데이터가 성공적으로 삭제(아카이브)되었습니다.")
else:
    print(f"데이터 삭제(아카이브)에 실패했습니다. 응답 코드: {response.status_code}")
    print(response.json())

결론

Notion API를 사용하면 Notion의 데이터를 효율적으로 관리하고 자동화할 수 있습니다. 이 가이드에서는 Notion API를 통해 데이터를 생성, 읽기, 수정 및 삭제하는 방법을 다루었습니다. Notion API를 사용하여 생산성을 높이고, 워크플로우를 자동화하며, 더 나은 조직화를 경험해 보세요. Notion API는 매우 강력한 도구이며, 이를 활용하여 다양한 작업을 자동화하고 통합할 수 있습니다.