Method: files.create

Crea un archivo. Para obtener más información, consulta Crea y administra archivos.

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.

Las apps que crean accesos directos con el método 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 inserten 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 de GET posteriores incluyen la propiedad de solo lectura fileExtension completada con la extensión especificada originalmente en la propiedad name. 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 crea un nombre de archivo completo (con extensión) basado en el nombre. En los casos en que falta la extensión, Drive intenta determinarla según el tipo de MIME del archivo.

Solicitud HTTP

  • URI de carga para las solicitudes de carga de medios:
    POST https://www.googleapis.com/upload/drive/v3/files
  • URI de metadatos para las solicitudes de metadatos únicamente:
    POST https://www.googleapis.com/drive/v3/files

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

Parámetros de consulta

Parámetros
enforceSingleParent
(deprecated)

boolean

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

boolean

Indica si se deben ignorar los parámetros de configuración de visibilidad predeterminados 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 anula ese comportamiento para la solicitud. Los permisos se siguen heredando de las carpetas superiores.
keepRevisionForever

boolean

Indica si se debe establecer el campo keepForever en la nueva revisión principal. Esto solo se aplica a los archivos con contenido binario en Google Drive. Solo se pueden conservar 200 revisiones del archivo de forma permanente. Si se alcanza el límite, intenta borrar las revisiones fijadas.
ocrLanguage

string

Es una sugerencia de idioma para el procesamiento de OCR durante la importación de imágenes (código ISO 639-1).
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.
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 subido como texto indexable.
includePermissionsForView

string

Especifica qué permisos de vista adicionales se incluirán 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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

Algunos alcances 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.