Configurer l'accès à l'API Google Cloud Search

Vous devez configurer l'accès à l'API Google Cloud Search avant de l'utiliser directement ou via un SDK. Ce document décrit les étapes requises pour l'API REST de l'API Cloud Search.

1. Créer un projet d'API

Pour activer l'API, créez d'abord un projet Google Cloud. Ce projet constitue la base de l'utilisation des services Google Cloud, de la gestion des API et de la définition des autorisations.

  1. Ouvrez la console Google Cloud.
  2. Cliquez sur la liste déroulante du projet à droite de "Google Cloud Console", puis sélectionnez NOUVEAU PROJET.
  3. Saisissez un nom dans le champ Nom du projet.
  4. (Facultatif) Cliquez sur Modifier pour modifier l'ID du projet. Vous ne pourrez plus modifier cet ID après sa création.
  5. Cliquez sur PARCOURIR pour choisir un emplacement, puis cliquez sur Sélectionner.
  6. Cliquez sur Créer. Le projet est généralement prêt en quelques minutes.

Pour en savoir plus, consultez la section Créer et gérer des projets.

2. Activer l'API

Activez l'API Cloud Search et créez un compte de service pour obtenir des identifiants.

  1. Sélectionnez votre nouveau projet dans le menu déroulant de la bannière Google Cloud Console.
  2. Cliquez sur ACTIVER DES API ET DES SERVICES.
  3. Recherchez et sélectionnez l' API Google Cloud Search.
  4. Cliquez sur Activer.

Pour en savoir plus, consultez la section Gérer les API dans Google Cloud Console.

3. Créer les identifiants du compte de service

  1. Dans la console Google Cloud, cliquez sur Identifiants dans le menu de navigation à gauche.
  2. Sélectionnez Compte de service dans le menu déroulant Créer des identifiants.
  3. Saisissez un nom dans le champ Nom du compte de service.
  4. (Facultatif) Modifiez l'ID du compte de service.
  5. Cliquez sur Créer et continuer.
  6. Cliquez sur Terminé pour accéder à la liste "Comptes de service".
  7. Cliquez sur l'adresse e-mail de votre nouveau compte de service, puis sélectionnez l'onglet Clés.
  8. Cliquez sur AJOUTER UNE CLÉ > Créer une clé.
  9. Sélectionnez JSON , puis cliquez sur Créer. La clé privée est téléchargée sur votre ordinateur.

Pour en savoir plus, consultez la page Comptes de service.

4. Identifier l'adresse e-mail du compte de service

  1. Dans la console Google Cloud, sélectionnez votre projet.
  2. Cliquez sur Menu de navigation > IAM et administration > Comptes de service.
  3. Notez l'adresse e-mail de votre compte de service. Vous en aurez besoin pour ajouter une source de données à Cloud Search.

5. Initialiser la compatibilité tierce

Initialisez la compatibilité tierce pour Google Cloud Search avant d'appeler d'autres API Cloud Search.

Pour initialiser la compatibilité tierce :

  1. Créez des identifiants d'application Web dans votre projet de plate-forme Cloud Search. Consultez Créer des identifiants. Vous aurez besoin de l'ID client et du code secret client.
  2. Obtenez un jeton d'accès à l'aide de OAuth 2.0 Playground :
    1. Cliquez sur Configuration OAuth 2.0 (icône Paramètres), puis cochez la case Utiliser vos propres identifiants OAuth.
    2. Saisissez votre ID client et votre code secret client.
    3. Dans le champ "Champs d'application", saisissez https://www.googleapis.com/auth/cloud_search.settings, puis cliquez sur Autoriser les API.
    4. Cliquez sur Échanger le code d'autorisation contre des jetons.

  3. Exécutez cette commande curl en remplaçant [YOUR_ACCESS_TOKEN] par votre jeton :

    curl --request POST \
'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

    Si la requête aboutit, le corps de la réponse inclut un operation. En cas d'échec, contactez l'assistance Cloud Search.

  4. Utilisez operations.get pour vérifier l'initialisation :

    curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    L'initialisation est terminée lorsque done est défini sur true.

Étapes suivantes

  1. Pour utiliser Cloud Search avec un dépôt non-Google, tel que Microsoft® SharePoint®, vous devez créer une source de données. Consultez Ajouter une source de données à la recherche.
  2. Après avoir configuré votre source de données, créez et enregistrez un schéma. pour identifier la façon dont Cloud Search représente vos données.