Method: files.create

Cria um arquivo. Para mais informações, consulte Criar e gerenciar arquivos.

Esse método é compatível com um URI de /upload e aceita mídias enviadas com as seguintes características:

  • Tamanho máximo do arquivo:5.120 GB
  • Tipos de mídia MIME aceitos: */*

    Especifique um tipo MIME válido, em vez do valor literal */*. O literal */* é usado apenas para indicar que qualquer tipo MIME válido pode ser enviado. Para mais informações, consulte Tipos MIME compatíveis com o Google Workspace e o Google Drive.

Para mais informações sobre como fazer upload de arquivos, consulte Fazer upload de dados de arquivos.

Os apps que criam atalhos com o método create precisam especificar o tipo MIME application/vnd.google-apps.shortcut.

Os apps precisam especificar uma extensão de arquivo na propriedade name ao inserir arquivos com a API. Por exemplo, uma operação para inserir um arquivo JPEG precisa especificar algo como "name": "cat.jpg" nos metadados.

As solicitações GET subsequentes incluem a propriedade somente leitura fileExtension preenchida com a extensão originalmente especificada na propriedade name. Quando um usuário do Google Drive solicita o download de um arquivo ou quando ele é baixado pelo cliente de sincronização, o Drive cria um nome de arquivo completo (com extensão) com base no nome. Quando a extensão está ausente, o Drive tenta determinar a extensão com base no tipo MIME do arquivo.

Solicitação HTTP

  • URI de upload, para solicitações de upload de mídia:
    POST https://www.googleapis.com/upload/drive/v3/files
  • URI de metadados, para solicitações somente de metadados:
    POST https://www.googleapis.com/drive/v3/files

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
enforceSingleParent
(deprecated)

boolean

Descontinuado: não é mais possível criar arquivos em várias pastas.
ignoreDefaultVisibility

boolean

Se as configurações de visibilidade padrão do domínio devem ser ignoradas para o arquivo criado. Os administradores de domínio podem escolher tornar todos os arquivos enviados visíveis para o domínio por padrão. Esse parâmetro ignora esse comportamento para a solicitação. As permissões ainda são herdadas das pastas principais.
keepRevisionForever

boolean

Se o campo keepForever deve ser definido na nova revisão principal. Isso só se aplica a arquivos com conteúdo binário no Google Drive. Apenas 200 revisões do arquivo podem ser mantidas indefinidamente. Se o limite for atingido, tente excluir revisões fixadas.
ocrLanguage

string

Uma dica de idioma para o processamento de OCR durante a importação de imagens (código ISO 639-1).
supportsAllDrives

boolean

Se o aplicativo solicitante é compatível com Meu Drive e com os drives compartilhados.
supportsTeamDrives
(deprecated)

boolean

Descontinuado: use supportsAllDrives.
uploadType

string

É o tipo de solicitação de upload para o URI /upload. Se você estiver fazendo upload de dados com um URI /upload, este campo será obrigatório. Este campo não é obrigatório caso você esteja criando um arquivo somente de metadados. Além disso, esse campo não é mostrado no widget "Testar este método" porque ele não é compatível com uploads de dados.

Os valores aceitáveis são:

  • media: upload simples. Faz upload apenas da mídia, sem metadados.
  • multipart: upload de várias partes. Faz upload da mídia e dos metadados em uma única solicitação.
  • resumable: upload retomável. Faça upload do arquivo de modo recuperável com uma série de pelo menos duas solicitações. A primeira inclui os metadados.
useContentAsIndexableText

boolean

Define se o conteúdo enviado será usado como texto indexável.
includePermissionsForView

string

Especifica quais permissões de visualização adicionais incluir na resposta. Somente published é aceito.
includeLabels

string

Uma lista separada por vírgulas de IDs de rótulos a serem incluídos na parte labelInfo da resposta.

Corpo da solicitação

O corpo da solicitação contém uma instância de File.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de File.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

Alguns escopos são restritos e exigem uma avaliação de segurança para que o app possa usá-los. Para mais informações, consulte o guia de autorização.