본 페이지에서는 API를 이용해서 노션 페이지에 블럭을 추가하는 방법을 설명합니다. 노션 페이지는 여러 종류의 블럭으로 구성되어 있으며, 각 블럭의 특성에 따라 필요한 옵션이 다르므로 노션 개발자 문서를 참고해야 합니다.
노션 블럭 추가 제한사항
API로 블럭을 추가할때 제한사항입니다.
•
한 번의 요청으로 최대 100개의 블럭만 추가할 수 있습니다.
•
블럭 타입에 따라 중첩이 불가능한 경우가 있습니다.
•
페이지 내에서 블럭의 최대 깊이는 2000레벨입니다.
•
일부 블럭 타입은 필수 속성이 있어 반드시 입력해야 합니다.
•
블럭 업데이트는 초당 3회로 제한됩니다.
•
파일 업로드의 경우 최대 크기는 5MB입니다.
노션블럭
모든 블럭들을 한꺼번에 다룰 수는 없으므로, 자주 사용되는 핵심 기능들을 중심으로 함수를 구현하며 학습해보겠습니다. 이후 대부분의 블럭을 처리할 수 있는 수준에 도달하면, 이를 라이브러리로 발전시켜 공개 등록까지 진행하도록 하겠습니다. 라이브러리 개발과 등록 과정은 여러분들이 직접 따라하시면서 파이썬 실력 향상에도 큰 도움이 될 것입니다.
블럭 추가 방법을 계속 업데이트할 예정입니다.
텍스트 블럭과 노션 개발자 레퍼런스를 참고하여 다양한 블럭 추가 함수를 만들어보세요!