- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Pruébala
Crea un archivo nuevo.
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.
Las apps que crean accesos directos con files.create
deben especificar el tipo de MIME application/vnd.google-apps.shortcut
.
Las apps deben especificar una extensión de archivo en la propiedad name
cuando se insertan archivos con la API. Por ejemplo, una operación para insertar un archivo JPEG debe especificar algo como "name": "cat.jpg"
en los metadatos.
Las solicitudes GET
posteriores incluyen la propiedad fileExtension
de solo lectura propagada con la extensión que se especificó originalmente en la propiedad title
. Cuando un usuario de Google Drive solicita descargar un archivo o cuando el archivo se descarga a través del cliente de sincronización, Drive compila un nombre de archivo completo (con extensión) en función del título. En los casos en que la extensión no esté presente, Drive intentará determinar la extensión según el tipo de MIME del archivo.
Solicitud HTTP
- URI de carga, para solicitudes de carga de contenido multimedia:
POST https://www.googleapis.com/upload/drive/v3/files
- URI de metadatos, para solicitudes solo de metadatos:
POST https://www.googleapis.com/drive/v3/files
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
Parámetros | |
---|---|
uploadType |
El tipo de solicitud de carga al URI Los valores aceptables son:
|
enforceSingleParent |
Ya no está disponible. Ya no se admite la creación de archivos en varias carpetas. |
ignoreDefaultVisibility |
Ignorar la configuración de visibilidad predeterminada del dominio para el archivo creado Los administradores del dominio pueden elegir que todos los archivos subidos sean visibles para el dominio de forma predeterminada. Este parámetro omite ese comportamiento para la solicitud. Los permisos aún se heredan de las carpetas superiores. |
keepRevisionForever |
Establece si se debe configurar el campo "keepForever" en la revisión del nuevo encabezado. Esto solo se aplica a los archivos con contenido binario en Google Drive. Solo se pueden conservar 200 revisiones del archivo para siempre. Si se alcanza el límite, intenta borrar las revisiones fijadas. |
ocrLanguage |
Sugerencia de idioma para el procesamiento de OCR durante la importación de imágenes (código ISO 639-1). |
supportsAllDrives |
Si la aplicación que realiza la solicitud admite tanto mis unidades como unidades compartidas. |
supportsTeamDrives |
Obsoleto: Usa |
useContentAsIndexableText |
Indica si se debe usar el contenido subido como texto indexable. |
includePermissionsForView |
Especifica qué permisos adicionales de la vista debe incluir en la respuesta. Solo se admite el estado "publicada". |
includeLabels |
Una lista separada por comas de los ID de las etiquetas que se deben incluir 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/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
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.