Een bestand uploaden naar Drive
De enige aanroep in deze sectie zonder JSON-body: een multipart-upload naar de eigen Drive van het account.
Elke andere aanroep in deze sectie stuurt api_key en zijn velden als één JSON-body. upload_drive_file_user
is de uitzondering: het bestand zelf moet als multipart-onderdeel mee, dus api_key en de rest van
de velden reizen er als formuliervelden naast mee in plaats van als JSON. Het endpoint blijft
/cpi/upload_drive_file_user, zoals elke andere methode: multer staat voor elke route vóór de router
en doet alleen iets als het verzoek echt multipart is.
Methode
Upload Drive File User
Uploads drive file to user drive.
upload_drive_file_user is een van de weinige methoden met een lege array fields in het register
(hij neemt een bestand, geen getypeerde parameters), dus de interactieve referentie kan zijn input niet
tonen. De handler leest ze rechtstreeks uit het verzoek, en hieronder staan ze uit de broncode
overgenomen.
Stappenplan
Stuur het bestand als multipart, niet als JSON
Het bestandsonderdeel moet file heten: dat is de enige veldnaam die multer accepteert. Al het
andere zijn gewone formuliervelden in hetzelfde verzoek: api_key, een optioneel path (de map waar
het in komt, standaard /), een optionele boolean make_public en een optionele waarde tags (een
door komma's gescheiden string of een JSON-array).
Het antwoord
Succes antwoordt met code: 760, niet de gebruikelijke 1: vertak op code > 0, niet op een
specifieke waarde. Een naamconflict op hetzelfde pad is ook geen fout: het bestand wordt opgeslagen
onder een aangepaste server_file_name en rename komt terug als true, zodat je weet dat de
originele naam niet is gebruikt. filename geeft altijd de oorspronkelijke uploadnaam terug.
Fouten
Omdat deze methode geen gedeclareerde velden heeft, komt geen van deze terug als het gebruikelijke
bericht 'x' is a mandatory field. Het is de eigen tekst van de handler in data, allemaal met
code: -400:
Een ontbrekende of niet toegestane api_key faalt nog steeds op de gewone manier, met -401, voordat
de handler wordt bereikt. Zie Errors.