העלאת קובץ ל-Drive
הקריאה היחידה בפרק הזה שאינה גוף JSON, העלאה מסוג multipart ל-Drive של החשבון עצמו.
כל קריאה אחרת בפרק הזה שולחת את api_key ואת השדות שלה כגוף JSON אחד. upload_drive_file_user
היא היוצאת מן הכלל: הקובץ עצמו צריך לנסוע כחלק multipart, ולכן api_key ושאר
השדות נוסעים לצדו כשדות טופס ולא כ-JSON. נקודת הקצה עדיין /cpi/upload_drive_file_user,
כמו כל שיטה אחרת, multer מותקן לפני הנתב בכל מסלול ופועל רק
כשהבקשה היא באמת multipart.
שיטה
Upload Drive File User
Uploads drive file to user drive.
upload_drive_file_user היא אחת מהשיטות המעטות עם מערך fields ריק ברישום
(היא מקבלת קובץ, לא פרמטרים מוקלדים), ולכן ההפניה האינטראקטיבית לא יכולה להראות לכם את
הקלטים שלה. ה-handler קורא אותם ישירות מהבקשה, והם משוחזרים מהקוד המקורי להלן.
הדרכה צעד אחר צעד
שולחים את הקובץ כ-multipart, לא כ-JSON
חלק הקובץ חייב להיקרא file, זה שם השדה היחיד ש-multer מוגדר לקבל.
כל השאר הם שדות טופס רגילים באותה בקשה: api_key, path אופציונלי (התיקייה שבה
ימוקם, ברירת המחדל /), ערך בוליאני אופציונלי make_public, וערך tags אופציונלי
(מחרוזת מופרדת בפסיקים או מערך JSON).
התשובה
הצלחה עונה code: 760, לא 1 הרגיל, מסתעפים לפי code > 0 ולא לפי ערך מסוים. התנגשות
שם באותו נתיב אינה שגיאה גם היא: הקובץ נשמר תחת server_file_name שהופרד מהאחרים ו-rename חוזר true כדי שתדעו שהשם המקורי לא היה
זה שנעשה בו שימוש בפועל. filename תמיד משקף את שם ההעלאה המקורי בכל מקרה.
שגיאות
מכיוון שלשיטה הזו אין שדות מוצהרים, אף אחת מהן לא חוזרת בהודעה הרגילה
'x' is a mandatory field, אלה הטקסט של ה-handler עצמו ב-data, כולן ב-code: -400:
api_key חסר או לא מורשה עדיין נכשל באופן הרגיל, ב--401, עוד לפני שמגיעים אל
ה-handler. ראו שגיאות.