찬찬의 Notion API 정복기 10 - API 집중분석 - Retrieve a page

The English series link is here.

Reference API URL : Retrieve a page

Retrieve 생소한 말입니다.
컴퓨터에서는 Retrieve가 검색하다는 의미로 쓰입니다. (search 라고 하면 헛갈리나..)
Page의 정보를 긁어오겠다 하시면 retrieve 를 이용하여 가져오시면 됩니다.

문서를 읽으시다보면 Limits 어쩌고 나와있는데, 25 relations 이게 신경쓰입니다. 무슨 의미일까요?

Limits

Each page property item is computed with a limit of 25 page references. Therefore relation property values feature a maximum of 25 relations, rollup property values are calculated based on a maximum of 25 relations, and rich text property values feature a maximum of 25 page mentions. Use the next_url property it retrieve the full value of that property.

위와 같이 관계형(relation)이 25개 초과일 경우, 25개 초과인 값은 안 보여진다는 뜻입니다. 최대 25개까지만 보여주겠다.
더 보고 싶으면 next_url property 어쩌구를 쓰라... 그런데 next_url 아무리 찾아도 이걸 어떻게 해야 25개 초과된 항목까지 다 볼수 있다는 말이냐? 이겁니다.

밑에 보시면
Retrieve a page property item (GET) 이라는 항목이 보이실겁니다. 이걸 사용하시면 보입니다. next_url이 왜 언급됐는지는 저도 잘 모르겠어요.
아무튼, 전부 보는 방법 역시 알려드립니다.
'relation' 상단에 짧은 고유 아이디 '%3CLrR' 가 보이실 겁니다. 이것이 relation 의 고유 아이디인데, 이 아이디를 property_id 로 기입하시면 relation 값 전부다 보실 수 있습니다.

property_id에는 relation이라는 property를 가지고 있는 짧은 길이의 id를 기재하시면 되시고,page_id에는 위 relation의 id를 기재하시면 됩니다.

notion.pages.properties.retrieve(page_id='1f217cc1-225f-4580-8e22-cd7eb8db3c5e', property_id='%3CLrR')

아무튼 되돌아가서, retrieve를 해보겠습니다.
PATH PARAMS을 참조해보니, 입력해야될 parameter가 page_id 뿐입니다.
page_id 어떻게 찾냐고요? 앞서 8화, 9화에서 API 집중분석한 - search 명령을 사용해서 찾습니다.
찾은 page_id 를 기재해주면 해당 page의 상세 정보를 보실 수 있습니다.

retrieved_page = notion.pages.retrieve(page_id='1f217cc1-225f-4580-8e22-cd7eb8db3c5e'
pprint(retrieved_page)