Prześlij plik na Dysk
Jedyne wywołanie w tej sekcji, które nie jest treścią JSON, przesyłanie multipart na własny Dysk konta.
Każde inne wywołanie w tej sekcji wysyła api_key i swoje pola jako jedną treść JSON.
upload_drive_file_user jest wyjątkiem: sam plik musi podróżować jako część multipart, więc
api_key i pozostałe pola jadą obok niego jako pola formularza, a nie JSON. Punkt końcowy to nadal
/cpi/upload_drive_file_user, jak każda inna metoda, multer jest zamontowany przed routerem dla
każdej trasy i działa tylko wtedy, gdy żądanie jest faktycznie multipart.
Metoda
Upload Drive File User
Uploads drive file to user drive.
upload_drive_file_user to jedna z garstki metod z pustą tablicą fields w rejestrze (przyjmuje
plik, a nie typowane parametry), więc interaktywna referencja nie pokaże jej danych wejściowych.
Procedura obsługi czyta je wprost z żądania, a poniżej są odtworzone ze źródła.
Krok po kroku
Wyślij plik jako multipart, a nie JSON
Część z plikiem musi nazywać się file, to jedyna nazwa pola, którą multer jest skonfigurowany
przyjmować. Wszystko inne to zwykłe pola formularza w tym samym żądaniu: api_key, opcjonalne
path (folder, w którym go umieścić, domyślnie /), opcjonalna wartość logiczna make_public i
opcjonalna wartość tags (ciąg rozdzielony przecinkami albo tablica JSON).
Odpowiedź
Sukces odpowiada code: 760, a nie zwykłym 1, rozgałęziaj się po code > 0, a nie po konkretnej
wartości. Kolizja nazwy w tej samej ścieżce też nie jest błędem: plik zostaje zapisany pod
rozróżnioną nazwą server_file_name, a rename wraca jako true, żebyś wiedział, że faktycznie
użyto innej nazwy niż oryginalna. filename zawsze zwraca oryginalną nazwę przesłania.
Błędy
Ponieważ ta metoda nie ma zadeklarowanych pól, żaden z nich nie wraca jako zwykły komunikat
'x' is a mandatory field, to własny tekst procedury obsługi w data, wszystkie przy code: -400:
Brakujący lub nieautoryzowany api_key nadal zawodzi normalnie, przy -401, zanim procedura
obsługi w ogóle zostanie osiągnięta. Zobacz Błędy.