Caricare un file su Drive
L'unica chiamata di questa sezione che non usa un corpo JSON, un caricamento multipart sul Drive dell'account.
Ogni altra chiamata di questa sezione invia api_key e i suoi campi in un unico corpo JSON.
upload_drive_file_user è l'eccezione: il file stesso deve viaggiare come parte multipart, quindi
api_key e gli altri campi lo accompagnano come campi del modulo invece che come JSON. L'endpoint è
sempre /cpi/upload_drive_file_user, come per qualsiasi altro metodo: multer è montato prima del
router su ogni route e agisce solo quando la richiesta è davvero multipart.
Metodo
Upload Drive File User
Uploads drive file to user drive.
upload_drive_file_user è uno dei pochi metodi con un array fields vuoto nel registro (accetta un
file, non parametri tipizzati), quindi il riferimento interattivo non può mostrarti i suoi input.
Vengono letti direttamente dalla richiesta dal gestore e sono riportati qui sotto dal sorgente.
Procedura
Invia il file come multipart, non come JSON
La parte del file deve chiamarsi file, l'unico nome di campo che multer è configurato ad
accettare. Tutto il resto è un normale campo del modulo nella stessa richiesta: api_key, un path
facoltativo (la cartella in cui metterlo, di default /), un booleano make_public facoltativo e un
valore tags facoltativo (una stringa separata da virgole o un array JSON).
La risposta
Il successo risponde code: 760, non il solito 1: ramifica su code > 0, non su un valore
specifico. Nemmeno una collisione di nome nello stesso percorso è un errore: il file viene salvato
con un server_file_name disambiguato e rename torna true, così sai che il nome originale non
è quello effettivamente usato. filename riporta sempre il nome originale del caricamento.
Errori
Poiché questo metodo non ha campi dichiarati, nessuno di questi torna con il solito messaggio
'x' is a mandatory field: sono il testo del gestore stesso in data, tutti con code: -400:
Una api_key mancante o non autorizzata fallisce comunque nel modo normale, con -401, prima che il
gestore venga raggiunto. Vedi Errori.