2023. 7. 25. 23:08ㆍDEV/ETC
Notion의 Data Table에 저장된 정보를 외부에서 Notion API를 사용해서 Database처럼 사용할 수 있다. Notion API를 설정하고 사용하는 방법을 알아보자.
Data 개념 정리
🔗 Working with databases
Page는 데이터베이스 내의 항목으로 사용되며, 각 페이지의 속성은 상위 데이터베이스의 스키마를 따라야 한다. 즉, 데이터베이스를 표로 보는 경우 페이지의 등록 정보는 단일 행의 모든 값을 정의한다.
create a page API 끝점을 사용하여 페이지를 데이터베이스에 추가한다. 위의 예제 데이터베이스에 페이지를 추가한다. 끝점에는 '부모'와 '속성'의 두 가지 필수 매개 변수가 있다.
데이터베이스에 페이지를 추가할 때 parent 파라미터는 database parent이어야 합니다. 위의 예제 데이터베이스에 대해 이 개체를 작성할 수 있다.
Notion API 설정
- Database 생성
- Integration 생성
- Integration에 Database 공유 설정
사용 전 준비사항
- Notion account에 로그인해서 Workspace를 준비한다.
- Admin level의 권한을 갖고 있어야 한다.
- Create at least one database in the workspace
- Install npm and node,js to use Notion’s JavaScript library → Flutter 사용할 예정이니 ❌
Database 생성
우선 API로 사용할 데이터베이스 테이블을 준비한다.
- Database로 사용할 테이블을 Database - Full Page(전체 페이지)로 생성한다.
- Sub Item 기능도 테스트를 하기 위해 설정한다.
- Linked Data도 설정해서 확인해보자.
⚠️ 단, Linked Database는 API에서 지원하지 않는다.
Linked Database를 사용하고 싶다면, 약간의 편법적인 방법으로 타이틀 값 정도는 사용할 수 있는 방법을 찾았다.
Integration 생성
📎 https://developers.notion.com/docs/create-a-notion-integration
My Integrations에 접속해서 New Integraion 버튼을 클릭한다.
💡Public vs Internal
쉽게 생각하자면 나 또는 우리만 사용할 것인가, 아니면 내가 모르는 누구든지 사용할 수 있게 할 것인가이다.
Notion의 모든 사용자가 모든 Workspace에서 사용 가능하게 하려면 Public으로 설정하고, 본인만 사용할 계획이라면 Internal로 설정한다.
나 혼자 사용할 목적이므로 Internal 기본으로 생성한다. 기본 정보를 입력하고 Submit~!
- Associated workspace : 본인의 Notion이 맞는 지 확인한다. 다른 사람이나 팀과 공유된 Notion이 있는 경우 특히 주의!
- Name : 원하는 이름을 자유롭게 설정한다.
- Logo : 없어서 패스~
생성이 되면 바로 API Key인 Token을 확인할 수 있다. Show를 누르면 키가 나타나고 Copy를 눌러 복사할 수 있다.
Integration에 Database 공유 설정
- API로 사용할 데이터 베이스가 있는 페이지로 이동한다.
- 우측 상단의 ··· 메뉴를 클릭 → Add Connectins → 만들어둔 Integration을 선택한다.
확인을 요청하면 Confirm을 눌러 완료한다.
연결이 잘 되었다면 Connectons에 연결된 Integration이 추가된 것을 볼 수 있다.
이제 Notion Database를 API로 사용할 준비는 끝났다. 다음 포스팅에서 API를 호출하는 방법을 알아보기로 한다.
'DEV > ETC' 카테고리의 다른 글
VScode 코드 자동 출력 Quokka (0) | 2021.12.06 |
---|---|
Mac Terminal 설정 (0) | 2021.03.24 |
Mac Full Xcode 설치하기 (0) | 2021.03.19 |
PostgreSQL - psql로 csv에서 데이터 입력하기 (0) | 2020.10.08 |
NestJS 세팅하기 (0) | 2020.10.02 |
Homebrew로 Java8 설치하기 (0) | 2020.09.29 |