L'API Actions de Looker permet aux développeurs de définir des actions ou des destinations personnalisées vers lesquelles Looker peut envoyer des résultats de requêtes, des résultats de tableaux de bord ou des interactions utilisateur.
Une fois une action développée, déployée en tant que service Web, puis ajoutée à une instance Looker, les utilisateurs Looker pourront envoyer des données à l'aide de cette action depuis Looker.
Utilisation d'actions
L'API Actions est compatible avec plusieurs variantes de cas d'utilisation :
- Les actions sont compatibles avec différents niveaux d'interactivité des utilisateurs. Elles peuvent être conçues pour des interactions utilisateur ponctuelles lorsqu'un utilisateur consulte un tableau de bord, ou elles peuvent être destinées à fonctionner avec des plannings récurrents ou déclenchés.
- Les actions peuvent demander à Looker de collecter des données de formulaire auprès des utilisateurs afin de paramétrer le traitement des données.
- Les actions peuvent même demander l'authentification de l'utilisateur auprès d'un service tiers à l'aide d'OAuth, par exemple pour fournir implicitement des données à des destinations spécifiques à l'utilisateur.
- Les actions peuvent également recevoir les résultats de requête dans différents formats, qu'il s'agisse de formats axés sur les données comme CSV et Excel, de différents formats JSON pour les cas d'utilisation programmatiques ou de formats axés sur la visualisation comme PNG ou PDF.
Bien que ces cas d'utilisation soient variés, le point commun entre eux est que les utilisateurs de Looker peuvent demander à Looker de contacter une action et de lui envoyer des données.
Par conséquent, l'implémentation d'une action implique le déploiement d'un service Web pour écouter ces requêtes.
Pour ce faire, vous pouvez ajouter quelques points de terminaison à un serveur d'application existant, déployer un serveur Web exclusivement à cet effet ou même utiliser un environnement sans serveur tel que les fonctions Google Cloud Run. L'API Actions ne nécessite pas que le service conserve un état entre les requêtes. Les serveurs d'actions peuvent donc bénéficier de configurations de déploiement sans état évolutives et flexibles.
Enfin, comme l'API Actions se compose de requêtes HTTP POST au format JSON, n'importe quel langage côté serveur peut être facilement utilisé pour implémenter une action. Looker fournit plusieurs exemples en TypeScript, y compris le code Open Source de notre Action Hub.
Liste des services intégrés
La liste suivante présente les services disponibles dans le hub d'actions Looker.
Voici comment utiliser la liste :
- Les URL affichées dans la colonne Lien vers le fichier README fournissent des instructions pour activer et configurer le service intégré afin qu'il fonctionne avec Looker.
- Les URL affichées dans la colonne Comment utiliser cette intégration fournissent des instructions sur la façon d'envoyer des données de Looker au service intégré. Certains de ces articles contiennent également des instructions d'activation.
- La section Balises LookML requises liste toutes les balises requises qui doivent être utilisées avec le paramètre
tagsdans le modèle sous-jacent du contenu. - Le type d'action indique le niveau de données que le service intégré envoie : champ, requête ou tableau de bord. Une action au niveau du champ envoie la valeur d'une seule cellule spécifiée dans un tableau de données. Une action au niveau de la requête envoie les résultats d'une requête entière, comme toutes les lignes d'une exploration ou d'un Look. Une action au niveau du tableau de bord envoie une image d'un tableau de bord.
- Contenu disponible pour les envois planifiés indique le type de contenu Looker que ce service intégré peut envoyer en tant qu'envoi de contenu ponctuel ou planifié.
- Utilise l'authentification Google OAuth indique si le service intégré utilise les identifiants Google OAuth pour l'authentification. Il est possible que les instances hébergées par le client ne puissent pas activer les actions du Looker Action Hub qui utilisent Google OAuth. Pour connaître les solutions suggérées à ce problème potentiel, consultez la page de documentation Partager des données via un Action Hub.
- Utilise le streaming de données indique si le service intégré est compatible avec les résultats de requête en flux continu. Il est possible que les instances hébergées par le client ne puissent pas activer les actions du Looker Action Hub qui diffusent les résultats. Pour connaître les solutions suggérées à ce problème potentiel, consultez la page de documentation Partager des données via un Action Hub.
- La version minimale de Looker compatible indique la version la plus ancienne de Looker que votre instance doit utiliser pour pouvoir utiliser cette intégration.
| Service intégré | Description | Lien vers le fichier README | Utiliser cette intégration | Balises LookML obligatoires | Type d'action | Contenu disponible pour les livraisons programmées | Utilise l'authentification Google OAuth (Oui/Non) | Utilise la diffusion de données (Oui/Non) | Version minimale de Looker compatible |
|---|---|---|---|---|---|---|---|---|---|
| Airtable | Ajoutez des enregistrements à une table dans Airtable. | Afficher le fichier README sur GitHub | Consulter l'article de la communauté | Aucun | Requête | Regarder, explorer | Non | Non | 5,6 |
| Amazon SageMaker Infer | Effectuez une inférence à l'aide d'Amazon SageMaker. | Aucun fichier README disponible | Aucun article disponible | Aucun | Requête | Regarder, explorer | Non | Oui | 5,6 |
| Amazon SageMaker Train : Linear Learner | Démarrez une tâche d'entraînement sur Amazon SageMaker à l'aide de l'algorithme Linear Learner. | Aucun fichier README disponible | Aucun article disponible | Aucun | Requête | Regarder, explorer | Non | Oui | 5,6 |
| Amazon SageMaker Train : Xgboost | Lancez une tâche d'entraînement sur Amazon SageMaker à l'aide de l'algorithme Xgboost. | Aucun fichier README disponible | Aucun article disponible | Aucun | Requête | Regarder, explorer | Non | Oui | 5,6 |
| Arrêt d'une instance Amazon Web Services EC2 | Arrêtez une instance EC2 à l'aide de l'API Amazon EC2. | Afficher le fichier README sur GitHub | Consulter l'article de la communauté | aws_resource_id | Champ, requête | Regarder, explorer | Non | Non | 5,6 |
| Auger | Utilisez les résultats de la requête pour créer un modèle prédictif. | Afficher le fichier README sur GitHub | Consulter le fichier README | Aucun | Requête | Regarder, explorer | Non | Oui | 5.24 |
| Azure Storage | Envoyez et stockez un fichier de données sur Azure Storage. | Afficher le fichier README sur GitHub | Consulter l'article de la communauté | Aucun | Requête, tableau de bord | Look, exploration, tableau de bord | Non | Oui (pour les requêtes), Non (pour les tableaux de bord) | 5,6 |
| Braze | L'action Braze vous permet de signaler des utilisateurs dans Braze à l'aide du point de terminaison de l'API REST à partir d'un Look. Assurez-vous qu'un champ braze_id est tagué dans les résultats. MAX EXPORT : 10000. |
Afficher le fichier README sur GitHub | Consulter le fichier README | braze_id | Requête | Regarder, explorer | Non | Oui | 5,6 |
| DataRobot | Envoyez des données à DataRobot et créez un projet. | Afficher le fichier README sur GitHub | Consulter le fichier README | Aucun | Requête | Regarder, explorer | Non | Oui | 5.24 |
| DigitalOcean : arrêter un droplet | Arrêtez le processus DigitalOcean à l'aide de l'API DigitalOcean. | Afficher le fichier README sur GitHub | Consulter l'article de la communauté | digitalocean_droplet_id | Champ, requête | Regarder, explorer | Non | Non | 5,6 |
| DigitalOcean Spaces | Envoyez et stockez un fichier de données dans DigitalOcean Storage. | Afficher le fichier README sur GitHub | Consulter l'article de la communauté | Aucun | Requête, tableau de bord | Look, exploration, tableau de bord | Non | Oui (pour les Looks et les explorations), non (pour les tableaux de bord) | 5,6 |
| Dropbox | Envoyez et stockez un fichier de données sur Dropbox. | Aucun fichier README disponible | Consulter la documentation | Aucun | Requête, tableau de bord | Look, exploration, tableau de bord | Oui | Non | 6,8 |
| Audiences personnalisées Facebook | Importer des données dans les audiences personnalisées Facebook Ads à partir d'une liste de clients. | Afficher le fichier README sur GitHub | Consulter le fichier README | Aucun | Requête | Regarder, explorer | Oui | Oui | 6.10 |
| Firebase | Utilisez Firebase pour envoyer des notifications push sur mobile. | Aucun fichier README disponible | Aucun article disponible | Aucun | Requête | Regarder, explorer | Non | Non | 22.4 |
| Customer Match de Google Ads | Importez des données dans le ciblage par liste de clients Google Ads. | Afficher le fichier README sur GitHub | Consulter la documentation | Aucun | Requête | Regarder, explorer | Oui | Oui | 6.10 |
| Importation des données de Google Analytics | Importer des données dans un ensemble de données Google Analytics | Afficher le fichier README sur GitHub | Consulter le fichier README | Aucun | Requête | Regarder, explorer | Oui | Oui | 6.10 |
| Google Cloud Storage | Écrivez des fichiers de données dans un bucket Google Cloud Storage. | Afficher le fichier README sur GitHub | Consulter l'article de la communauté | Aucun | Requête, tableau de bord | Look, exploration, tableau de bord | Non | Oui (pour les Looks et les explorations), non (pour les tableaux de bord) | 5,6 |
| Google Drive | Envoyez des données vers Google Drive. | Aucun fichier README disponible | Consulter la documentation | Aucun | Requête, tableau de bord | Look, exploration, tableau de bord | Oui | Oui (pour les Looks et les explorations), non (pour les tableaux de bord) | 7.4 |
| Google Sheets | Envoyez des données CSV vers une Google Sheet. | Aucun fichier README disponible | Consulter la documentation | Aucun | Requête | Regarder, explorer | Oui | Oui | 7.4 |
| Entreprises HubSpot | Ajoutez des propriétés à vos entreprises à l'aide de l'API HubSpot V3. | Afficher le fichier README sur GitHub | Consulter le fichier README | hubspot_company_id | Requête | Regarder, explorer | Non | Oui | 5,6 |
| Contacts HubSpot | Ajoutez des propriétés à vos contacts à l'aide de l'API HubSpot V3. | Afficher le fichier README sur GitHub | Consulter le fichier README | hubspot_contact_id | Requête | Regarder, explorer | Non | Oui | 5,6 |
| Kloudio | Ajoutez des données à une Google Sheet. | Afficher le fichier README sur GitHub | Consulter le fichier README | Aucun | Requête | Regarder, explorer | Non | Non | 5,6 |
| mParticle | Exportez vos données utilisateur ou d'événement de manière groupée depuis Looker vers mParticle. | Afficher le fichier README sur GitHub | Consulter le fichier README | Consulter le fichier README | Requête | Regarder, explorer | Non | Oui | 5,6 |
| Campagnes Salesforce | Ajoutez des contacts ou des prospects à une campagne Salesforce. | Afficher le fichier README sur GitHub | Consulter le fichier README | sfdc_contact_id ou sfdc_lead_id | Requête | Regarder, explorer | Oui | Non | 22.6 |
| Groupe de segments | Ajoutez des caractéristiques et/ou des utilisateurs à vos groupes Segment. | Afficher le fichier README sur GitHub | Consulter la documentation | segment_group_id et user_id, ou segment_group_id et segment_anonymous_id | Requête | Regarder, explorer | Non | Oui | 4,20 |
| Segment Identify | Ajoutez des caractéristiques à vos utilisateurs Segment à l'aide d'Identify. | Afficher le fichier README sur GitHub | Consulter la documentation | email ou user_id ou segment_anonymous_id ou segment_group_id | Requête | Regarder, explorer | Non | Oui | 4,20 |
| Piste de segment | Connectez-vous à un certain nombre d'intégrations fournies par Segment pour identifier et cibler les utilisateurs pour les workflows marketing. | Afficher le fichier README sur GitHub | Consulter la documentation | email ou user_id ou segment_anonymous_id ou segment_group_id | Requête | Regarder, explorer | Non | Oui | 4,20 |
| SendGrid | Envoyez des données et planifiez l'envoi des résultats à une adresse e-mail à l'aide de l'API SendGrid. | Afficher le fichier README sur GitHub | Consulter l'article de la communauté | Aucun | Requête, tableau de bord | Look, exploration, tableau de bord | Non | Non | 5,6 |
| Slack | Envoyez du contenu Looker dans des messages directs, des chaînes publiques et des chaînes privées dans Slack à l'aide d'OAuth. Elle est disponible pour les déploiements hébergés sur Looker à partir de la version 6.24+ avec la fonctionnalité Liste autorisée d'adresses IP désactivée. | Aucun fichier README disponible | Consulter la documentation | Aucun | Requête, tableau de bord | Look, exploration, tableau de bord | Oui | Oui (pour les Looks et les explorations), non (pour les tableaux de bord) | 6.24 |
| Pièce jointe Slack (jeton d'API) | Envoyez des données directement dans un canal Slack, ainsi que les identifiants utilisateur. Vous pouvez également consulter la documentation Lookerbot pour en savoir plus sur les fonctionnalités Slack supplémentaires. | Afficher le fichier README sur GitHub | Consulter la documentation | Aucun | Requête, tableau de bord | Look, exploration, tableau de bord | Non | Non | 5,6 |
| Teams : webhook entrant | Envoyez des données à Microsoft Teams à l'aide d'un webhook entrant. | Afficher le fichier README sur GitHub | Consulter le fichier README | Aucun | Requête, tableau de bord | Look, exploration, tableau de bord | Non | Non | 5,6 |
| Tray | Connectez-vous à un certain nombre d'intégrations fournies par Tray.io pour automatiser les workflows. | Afficher le fichier README sur GitHub | Consulter l'article de la communauté | Aucun | Requête | Regarder, explorer | Non | Oui | 5,6 |
| Twilio : envoyer des données | Envoyez des données à partir d'un Look ou planifiez des résultats à envoyer à un numéro de téléphone à l'aide de l'API Twilio. | Afficher le fichier README sur GitHub | Consulter l'article de la communauté | Aucun | Requête | Regarder, explorer | Non | Non | 5,6 |
| Twilio : envoyer un message | Envoyez un message à une série de numéros de téléphone (colonnes de données taguées comme numéros de téléphone) dans un Look. | Afficher le fichier README sur GitHub | Consulter le fichier README | téléphone | Champ, requête | Regarder, explorer | Non | Non | 5,6 |
| Zapier | Associez-vous à un certain nombre d'intégrations fournies par Zapier pour automatiser les workflows. | Afficher le fichier README sur GitHub | Consulter l'article de la communauté | Aucun | Requête | Regarder, explorer | Non | Oui | 5,6 |
Pour en savoir plus
Pour en savoir plus, consultez la page de documentation Partager des données via un hub d'actions.