- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Pruébala
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:
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 |
Es el tipo de solicitud de carga para el URI Los valores aceptables son:
|
fileId |
El ID del archivo que se actualizará. |
Parámetros de consulta
Parámetros | |
---|---|
uploadType |
Es el tipo de solicitud de carga para el URI Los valores aceptables son:
|
addParents |
Lista separada por comas de los ID principales que se deben agregar. |
convert |
Obsoleto: este parámetro no tiene función. |
enforceSingleParent |
Obsoleto: ya no se admite la opción de agregar archivos a varias carpetas. Usa |
modifiedDateBehavior |
Determina el comportamiento en el que se actualiza |
newRevision |
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. |
ocr |
Indica si se debe intentar aplicar OCR en cargas de .jpg, .png, .gif o .pdf. |
ocrLanguage |
Si ocr es "true", sugiere el idioma que se usará. Los valores válidos son los códigos BCP 47. |
pinned |
Establece si se debe fijar la nueva revisión. Un archivo puede tener hasta 200 revisiones fijas. |
removeParents |
Lista de los ID principales separados por comas para quitar. |
setModifiedDate |
Indica si se debe establecer la fecha de modificación con el valor proporcionado en el cuerpo de la solicitud. Establecer este campo en |
supportsAllDrives |
Indica si la aplicación solicitante admite Mi unidad y las unidades compartidas. |
supportsTeamDrives |
Obsoleto: usa |
timedTextLanguage |
El idioma del texto cronometrado. |
timedTextTrackName |
El nombre de la pista de texto cronometrado. |
updateViewedDate |
Establece si se debe actualizar la fecha de visualización después de actualizar el archivo correctamente. |
useContentAsIndexableText |
Indica si se debe usar el contenido como texto indexable. |
includePermissionsForView |
Especifica qué permisos de vistas adicionales se deben incluir en la respuesta. Solo se admite |
includeLabels |
Una lista separada por comas de los IDs de las etiquetas que se incluirán en la parte |
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.