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 brinda espacio de almacenamiento personal para almacenar y acceder a carpetas y archivos compartidos colaborativos en la nube.

Antes de comenzar

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

Habilita la API Google Sheets (sheets.googleapis.com).
Habilita la API de Google Drive
Crea un perfil de autenticación. La integración de Apigee 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

En la IU de Apigee, selecciona tu organización de Apigee.
Haz clic en Desarrollar > Integraciones.
Selecciona una integración existente o crea una nueva haciendo clic en Crear integración.
Si creas una integración nueva, haz lo siguiente:
1. Ingresa un nombre y una descripción en el diálogo Crear integración.
2. En la lista de regiones compatibles, selecciona Región para la integración.
3. Haz clic en Crear.
Esto abrirá la integración en la página del diseñador de integración.
En la barra de navegación Diseñador de integración, haz clic en +Agregar una tarea o un activador > Tareas para ver la lista de tareas disponibles.
Haz clic y coloca el elemento Drive - List en el diseñador de integración.
Haz clic en el elemento Drive - List en el diseñador para ver el panel de configuración de la tarea Drive - List.
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.
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 una corpora.
`DriveId`	Cadena	El ID de tu unidad compartida de Google.
`IncludeItemsFromAllDrives`	Booleano	Establece el valor en `true` si deseas incluir tus elementos personales y 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 Comparte archivos, carpetas y unidades.
`OrderBy`	Cadena	El orden en el que se ordenan los archivos. Los valores aceptables son los siguientes: `createdTime` `folder` `modifiedByMeTime` `modifiedTime` `name` `name_natural` `quotaBytesUsed` `recency` `sharedWithMeTime` `starred` `viewedByMeTime`
`PageSize`	Número entero	La cantidad máxima de archivos que se mostrarán por página. Los valores aceptables son `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	Una consulta para filtrar los resultados del archivo. Para obtener más información, consulta Busca archivos.
`Spaces`	Cadena	Una lista de espacios separados por comas para consultar dentro de la empresa. Los valores aceptables son `drive` y `appDataFolder`.
`SupportsAllDrives`	Booleano	Establece el valor en `true` si la aplicación solicitante admite ambas unidades y 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 muestra:

  {
    "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.

¿Qué sigue?

Agrega perímetros y condiciones perimetrales.
Prueba y publica tu integración.
Configura un activador.
Agrega una tarea de asignación de datos.
Consulta todas las tareas para los servicios de Google Cloud.