MCPサーバー

オーディエンス

連絡先をまとめた名前付きのリスト。

オーディエンスのツール

ツール	機能
listAudiences	このメールボックスが連絡先をまとめているリストの一覧。既定のものが先頭に来る。オーディエンスはグループ分けであって、それ以上のものではない。
getAudience	1 つのオーディエンスの全体。名前、何のためのものか、いくつの連絡先が入っているか、既定のものかどうか。
createAudience	名前付きのリストを作る。空の状態で作られ、2 つのオーディエンスが同じ名前を持つことも妨げられないので、先に一覧を読むこと。
updateAudience	オーディエンスの名前や、何のためのものかという説明を変える。既定のオーディエンスも他と同じように名前を変更でき、どんな名前になっても既定のままである。
deleteAudience	オーディエンスを削除する。所属関係は消えるが、そこに入っていた連絡先はすべて残る。既定のオーディエンスは削除できない。
listAudienceContacts	1 つのオーディエンスに誰が入っているか。既定のオーディエンスを指定すると、メールボックスのすべての連絡先が並ぶ。
addContactToAudience	既存の連絡先をオーディエンスに入れる。連絡先を作ることは決してない。打ち間違えたアドレスが、誰も望まない恒久的な行になってしまうからだ。
removeContactFromAudience	連絡先をオーディエンスから外す。連絡先としては、そのメモや他のオーディエンスとともに残る。

どのメールボックスにも、すべての連絡先を含む既定のオーディエンスがあり、ここで唯一、削除も間引きもできないものである。そこから誰かを外せば、listContacts には現れるのに listAudienceContacts には現れない連絡先ができてしまい、それは自分自身と食い違う帳簿である。メールボックスから完全に取り除くのは deleteContact である。

ここにはオーディエンス宛に送信するものは何もなく、そうするツールも存在しない。オーディエンスは連絡先をグループ化する手段であって購読リストではなく、誰かをそこに入れてもメールは一切送られない。

連絡先をリストに追加するのは、連絡先ではなくリストへの書き込みなので、contacts:write ではなく audiences:write で保護される。オーディエンス内のアドレスを読むのに必要なのは audiences:read だけである。