Method: files.update

Atualiza os metadados, o conteúdo ou ambos de um arquivo.

Ao chamar esse método, preencha apenas os campos da solicitação que você quer modificar. Ao atualizar campos, alguns podem ser alterados automaticamente, como modifiedDate. Esse método é compatível com a semântica de patch.

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.

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
fileId

string

O ID do arquivo.

Parâmetros de consulta

Parâmetros
addParents

string

Uma lista separada por vírgulas de IDs principais a serem adicionados.
enforceSingleParent
(deprecated)

boolean

Descontinuado: não é mais possível adicionar arquivos a várias pastas. Use atalhos.
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).
removeParents

string

Uma lista separada por vírgulas de IDs principais a serem removidos.
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
  • 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 o app possa usá-los. Para mais informações, consulte o guia de autorização.