備考
スレッドに留める個人用メモ。
メモのツール
| ツール | 機能 |
|---|---|
| listThreadNotes | スレッドのメモ。ピン留めしたものが先で、それぞれに他のメモツールが受け取る ID が付きます。 |
| addThreadNote | アプリが用意する 8 色のいずれかで、スレッドにメモを留めます。他のメモの後ろに入り、ピン留めしたメモは上に残ります。 |
| updateThreadNote | メモの本文、色、ピン留めするかどうかを変更します。 |
| deleteThreadNote | メモを完全に削除します。メモにゴミ箱はありません。 |
| reorderThreadNotes | スレッドのメモを、すべて挙げて最初から最後まで並べ替えます。 |
メモは書いた本人のものなので、これらのツールはクライアントを接続した人のメモを読み書きします。読むには threads:read、変更するには threads:write が必要で、一部のアドレスに限定されたクライアントが届くのは、そこに届いたスレッドだけです。
アプリのチャットでは、メモの追加、変更、削除、並べ替えは、自分で頼んだ場合を除いて事前に確認します。
リファレンス
listThreadNotes
The private notes on one email thread, pinned ones first, each with the id the other note tools take. Notes belong to the person who wrote them, so this is that person's view.
入力
threadIdstring必須- 空でないこと
ほかの提供先
addThreadNote
Pin a private note to an email thread, as the Notes panel does. It goes after the other notes, and pinned keeps it at the top. color is one of the eight the app offers.
入力
threadIdstring必須- 空でないこと
contentstring必須- 1〜20000文字
colorstring- 次のいずれか
"default""red""orange""yellow""green""blue""purple""pink" pinnedboolean
ほかの提供先
updateThreadNote
Change a note on a thread: its text, its colour or whether it is pinned. Give at least one. Take the note id from listThreadNotes.
入力
threadIdstring必須- 空でないこと
noteIdstring必須- 1〜64文字
contentstring- 1〜20000文字
colorstring- 次のいずれか
"default""red""orange""yellow""green""blue""purple""pink" pinnedboolean
ほかの提供先
deleteThreadNote
Delete a note from a thread for good. There is no bin for notes. Take the note id from listThreadNotes.
入力
threadIdstring必須- 空でないこと
noteIdstring必須- 1〜64文字
ほかの提供先
reorderThreadNotes
Arrange the notes on a thread, first to last. noteIds has to name every note on the thread exactly once; pinned notes still come first.
入力
threadIdstring必須- 空でないこと
noteIdsstring[]必須- 1〜200件