Примечания
Личные заметки, закреплённые за цепочкой.
Инструменты заметок
| Инструмент | Что делает |
|---|---|
| listThreadNotes | Заметки одной цепочки, сначала закреплённые, каждая с идентификатором, который принимают остальные инструменты заметок. |
| addThreadNote | Закрепить заметку за цепочкой, одним из восьми цветов, которые предлагает приложение. Она встаёт после остальных, а закреплённая заметка остаётся наверху. |
| 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 элементов