Method: files.insert

Inserta un nuevo archivo.

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.

Las apps que crean accesos directos con files.insert deben especificar el tipo de MIME application/vnd.google-apps.shortcut.

Las apps deben especificar una extensión de archivo en la propiedad title cuando insertan archivos con la API. Por ejemplo, una operación para insertar un archivo JPEG debe especificar algo como "title": "cat.jpg" en los metadatos.

Las solicitudes GET posteriores incluyen la propiedad fileExtension de solo lectura propagada con la extensión especificada originalmente en la propiedad title. Cuando un usuario de Google Drive solicita descargar un archivo o cuando el archivo se descarga mediante el cliente de sincronización, Drive crea un nombre de archivo completo (con extensión) basado en el título. En los casos en que falta la extensión, Drive intenta determinar la extensión en función del tipo de MIME del archivo.

Solicitud HTTP

  • URI de carga para solicitudes de carga de contenido multimedia:
    POST https://www.googleapis.com/upload/drive/v2/files
  • URI de metadatos, para solicitudes solo de metadatos:
    POST https://www.googleapis.com/drive/v2/files

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

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

boolean

Indica si se debe convertir este archivo al formato de editores de Documentos correspondiente.
enforceSingleParent
(deprecated)

boolean

Obsoleto: Ya no se admite la creación de archivos en varias carpetas.
ocr

boolean

Indica si se debe intentar aplicar OCR en cargas de .jpg, .png, .gif o .pdf.
ocrLanguage

string

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

boolean

Establece si se debe fijar la revisión principal del archivo subido. Un archivo puede tener hasta 200 revisiones fijas.
supportsAllDrives

boolean

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

boolean

Obsoleto: usa supportsAllDrives en su lugar.
timedTextLanguage

string

El idioma del texto cronometrado.
timedTextTrackName

string

El nombre de la pista de texto cronometrado.
useContentAsIndexableText

boolean

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

enum (Visibility)

La visibilidad del archivo nuevo. Este parámetro solo es relevante cuando convert=false.
includePermissionsForView

string

Especifica qué permisos de vistas adicionales se deben incluir en la respuesta. Solo se admite published.
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/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

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.