A API Google Drive oferece suporte a vários tipos de ações de download e exportação, como listados na tabela a seguir:
Downloads |
|
|||
Exportações |
|
Antes de fazer o download ou exportar o conteúdo do arquivo, verifique se os usuários podem fazer o download do
usando o campo capabilities.canDownload
na
files
.
O restante deste guia fornece instruções detalhadas para executar esses tipos de ações de download e exportação.
Baixar o conteúdo do arquivo blob
Para fazer o download de um arquivo blob armazenado no Drive, use o método files.get
com o ID do arquivo.
e o parâmetro de URL alt=media
. O parâmetro de URL alt=media
informa ao
de que um download de conteúdo está sendo solicitado como resposta alternativa
.
O parâmetro de URL alt=media
é um sistema
parâmetro
disponíveis em todas as APIs REST do Google. Se você usa uma biblioteca de cliente para a
API Drive, não é necessário definir explicitamente esse parâmetro.
O exemplo de código a seguir mostra como usar o método files.get
para fazer o download de um
com as bibliotecas de cliente da API Drive.
Java
Python
Node.js
PHP
.NET
Este exemplo de código usa um método de biblioteca que adiciona o parâmetro de URL alt=media
.
à solicitação HTTP subjacente.
Os downloads de arquivos iniciados pelo app precisam ser autorizados com um escopo que permita
acesso de leitura ao conteúdo do arquivo. Por exemplo, um app que usa
O escopo drive.readonly.metadata
não tem autorização para fazer o download do conteúdo do arquivo.
Este exemplo de código usa o escopo de arquivo restrito "drive" que permite aos usuários
visualizar e gerenciar todos os seus arquivos do Google Drive. Para saber mais sobre
escopos do Drive, consulte Escolher a API Google Drive
escopos.
Os usuários com permissões para edição podem restringir o download para usuários com acesso somente leitura por meio do
definir o copyRequiresWriterPermission
como false
.
Arquivos identificados como
abusivo
(como softwares nocivos) só podem ser baixados pelo proprietário do arquivo.
Além disso, o parâmetro de consulta get
acknowledgeAbuse=true
precisa ser incluído
para indicar que o usuário reconheceu o risco de fazer downloads potencialmente
softwares indesejados ou outros arquivos abusivos. O aplicativo precisa interagir
avisar o usuário antes de usar esse parâmetro de consulta.
Download parcial
O download parcial envolve o download de apenas uma parte específica de um arquivo. Você
você pode especificar a parte do arquivo que deseja baixar usando um byte
intervalo
com o cabeçalho Range
. Exemplo:
Range: bytes=500-999
Fazer o download do conteúdo do arquivo blob em uma versão anterior
Para fazer o download do conteúdo de arquivos blob em uma versão anterior, use o
Método revisions.get
com o ID de
o arquivo que será transferido por download, o ID da revisão e o parâmetro de URL alt=media
.
O parâmetro de URL alt=media
informa ao servidor que um download de conteúdo está
solicitadas como um formato de resposta alternativo. Semelhante a files.get
, a
O método revisions.get
também aceita o parâmetro de consulta opcional
acknowledgeAbuse
e o cabeçalho Range
. Para mais informações sobre como fazer o download
revisões, consulte Fazer o download e publicar o arquivo
revisões.
Fazer o download do conteúdo do arquivo blob em um navegador
Para fazer o download do conteúdo de arquivos blob armazenados no Drive em um
navegador, e não por meio da API, use a
webContentLink
do
files
. Se o usuário tiver feito o download
acesso ao arquivo, há um link para fazer o download do arquivo e de seu conteúdo
retornados. Você pode redirecionar um usuário para esse URL ou oferecê-lo como uma página
.
Exportar conteúdo de documentos do Google Workspace
Para exportar o conteúdo de bytes do documento do Google Workspace, use o método files.export
com o ID do arquivo a ser exportado.
e o tipo MIME correto. Exportado
tem um limite de 10 MB.
O exemplo de código a seguir mostra como usar o método files.export
para exportar um
Documento do Google Workspace em formato PDF usando o cliente da API Drive
bibliotecas:
Java
Python
Node.js
PHP
.NET
Este exemplo de código usa o escopo drive
restrito que permite aos usuários visualizar e
gerenciar todos os seus arquivos do Google Drive. Para saber mais sobre
escopos do Drive, consulte Escolher a API Google Drive
escopos.
O exemplo de código também declara o tipo MIME de exportação como application/pdf
. Para um
lista completa de todos os tipos MIME de exportação aceitos em cada produto do
consulte Exportar tipos MIME para o Google Workspace
documentos.
Exportar conteúdo de documentos do Google Workspace em um navegador
Para exportar o conteúdo de um documento do Google Workspace em um navegador, use o
exportLinks
do
files
. Dependendo do documento,
tipo de arquivo, um link para fazer download do arquivo e seu conteúdo será retornado para cada
tipo disponível. Você pode redirecionar um usuário para um URL ou oferecê-lo como um
link clicável.
Exportar o conteúdo de documentos do Google Workspace em uma versão anterior em um navegador
Para exportar o conteúdo de documentos do Google Workspace em uma versão anterior em um
navegador, use o método revisions.get
com o ID do arquivo que será baixado e o ID da revisão. Se o usuário tiver
acesso de download ao arquivo, há um link para fazer download do arquivo e de seu conteúdo
retornados. Você pode redirecionar um usuário para esse URL ou oferecê-lo como uma página
.