Airtable peut être utilisé comme collection pour générer des pages dynamiques. Pour plus d'informations sur les collections, consultez « Définir une collection pour les pages dynamiques ».
Important :
À compter du 1er février 2024, les clés API seront progressivement supprimées. À ce moment-là, les collections dont la clé API n'a pas été remplacée par un jeton d'accès personnel pourraient subir des perturbations.
Limitations et spécifications par type de collection
Les collections Airtable présentent les limitations suivantes :
|
Table Airtable |
Nombre de collections par site |
100 |
Champs (colonnes) |
100 |
Limite de caractères du nom de la collection |
50 |
Limite de caractères du nom de champ |
50 |
URL de l'élément de page |
350 caractères |
Mise à jour des données |
Automatiquement toutes les heures |
Pour créer une collection Airtable :
- Dans le panneau de gauche, cliquez sur Contenu, sur Collections, puis sur + Ajouter une collection.
- Cliquez Table Airtable.
- Entrez votre jeton Airtable.
- Saisissez vos informations d'authentification API Airtable.
- Clé API
- Cliquez Page de compte Airtable (situé à l'étape 1 de Comment se connecter à Airtable).
- Un nouvel onglet s'ouvrira sur la page de votre compte Airtable (vous devrez peut-être vous connecter).
- Une fois connecté, visitez airtable.com/create/tokens (si vous n'êtes pas connecté à Airtable, vous recevrez leur page 404).
Une fois sur la page des jetons d'accès personnels, cliquez sur Créer un jeton.
Entrez un nom pour le jeton.
Dans la section Étendues, cliquez sur + Ajouter une étendue et sélectionnez data.records:read (Voir les données dans les enregistrements).
- Dans la section Accès, cliquez sur + Ajouter une base et sélectionnez l’option Toutes les bases actuelles et futures dans tous les espaces de travail actuels et futurs située sous Tous les espaces de travail.
Sélectionnez l'option données.enregistrements : lecture (Voir les données dans les enregistrements) .
Dans la section Accès, cliquez sur Ajouter une base.
Sélectionnez l' option Toutes les bases actuelles et futures dans tous les espaces de travail actuels et futurs située sous Tous les espaces de travail.
Cliquez Créer un jeton.
Cliquez sur le bouton Copier situé à côté du jeton.
Retournez à Site Web Guesty et collez le jeton dans le champ Jeton d'accès.
- Exemple d'URL
- Cliquez Page API Airtable (situé à l'étape 2 de Comment se connecter à Airtable).
- Un nouvel onglet s'ouvrira dans Airtable (vous devrez peut-être vous connecter).
- Une fois sur la page de référence de l'API, faites défiler vers le bas et sélectionnez la table souhaitée.
- Dans le panneau latéral, cliquez sur Authentification.
- Dans l'onglet curl, copiez le lien sous EXEMPLE.
- Copiez le lien sous EXEMPLE (situé dans l'onglet Boucle).
- Retournez à Site Web Guesty et collez-le dans le champ Exemple d'URL.
- Cliquez Champs d'importation.
- Définissez le type de données correct pour chaque champ.
- Cliquez Continuer.
Mettre à jour la clé API d'une collection existante avec un jeton d'accès personnel
Pour mettre à jour l'API d'une collection existante avec un jeton d'accès personnel :
Dans le panneau de gauche, cliquez sur Contenu, cliquez sur Collections, puis sur la collection Airtable souhaitée.
Cliquez sur Paramètres de la collection situé vers le bas.
-
Dans le champ Jeton d’accès, remplacez la clé API par un jeton d’accès personnel.
Cliquez Rafraîchir les données.
Cliquez Fait.
Champs pris en charge
Note :
Airtable a apporté des modifications à leurs pièces jointes URL (telles que des liens et des images) les faisant expirer après deux heures. Sites Internet Guesty n'est pas affecté par ce changement car il extrait les données d'Airtable toutes les heures.
Le tableau suivant décrit les champs Airtable pris en charge, les champs de Sites Internet Guesty correspondants et des exemples.
| Domaine des Sites Internet Guesty |
Champ de table Airtable |
Exemple |
Texte |
Texte enrichi |
Bienvenue dans mon cabinet dentaire.
Note :
L'utilisation du champ de texte enrichi intégré à Airtable n'est pas prise en charge. Par exemple, pour ajouter un lien, utilisez le code HTML : <a> </a> tag.
|
Texte |
Texte long |
Note :
Ce champ prend en charge le HTML et les sauts de ligne.
|
Texte |
Texte brut |
bienvenue dans mon bureau |
Numérique |
Nombre |
10 000
Note :
Doit contenir uniquement des chiffres et des points (pour les décimales).
|
Booléen |
Case à cocher |
Note :
Uniquement pour les widgets personnalisés.
|
Image |
Pièce jointe avec une image |
Image ajoutée via Airtable. |
Lien |
URL |
https://goo.gl/maps/F81HPm4CBTQSTsJ5A |
Vidéo |
URL ou texte |
https://www.youtube.com/watch?v=8EsYwAKxAFU |
Téléphone |
Numéro de téléphone ou texte |
123456789 |
e-mail |
e-mail ou SMS |
e-mail@email.com |
Emplacement |
Texte |
adresse, code postal, région, ville, pays
846 Kerry Way, 90017, CA, Los Angeles, États-Unis
|
Heures d'ouverture |
Texte |
SAMEDI, DIM : 08h00-20h00 ; JEU, VEN : 08h00-12h00 ; |
Collection interne contenant un champ d'image |
Pièce jointe avec plusieurs images |
Images ajoutées via Airtable. |
Texte |
Nombre |
|
Texte |
Devise |
Note :
Affiche uniquement le nombre, sans le signe $.
|
Texte |
Pourcentage |
Note :
Affiche avec décimal et sans signe %.
|
Texte |
Note |
Note :
Affiche le nombre.
|
Texte |
Formule |
Note :
Le résultat de la formule peut être une chaîne.
|
Texte |
Numérotation automatique |
|
Compte social |
Valeur |
Doit être formaté comme nom : valeur ; nom : valeur ;
e-mail : my@gmail.com ; whatsapp : 123456 ; facebook : Guesty Sites Internet ;
Note :
Réseaux sociaux pris en charge : e-mail, whatsapp, facebook, twitter, instagram, youtube, linkedin, yelp, pinterest, google_my_business, waze, vimeo, snapchat, reddit, tripadvisor, foursquare, rss.
|
Date et heure |
Texte |
La structure par défaut est AAAA-MM-JJ HH:mm:SS, qui s'affiche sous la forme 2021-10-06 16:12:00. Pour une liste complète des formats de date et d'heure et leur mode d'affichage, consultez la classe DateTimeFormatter.
Note :
Le site s'affichera toujours dans le fuseau horaire UTC, quel que soit ce qui est défini dans Airtable, même si l'option Utiliser le même fuseau horaire pour tous les collaborateurs est activée (dans Airtable).
Pour éviter toute confusion de fuseau horaire entre le site et Airtable, il est recommandé d'activer l'option Utiliser le même fuseau horaire pour tous les collaborateurs (située dans Airtable) et de sélectionner le fuseau horaire GMT/UTC.
Ce champ peut être utilisé pour le tri lors de l'utilisation des filtres ou de la fonctionnalité de tri dans la fenêtre contextuelle Données connectées.
|
Sélection multiple |
Sélection multiple |
Après avoir défini le champ comme Sélection multiple, cliquez sur Options pour ajouter des options. Chaque ligne de la collection peut être attribuée à une ou plusieurs des options que vous avez créées.
Note :
Ce champ peut être utilisé pour filtrer la collection affichée dans les widgets, tels que la galerie de photos, la liste, l'accordéon et les widgets personnalisés qui se connectent aux collections.
|
Note :
En raison des limitations de l'API, les Sites Internet Guesty n'importeront pas les champs qui n'ont pas de contenu dans les 10 premières lignes.
Ordre des lignes
Lors de l'utilisation des collections Airtable, l'ordre des lignes est aléatoire en raison d'une limitation de l'API sur le site Airtable. Nous ignorons les filtres et le tri dans Airtable.
Pour conserver l'ordre des lignes dans Airtable, y compris les filtres et le tri, ajoutez le nom de la vue Airtable à l'URL d'exemple que vous utilisez pour importer la collection. Pour plus d'informations, consultez l'assistance Airtable.
Pour ajouter la vue, après avoir ajouté l'URL d'exemple, ajoutez '?view=View Name' . Le nom de la vue est sensible à la casse et doit être saisi exactement comme il est écrit dans Airtable.
Important :
La suppression ou la modification du nom de la vue après l'importation de la collection rompra la connexion.
Voici un exemple d’URL avant l’ajout du nom de la vue :
https://api.airtable.com/v0/appbiL1pCyvFcW8WG/Feedback%20Session?view=Main%20View
Voici un exemple d’URL après l’ajout du nom de la vue :
https://api.airtable.com/v0/appbiL1pCyvFcW8WG/Feedback%20Session?view=Main View
Pour plus d'informations sur l'ajout du nom de la vue à l'URL, consultez cette vidéo .
L'étape suivante consiste à créer ou à convertir une page dynamique afin de la connecter à votre nouvelle collection. Vous pouvez également connecter les lignes de la collection à des pages standard. Pour savoir comment procéder, consultez la section « Connecter des lignes de collection à des pages standard ».