Ce guide fournit toutes les étapes de configuration requises pour utiliser Natural Language.
À propos de Google Cloud Console
Google Cloud Console est une interface utilisateur Web permettant de provisionner, configurer, gérer et surveiller les systèmes utilisant des produits Google Cloud. Utilisez Google Cloud Console pour configurer et gérer les ressources Natural Language.
Créer un projet
Pour utiliser les services fournis par Google Cloud, vous devez créer un projet.
Un projet permet d'organiser toutes vos ressources Google Cloud. Un projet se compose des éléments suivants :
- un ensemble de collaborateurs ;
- des API activées (et autres ressources) ;
- des outils de surveillance ;
- des informations de facturation ;
- l'authentification et le contrôle des accès.
Vous pouvez créer un projet, ou en créer plusieurs et les utiliser pour organiser vos ressources Google Cloud dans une hiérarchie des ressources. Pour en savoir plus sur les projets, consultez la documentation concernant Resource Manager.
Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
Accéder au sélecteur de projet
Activer la facturation
Un compte de facturation sert à déterminer qui assume les frais pour un ensemble de ressources donné. Il peut être associé à un ou plusieurs projets. Les frais d'utilisation du projet sont imputés au compte de facturation associé. Dans la plupart des cas, vous configurez la facturation lorsque vous créez un projet. Pour en savoir plus, consultez la documentation concernant la facturation.
Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.
Activer l'API
Vous devez activer l'API Cloud Natural Language pour votre projet. Pour en savoir plus sur l'activation des API, consultez la documentation concernant Service Usage.
Activez Cloud Natural Language API.
Configurer l'authentification
Toute application cliente qui utilise l'API doit être authentifiée et se voir accorder l'accès aux ressources demandées. Cette section décrit des concepts d'authentification importants et vous indique la procédure à suivre pour la configurer. Pour en savoir plus, consultez la présentation de l'authentification Google Cloud.
À propos des comptes de service
Il existe plusieurs options d'authentification, mais nous vous recommandons d'utiliser les comptes de service pour l'authentification et le contrôle des accès. Un compte de service fournit des identifiants pour les applications, et non pour les utilisateurs finaux. Les comptes de service appartiennent à des projets. Vous pouvez créer plusieurs comptes de service par projet. Pour en savoir plus, consultez la page Comptes de service.
À propos des rôles
Aucun rôle n'est requis pour accéder à l'API Cloud Natural Language. Les utilisateurs ou les applications authentifiés peuvent appeler l'API, quelles que soient leurs autorisations.
À propos des clés de compte de service
Les comptes de service sont associés à une ou plusieurs paires de clés publiques/privées. Lorsque vous créez une paire de clés, vous téléchargez la clé privée. Cette clé privée permet de générer des identifiants lors de l'appel de l'API. Vous êtes responsable de la sécurité de la clé privée et des autres opérations de gestion, telles que la rotation des clés.
Créer un compte de service et télécharger le fichier de clé privée
Créez un compte de service :
-
Dans la console Google Cloud, accédez à la page Créer un compte de service.
Accéder à la page "Créer un compte de service" - Sélectionnez votre projet.
-
Dans le champ Nom du compte de service, saisissez un nom. La console Google Cloud remplit le champ ID du compte de service en fonction de ce nom.
Dans le champ Description du compte de service, saisissez une description. Exemple :
Service account for quickstart. - Cliquez sur Créer et continuer.
-
Cliquez sur OK pour terminer la création du compte de service.
Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.
Créez une clé de compte de service :
- Dans la console Google Cloud, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
- Cliquez sur Keys (Clés).
- Cliquez sur Ajouter une clé, puis sur Créer une clé.
- Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
- Cliquez sur Close (Fermer).
Utiliser le fichier de clé de compte de service dans votre environnement
Fournissez des identifiants d'authentification au code de votre application en définissant la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS. Cette variable ne s'applique qu'à la session d'interface système actuelle. Si vous souhaitez que la variable s'applique aux sessions d'interface système futures, définissez-la dans votre fichier de démarrage de l'interface système, par exemple dans le fichier ~/.bashrc ou ~/.profile.
Linux ou macOS
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
Remplacez KEY_PATH par le chemin du fichier JSON contenant la clé de votre compte de service.
Exemple :
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
Windows
Pour PowerShell :
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
Remplacez KEY_PATH par le chemin du fichier JSON contenant la clé de votre compte de service.
Exemple :
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
Pour l'invite de commande :
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
Remplacez KEY_PATH par le chemin du fichier JSON contenant la clé de votre compte de service.
Installer et initialiser gcloud CLI
Si vous prévoyez d'utiliser l'API Natural Language, vous devez installer et initialiser gcloud CLI. gcloud CLI est un ensemble d'outils qui vous permet de gérer les ressources et les applications hébergées sur Google Cloud. Cela inclut gcloud CLI. Le lien suivant fournit les instructions correspondantes :
Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante :
gcloud init
Tester le SDK et s'authentifier
Si vous avez configuré l'authentification lors des étapes précédentes, vous pouvez utiliser gcloud CLI pour tester votre environnement d'authentification. Exécutez la commande suivante et vérifiez qu'aucune erreur ne se produit et que les identifiants sont bien renvoyés :
gcloud auth application-default print-access-token
Cette commande est utilisée par tous les exemples REST en ligne de commande de Natural Language, afin d'authentifier les appels d'API.
Installer la bibliothèque cliente de l'API Natural Language
Vous disposez de trois options pour appeler l'API Natural Language :
- Bibliothèques clientes compatibles avec Google (recommandé)
- REST
- gRPC
Les bibliothèques clientes sont disponibles dans plusieurs langages courants. Pour en savoir plus sur l'installation des bibliothèques clientes, consultez la documentation sur les bibliothèques clientes de Cloud Natural Language.