پرش به مستندات
سرور MCP

توضیحات

یادداشت‌های خصوصیِ سنجاق‌شده به یک رشته.

ابزارهای یادداشت

ابزارچه می‌کند
listThreadNotesیادداشت‌های یک رشته، سنجاق‌شده‌ها نخست، هر کدام با شناسه‌ای که دیگر ابزارهای یادداشت می‌گیرند.
addThreadNoteیادداشتی را با یکی از هشت رنگی که برنامه پیشنهاد می‌دهد به یک رشته سنجاق کنید. پس از بقیه می‌آید، و یادداشت سنجاق‌شده بالا می‌ماند.
updateThreadNoteمتن یک یادداشت، رنگش یا سنجاق‌شدنش را تغییر دهید.
deleteThreadNoteیک یادداشت را برای همیشه حذف کنید. یادداشت‌ها سطل زباله ندارند.
reorderThreadNotesیادداشت‌های یک رشته را با نام بردن از همهٔ آن‌ها، از اول تا آخر، بچینید.

یادداشت‌ها از آنِ کسی‌اند که آن‌ها را نوشته، پس این ابزارها یادداشت‌های کسی را می‌خوانند و می‌نویسند که کلاینت را وصل کرده است. خواندن به threads:read و تغییر به threads:write نیاز دارد، و کلاینتی که به برخی نشانی‌ها محدود است فقط به رشته‌هایی می‌رسد که به همان‌ها رسیده‌اند.

در گفت‌وگوی برنامه، افزودن، تغییر، حذف و چیدن یادداشت‌ها نخست می‌پرسد، مگر آنکه خودتان خواسته باشید.

مرجع

listThreadNotes

محدوده‌های دسترسیthreads:readدستیار برنامه آن را بدون پرسیدن اجرا می‌کندجعبه‌ابزارnotes

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الزامی
خالی نباشد

همچنین در دسترس در

API
GET /threads/{id}/notes
SDK
threads.listNotes()

addThreadNote

محدوده‌های دسترسیthreads:writeدستیار برنامه اول می‌پرسد، مگر آنکه خودتان آن را خواسته باشیدجعبه‌ابزارnotes

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

همچنین در دسترس در

API
POST /threads/{id}/notes
SDK
threads.createNote()

updateThreadNote

محدوده‌های دسترسیthreads:writeدستیار برنامه اول می‌پرسد، مگر آنکه خودتان آن را خواسته باشیدجعبه‌ابزارnotes

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

همچنین در دسترس در

API
PATCH /threads/{id}/notes/{noteId}
SDK
threads.updateNote()

deleteThreadNote

محدوده‌های دسترسیthreads:writeدستیار برنامه اول می‌پرسد، مگر آنکه خودتان آن را خواسته باشیدجعبه‌ابزارnotes

Delete a note from a thread for good. There is no bin for notes. Take the note id from listThreadNotes.

ورودی‌ها

threadIdstringالزامی
خالی نباشد
noteIdstringالزامی
1 تا 64 نویسه

همچنین در دسترس در

API
DELETE /threads/{id}/notes/{noteId}
SDK
threads.deleteNote()

reorderThreadNotes

محدوده‌های دسترسیthreads:writeدستیار برنامه اول می‌پرسد، مگر آنکه خودتان آن را خواسته باشیدجعبه‌ابزارnotes

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 مورد

همچنین در دسترس در

API
POST /threads/{id}/notes/reorder
SDK
threads.reorderNotes()