Method: files.patch

Atualiza os metadados e/ou o conteúdo de um arquivo. Ao chamar esse método, preencha apenas os campos na solicitação que você quer modificar. Ao atualizar campos, alguns deles podem mudar automaticamente, como "modifiedDate". Esse método é compatível com a semântica de patch.

Solicitação HTTP

PATCH https://www.googleapis.com/drive/v2/files/{fileId}

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

Parâmetros de caminho

Parâmetros
fileId

string

O ID do arquivo a ser atualizado.

Parâmetros de consulta

Parâmetros
addParents

string

Lista separada por vírgulas de IDs principais a serem adicionadas.

convert
(deprecated)

boolean

Desativado: esse parâmetro não tem função.

enforceSingleParent
(deprecated)

boolean

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

modifiedDateBehavior

enum (ModifiedDateBehavior)

Determina o comportamento em que modifiedDate é atualizado. Isso substitui setModifiedDate.

newRevision

boolean

Indica se um upload de blob precisa criar uma nova revisão. Se for falso, os dados do blob na revisão atual da cabeça são substituídos. Se for verdadeiro ou não estiver definido, um novo blob será criado como revisão principal, e as revisões desconectadas anteriores serão preservadas por um curto período. As revisões fixadas são armazenadas indefinidamente, usando uma cota de armazenamento extra, até um máximo de 200 revisões. Para saber como as revisões são retidas, consulte a Central de Ajuda do Drive. Esse campo é ignorado se não houver payload na solicitação.

ocr

boolean

Define se o OCR será usado em uploads .jpg, .png, .gif ou .pdf.

ocrLanguage

string

Se o reconhecimento óptico de caracteres for verdadeiro, ele vai sugerir o idioma a ser usado. Os valores válidos são códigos BCP 47.

pinned

boolean

Se a nova revisão será fixada. Um arquivo pode ter no máximo 200 revisões fixadas. Esse campo é ignorado se não houver payload na solicitação.

removeParents

string

Lista separada por vírgulas de IDs principais a serem removidos.

setModifiedDate

boolean

Define se a data modificada será definida usando o valor fornecido no corpo da solicitação. Definir esse campo como true é equivalente a modifiedDateBehavior=fromBodyOrNow, e false é equivalente a modifiedDateBehavior=now. Para evitar mudanças na data modificada do conjunto modifiedDateBehavior=noChange.

supportsAllDrives

boolean

Indica se o aplicativo solicitante é compatível com o Meu Drive e com os drives compartilhados.

supportsTeamDrives
(deprecated)

boolean

Descontinuado: use supportsAllDrives.

timedTextLanguage

string

O idioma do texto programado.

timedTextTrackName

string

O nome da faixa de texto programado.

updateViewedDate

boolean

Define se a data de visualização será atualizada após a atualização do arquivo.

useContentAsIndexableText

boolean

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

includePermissionsForView

string

Especifica quais permissões de visualizações 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/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • 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.