fedibird_searchable-by_memo.md

fedibird:searchableByの仕様メモ

前提条件

• ToまたはCcにActor URIが含まれている、またはActor個別Inboxへの直接配送の場合、searchableByの設定内容に関わらず検索可能となる。(Actor直接指定パターン)
• searchableByで指定する検索可能範囲は、公開範囲で示される範囲を超える事はできない。
  • searchableByで指定された検索可能範囲が公開範囲より広い場合、公開範囲で示されている範囲が優先される。
    例) 公開範囲がFollowers、searchableByがPublicの場合、検索実行可能なActorは投稿者のフォロワーおよび直接指定されたActorのみとなる。
  • searchableByで指定された検索可能範囲が公開範囲より狭い場合、直接指定されたActorを除いてsearchableByによって指定された検索可能範囲が優先される。
    例) 公開範囲がPublic、searchableByがFollowersの場合、検索実行可能なActorは投稿者のフォロワーおよび直接指定されたActorのみとなる。

検索可能とする条件

1. 以下のいずれかの場合において、searchableByの設定内容に関わらず検索可能とする。

   • 検索実行者(※以下、「自身」とする)が投稿者本人である場合
   • To・Ccに自身のActor URIが含まれている場合
   • 自身のInbox URLへ投稿が直接配送された場合 (みなしメンション扱い)

2. 公開範囲がPublicの場合、以下のいずれかの条件に合致する場合に検索可能とする。

   • 項番1の条件に合致する場合
   • searchableByで指定された検索可能範囲がPublicである場合
   • searchableByで指定された検索可能範囲がFollowers、かつ自身が投稿者のフォロワーである場合

3. 公開範囲がUnlistedの場合、以下のいずれかの条件に合致する場合に検索可能とする。

   • 項番1の条件に合致する場合
   • searchableByで指定された検索可能範囲がPublicまたはFollowersであり、かつ自身が投稿者のフォロワーである場合
     ※本来この場合のsearchableBy=Publicは、この公開範囲との組み合わせ的には正しくない。(扱いとしてはFollowersに格下げされる)

4. 公開範囲がFollowersの場合、以下のいずれかの条件に合致する場合に検索可能とする。

   • 項番1の条件に合致する場合
   • searchableByで指定された検索可能範囲がPublicまたはFollowersであり、かつ自身が投稿者のフォロワーである場合
     ※本来この場合のsearchableBy=Publicは、この公開範囲との組み合わせ的には正しくない。(扱いとしてはFollowersに格下げされる)

5. 公開範囲がDirectの場合、以下の条件に合致する場合に検索可能とする。

   • 項番1の条件に合致する場合

※Limitedまたは相互フォローの場合の条件については割愛。(私がまだ当該公開範囲の考え方を理解出来ていないため...)

補足：JSON-LD上における公開範囲の表現について

上記文章における各公開範囲は以下に示すものとする。(※Direct以外のActor URI直接指定については省略)

公開範囲	To	Cc
Public	https://www.w3.org/ns/activitystreams#Public	投稿者のフォロワーのコレクションを示すURI (任意)
Unlisted	投稿者のフォロワーのコレクションを示すURI	https://www.w3.org/ns/activitystreams#Public
Followers	投稿者のフォロワーのコレクションを示すURI
Direct	Actor個別のURI

補足：searchableByの取り得る値

検索許諾対象	searchableByの値
Public	https://www.w3.org/ns/activitystreams#Public (※Compactionされた状態の値についても許容される)
Followers	投稿者のフォロワーのコレクションを示すURI
Direct	(空配列)

補足：公開範囲とsearchableByの検索範囲の組み合わせ

公開範囲	searchableByに指定可能な値
Public	Public, Followers, Direct
Unlisted	Followers, Direct
Followers	Followers, Direct
Direct	Direct