Rechercher et sélectionner des API Google

1. Avant de commencer

Cet atelier de programmation vous explique comment rechercher et sélectionner des API Google, et comment afficher les métriques d'API.

Prérequis

  • Vous devez savoir parcourir la console Google Cloud.

Points abordés

Prérequis

2. Accéder aux API depuis la console Cloud

  1. Dans la console Cloud, sélectionnez 5854836f11d5d97b.png Menu de navigation > API et services > API et services activés.

Menu de navigation de la console Cloud

  1. Dans le tableau de bord API et services, cliquez sur + ACTIVER DES API ET DES SERVICES pour afficher les API disponibles.

Tableau de bord "API et services" affichant l'option "ACTIVER LES API ET LES SERVICES".

Sur la page API et services, vous pouvez rechercher des API de plusieurs façons. Si vous connaissez le nom de l'API, vous pouvez le saisir dans le champ Rechercher des API et des services en haut de la page. Vous pouvez également filtrer les API par catégorie à l'aide des filtres situés sur le côté de la page.

Liste des API résultant du champ "Rechercher des API et des services".

  1. Dans le menu CATÉGORIE, sélectionnez Machine learning pour n'afficher que les API de machine learning.

API filtrées par CATÉGORIE pour n'afficher que les API de machine learning.

  1. Dans les API de machine learning, sélectionnez API Cloud Natural Language pour afficher des informations sur cette API.
  2. Cliquez sur ACTIVER pour activer cette API dans le projet approprié.

Volet de l'API Cloud Natural Language affichant les boutons "ACTIVER" et "ESSAYER CETTE API".

Lorsque vous activez l'API, la page "Présentation" de l'API s'affiche. Vous pouvez consulter les métriques concernant votre utilisation de cette API, qui ne contient que très peu d'informations, car vous l'avez activée récemment.

Page "Présentation" de l'API sélectionnée, affichant les métriques de l'API.

Dans un prochain atelier de programmation, vous apprendrez à créer des identifiants. Si vous êtes curieux, cliquez sur CRÉER DES IDENTIFIANTS, puis répondez aux questions qui s'affichent.

  1. Cliquez sur GÉRER pour revenir à l'aperçu de l'étape précédente.

Page de présentation de l'API Cloud Natural Language.

  1. Pour essayer l'API (même avant de l'activer), cliquez sur ESSAYER CETTE API.

Vous êtes généralement redirigé vers une page de la documentation de l'API. Toutefois, pour certaines API, il n'existe aucun moyen immédiat de les essayer, car elles comportent de nombreuses méthodes différentes. C'est le cas de l'API Cloud Natural Language.

Page de référence de l'API Cloud Natural Language.

  1. Sélectionnez la méthode analyzeEntitites.

Une page Web contenant des informations sur les méthodes de l'API et un volet Essayer cette API devrait s'afficher.

Page de la méthode analyzeEntities affichant les détails de la méthode et un volet "Essayer cette API".

  1. Pour essayer un exemple de requête, ajoutez un objet document au champ Corps de la requête avec ces paramètres. Cliquez sur les icônes + pour développer les options de champ.
  2. Dans le champ content:, saisissez le texte à analyser.

Cet exemple utilise Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'..

  1. Dans le champ type:, sélectionnez PLAIN_TEXT.

Le corps de la requête doit ressembler à ce qui suit :

Volet "Corps de la requête" affichant les paramètres du corps de la requête.

Pour en savoir plus sur chaque paramètre, consultez la documentation.

  1. Décochez la case Google OAuth 2.0, puis cliquez sur Exécuter pour obtenir une réponse contenant des informations sur les entités.

Réponse 200 avec des informations sur les entités.

  1. Décochez la case Clé API, puis cliquez à nouveau sur Exécuter.

Lorsque vous exécutez la requête cette fois-ci, vous obtenez une erreur comme celle-ci, car l'API nécessite des identifiants pour s'exécuter.

Réponse 403 pour une requête dont les identifiants sont manquants.

  1. Cochez la case Google OAuth 2.0, puis cliquez de nouveau sur Exécuter.

OAuth 2.0 fournit les autorisations d'API sur votre compte et affiche un avertissement.

Avertissement OAuth 2.0 indiquant que Google APIs Explorer souhaite accéder à votre compte Google.

Si vous autorisez l'accès, vous obtenez la même réponse qu'avec les clés API. Si vous utilisez l'API dans une application et que vous devez accorder l'accès à des personnes qui connaissent leurs identifiants, vous devez utiliser OAuth 2.0. Si l'accès à l'API pour l'utilisateur suffit à l'application, vous pouvez utiliser des clés API à la place.

