Method: files.update

Actualiza los metadatos, el contenido o ambos de un archivo.

Cuando llames a este método, solo propaga los campos de la solicitud que quieras modificar. Cuando actualices campos, es posible que algunos se 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 contenido multimedia subido con las siguientes características:

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

    (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, consulta Tipos de MIME compatibles con Google Workspace y Google Drive.

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

Solicitud HTTP

  • URI de carga para las solicitudes de carga de medios:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • URI de metadatos para las solicitudes de metadatos únicamente:
    PUT https://www.googleapis.com/drive/v2/files/{fileId}

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

Parámetros de ruta

Parámetros
fileId

string

ID del archivo que se actualizará.

Parámetros de consulta

Parámetros
addParents

string

Lista de IDs principales separados por comas que se agregarán.
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 con el que se actualiza modifiedDate. Esta acción anula setModifiedDate.
newRevision

boolean

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

boolean

Indica si se intentará realizar el OCR en las cargas de archivos .jpg, .png, .gif o .pdf.
ocrLanguage

string

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

boolean

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

string

Lista de IDs principales separados por comas que se quitarán.
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 como true equivale a modifiedDateBehavior=fromBodyOrNow, y false equivale a modifiedDateBehavior=now. Evita que se realicen cambios en la fecha de modificación establecida modifiedDateBehavior=noChange.
supportsAllDrives

boolean

Indica si la aplicación solicitante admite tanto Mi unidad como las unidades compartidas.
supportsTeamDrives
(deprecated)

boolean

Obsoleto: Usa supportsAllDrives en su lugar.
timedTextLanguage

string

Es el idioma del texto cronometrado.
timedTextTrackName

string

Es el nombre de la pista de texto cronometrado.
updateViewedDate

boolean

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

string

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

Los valores aceptables son:

  • media: Carga simple. Carga 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 forma reanudable con una serie de al menos dos solicitudes en las que la primera incluya los metadatos.
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

Es 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 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.