Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Integración con Airtable
Con el conector de acción Airtable, puede acceder a la plataforma Airtable directamente en Amazon Quick mediante lenguaje natural. Puede crear y actualizar registros, gestionar bases y tablas, filtrar vistas y realizar operaciones de datos relacionales sin salir de Amazon Quick.
Amazon Quick admite varios métodos de autenticación para Airtable. Elija el método que mejor se adapte a los requisitos de seguridad de su organización.
+ Aplicación **OAuth predeterminada: utiliza una aplicación** OAuth AWS gestionada. No se necesitan credenciales adicionales. Los usuarios se autentican directamente con su cuenta de Airtable.
+ Aplicación **OAuth personalizada: utiliza una aplicación OAuth** gestionada por el cliente y registrada en Airtable. Esta opción le da a tu organización un control total sobre la configuración de OAuth.
+ **Clave de API**: utiliza un token de acceso personal de Airtable para la autenticación. Apto para uso individual o pruebas.
Para obtener más información sobre los métodos de autenticación que admite Amazon Quick, consulte[Métodos de autenticación](quick-action-auth.md).
## Antes de empezar
Asegúrese de disponer de lo siguiente antes de configurar la integración.
+ Una cuenta Airtable activa con acceso a las bases y los datos que quieras usar.
+ Para una **aplicación OAuth personalizada**: accede al [Airtable Builder Hub en el sitio web de Airtable](https://airtable.com/create/oauth) para registrar una integración de OAuth.
+ Para la **clave de API**: un token de acceso personal del Airtable Builder Hub del sitio web de [Airtable.](https://airtable.com/create/tokens)
+ Para conocer los requisitos de suscripción a Amazon Quick, consulte[Configurar integraciones en la consola](integration-console-setup-process.md).
## Configuración de Airtable
Si utiliza la autenticación de la **aplicación OAuth predeterminada**, omita esta sección y continúe con. [Configuración del conector en Amazon Quick](#airtable-quicksuite-setup)
Para autenticar una aplicación OAuth personalizada o una clave de API, complete los pasos correspondientes en Airtable antes de configurar Amazon Quick.
### Registre una integración de OAuth (aplicación OAuth personalizada)
Cree una integración de OAuth en Airtable Builder Hub para obtener las credenciales de cliente que necesita para Amazon Quick.
1. **Inicie sesión en el [Airtable Builder Hub en el sitio web de Airtable](https://airtable.com/create/oauth) y elija las integraciones de OAuth.**
1. **Selecciona Registrar una nueva integración de OAuth.**
1. Introduce un **nombre** para la integración.
1. Para las URL de **redireccionamiento de OAuth, introduce la URL** de redireccionamiento de Amazon Quick: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. **Selecciona Registrar integración.**
1. Tras el registro, genere un secreto de cliente seleccionando **Regenerar el secreto de cliente**.
1. Registre los siguientes valores. Los necesitas cuando configuras Amazon Quick.
+ **ID de cliente**
+ **Secreto del cliente**
1. En **Ámbitos**, selecciona los permisos que requiere tu integración. Para ver la lista completa de los ámbitos recomendados, consulte. [Alcances recomendados](#airtable-oauth-scopes)
### Cree un token de acceso personal (clave de API)
Cree un token de acceso personal en Airtable Builder Hub para la autenticación con la clave de API.
1. Inicia sesión en el [Airtable Builder Hub](https://airtable.com/create/tokens) en el sitio web de Airtable y elige los tokens de acceso **personal**.
1. Seleccione **Crear token**.
1. Configure el nombre del token, los ámbitos y el acceso base según sea necesario para su caso de uso.
1. Copie y almacene de forma segura el token generado. Lo necesitas cuando configuras Amazon Quick.
### Alcances recomendados
Cuando registres una integración de OAuth o crees un token de acceso personal, configura los siguientes ámbitos en función de las acciones que quieras usar.
**Ámbitos recomendados por Airtable**
| Alcance | Description (Descripción) |
| --- | --- |
| data.records:read | Lea los datos de los registros. |
| data.records:write | Cree, edite y elimine registros. |
| data.recordComments:read | Lea los comentarios de los registros. |
| data.recordComments:write | Cree, edite y elimine los comentarios de los registros. |
| schema.bases:read | Lea la estructura de las bases, incluidos los nombres de las tablas y los tipos de campos. |
| schema.bases:write | Edite la estructura de las bases, incluidos los nombres de las tablas y los tipos de campos. |
| user.email:read | Lea la dirección de correo electrónico del usuario autenticado. |
## Configuración del conector en Amazon Quick
### Conectarse desde la pestaña Disponible
Si quieres usar la autenticación de la aplicación OAuth predeterminada, puedes conectarte directamente desde la pestaña **Disponible** sin necesidad de realizar ninguna configuración adicional.
1. En la consola Amazon Quick, selecciona **Connectors**.
1. En la pestaña **Disponible**, busca **Airtable** y selecciona **Connect**.
1. Complete el flujo de inicio de sesión de Airtable y otorgue los permisos solicitados.
Para configurar un conector con una aplicación OAuth personalizada o una clave de API, usa la pestaña **Crear para tu equipo**, tal y como se describe a continuación.
### Crea desde la pestaña Crear para tu equipo
Tras completar cualquier configuración de Airtable requerida, crea el conector en Amazon Quick.
1. En la consola Amazon Quick, selecciona **Connectors**.
1. Selecciona la pestaña **Crear para tu equipo**.
1. Busca y elige **Airtable.**
**nota**
Si ya existe un conector Airtable, aparecerá un cuadro de diálogo con los conectores existentes. Para usar un conector existente, elíjalo. Para crear uno nuevo, elija **No, crear nuevo**.
1. Introduzca un **nombre** para el conector. Si lo desea, elija **\+ Añadir descripción** para añadir una descripción.
1. En **Tipo de conexión**, elija **Red pública**.
1. Para **la configuración de OAuth**, elija uno de los siguientes métodos de autenticación y configure los campos obligatorios.
1. Para la aplicación **OAuth predeterminada**:
No se necesitan credenciales adicionales. Elija **Siguiente** para continuar.
1. Para la **aplicación OAuth personalizada**, configura los siguientes campos:
+ **URL base** (opcional): la URL base de la API de Airtable. Ejemplo: `https://api.airtable.com`
+ **ID de cliente**: el ID de cliente de tu integración con Airtable OAuth.
+ Secreto de **cliente: el secreto** de cliente de tu integración con Airtable OAuth.
+ **URL del token: el punto** final del token. Ejemplo: `https://airtable.com/oauth2/v1/token`
+ **URL de autorización**: el punto final de autorización. Ejemplo: `https://airtable.com/oauth2/v1/authorize`
+ **URL de redireccionamiento**: Pre-filled con la URL de devolución de llamada rápida de Amazon.
1. Para la **clave de API**, configure los siguientes campos:
+ **URL base** (opcional): la URL base de la API de Airtable. Ejemplo: `https://api.airtable.com`
+ **Clave de API**: tu token de acceso personal de Airtable.
+ **Correo electrónico** (opcional): la dirección de correo electrónico asociada a tu cuenta de Airtable.
1. Elija **Siguiente**.
1. Si seleccionaste la aplicación **OAuth predeterminada o la aplicación OAuth** **personalizada, se abrirá una ventana de autorización** de Airtable. **Revisa los permisos solicitados, elige las bases y los espacios de trabajo a los que deseas conceder el acceso y selecciona Conceder acceso.**
1. En la página de **revisión**, revise las acciones disponibles para el conector. Elija **Siguiente**.
1. En la página de **publicación**, elija quién puede acceder al conector. Puedes habilitar el acceso para todos los miembros de tu organización o buscar equipos o grupos específicos.
1. Elija **Publicar**.
## Acciones disponibles
Tras configurar el conector, estarán disponibles las siguientes acciones.
**Acciones disponibles en Airtable**
| Categoría | Action | Description (Descripción) |
| --- | --- | --- |
| Registros | Listar registros | Muestra los registros de una tabla con filtrado y clasificación opcionales. |
| Registros | Obtenga un registro | Recupera un registro específico por ID. |
| Registros | Registro de creación por lotes | Crea uno o más registros nuevos en una tabla. |
| Registros | Actualizar registro | Actualiza los campos de un registro existente. |
| Registros | Registro de actualización por lotes | Actualiza varios registros en una sola operación mediante PATCH. |
| Registros | Registro de venta por lotes | Cambia varios registros en una sola operación mediante PUT. |
| Comentarios | Lista de comentarios | Muestra los comentarios de un registro. |
| Comentarios | Crear comentario | Añade un comentario a un registro. |
| Comentarios | Actualizar comentario | Edita un comentario existente en un registro. |
| Esquema | Bases de listas | Enumera todas las bases accesibles para el usuario autenticado. |
| Esquema | Obtenga el esquema base | Recupera el esquema de una base, incluidas las tablas y las definiciones de campos. |
| Esquema | Crear tabla | Crea una tabla nueva en una base. |
| Esquema | Actualizar tabla | Actualiza las propiedades de la tabla, como el nombre o la descripción. |
| Esquema | Crear campo | Añade un campo nuevo a una tabla. |
| Esquema | Actualizar campo | Actualiza las propiedades del campo, como el nombre o el tipo. |
| Archivos adjuntos | Crear adjunto | Carga un archivo adjunto a un registro. |
| Users | Obtenga información de usuario | Recupera información sobre el usuario autenticado. |
**nota**
Las acciones que puede utilizar dependen de las bases y los espacios de trabajo accesibles para el usuario autenticado.
## Gestión y solución de problemas
Para editar, compartir o eliminar el conector, consulte[Administrar las integraciones existentes](integration-workflows.md#managing-existing-integrations).
### Problemas de autenticación
+ **Sign-in falla (aplicación OAuth predeterminada o aplicación OAuth personalizada)**: comprueba que tu cuenta de Airtable esté activa y que puedas iniciar sesión directamente en [airtable.com desde el sitio web de Airtable](https://airtable.com). En el caso de la aplicación OAuth personalizada, confirma que la URL de redireccionamiento de tu integración con Airtable OAuth coincide con la URL de devolución de llamada rápida de Amazon.
+ **Credenciales de cliente no válidas (aplicación OAuth personalizada)**: comprueba que el ID de cliente y el secreto del cliente coincidan con los valores de tu integración de OAuth con Airtable. Si has regenerado el secreto de cliente, actualiza el valor en Amazon Quick.
+ **Clave de API rechazada**: compruebe que su token de acceso personal esté activo y tenga los alcances requeridos. Los tokens se pueden revocar o caducar en Airtable Builder Hub.
+ **Permisos insuficientes**: compruebe que los ámbitos configurados para su método de autenticación incluyen los permisos necesarios para las acciones que desee utilizar. Consulte [Alcances recomendados](#airtable-oauth-scopes).