Consulta los conectores compatibles con Application Integration.

Tarea Drive - List

La tarea Drive - List te permite buscar y recuperar archivos y carpetas que se almacenan en una cuenta de Google Drive.

Google Drive es un servicio de almacenamiento de archivos en la nube que te proporciona espacio de almacenamiento personal para guardar archivos y carpetas compartidos de forma colaborativa en la nube, y acceder a ellos.

Antes de comenzar

Asegúrate de realizar las siguientes tareas en tu proyecto de Google Cloud antes de configurar la tarea Drive - List:

  1. Habilita la API de Google Drive (drive.googleapis.com).

    Habilita la API de Google Drive

  2. Crea un perfil de autenticación. Application Integration usa un perfil de autenticación para conectarse a un extremo de autenticación de la tarea Drive - List.

    Para obtener información sobre cómo otorgar roles o permisos adicionales a una cuenta de servicio, consulta Cómo otorgar, cambiar y revocar el acceso a los recursos.

Configura la tarea Drive - List

  1. En la consola de Google Cloud , ve a la página Application Integration.

    Ir a Application Integration

  2. En el menú de navegación, haz clic en Integraciones.

    Aparecerá la página Integraciones con todas las integraciones disponibles en el proyecto de Google Cloud.

  3. Selecciona una integración existente o haz clic en Crear integración para crear una nueva.

    Si creas una integración nueva, haz lo siguiente:

    1. Ingresa un nombre y una descripción en el panel Crear integración.
    2. Selecciona una región para la integración.
    3. Selecciona una cuenta de servicio para la integración. Puedes cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración en la barra de herramientas de integración.
    4. Haz clic en Crear. La integración recién creada se abre en el editor de integración.

  4. En la barra de navegación del editor de integración, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
  5. Haz clic y coloca el elemento Drive - List en el editor de integración.
  6. Haz clic en el elemento Drive - List en el diseñador para ver el panel de configuración de la tarea Drive - List.
  7. Ve a Autenticación y selecciona un perfil de autenticación existente que desees usar.

    Opcional. Si no creaste un perfil de autenticación antes de configurar la tarea, haz clic en + Nuevo perfil de autenticación y sigue los pasos que se mencionan en Crea un perfil de autenticación nuevo.

  8. Ve a Entrada de tarea y configura los campos de entrada deseados que se muestran con la siguiente tabla de parámetros de entrada de la tarea.

    Los cambios en los campos de entrada se guardan de forma automática.

Parámetros de entrada de la tarea

En la siguiente tabla, se describen los parámetros de entrada de la tarea Drive - List:

Propiedad Tipo de datos Descripción
Corpora Cadena Parámetro opcional para buscar archivos dentro de un corpus.
DriveId Cadena Es el ID de tu unidad compartida de Google.
IncludeItemsFromAllDrives Booleano Establece el valor en true si deseas incluir tanto los elementos de tu unidad personal como los de la unidad compartida en los resultados de la búsqueda.

Valor predeterminado: false.
IncludeLabels Cadena Una lista separada por comas de los IDs de etiqueta que se incluyen en la parte labelInfo de la respuesta. Para obtener más información sobre los IDs de etiquetas, consulta Descripción general de las etiquetas.
IncludePermissionsForView Cadena Especifica published. Para obtener más información, consulta Cómo compartir archivos, carpetas y unidades.
OrderBy Cadena Es el orden en que se clasifican los archivos. Cada clave se ordena de forma ascendente de forma predeterminada. Para obtener más información, consulta el método files.list.

Los siguientes son los valores de salid:

  • createdTime
  • folder
  • modifiedByMeTime
  • modifiedTime
  • name
  • name_natural
  • quotaBytesUsed
  • recency
  • sharedWithMeTime
  • starred
  • viewedByMeTime
PageSize Número entero Es la cantidad máxima de archivos que se devolverán por página.

Los valores aceptables son de 1 a 1000.

Valor predeterminado: 100.
PageToken Cadena El token para continuar con una tarea anterior de Drive - List. Establece este valor en el valor de nextPageToken de la respuesta anterior.
Q Cadena Es una consulta para filtrar los resultados de los archivos. Para obtener más información, consulta Cómo buscar archivos.
Spaces Cadena Es una lista separada por comas de los espacios para consultar dentro de los corpus.

Los valores aceptables son drive y appDataFolder.
SupportsAllDrives Booleano Establece el valor en true si la aplicación solicitante admite tanto Mi unidad como las unidades compartidas.

Valor predeterminado: false.

Resultado de la tarea

La tarea Drive - List muestra el resultado de la respuesta que contiene la lista de archivos. A continuación, se muestra un resultado de ejemplo:

  {
    "nextPageToken": string,
    "kind": string,
    "incompleteSearch": boolean,
    "files": [
      {
        object (File)
      }
    ]
  }

Estrategia de manejo de errores

Una estrategia de manejo de errores de una tarea específica la acción que se debe realizar si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de manejo de errores y conocer los diferentes tipos de estrategias de manejo de errores, consulta Estrategias de manejo de errores.

Cuotas y límites

Para obtener información sobre las cuotas y los límites, consulta Cuotas y límites.

¿Qué sigue?