تخطَّ إلى المستندات
خادم 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()