Ce guide fournit toutes les étapes de configuration requises pour utiliser Natural Language.
À propos de la Google Cloud console
La Google Cloud console, est une interface utilisateur Web permettant de provisionner, configurer, gérer, et surveiller les systèmes utilisant des Google Cloud produits. Utilisez la 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 Google Cloud ressources. 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 Google Cloud ressources dans une hiérarchie des ressources. Pour en savoir plus sur les projets, consultez la documentation concernant Resource Manager.
Dans la Google Cloud console, sur la page de sélection du projet, sélectionnez ou créez un Google Cloud projet.
Rôles requis pour sélectionner ou créer un projet
- Sélectionner un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
-
Créer un projet : pour créer un projet, vous avez besoin du rôle Créateur de projet
(
roles/resourcemanager.projectCreator), qui contient l'autorisationresourcemanager.projects.create. Découvrez comment attribuer des rôles.
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.
Vérifiez que la facturation est activée pour votre Google Cloud 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 l'API Cloud Natural Language.
Rôles requis pour activer les API
Pour activer les API, vous avez besoin de l'autorisation serviceusage.services.enable. Si vous
avez créé le projet, vous disposez probablement déjà de cette autorisation via le
rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation via le
rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin).
Découvrez comment attribuer des rôles.
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 que vous pouvez utiliser pour gérer les ressources et les applications hébergées sur Google Cloud. Cela inclut gcloud CLI. Le lien suivant fournit des instructions :
Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisezla en exécutant la commande suivante :
gcloud initSi vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
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. La façon dont vous configurez l'authentification dépend de si vous travaillez dans un environnement de développement local ou si vous configurez un environnement de production. Pour en savoir plus, consultez la page Configurer les identifiants par défaut de l'application.
Sélectionnez les onglets correspondant à la manière dont vous prévoyez d'accéder à l'API :
gcloud
Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisezla en exécutant la commande suivante :
gcloud initSi vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
Bibliothèques clientes
Pour utiliser des bibliothèques clientes dans un environnement de développement local, installez et initialisez la gcloud CLI, puis configurez le service Identifiants par défaut de l'application avec vos identifiants utilisateur.
-
Installez la Google Cloud CLI.
-
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
-
Si vous utilisez un shell local, créez des identifiants d'authentification locaux pour votre compte utilisateur :
gcloud auth application-default login
Vous n'avez pas besoin de le faire si vous utilisez Cloud Shell.
Si une erreur d'authentification est renvoyée et que vous utilisez un fournisseur d'identité (IdP) externe, vérifiez que vous vous êtes connecté à la gcloud CLI avec votre identité fédérée.
Pour en savoir plus, consultez la section Configurer les ADC pour un environnement de développement local dans la documentation sur l'authentification. Google Cloud
REST
Pour utiliser l'API REST dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.
Installez la Google Cloud CLI.
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l' Google Cloud authentification.
Pour en savoir plus sur la configuration de l'authentification dans un environnement de production, consultez la section Configurer les identifiants par défaut de l'application pour le code s'exécutant sur Google Cloud dans la documentation sur l'authentification. Google Cloud
Installer la bibliothèque cliente 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.
Rôles IAM
Pour obtenir les autorisations nécessaires pour accéder à l'API Cloud Natural Language, demandez à votre administrateur de vous accorder le rôle IAM Consommateur Service Usage (roles/serviceusage.serviceUsageConsumer) sur votre projet de quota.
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.