À propos du projet

Ce dépôt fournit des bibliothèques clientes Go générées automatiquement pour les API Google, dérivées des fichiers de description JSON du Google Discovery Service. Chaque API est exposée sous forme de paquet importable distinct, ce qui permet de n'importer que ce dont vous avez besoin, par exemple google.golang.org/api/tasks/v1 ou google.golang.org/api/urlshortener/v1, puis de construire un service avec NewService(ctx). Caractéristiques principales : - Code généré : les bibliothèques sont produites par un générateur à partir des documents Discovery, elles peuvent donc contenir des changements incompatibles entre les versions ; le générateur et sa sortie sont considérés comme bêta. - Statut de prise en charge : officiellement pris en charge par Google, mais les bibliothèques sont décrites comme complètes et en mode maintenance, ce qui signifie que les bugs critiques et les problèmes de sécurité sont traités tandis que de nouvelles fonctionnalités ne sont pas ajoutées. - API Cloud : pour les services Google Cloud Platform tels que Datastore ou Pub/Sub, le README oriente les utilisateurs vers les Cloud Client Libraries for Go distinctes. Autorisation : - Par défaut, les services utilisent les Google Application Default Credentials, ce qui permet aux applications de s'exécuter dans de nombreux environnements sans configuration explicite. - Les fichiers de clé JSON peuvent être fournis via option.WithAuthCredentialsFile avec un type d'identifiant explicite (par exemple ServiceAccount), ou les identifiants JSON directement via option.WithAuthCredentialsJSON. - Les fonctions plus anciennes option.WithCredentialsFile et option.WithCredentialsJSON sont obsolètes en raison d'un risque de sécurité potentiel. - Pour un contrôle plus fin, un oauth2.TokenSource de golang.org/x/oauth2 peut être passé avec option.WithTokenSource. Documentation et exemples : - Un guide Getting Started et un répertoire examples sont référencés pour des tutoriels plus longs et des exemples d'utilisation. - La documentation des paquets est disponible sur pkg.go.dev, et le support communautaire est orienté vers la liste de diffusion golang-nuts. Il s'agit d'une collection de SDK destinée aux développeurs plutôt que d'une application pour l'utilisateur final ; sa valeur réside dans le fait de donner aux programmes Go un accès typé à un large éventail d'API Google avec des modèles d'authentification cohérents.