מדריך API ו-MCP לקישורי שיתוף של Drive

קישורי שיתוף מאפשרים למסור קובץ Drive מחוץ לחשבון TrekMail בלי לשלוח קובץ מצורף גדול בדוא"ל. כלי ה-API וה-MCP יכולים ליצור קישורים, להציג קישורים של קובץ ולבטל קישורים כאשר יש לסיים את הגישה.

השתמשו בקישורי שיתוף עבור תוצרים ללקוחות, חשבוניות, קובצי וידאו, חבילות ייצוא וכל קובץ שהוא גדול מדי או זמני מדי עבור קובץ מצורף בדוא"ל.

היקפים נדרשים

עבור קבצים ב-Drive של החשבון, השתמשו ב-drive:account:share. עבור קבצים ב-Drive של תיבת הדואר, השתמשו ב-drive:mailbox:share. היקף קריאה גם שימושי, מכיוון שברוב תהליכי העבודה צריך למצוא את הקובץ לפני שמשתפים אותו.

היקפי שיתוף אינם מאפשרים העלאה, שינוי שם, העברה, העברה לאשפה, שחזור או מחיקה לצמיתות. שמרו אותם בנפרד כאשר התפקיד היחיד של הסוכן הוא מסירת הקובץ.

יצירת קישור באמצעות REST

curl -s -X POST "https://trekmail.net/api/v1/drive/files/{FILE_ID}/share-links" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: share-{FILE_ID}-client-a" \
  -d '{"expires_at":"2026-06-01T00:00:00Z","max_downloads":25}'

התשובה כוללת את כתובת ה-URL הציבורית. אסימון השיתוף הגולמי מוחזר רק בזמן היצירה. אם תאבדו אותו, בטלו את הקישור וצרו קישור חדש.

יצירת קישור באמצעות MCP

drive_share_create(file_id=123, expires_at="2026-06-01T00:00:00Z", max_downloads=25)

בקשו מהסוכן להחזיר את כתובת ה-URL בתשובתו הסופית ולציין את מועד התפוגה ואת מגבלת ההורדות.

הצגת קישורים וביטולם

השתמשו ב-endpoint של הרשימה או ב-drive_share_list כדי לראות קישורים פעילים וקודמים של קובץ. בטלו קישור כאשר הוא נשלח לאדם הלא נכון, כאשר חוזה אינו בתוקף עוד או כאשר חלון מסירה זמני נסגר.

drive_share_revoke(link_id=456)

הביטול נכנס לתוקף מיד. צרו קישור חדש אם צריך לשחזר את הגישה.

ברירות מחדל מומלצות

קישורים ללא הגבלה הם נוחים, אך קשה יותר להעריך אותם בהמשך. אם בחרתם לא להגדיר תפוגה, הוסיפו במערכת שלכם הערה שמסבירה מדוע.

התנהגות אבטחה

קישור שיתוף ציבורי לכל מי שמחזיק בכתובת ה-URL. הוא מוגן באמצעות אסימון שלא ניתן לנחש, ולא באמצעות כניסה ל-TrekMail. אל תשלחו קישורים ציבוריים לקבצים שדורשים גישה של נמענים מוגדרים בשמם, אלא אם הארגון שלכם מקבל את המודל הזה.

דף ההורדה אינו חושף פרטים מיותרים על החשבון. קישורים שפג תוקפם, שבוטלו או שמכסתם מוצתה מפסיקים לפעול בלי לחשוף מידע פרטי על הקובץ.

נתיב ביקורת

יצירה וביטול של קישורי שיתוף נרשמים לביקורת עם זהות אסימון ה-API. אם סוכן יוצר קישורים עבור לקוחות, בדקו את יומן הביקורת מדי פעם והחליפו אסימונים כאשר תחומי האחריות בצוות משתנים.