Cette page explique comment utiliser les bibliothèques clientes Cloud pour l'API Text-to-Speech. Pour en savoir plus sur les bibliothèques clientes des API Cloud, y compris les anciennes bibliothèques clientes des API Google, consultez la page Présentation des bibliothèques clientes.
Installer la bibliothèque cliente
C#
Pour en savoir plus, consultez la page Configurer un environnement de développement C#.
Si vous utilisez Visual Studio 2017 ou une version ultérieure, ouvrez la fenêtre du gestionnaire de packages NuGet et saisissez les éléments suivants :Install-Package Google.Apis
Si vous utilisez les outils d'interface de ligne de commande .NET Core pour installer vos dépendances, exécutez la commande suivante :
dotnet add package Google.Apis
Go
Pour plus d'informations, consultez la page Configurer un environnement de développement Go.
go get cloud.google.com/go/texttospeech/apiv1
Java
Pour en savoir plus, consultez la section Configurer un environnement de développement Java.
Si vous utilisez Maven, ajoutez les lignes suivantes à votre fichier pom.xml
. Pour en savoir plus sur les BOM, consultez la page The Google Cloud Platform Libraries BOM (BOM des bibliothèques Google Cloud Platform).
Si vous utilisez Gradle, ajoutez les éléments suivants à vos dépendances :
Si vous utilisez sbt, ajoutez les éléments suivants à vos dépendances :
Si vous utilisez Visual Studio Code, IntelliJ ou Eclipse, vous pouvez ajouter des bibliothèques clientes à votre projet à l'aide des plug-ins IDE suivants :
Les plug-ins offrent des fonctionnalités supplémentaires, telles que la gestion des clés pour les comptes de service. Reportez-vous à la documentation de chaque plug-in pour plus de détails.
Node.js
Pour en savoir plus, consultez la section Configurer un environnement de développement Node.js.
npm install --save @google-cloud/text-to-speech
PHP
Pour en savoir plus, consultez la page Utiliser PHP sur Google Cloud.
composer require google/apiclient
Python
Pour en savoir plus, consultez la section Configurer un environnement de développement Python.
pip install --upgrade google-cloud-texttospeech
Ruby
Pour en savoir plus, consultez la section Configurer un environnement de développement Ruby.
gem install google-api-client
Configurer l'authentification
Pour exécuter la bibliothèque cliente, vous devez d'abord configurer l'authentification. Pour ce faire, vous pouvez créer un compte de service et définir une variable d'environnement, comme indiqué dans les étapes suivantes. Pour en savoir plus sur les méthodes d'authentification, consultez la section Authentification en tant que compte de service.
Console
Créez un compte de service :
-
Dans la console, 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 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.
-
Pour accorder l'accès à votre projet, attribuez le ou les rôles suivants à votre compte de service : Projet > Propriétaire.
Dans la liste Sélectionner un rôle, sélectionnez un rôle.
Pour ajouter des rôles supplémentaires, cliquez sur
Ajouter un autre rôle et ajoutez chaque rôle supplémentaire. - Cliquez sur 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, 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).
gcloud
Configurez l'authentification :
-
Créez le compte de service :
gcloud iam service-accounts create NAME
Remplacez
NAME
par le nom que vous souhaitez donner au compte de service. -
Attribuez des rôles au compte de service. Exécutez la commande suivante une fois pour chacun des rôles IAM suivants :
roles/owner
:gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=ROLE
Remplacez les éléments suivants :
SERVICE_ACCOUNT_NAME
: nom du compte de service.PROJECT_ID
: ID du projet dans lequel vous avez créé le compte de service.ROLE
: rôle à accorder
-
Générez le fichier de clé :
gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Remplacez les éléments suivants :
FILE_NAME
: nom du fichier de cléSERVICE_ACCOUNT_NAME
: nom du compte de service.PROJECT_ID
: ID du projet dans lequel vous avez créé le compte de service.
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.
Utiliser la bibliothèque cliente
L'exemple suivant montre comment utiliser la bibliothèque cliente.
Go
Java
Node.js
Python