כיבוי Drive לתיבת דואר באמצעות API

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

אותה הגדרה נמצאת בלוח הבקרה תחת תיבות דואר → (תיבת דואר) → מגבלות. היא זמינה בכל תוכנית ללא עלות נוספת.

שלוש הרמות

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

ההיקף הנדרש

mailboxes:write, אותו היקף שמעדכן כל שדה אחר בתיבת הדואר. שני ה-endpoint שלהלן מקבלים כותרת Idempotency-Key ובטוח לנסות אותם שוב.

תיבת דואר אחת

curl -s -X PATCH "https://trekmail.net/api/v1/mailboxes/{MAILBOX_ID}" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: drive-access-{MAILBOX_ID}-off" \
  -d '{"drive_access":"disabled"}'

תיבת הדואר המעודכנת מוחזרת עם הרמה החדשה:

{ "data": { "id": 1701, "email": "sam@example.com", "drive_access": "disabled", "...": "..." } }

drive_access מוחזר גם על ידי GET /api/v1/mailboxes/{id} ועל ידי endpoint הרשימה, כך שאפשר לבדוק מה הוגדר בלי לשנות דבר.

תיבות דואר רבות בבת אחת

curl -s -X POST "https://trekmail.net/api/v1/mailboxes:drive-access" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: drive-access-domain-123-off" \
  -d '{"domain_id":123,"drive_access":"disabled"}'

העבירו בדיוק בורר אחד:

התשובה מציגה מה קרה:

{ "data": { "drive_access": "disabled", "matched": 24, "updated": 21, "skipped_shared": 3 } }

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

החלה על תיבות דואר חדשות

יצירת תיבת דואר אינה מקבלת drive_access; תיבות חדשות מתחילות ב-full. כדי להקצות תיבה שמעולם לא קיבלה Drive, צרו אותה ולאחר מכן הגדירו את הרמה:

# 1. Create the mailbox. The server generates the one-time password and returns it once.
curl -s -X POST "https://trekmail.net/api/v1/mailboxes" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-mailbox-sam" \
  -d '{"domain_id":123,"local_part":"sam","password_mode":"generated_one_time"}'

# 2. Turn off Drive using the id returned above.
curl -s -X PATCH "https://trekmail.net/api/v1/mailboxes/1701" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: drive-access-1701-off" \
  -d '{"drive_access":"disabled"}'

אם אתם יוצרים תיבות דואר בקבוצות, התהליך הפשוט יותר הוא ליצור את כולן ואז לבצע קריאה אחת בכמות גדולה עם domain_id.

באמצעות סוכן MCP

set_mailboxes_drive_access(domain_id=123, drive_access="disabled")

הכלי מקבל את אותם שלושה בוררים כמו endpoint ה-REST ומחזיר את אותן ספירות. עבור תיבה יחידה אפשר גם להשתמש ב-update_mailbox(mailbox_id=1701, drive_access="disabled").

תיבות דואר משותפות

ה-endpoint היחיד דוחה תיבות דואר משותפות עם 422 drive_access_not_applicable, וה-endpoint בכמות גדולה מדלג עליהן אך עדיין סופר אותן. אף אחד אינו נכנס ישירות לתיבה משותפת: הצוות פותח אותה מתוך התיבה האישית שלו, ולכן חלה הרמה של תיבת אותו חבר. אדם שכיביתם עבורו את Drive אינו יכול להגיע לקבצים של תיבה משותפת או להשתמש בה כדי לעקוף את ההגדרה.

מה רואה תיבת דואר מוגבלת

ההגבלה נאכפת בכל מקום ולא רק מוסתרת בממשק:

• שטח ה-Drive שלה אינו מופיע ב-GET /api/v1/drive/spaces
• הקבצים שלה מחזירים 404 כאשר מבקשים אותם לפי id
• אי אפשר ליצור עבורה התקן סנכרון; POST /api/v1/drive/devices מחזיר 422 drive_disabled
• בדואר האינטרנט אין Drive בסרגל הצד, העלאה בגרירה ושחרור או תוצאות Drive בחיפוש

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

שגיאות אפשריות