Comment générer une clé API pour Google Translate

Publié: 2019-03-06

De nombreux services externes qui utilisent le cloud Google nécessitent une clé API pour fonctionner. Mais qu'est-ce qu'une clé API et comment en obtenir une ? C'est ce que je vais vous expliquer tout de suite.

Dans cet article, nous verrons comment obtenir une clé API pour pouvoir utiliser Google Cloud Translate, mais le processus est le même si nous voulons obtenir une clé API pour un autre service Google Cloud, tel que Google Maps.

Commençons par le début… Une clé API n'est rien de plus qu'une chaîne que nous utilisons comme clé de licence pour un service particulier. Dans notre exemple, une clé API Google nous permettra d'accéder à n'importe quel service cloud de Google à partir d'une application externe. Sans cette clé, nous ne pouvons pas effectuer d'appels authentifiés vers les services Google Cloud à partir d'une application tierce, et donc l'application qui nécessite cette clé ne fonctionnera pas.

Maintenant que nous comprenons ce qu'est une clé API, voyons comment en obtenir une pour Google Traduction.

Comment créer un nouveau compte dans Google Cloud Console

La première chose dont vous avez besoin est un compte dans Google Cloud Console et un mode de paiement. Pour le faire, suivez ces étapes:

  • Accédez à Google Cloud Console et connectez-vous ou, si vous n'avez pas encore de compte, inscrivez-vous.
  • Ouvrez le menu de gauche de la console et sélectionnez Facturation .
  • Cliquez sur le bouton Nouveau compte de facturation . N'oubliez pas que s'il ne s'agit pas de votre premier compte de facturation, vous devez d'abord ouvrir la liste des comptes de facturation. Pour ce faire, cliquez sur le nom de votre compte de facturation existant en haut de la page, puis cliquez sur Gérer les comptes de facturation .
  • Entrez le nom du compte de facturation et vos informations de facturation. Les options qui s'affichent dépendent du pays de votre adresse de facturation.
  • Cliquez sur Soumettre et activez la facturation .
Écran principal de Google Cloud Console.
Écran principal de Google Cloud Console.

Par défaut, la personne qui crée le compte de facturation est un administrateur de facturation pour le compte. Une fois le compte créé et les informations de facturation prêtes, vous pouvez continuer avec les étapes suivantes pour obtenir la clé API.

Comment créer un nouveau projet dans Google Cloud

Accédez à la barre en haut de la fenêtre et dans le menu déroulant, vous pouvez voir vos projets créés ainsi que la possibilité d'en créer un nouveau en cliquant sur le bouton Nouveau projet :

Écran de sélection et de création de projet dans Google Cloud.
Écran de sélection et de création de projet dans Google Cloud.

Donnez maintenant un nom au nouveau projet et créez-le en cliquant sur le bouton correspondant, comme vous pouvez le voir sur la capture d'écran suivante :

Vue de création d'un nouveau projet dans Google Cloud.
Vue de création d'un nouveau projet dans Google Cloud.

À ce stade, vous devriez déjà avoir créé et sélectionné le projet, alors passons à autre chose.

Activer l'API Google Traduction

Avant de pouvoir utiliser une API Google dans votre projet, vous devez l'activer. Allez dans le menu latéral et sélectionnez l'option APIs & Services :

Menu des API et des services Google Cloud.
Menu des API et des services Google Cloud.

Vous verrez maintenant un écran avec des statistiques sur les API que vous avez activées. Si vous avez créé le projet à partir de zéro en suivant les étapes ci-dessus, vous n'aurez pas encore de données, comme vous pouvez le voir :

Tableau de bord des API et services Google Cloud.
Tableau de bord des API et services Google Cloud.

Cliquez sur le bouton supérieur Activer les API et les services pour poursuivre le processus d'activation de l'API. Cela nous amène à un champ de recherche où nous devons rechercher l'API qui nous intéresse. Dans ce cas, nous voulons utiliser l'API Google Translate. Tapez translate dans le champ de recherche et cliquez sur le résultat Cloud Translate API :

