Method: files.patch

Actualiza los metadatos o el contenido de un archivo. Cuando llames a este método, propaga solo los campos de la solicitud que deseas modificar. Cuando se actualizan los campos, es posible que algunos cambien 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

Es el ID del archivo que se actualizará.

Parámetros de consulta

Parámetros
addParents

string

Es una lista de IDs superiores separados por comas para agregar.

convert
(deprecated)

boolean

Obsoleto: Este parámetro no tiene ninguna función.

enforceSingleParent
(deprecated)

boolean

Obsoleto: Ya no se admite 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

Indica si una carga de blob debe crear una revisión nueva. Si es falso, se reemplazan los datos de BLOB en la revisión principal actual. Si es verdadero o no se establece, se crea un nuevo BLOB como revisión principal, y las revisiones anteriores sin fijar se conservan durante un período breve. Las revisiones fijadas se almacenan de forma indefinida 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 no hay ninguna carga útil en la solicitud.

ocr

boolean

Si se debe intentar el OCR en las cargas de archivos .jpg, .png, .gif o .pdf

ocrLanguage

string

Si ocr es verdadero, insinúa el idioma que se debe usar. Los valores válidos son los códigos BCP 47.

pinned

boolean

Si se debe fijar la revisión nueva. Un archivo puede tener un máximo de 200 revisiones fijadas. Ten en cuenta que este campo se ignora si no hay ninguna carga útil en la solicitud.

removeParents

string

Es una lista de IDs de elementos superiores que se deben quitar, separados por comas.

setModifiedDate

boolean

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

supportsAllDrives

boolean

Si la aplicación solicitante admite Mi unidad y unidades compartidas.

supportsTeamDrives
(deprecated)

boolean

Obsoleto: Usa supportsAllDrives en su lugar.

timedTextLanguage

string

Es el idioma del texto sincronizado.

timedTextTrackName

string

Es el nombre de la pista de texto sincronizado.

updateViewedDate

boolean

Indica si se debe actualizar la fecha de vista 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 vista adicionales se incluirán en la respuesta. Solo se admite published.

includeLabels

string

Es una lista separada por comas de los IDs de las etiquetas que se incluyen en la parte labelInfo de la respuesta.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de File.

Cuerpo de la respuesta

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

Alcances de autorización

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