Nous sommes heureux d'annoncer que l'API Looker 4.0 est désormais disponible pour tous dans Looker 22.4. L'API 4.0 en disponibilité générale (API 4.0 DG) comprend de nouveaux ajouts et suppressions qui font passer plusieurs points de terminaison de la version bêta à la version stable. Consultez notre documentation de référence sur l'API pour obtenir des spécifications détaillées sur l'API 4.0. Nous avons mis à jour nos SDK pris en charge par Looker et par la communauté pour prendre en charge les points de terminaison de l'API 4.0 DG. Pour en savoir plus, consultez les Règles d'assistance pour les API et les SDK et la Gestion des versions d'API. Le reste de cet article décrit les modifications importantes, les atténuations et les fonctionnalités que vous pouvez attendre lors de la migration vers l'API 4.0 DG.
À qui s'adresse cet article ?
Ce document s'adresse à vous si vous utilisez l'API Looker via des SDK pris en charge par Looker, des SDK pris en charge par la communauté ou l'API elle-même. Lisez la section suivante qui correspond à la version de l'API Looker que vous utilisez.
Utilisateurs de l'API 4.0 avant sa disponibilité générale
Si vous utilisez l'API 4.0, lisez cette section. Elle couvre les modifications importantes et les atténuations disponibles lorsque vous migrez vers l'API 4.0 DG.
L'API 4.0 DG inclut la modification de tous les champs d'ID d'entité, qui passent du type numérique integer au type string. Par exemple, GET /groups/{group_id} point de terminaison renvoie id en tant que type string au lieu du type int64.
Veuillez lire le tableau suivant pour connaître l'impact et les atténuations spécifiques à votre utilisation du point de terminaison de l'API 4.0 :
| Utilisation | Impact potentiel1 | Prévention |
| Applications mobiles Looker | Les installations obsolètes des applications mobiles Looker ne fonctionnent plus. | Demandez aux utilisateurs d'installer la dernière version des applications mobiles Looker. |
| SDK pris en charge par Looker2 | ||
| SDK TypeScript (API 4.0) | Aucun impact | Aucune action requise |
| SDK Python (API 4.0) | Aucun impact | Aucune action requise |
| SDK Ruby (API 4.0) | Aucun impact | Aucune action requise |
| SDK pris en charge par la communauté2 SDK | ||
| SDK Swift | Exceptions d'exécution | Mettez à jour le SDK vers la version 22.0 ou ultérieure, puis résolvez les erreurs de type résultantes, le cas échéant. |
| SDK Kotlin | Aucun impact | Aucune action requise |
| SDK LookR | Aucun impact | Aucune action requise |
| SDK C# | Aucun impact | Aucune action requise |
| SDK Go | Exceptions d'exécution | Mettez à jour le SDK vers la version 22.0 ou ultérieure, puis résolvez les erreurs de type résultantes, le cas échéant. |
| Autre | ||
| Utilisation de l'API 4.0 sans SDK (ou avec des bibliothèques fournies en externe) | Erreurs d'exécution possibles, en fonction de la sensibilité au type du langage | Vérifiez le code pour détecter les dépendances sur le type de tous les champs d'ID et ajoutez la prise en charge des champs d'ID de type chaîne. Consultez également ces conseils supplémentaires. |
1 : en supposant des modèles d'utilisation courants qui peuvent inclure l'utilisation des champs d'ID de Looker, mais pas des modèles d'utilisation inhabituels tels que l'application d'opérations numériques aux ID.
2 : Assistance pour l'API et les SDK Looker. Les bibliothèques prises en charge par la communauté ne sont pas officiellement prises en charge par Looker.
Utilisateurs de l'API 3.1
Si vous utilisez l'API 3.1, lisez cette section. Elle couvre les fonctionnalités et modifications supplémentaires que l'API 4.0 met à votre disposition. N'oubliez pas que tous nos SDK pris en charge par Looker et par la communauté sont principalement compatibles avec l'API 4.0. Pour en savoir plus, consultez les Règles d'assistance pour les SDK et les API.
Fonctionnalités supplémentaires de l'API 4.0 DG
Pour plus de commodité, nous listons les modifications les plus notables et les plus utiles apportées à l'API 4.0 :
- Création et gestion de tableaux, d'éléments de tableau et de sections de tableau. Pour en savoir plus sur les tableaux, consultez la page de documentation sur les tableaux.
- Interrogez des informations de connexion supplémentaires telles que les bases de données, les schémas, les colonnes et les tables. Définissez et mettez à jour des champs de connexion supplémentaires.
- Créez et gérez des applications et des utilisateurs OAuth. Pour en savoir plus sur OAuth, consultez la page de documentation sur OAuth.
- Recherchez des groupes avec une hiérarchie et des rôles.
- Recherchez des rôles avec le nombre d'utilisateurs.
- Obtenez et définissez les paramètres d'instance Looker. Pour en savoir plus sur les paramètres, consultez la page de documentation sur les paramètres.
- Créez et gérez des alertes. Pour en savoir plus sur les alertes, consultez la page de documentation sur les alertes.
- Créez, gérez et testez des tunnels et des serveurs SSH. Pour en savoir plus sur SSH, consultez la page de documentation sur SSH.
- Déplacez et copiez des tableaux de bord.
- Obtenez des URL relatives pour les nouveaux tableaux de bord.
- Déplacez et copiez des présentations.
- Créez et gérez des secrets, des URL et des utilisateurs d'intégration signée et non signée.
- Obtenez un jeton d'actualisation pour actualiser le jeton d'accès à la connexion.
- Limitez et décallez les résultats de l'obtention de tous les modèles LookML et de tous les utilisateurs.
- Limitez et décallez les résultats de la recherche d'utilisateurs.
- Obtenez la spécification de l'API de l'instance Looker au format JSON Swagger 2.x.
Modifications apportées à l'obsolescence de l'API 4.0 DG
L'API 4.0 DG remplace plusieurs points de terminaison obsolètes de l'API 3.1 par des fonctionnalités améliorées. Les points de terminaison suivants sont concernés :
- Les points de terminaison obsolètes de la page d'accueil ont été supprimés. Veuillez utiliser des points de terminaison de tableau au lieu de pages d'accueil. Consultez Présenter du contenu à l'aide de tableaux.
- Les points de terminaison obsolètes de l'espace ont été supprimés. Utilisez des points de terminaison de dossier au lieu d'un espace. Consultez Organiser et gérer l'accès au contenu.
Utilisateurs de l'API 3.0
L'API 3.0 est obsolète. Nous vous recommandons de migrer vers l'API 4.0.
- Seule l'API 4.0 est compatible avec tous les SDK pris en charge par Looker et par la communauté pour faciliter votre développement. Consultez notre dépôt de SDK.
- L'API 4.0 introduit plusieurs nouvelles fonctionnalités et améliorations, comme indiqué dans la section Fonctionnalités supplémentaires de l'API 4.0 DG de cette page.
Conclusion
Vous pouvez vous attendre à ce que de nouvelles fonctionnalités et des modifications supplémentaires soient ajoutées à l'API 4.0. Vous trouverez toujours les dernières modifications dans notre documentation de référence sur l'API. Pour en savoir plus, consultez les Règles d'assistance pour les API et les SDK et la Gestion des versions d'API. Nous savons que les modifications importantes ne sont pas idéales. Sauf en cas de problème extrême, nous n'apporterons aucune modification importante à notre API 4.0 en disponibilité générale. Nous espérons que notre API Looker 4.0 en disponibilité générale vous aidera à développer plus facilement et de manière plus productive sur la plate-forme Looker.