단축어로 일상 기록, 노션 연동 - 3

[단축어 📱] - 단축어로 일상 기록, 공부 데이터 수집 - 1

[단축어 📱] - [Swift] 단축어로 일상 기록, 건강 데이터 수집 - 2

[단축어 📱] - 단축어로 일상 기록, 노션 연동 - 3

 

 

저번 두 게시글에서 기록한 공부 데이터와, 하루 건강 데이터를 받아올 수 있었다.

 

이번에는 내가 사용중인 노션 앱의 일정관리에, 두 데이터를 자동으로 기록할 수 있게

단축어를 이용해 자동화를 해보려고 한다.

 

Notion과의 연동은 Notion이 제공하는 API를 이용해서 만들어 보겠다.

 

 

Notion 템플릿

 

내가 기록하고 있는 노션 템플릿이다.

간단하게 하루 일과표와, To-do list, 목표설정 페이지로 이루어져 있다.

 

목표는 우측 하단 Record 페이지에 하루의 기록을 차곡차곡 기록하고자 한다.

 

 

Notion API

 

단축어에서 노션을 사용하기에 앞서

Notion API 에 대해 찾아볼 필요가 있었다.

 

문서를 여러번 읽었으니, 하나하나 구현해 보도록 하자

https://developers.notion.com/reference/intro

Introduction

 

API를 사용하기 위해 개인 Key를 발급 받아야 한다.

Notion의 API 통합 페이지에서, 내 Secret Key를 발급했다.

 

내가 만들어야 할, 동작은 다음과 같다.

• Record Calendar(DB)에 페이지 생성
• 생성된 페이지에 데이터 입력

 

API 문서를 정독 하고, 내 페이지를 API와 연동하는 작업을 했다.

상단 메뉴 > 연결 > 내 API 추가

 

다음으로 작업을 할, 페이지의 id값을 가져왔다.

(필자는, Record Calendar의 id값을 가져왔다.)

해당 페이지 > 상단 공유 버튼 > 링크 복사

 

그럼 아래와 같은 형식의 링크가 복사되는데,

?v 앞의 부분이 페이지의 id 이다.

https://www.notion.so/{id}?v=...&pvs=4

 

 

이제 key와 id값으로 Postman에서 페이지 생성을 해보자

요청 URL은 다음과 같다.

https://api.notion.com/v1/pages

 

 

페이지 생성은 Post 방식으로,

Header엔 Key값 Body는 json 타입의 요청 값이 필요했다.

Authorization:Bearer {key값}
Content-Type:application/json
Notion-Version:2022-06-28

 

{ "parent": {
    "database_id": "id값"
},
"properties": { 
  "Name": { "title": [{"text": { "content": "페이지 이름" }}]},
  "Date": { "date": { "start": "2025-03-15" }}}
}

 

 

성공적으로 페이지가 생성되었고, 리턴값으로 생성된 페이지의 id값이 나왔다.

 

이제 이 id값에 페이지의 내용을 넣어보자

내용을 넣으려면 Patch 방식으로 요청 URL에 id값을 넣어줘야 한다.

https://api.notion.com/v1/blocks/{id}/children

 

 

내용은 간단하게 h3태그와 callout을 넣었다.

실행 결과, 생성된 페이지 안에 잘 들어간 모습

 

 

페이지 내용 만들기

 

이제 실제 페이지에 넣을 내용(json 포맷)을 만들어 보자

API 문서 규칙에 맞게, 대략 틀을 만들어 보았다.

 

분류 타이틀을 넣어줄 h3태그는 이렇게

"heading_3": {
  "rich_text": [{
    "type": "text",
    "text": {
      "content": "공부 기록"
    }
  }]
}

 

 

공부 기록을 위한 테이블은 이렇게 설계하고,

과목별로 반복문을 돌릴 것이기 때문에 가운데는 비워놨다.

"table": {
  "table_width": 2,
  "has_column_header": true,
  "has_row_header": false,
    "children": [{
      "object": "block",
      "type": "table_row",
      "table_row": {
        "cells": [
          [{ "type": "text", "text": { "content": "과목" }}],
          [{"type": "text", "text": { "content": "시간" }}]
        ]
      }
    },
    { /*공부데이터의 k-v 개수만큼 반복문*/ },
    {
      "object": "block",
      "type": "table_row",
      "table_row": {
        "cells": [
          [{"type": "text", "text": { "content": "계" }}],
          [{"type": "text", "text": { "content": "studyTime" }}]
        ]
      }
    }]
}

 

 

마지막으로 건강 기록의 데이터들은 callout 안에 넣을 예정이므로

이모지와 함께, callout 틀도 만들어 주었다.

"callout": {
  "rich_text": [{"type": "text", "text": { "content": "운동시간: exerciseTime" }}],
  "icon": { type": "emoji", "emoji": "🍀" }
}

 

 

추가적으로 column_list로 항목을 감싸면, 한 행에 여러개의 열로 추가가 가능하다.

"object": "block",
"type": "column_list",
  "column_list": {
     "children": [ 
       ...

 

 

 

단축어 구현

 

이제 이 틀을 그대로 단축어에 적용시켜보자

 

처음으로, Postman으로 테스트 한 그대로 Post방식으로

Header와 Body에 필요한 값을 넣고 요청을 했다.

 

그 후, 결과 값에서 값을 넣을 페이지의 id값을 받아두고

1편에서 만든 공부데이터를 가져온다.

(값은 총 공부시간, {n개의 과목: 공부시간})

 

과목 수 만큼 반복문을 돌려, 공부 시간을 기록할 행을 만들어주고,

2편에서 만든 운동데이터도 가져온다

이때 hh:mm:ss 형식의 시간은 정규식으로 00시 00분 형태로 바꾸어 주었다.

 

또, 하루를 평가하는 입력 폼도 만들었다.

 

마지막으로 Patch 방식으로 최종 데이터를 넣어주면

단축어가 정상적으로 잘 작동한다.

 

추가로, 상단의 Today's Mood엔

애플 건강앱에 기록된 "Satisfied" 값이 들어가는 것을 알 수 있다.

 

단축어가 동작하는 과정

https://youtube.com/shorts/asOfL6ncTkU?si=ODeIHOj7M6bhmeov

 

 

 

Notion 확인

 

주로 PC 환경에서 사용중이므로, 최종적으로 확인해보았다.

PC에서 보면 더 깔끔하게 정리가 되어 보인다.

 

구조를 column_list로 설정해주었기에,

공부기록과 운동기록이 한 행에 배치되어 들어간다.

 

 

이렇게 하루 기록 자동화 작업이 끝났다.

좀 더 규칙적이고 보람찬 하루를 보내는 계기가 되었으면 좋겠다.

 

 

원본 게시글

https://blog.naver.com/101artspace/223808245035

단축어로 일상 기록하기, 노션 연동 - 3