Method: files.update

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, es posible que algunos cambien automáticamente, como modifiedDate. Este método es compatible con la semántica de parches.

Este método admite un URI /upload y acepta los archivos multimedia subidos 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 */*. 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:
    PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
  • URI de metadatos, para solicitudes solo de metadatos:
    PATCH https://www.googleapis.com/drive/v3/files/{fileId}

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

Parámetros de ruta de acceso

Parámetros
uploadType

string

Es el tipo de solicitud de carga para el URI /upload. Si subes datos con un URI /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 el widget no admite cargas de datos.

Los valores aceptables son:

  • media: Carga simple. Sube solo el contenido multimedia, sin metadatos.
  • multipart: Carga multiparte. Sube los medios 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 incluya los metadatos.
fileId

string

El ID del archivo.

Parámetros de consulta

Parámetros
uploadType

string

Es el tipo de solicitud de carga para el URI /upload. Si subes datos con un URI /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 el widget no admite cargas de datos.

Los valores aceptables son:

  • media: Carga simple. Sube solo el contenido multimedia, sin metadatos.
  • multipart: Carga multiparte. Sube los medios 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 incluya los metadatos.
addParents

string

Una lista separada por comas de los ID principales que se agregarán.

enforceSingleParent
(deprecated)

boolean

Obsoleto: ya no se admite la opción de agregar archivos a varias carpetas. En su lugar, usa combinaciones de teclas.

keepRevisionForever

boolean

Establece si se debe establecer el campo “keepForever” en la nueva revisión de encabezado. Esto solo se aplica a archivos con contenido binario en Google Drive. Solo se pueden conservar 200 revisiones de un archivo para siempre. Si se alcanza el límite, intenta borrar las revisiones fijadas.

ocrLanguage

string

Una sugerencia de idioma para el procesamiento de OCR durante la importación de imágenes (código ISO 639-1).

removeParents

string

Lista separada por comas de los ID principales que se van a quitar.

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

Obsoleto: usa supportsAllDrives en su lugar.

useContentAsIndexableText

boolean

Indica si se debe usar el contenido subido como texto indexable.

includePermissionsForView

string

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

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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • 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.