Eine Datei zu Drive hochladen
Der einzige Aufruf in diesem Abschnitt ohne JSON-Body: ein Multipart-Upload in das eigene Drive des Kontos.
Jeder andere Aufruf in diesem Abschnitt sendet api_key und seine Felder als einen JSON-Body. upload_drive_file_user
ist die Ausnahme: Die Datei selbst muss als Multipart-Teil übertragen werden, daher reisen api_key und die übrigen
Felder als Formularfelder daneben statt als JSON. Der Endpunkt ist weiterhin /cpi/upload_drive_file_user,
wie bei jeder anderen Methode. multer ist bei jeder Route vor dem Router eingehängt und greift nur,
wenn die Anfrage tatsächlich Multipart ist.
Methode
Upload Drive File User
Uploads drive file to user drive.
upload_drive_file_user ist eine der wenigen Methoden mit einem leeren fields-Array in der
Registry (sie nimmt eine Datei, keine typisierten Parameter), daher kann die interaktive Referenz ihre
Eingaben nicht anzeigen. Der Handler liest sie direkt aus der Anfrage, unten sind sie aus dem Quellcode wiedergegeben.
Schritt für Schritt
Sende die Datei als Multipart, nicht als JSON
Der Dateiteil muss file heißen, das ist der einzige Feldname, den multer annimmt.
Alles andere sind gewöhnliche Formularfelder derselben Anfrage: api_key, ein optionaler path (der
Ordner, in den die Datei kommt, Standard ist /), ein optionaler Boolean make_public und ein optionaler tags-Wert
(ein durch Kommas getrennter String oder ein JSON-Array).
Die Antwort
Erfolg antwortet mit code: 760, nicht dem üblichen 1. Verzweige nach code > 0, nicht nach einem bestimmten Wert. Eine
Namenskollision am selben Pfad ist ebenfalls kein Fehler: Die Datei wird unter einem eindeutig gemachten
server_file_name gespeichert, und rename kommt als true zurück, damit du weißt, dass der ursprüngliche Name nicht der war,
der tatsächlich verwendet wurde. filename gibt immer den ursprünglichen Upload-Namen wieder.
Fehler
Da diese Methode keine deklarierten Felder hat, kommt keine davon als die übliche
Meldung 'x' is a mandatory field zurück. Es ist der eigene Text des Handlers in data, jeweils mit code: -400:
Ein fehlender oder nicht berechtigter api_key scheitert weiterhin auf dem normalen Weg bei -401, bevor der Handler
überhaupt erreicht wird. Siehe Fehler.