はじめに

hkob の雑記録の第536回目(連続112日目)は、Developer ChangeLog の 6/10 版を解説します。

Bots in people properties and user mentions

6/10 の Changelog には以下のように記載されていました。

API レスポンスで user オブジェクトとして表示されるボットを、people のページプロパティ値に割り当てたり、user のリッチテキストメンションで参照したりできるようになりました。ページを作成するときや、ページプロパティを更新するときに、people プロパティを設定できます。以前は、同じボットがそれらのフィールドを読み取る際には返されていたにもかかわらず、これらの書き込みは validation_error を返していました。データベースオートメーションやカスタムエージェントのような機能を動かすために Notion が内部で使用するインテグレーションなど、一部のボットは user オブジェクトとして表示されません。そのようなボットを割り当てようとすると、引き続き validation_error が返されます。

bot オブジェクトが People property に登録できるようになったようです。

動作確認

せっかくなので動作確認してみましょう。今編集している Notion のページに bot を登録してみます。登録前はこんな感じです。

nrm_console.rb
irb(main):001> page = Page.find "https://app.notion.com/p/hkob-private/Notion-Bots-in-people-properties-and-user-mentions-Changelog-6-10-hkob-536-38d0ce2a652080bb96c5d41654dcc139?source=copy_link"
=> NotionRubyMapping::Page-38d0ce2a652080bb96c5d41654dcc139
irb(main):002> pp = page.properties["オーナー"]
=>
#<NotionRubyMapping::PeopleProperty:0x0000000123e037a0
...
irb(main):003> pp
=>
#<NotionRubyMapping::PeopleProperty:0x0000000123e037a0
 @base_type="page",
 @create=false,
 @json=[NotionRubyMapping::UserObject-fffd872b594c811b82180002b0392cd8],
 @name="オーナー",
 @new_name=nil,
 @property_cache=PropertyCache,
 @property_id="notion%3A%2F%2Fwiki%2Fowner_property",
 @query=nil,
 @remove=false,
 @will_update=false>
irb(main):004> bot = UserObject.find_me
=> NotionRubyMapping::UserObject-9c1dfdfc452740459decf815c42a9efc
irb(main):005> pp.add_person bot
=> [NotionRubyMapping::UserObject-fffd872b594c811b82180002b0392cd8, NotionRubyMapping::UserObject-9c1dfdfc452740459decf815c42a9efc]
irb(main):006> page.save
=> NotionRubyMapping::Page-38d0ce2a652080bb96c5d41654dcc139

find_me で取得した bot ユーザを PeopleProperty に add_person で追加してみました。ちゃんと Array が二つ入っていたので、save すると無事に成功しました。これまでは validation_error となっていたところです。実際にページ上部を見てみると「Manage tasks」bot がちゃんと登録されています。