1. Class methods

self.find(id, dry_run: false) → Page

[PARAM] id page_id (String) or page_url(String)
[PARAM(optional)] dry_run: true if you want to create a verification script
[EXCEPTION] StandardError: throw StandardError when the page is not found.

Page.find(id) creates a Page object with retrieving page API. The created object has page information generated from the JSON response.

page = Page.find "c01166c6-13ae-45cb-b968-18b4ef2f5a77" # by page id
=> NotionRubyMapping::Page-c01166c613ae45cbb96818b4ef2f5a77

page = Page.find "<https://www.notion.so/notion_ruby_mapping_test_data-c01166c613ae45cbb96818b4ef2f5a77>" # by page url
=> NotionRubyMapping::Page-c01166c613ae45cbb96818b4ef2f5a77

Page.find(id, dry_run: true) creates a shell script using Retrieve a page API for verification.

print Page.find "c01166c6-13ae-45cb-b968-18b4ef2f5a77", dry_run: true
# => 
# #!/bin/sh
# curl  '<https://api.notion.com/v1/pages/c01166c6-13ae-45cb-b968-18b4ef2f5a77>' \\
#   -H 'Notion-Version: 2022-02-22' \\
#   -H 'Authorization: Bearer '"$NOTION_API_KEY"'' \\
#   -H 'Content-Type: application/json'

2. Instance methods

append_block_children(*blocks, dry_run: false) → Array<Block>, String

[PARAM] blocks array of blocks
[PARAM(optional)] dry_run: true if you want to create a verification script

append_block_children method of an existing page appends some block objects. Some blocks allow child blocks to be set up at the same time. However, due to API limitations, grandchild blocks cannot be created at once. There are many types of blocks, so check the page( Append block children sample) to see how to create blocks.

parent_page = Page.find "206ffaa277744a99baf593e28730240c"
parent_page.append_block_children CodeBlock.new("% ls -l", caption: "List files")
# => 
# #<NotionRubyMapping::Block:0x00000001064431d8

append_block_children(blocks, dry_run: true) creates a shell script using Append block children API for verification.

print parent_page.append_block_children(CodeBlock.new("% ls -l", caption: "List files"), dry_run: true)
#!/bin/sh
curl -X PATCH '<https://api.notion.com/v1/blocks/206ffaa277744a99baf593e28730240c/children>' \\
  -H 'Notion-Version: 2022-06-28' \\
  -H 'Authorization: Bearer '"$NOTION_API_KEY"'' \\
  -H 'Content-Type: application/json' \\
  --data '{"children":[{"type":"code","object":"block","code":{"rich_text":[{"type":"text","text":{"content":"% ls -l","link":null},"plain_text":"% ls -l","href":null}],"caption":[{"type":"text","text":{"content":"List files","link":null},"plain_text":"List files","href":null}],"language":"shell"}}]}'=> nil

build_child_database(title, *assigns) { |d, pc| ... } → Database

[PARAM] title Database title
[PARAM] assigns variable-length array of property class and property name pairs