Method: files.patch

Actualiza los metadatos o el contenido de un archivo. Cuando llames a este método, solo propaga los campos en la solicitud que deseas modificar. Cuando actualizas campos, algunos pueden cambiar automáticamente, como modifiedDate. Este método es compatible con la semántica de parches.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
fileId

string

El ID del archivo que se actualizará.

Parámetros de consulta

Parámetros
addParents

string

Lista separada por comas de los ID principales que se deben agregar.

convert
(deprecated)

boolean

Obsoleto: este parámetro no tiene función.

enforceSingleParent
(deprecated)

boolean

Obsoleto: ya no se admite la opción de agregar archivos a varias carpetas. Usa shortcuts en su lugar.

modifiedDateBehavior

enum (ModifiedDateBehavior)

Determina el comportamiento en el que se actualiza modifiedDate. Esto anula setModifiedDate.

newRevision

boolean

Establece si una carga de BLOB debe crear una revisión nueva. Si es falso, se reemplazan los datos del BLOB de la revisión principal actual. Si se establece como verdadera o no se establece, se creará un BLOB nuevo como revisión principal y las revisiones no fijadas anteriores se conservarán por un período breve. Las revisiones fijadas se almacenan indefinidamente, con una cuota de almacenamiento adicional, hasta un máximo de 200 revisiones. Para obtener detalles sobre cómo se retienen las revisiones, consulta el Centro de ayuda de Drive. Ten en cuenta que este campo se ignora si la solicitud no tiene carga.

ocr

boolean

Indica si se debe intentar aplicar OCR en cargas de .jpg, .png, .gif o .pdf.

ocrLanguage

string

Si ocr es "true", sugiere el idioma que se usará. Los valores válidos son los códigos BCP 47.

pinned

boolean

Establece si se debe fijar la nueva revisión. Un archivo puede tener hasta 200 revisiones fijas. Ten en cuenta que este campo se ignora si la solicitud no tiene carga.

removeParents

string

Lista de los ID principales separados por comas para quitar.

setModifiedDate

boolean

Indica si se debe establecer la fecha de modificación con el valor proporcionado en el cuerpo de la solicitud. Establecer este campo en true equivale a modifiedDateBehavior=fromBodyOrNow, y false a modifiedDateBehavior=now. Para evitar cambios en la fecha modificada, establece modifiedDateBehavior=noChange.

supportsAllDrives

boolean

Indica si la aplicación solicitante admite Mi unidad y las unidades compartidas.

supportsTeamDrives
(deprecated)

boolean

Obsoleto: usa supportsAllDrives en su lugar.

timedTextLanguage

string

El idioma del texto cronometrado.

timedTextTrackName

string

El nombre de la pista de texto cronometrado.

updateViewedDate

boolean

Establece si se debe actualizar la fecha de visualización después de actualizar el archivo correctamente.

useContentAsIndexableText

boolean

Indica si se debe usar el contenido como texto indexable.

includePermissionsForView

string

Especifica qué permisos de vistas adicionales se deben incluir en la respuesta. Solo se admite published.

includeLabels

string

Una lista separada por comas de los IDs de las etiquetas que se incluirán en la parte labelInfo de la respuesta.

Cuerpo de la solicitud

El cuerpo de la solicitud incluye una instancia de File.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de File.

Permisos de autorización

Se necesita uno de los siguientes alcances 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

Algunos permisos están restringidos y requieren una evaluación de seguridad para que tu app los use. Para obtener más información, consulta la guía de autorización.