Carregar um ficheiro para o Drive
A única chamada desta secção que não é um corpo JSON, um carregamento multipart para o Drive da própria conta.
Todas as outras chamadas desta secção enviam api_key e os seus campos como um único corpo JSON.
upload_drive_file_user é a exceção: o próprio ficheiro tem de viajar como uma parte multipart, por
isso api_key e os restantes campos seguem ao lado como campos de formulário em vez de JSON. O
endpoint continua a ser /cpi/upload_drive_file_user, como qualquer outro método, o multer está
montado à frente do router para todas as rotas e só atua quando o pedido é realmente multipart.
Método
Upload Drive File User
Uploads drive file to user drive.
upload_drive_file_user é um dos poucos métodos com um array fields vazio no registo (recebe um
ficheiro, não parâmetros com tipos), por isso a referência interativa não lhe pode mostrar as entradas.
São lidas diretamente do pedido pelo handler e reproduzidas a partir do código abaixo.
Passo a passo
Envie o ficheiro como multipart, não como JSON
A parte do ficheiro tem de se chamar file, esse é o único nome de campo que o multer está
configurado para aceitar. Tudo o resto é um campo de formulário normal no mesmo pedido: api_key, um
path opcional (a pasta onde o colocar, por omissão /), um booleano make_public opcional e um
valor tags opcional (uma cadeia separada por vírgulas ou um array JSON).
A resposta
O sucesso responde code: 760, não o habitual 1, ramifique por code > 0, não por um valor
específico. Uma colisão de nomes no mesmo caminho também não é um erro: o ficheiro é guardado com um
server_file_name desambiguado e rename regressa true para que saiba que o nome original não foi
o realmente usado. filename devolve sempre o nome original do carregamento.
Erros
Como este método não tem campos declarados, nenhum destes regressa com a habitual mensagem
'x' is a mandatory field, são o texto do próprio handler em data, todos com code: -400:
Uma api_key em falta ou sem autorização continua a falhar da forma normal, em -401, antes de o
handler ser sequer alcançado. Consulte Erros.