Vue de recherche d'API pour une activation ultérieure dans notre projet Google Cloud.
Vue de recherche d'API pour une activation ultérieure dans notre projet Google Cloud.

Cela nous amène à un écran avec la description de l'API Cloud Translation. Cliquez sur le bouton Activer pour activer l'API dans notre projet :

Avant de pouvoir commencer à utiliser l'API Google Translate dans notre projet, vous devez l'activer dans Google Cloud.
Avant de pouvoir commencer à utiliser l'API Google Translate dans notre projet, vous devez l'activer dans Google Cloud.

L'API Google Cloud Translation est déjà activée. Nous y sommes presque…

Créer une nouvelle clé API pour Google Traduction

Après avoir activé l'API, voyons comment générer une nouvelle Key API pour pouvoir utiliser ce service. Nous devons retourner dans le menu latéral et sélectionner l'option Identifiants :

Menu de gestion des identifiants de Google Cloud Translate.
Menu de gestion des identifiants de Google Cloud Translate.

Sur cet écran, nous voyons un bouton avec une liste déroulante et le texte Créer des informations d'identification . Ne cliquez pas sur le bouton ! Au lieu de cela, ouvrez le menu déroulant en cliquant sur la flèche à droite du bouton et sélectionnez l'option Clé API .

Vous devez sélectionner le type d'identifiant Key API pour créer une nouvelle clé pour l'API Google Translate.
Vous devez sélectionner les informations d'identification de la clé API pour créer une nouvelle clé pour l'API Google Translate.

Cela crée la nouvelle API de clé. Vous pouvez le copier si vous le souhaitez, bien que vous puissiez y accéder ultérieurement :

Google Cloud nous fournit une nouvelle API Key pour utiliser Google Translate avec nos applications tierces.
Google Cloud nous fournit une nouvelle API Key pour utiliser Google Translate avec nos applications tierces.

Comment restreindre notre clé API pour protéger et limiter son utilisation

Pour contrôler le coût de Google Cloud en utilisant l'API Google Cloud Translation (ou Google Translate, c'est la même chose), nous pouvons faire deux choses : restreindre où vous pouvez utiliser la clé API que nous venons de créer ou limiter le quota autorisé à utiliser le service lui-même.

Dans la capture d'écran ci-dessus, si vous cliquez sur le bouton Restreindre la clé , vous accéderez à l'écran de restriction de la clé API qui suit :

Nous pouvons restreindre à partir de quel domaine Web nous pouvons utiliser l'API Key que nous venons de générer pour éviter toute utilisation abusive en cas de perte.
Nous pouvons restreindre le domaine Web à partir duquel nous pouvons utiliser la clé API que nous venons de générer.

Là, vous pouvez choisir de restreindre la clé API par des référents HTTP , ce qui signifie que vous ne pouvez effectuer des appels à l'API Google Cloud Translate qu'à l'aide de la clé API à partir de certains noms de domaine.

Vous devez ajouter les noms de domaine valides dans la zone de texte qui s'affiche lors de la sélection de l'option Référents HTTP . Dans notre cas, nous avons ajouté ici notre nom de domaine https://neliosoftware.com/* .

D'autre part, allez dans le menu API's & ServicesDashboardCloud Translation APIQuotas et vous y trouverez une boîte appelée Characters . Là, vous pouvez modifier les limites de quota de l'API Google Cloud Translation et les réduire, si nécessaire.

Le prix de l'API Google Cloud Translation au moment de la rédaction de cet article est de 20 USD par million de caractères traduits, alors faites vos calculs.

Google Cloud nous permet de limiter l'utilisation que nous faisons des API afin de contrôler la consommation maximale que nous voulons finir par payer.
Google Cloud nous permet de limiter l'utilisation des API pour contrôler le coût maximum que nous voulons finir par payer.

Et c'est tout! Vous avez déjà votre clé API prête à être utilisée avec l'application que vous souhaitez. Le processus est un peu lourd au début, mais en suivant les étapes, vous obtiendrez la clé API sans problème. Essayez-le et faites-moi savoir si vous avez besoin d'aide supplémentaire !

Image sélectionnée par Conor Luddy sur Unsplash.