Method: files.update

Atualiza os metadados e/ou o conteúdo de um arquivo. Ao chamar esse método, preencha apenas os campos da solicitação que você quer modificar. Ao atualizar os campos, alguns deles podem ser alterados automaticamente, como modifiedDate. Este método oferece suporte à semântica de patches.

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 MIME de mídia aceitos:*/*

Observação: 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 sobre o upload de arquivos, consulte Fazer o upload de dados do arquivo.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
uploadType

string

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

Os valores aceitos são:

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

string

O ID do arquivo.

Parâmetros de consulta

Parâmetros
uploadType

string

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

Os valores aceitos são:

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

string

Uma lista separada por vírgulas de IDs pais a serem adicionados.

enforceSingleParent
(deprecated)

boolean

Obsoleto: não é mais possível adicionar arquivos a várias pastas. Use atalhos.

keepRevisionForever

boolean

Define se o campo "keepForever" será definido na nova revisão principal. Isso só é aplicável a arquivos com conteúdo binário no Google Drive. Apenas 200 revisões do arquivo podem ser mantidas para sempre. Se o limite for atingido, exclua as revisões fixadas.

ocrLanguage

string

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

removeParents

string

Uma lista separada por vírgulas de IDs pais a serem removidos.

supportsAllDrives

boolean

Se o aplicativo que fez a solicitação é compatível com o Meu Drive e os drives compartilhados.

supportsTeamDrives
(deprecated)

boolean

Obsoleto: use supportsAllDrives.

useContentAsIndexableText

boolean

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

includePermissionsForView

string

Especifica as permissões de visualização extra que vão ser incluídas na resposta. Somente "Publicado" é compatível.

includeLabels

string

Uma lista separada por vírgulas de IDs de rótulos a serem incluídos na parte de 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 de OAuth:

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

Alguns escopos são restritos e exigem uma avaliação de segurança para que sejam usados pelo app. Para mais informações, consulte o Guia de autorização.