Drive Menu V2

דגל פיצ’ר

  • DRIVE_MENU_V2 (ברירת מחדל: true) — דגל של הבוט בלבד: כשהוא כבוי, GoogleDriveMenuHandler.menu עונה שהתכונה כבויה. הוובאפ לא קורא אותו.

זרימות עיקריות

  • קבצי גיבוי: העלאת ZIPים שמורים בבוט, כולל הצעה ליצור ZIP אם אין.

  • הכל: יצירת ZIP מלא והעלאה.

  • מתקדם: לפי ריפו / קבצים גדולים / שאר; בחירה מרובה.

  • תיקיית יעד: אוטומטי (סידור לפי קטגוריה; התאריך נכנס לשם הקובץ), ברירת מחדל, או נתיב מותאם.

  • תזמון: בחירה מהירה לתדירות גיבוי.

התחברות (Device Flow)

  1. לחיצה על ”התחבר ל‑Drive“ → קישור + קוד.

  2. אישור בדפדפן.

  3. הבוט יאמת אוטומטית; ניתן ללחוץ ”בדוק חיבור“ או להדביק את הקוד בהודעה.

בשלוש הדרכים החיבור מוצג כ“הושלם“ רק אחרי שהטוקנים נשמרו (_save_auth_tokens), ושמירה שנכשלה מוצגת כהודעת כשל. תשובת שגיאה מגוגל לא נשמרת אף פעם, ומוצגת כשגיאה (_auth_error_text): ב“בדוק חיבור“ ובהדבקת קוד מיד, ובבדיקה ברקע כשהשגיאה סוגרת את הבקשה — כל קוד שגיאה של OAuth חוץ מ-authorization_pending ו-slow_down, לפי RFC 8628 §3.5 (is_terminal_device_flow_error). שגיאה כזו סוגרת את הבקשה בכל אחת משלוש הדרכים, וכך גם טוקנים שהתקבלו: ה-device code נמחק והבדיקה ברקע נעצרת (_close_auth_request), כדי שלא תמשיך לפנות לגוגל עם קוד סגור. תשובת שגיאה בלי קוד של OAuth (למשל 503 מגוגל) לא סוגרת את הבקשה, והבדיקה ברקע ממשיכה עד שתוקף הבקשה פג.

החיבור שנוצר כאן, והתזמון שנקבע בתפריט, הם של הבוט בלבד (drive_owner.BOT). חיבור, ניתוק או תזמון בוובאפ לא משנים אותם, וההפך — ראו חיבור נפרד לכל שירות (owner).

טיפול שגיאות

  • אין גישה/הרשאות → כפתור ”התחבר ל‑Drive“.

  • כשל בהעלאה → הודעה + הצעה להתחבר מחדש. הסיבה נרשמת בלוג בשורת drive_call_failed (services/google_drive_service.py).

  • סיום התחברות שהטוקנים שלו לא נשמרו → הודעת כשל, ולא ”✅“.

  • גוגל סגר את בקשת ההתחברות (למשל המשתמש סירב) → הודעת השגיאה, והבדיקה ברקע נעצרת. בבדיקה ברקע וב“בדוק חיבור“ ההודעה מציעה את הכפתור ”התחבר ל‑Drive“ במקום ”בדוק חיבור“.

ניטור

  • breadcrumbs בלוגים על התחלה/סיום התחברות ושגיאות OAuth; drive_auth_tokens_not_saved כשהטוקנים לא נשמרו בסוף ההתחברות.

  • אירועי התזמון של הבוט — ראו Google Drive.

  • ניתן להוריד את רמת הלוג של apscheduler ל‑WARNING להפחתת רעש.

API (autodoc)