Method: files.update

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

Este método admite un URI /upload y acepta contenido multimedia subido con las siguientes características:

  • Tamaño máximo del archivo: 5,120 GB
  • Tipos de MIME multimedia aceptados:*/*

Nota: Especifica un tipo de MIME válido en lugar del valor literal de */*. El literal */* solo se usa para indicar que se puede subir cualquier tipo de MIME válido.

Para obtener más información sobre cómo subir archivos, consulta Cómo subir datos de archivos.

Solicitud HTTP

  • URI de carga, para solicitudes de carga de contenido multimedia:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • URI de metadatos, para solicitudes solo de metadatos:
    PUT 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
uploadType

string

El tipo de solicitud de carga al URI /upload. Si subes datos con un URI de /upload, este campo es obligatorio. Si creas un archivo de solo metadatos, este campo no es obligatorio. Además, este campo no se muestra en el widget "Probar este método" porque no admite cargas de datos.

Los valores aceptables son:

  • media: Carga simple. Sube solo el contenido multimedia, sin metadatos.
  • multipart: Carga multiparte. Sube el contenido multimedia y sus metadatos en una sola solicitud.
  • resumable: Carga reanudable. Sube el archivo de manera reanudable mediante una serie de al menos dos solicitudes en las que la primera solicitud incluya los metadatos.
fileId

string

El ID del archivo que se actualizará.

Parámetros de consulta

Parámetros
uploadType

string

El tipo de solicitud de carga al URI /upload. Si subes datos con un URI de /upload, este campo es obligatorio. Si creas un archivo de solo metadatos, este campo no es obligatorio. Además, este campo no se muestra en el widget "Probar este método" porque no admite cargas de datos.

Los valores aceptables son:

  • media: Carga simple. Sube solo el contenido multimedia, sin metadatos.
  • multipart: Carga multiparte. Sube el contenido multimedia y sus metadatos en una sola solicitud.
  • resumable: Carga reanudable. Sube el archivo de manera reanudable mediante una serie de al menos dos solicitudes en las que la primera solicitud incluya los metadatos.
addParents

string

Lista de los ID principales 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

Si una carga de BLOB debe crear una revisión nueva. Si es falso, se reemplazan los datos del BLOB en la revisión del encabezado actual. Si la política se establece como verdadera o no se establece, se crea un nuevo BLOB como revisión principal y se conservan las revisiones anteriores sin fijar por un período breve. Las revisiones fijadas se almacenan de forma indefinida y usan una cuota de almacenamiento adicional de hasta 200 revisiones. Para obtener detalles sobre cómo se retienen las revisiones, consulte el Centro de ayuda de Drive.

ocr

boolean

Si se debe intentar cargar con OCR en archivos .jpg, .png, .gif o .pdf.

ocrLanguage

string

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

pinned

boolean

Indica si se debe fijar la revisión nueva. Un archivo puede tener un máximo de 200 revisiones fijas.

removeParents

string

Lista de ID superiores separados por comas para quitar.

setModifiedDate

boolean

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

supportsAllDrives

boolean

Si la aplicación que realiza la solicitud admite tanto mis unidades como unidades compartidas.

supportsTeamDrives
(deprecated)

boolean

Obsoleto: Usa supportsAllDrives en su lugar.

timedTextLanguage

string

El idioma del texto temporizado.

timedTextTrackName

string

El nombre de la pista de texto con marca de tiempo.

updateViewedDate

boolean

Indica si se debe actualizar la fecha de vista después de actualizar correctamente el archivo.

useContentAsIndexableText

boolean

Indica si se debe usar el contenido como texto indexable.

includePermissionsForView

string

Especifica qué permisos adicionales de la vista debe incluir en la respuesta. Solo se admite published.

includeLabels

string

Una lista separada por comas de los ID de las etiquetas que se deben incluir 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.