3. Afficher vos métriques d'API avec l'explorateur de métriques

Vous pouvez consulter l'historique des appels pour n'importe quelle API sur la page "Présentation de l'API", comme indiqué à l'étape 6 de la section "Accéder aux API depuis la console Cloud". Toutefois, pour afficher plus de métriques sur l'utilisation de toutes les API, utilisez l'explorateur de métriques.

  1. Dans la section Opérations du f6b6844bf5688982.png menu de navigation, cliquez sur Surveillance > Explorateur de métriques.

Section "Opérations" du menu de navigation, avec les options "Surveillance" et "Explorateur de métriques" sélectionnées.

  1. Dans le menu Type de ressource, sélectionnez API consommée comme type de métrique. (Si vous ne le voyez pas, décochez la case N'afficher que les éléments actifs.)

ca850c4295ef4ec9.png

  1. Dans le menu Métrique, sélectionnez l'une des métriques individuelles pour les API, comme Nombre de requêtes, pour voir combien d'API ont été appelées au cours de la période donnée.

L'explorateur de métriques affiche les métriques "API consommées" pour le nombre de requêtes.

  1. Pour personnaliser davantage le résultat, définissez un agrégateur et ajustez la période. L'explorateur de métriques affiche les métriques "API consommées" pour le nombre de requêtes avec un agrégateur et une période spécifiés.

4. Utiliser OAuth 2.0 Playground pour tester les API

Vous pouvez également utiliser OAuth 2.0 Playground pour essayer les API Google. Avec OAuth 2.0 Playground, vous pouvez sélectionner une API, l'autoriser, puis envoyer des requêtes et afficher les réponses dans la fenêtre de la console OAuth 2.0 Playground.

  1. Ouvrez OAuth 2.0 Playground.

OAuth 2.0 Playground affichant une liste des API que vous pouvez essayer.

  1. Cliquez sur Cloud Natural Language API > https://www.googleapis.com/auth/cloud-language > https://www.googleapis.com/auth/cloud-platform > Autoriser les API.

OAuth 2.0 Playground montrant les API Cloud Natural Language sélectionnées.

  1. Si nécessaire, connectez-vous à votre compte Google, puis cliquez sur Autoriser pour obtenir un code d'autorisation.
  2. Cliquez sur Exchange authorization code for tokens (Échanger le code d'autorisation contre des jetons).

Volet "Exchange authorization code for tokens" (Échanger le code d'autorisation contre des jetons) à partir duquel vous pouvez cliquer sur "Exchange authorization code for tokens".

Vous pouvez maintenant envoyer une requête à l'API.

  1. Cliquez sur Lister les opérations possibles pour examiner tous les appels d'API possibles.

Vous avez précédemment ouvert la page d'informations sur le document analyzeEntities de l'API Natural Language. Vous pouvez donc voir que l'URL de la requête HTTP est la suivante :

https://language.googleapis.com/v1beta2/documents:analyzeEntities

Il s'agit d'une requête POST.

Le volet "Configurer la requête d'API" vous permet de sélectionner la méthode HTTP, d'enregistrer l'URI de la requête, de saisir le corps de la requête et d'envoyer la requête.

  1. Saisissez les informations de l'URI de la requête et ajoutez un corps de requête.

Vous pouvez utiliser le même corps que celui utilisé dans APIs Explorer.

Volet du corps de la requête.

  1. Cliquez sur Fermer > Envoyer la demande.

Vous devriez obtenir des résultats semblables à ceux de cette image :

Volet "Requête/Réponse OAuth 2.0" après l'envoi de la requête.

N'hésitez pas à tester d'autres API dans OAuth 2.0 Playground.

5. Effectuer un nettoyage

Il est déconseillé d'utiliser une clé API sans restriction pour les projets. Si une personne y a accès, elle peut l'utiliser sans avoir besoin de s'authentifier.

Pour supprimer cette clé API :

  1. Cliquez sur f6b6844bf5688982.png Menu de navigation > API et services > Identifiants.
  2. Sous Clés API, sélectionnez la clé à supprimer, puis cliquez sur 247adf2e1d1eae4b.png.
  3. De même, plutôt que de vous inquiéter de la protection de la clé privée de votre compte de service, sous Comptes de service, sélectionnez le compte de service à supprimer, puis cliquez sur 247adf2e1d1eae4b.png.

6. Félicitations

Félicitations ! Vous avez appris à rechercher et à sélectionner des API Google, et à afficher leurs métriques.