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

Pour pouvoir utiliser l'API Google Cloud Search, vous devez configurer l'accès à celle-ci soit directement, soit via un SDK. Ce document décrit les étapes requises pour l'API REST Cloud Search.

1. Créer un projet d'API

Pour activer l'API, commencez par créer un projet Google Cloud. Ce projet est la base pour utiliser les services Google Cloud, gérer les API et définir les autorisations.

  1. Ouvrez Google Cloud Console.
  2. Cliquez sur la liste déroulante du projet à droite de "Console Google Cloud", 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 pas modifier cet ID une fois la campagne créée.
  5. Cliquez sur PARCOURIR pour choisir un emplacement, puis sur Sélectionner.
  6. Cliquez sur Créer. Le projet est généralement prêt en quelques minutes.

Pour en savoir plus, consultez 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 de la console Google Cloud.
  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 Gérer les API dans la console Google Cloud.

3. Créer les identifiants du compte de service

  1. Dans la console Google Cloud, cliquez sur Identifiants dans le menu de navigation de 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 OK pour accéder à la liste des 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

Activez 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 avez 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 OAuth 2.0 Configuration (Configuration OAuth 2.0, icône en forme de roue dentée), puis cochez Use your own OAuth credentials (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 Exchange authorization code for tokens (É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. Si la requête échoue, 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 indiquer comment Cloud Search doit représenter les données.