Method: files.patch

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 campos, alguns podem ser alterados automaticamente, como changedDate. Este método oferece suporte à semântica de patches.

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 pais a serem adicionados.
convert
(deprecated)

boolean

Obsoleto: este parâmetro não tem função.
enforceSingleParent
(deprecated)

boolean

Obsoleto: 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

Se um upload de blob deve criar uma nova revisão. Se for falso, os dados do blob na revisão principal atual serão substituídos. Se definida como verdadeira ou não for definida, um novo blob será criado como revisão principal, e as revisões não fixadas anteriores serão preservadas por um curto período. As revisões fixadas são armazenadas indefinidamente, usando a cota de armazenamento adicional, até um máximo de 200 revisões. Veja mais detalhes sobre como as revisões são retidas na Central de Ajuda do Drive. Observe que este campo será ignorado se não houver payload na solicitação.
ocr

boolean

Para tentar usar o OCR nos uploads de .jpg, .png, .gif ou .pdf.
ocrLanguage

string

Se o parâmetro ocr for "true", ele indica o idioma a ser usado. Os valores válidos são códigos BCP 47.
pinned

boolean

Define se a nova revisão será fixada. Um arquivo pode ter no máximo 200 revisões fixadas. Observe que este campo será ignorado se não houver payload na solicitação.
removeParents

string

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

boolean

Define se a data de modificação será definida usando o valor fornecido no corpo da solicitação. Definir esse campo como true equivale a modifiedDateBehavior=fromBodyOrNow e false equivale a modifiedDateBehavior=now. Para evitar mudanças na data de modificação, defina modifiedDateBehavior=noChange.
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.
timedTextLanguage

string

O idioma do texto com marcação de tempo.
timedTextTrackName

string

O nome da faixa de texto com marcação de tempo.
updateViewedDate

boolean

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

boolean

Define se o conteúdo 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 published é aceito.
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/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 sejam usados pelo app. Para mais informações, consulte o Guia de autorização.