A API Google Drive é compatível com vários tipos de ações de download e exportação, conforme listado na tabela a seguir:
Faça downloads |
|
|||
Exportações |
|
O restante deste guia fornece instruções detalhadas para realizar esses tipos de ações de download e exportação.
Fazer o download do 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
servidor que um download do conteúdo está sendo solicitado como um formato de resposta
alternativo.
O parâmetro de URL alt=media
é um parâmetro do sistema disponível em todas as APIs REST do Google. Se você usa uma biblioteca de cliente para a API Drive, não precisa definir esse parâmetro explicitamente.
O exemplo de código a seguir mostra como usar o método files.get
para fazer o download de um arquivo 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 no 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 está autorizado a fazer o download do conteúdo do arquivo.
Este exemplo de código usa o escopo restrito de arquivos "drive" para que os usuários possam ver e gerenciar todos os seus arquivos do Drive. Para saber mais sobre os escopos do Drive, consulte as informações de autorização e autenticação específicas da API.
Usuários com permissões para edição podem restringir o download por usuários com acesso somente leitura
configurando o campo
copyRequiresWriterPermission
como false
.
Os arquivos identificados como
abusivos
(como software nocivo) só podem ser transferidos pelo proprietário.
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 o download de um possível software indesejado ou de outros arquivos abusivos. Seu aplicativo precisa avisar o usuário
de maneira interativa 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. É possível especificar a parte do arquivo que você quer transferir por download usando um intervalo de bytes com o cabeçalho Range
. Por exemplo:
Range: bytes=500-999
Fazer o download do conteúdo do arquivo de 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 do
arquivo para 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á
sendo solicitado como um formato de resposta alternativo. De forma semelhante a files.get
, 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
de revisões, consulte Fazer o download e publicar revisões de
arquivos.
Fazer o download do conteúdo do arquivo de blob em um navegador
Para fazer o download do conteúdo de arquivos blob armazenados no Drive em um navegador, em vez de usar a API, use o campo webContentLink
do recurso Files
. Se o usuário tiver acesso de download
ao arquivo, será retornado um link para fazer o download e o conteúdo
dele. É possível redirecionar um usuário para esse URL ou oferecê-lo como um link
clicável.
Exportar o 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. O conteúdo exportado é limitado a 10 MB.
O exemplo de código a seguir mostra como usar o método files.export
para exportar um documento do Google Workspace no formato PDF usando as bibliotecas de cliente da API Drive:
Java
Python
Node.js
PHP
.NET
Este exemplo de código usa o escopo restrito drive
, que permite aos usuários ver e gerenciar todos os arquivos do Drive. Para saber mais sobre os escopos do Drive, consulte as
informações de autorização e autenticação específicas
da API.
O exemplo de código também declara o tipo MIME de exportação como application/pdf
. Para ver uma
lista completa de todos os tipos MIME de exportação compatíveis com cada documento do Google Workspace, consulte Exportar tipos MIME para documentos do
Google Workspace.
Exportar o conteúdo de documentos do Google Workspace em um navegador
Para exportar o conteúdo do documento do Google Workspace em um navegador, use o
campo exportLinks
do recurso
Files
. Dependendo do tipo de
documento, um link para fazer o download do arquivo e do conteúdo dele é retornado para cada tipo
MIME disponível. Você pode redirecionar um usuário para um URL ou oferecê-lo como um link clicável.
Exportar o conteúdo do documento do Google Workspace para uma versão anterior em um navegador
Para exportar o conteúdo do documento do Google Workspace em uma versão anterior em um
navegador, use o método revisions.get
com o ID do arquivo para download e o ID da revisão. Se o usuário tiver acesso para fazer o download do arquivo, será retornado um link para fazer o download e o conteúdo dele. É possível redirecionar um usuário para esse URL ou oferecê-lo como um link
clicável.