Vous devez configurer l'accès à l'API Google Cloud Search avant de pouvoir utilisez cette API soit directement, soit via un SDK. Ce document décrit la procédure à suivre pour utiliser l'API REST Google Cloud Search.
1. Créer un projet d'API
Pour activer l'API, vous devez d'abord créer un projet Google Cloud. Ce permet de créer, d'activer et d'utiliser toutes les ressources des services, y compris la gestion des API, l'activation de la facturation, l'ajout et supprimer des collaborateurs et gérer les autorisations.
Ouvrez Google Cloud Console.
En haut de la page, cliquez sur
à droite de "Console Google Cloud". Boîte de dialogue répertoriant les projets en cours s'affiche.Cliquez sur NOUVEAU PROJET. Le "Nouveau projet" s'affiche.
Saisissez un nom de projet dans le champ Project Name (Nom du projet).
(Facultatif) Cliquez sur Modifier pour modifier l'ID du projet. L'ID du projet ne peut pas être modifiées après la création du projet. Par conséquent, choisissez ID qui répond à vos besoins pour toute la durée de vie du projet.
Pour parcourir les emplacements associés au projet, cliquez sur PARCOURIR.
Cliquez sur un emplacement pour votre projet, puis sur Sélectionner.
Cliquez sur Créer. La console permet d'accéder à la page "Tableau de bord". Le projet est créée en quelques minutes.
Pour en savoir plus sur la création et la gestion de projets, consultez Créer et gérer des projets
2. Activer l'API
Vous devez activer l'API Google Cloud Search et créer un compte de service pour : obtenir des identifiants.
- Pour vérifier que vous êtes bien dans le projet que vous venez de créer, cliquez sur L'icône à droite de Bannière de la console Google Cloud, puis sélectionnez le projet que vous venez de créer.
- Cliquez sur ACTIVER DES API ET DES SERVICES. La page "Bienvenue dans la bibliothèque d'API" page s'affiche.
- Accédez à l'API Google Cloud Search.
- Cliquez sur Activer. La page "Vue d'ensemble" s'affiche.
Pour en savoir plus sur l'activation et la désactivation des API, consultez Gérer les API dans la console Google Cloud
3. Créer les identifiants du compte de service
- Dans la console Google Cloud : Cliquez sur Identifiants dans le panneau de navigation de gauche. La page "Identifiants" s'affiche.
- Dans la liste déroulante Créer des identifiants, sélectionnez Compte de service : La "Créer un compte de service" s'affiche.
- Saisissez un nom dans le champ Nom du compte de service.
- (Facultatif) Modifiez l'ID du compte de service.
- Cliquez sur Créer. Une "Autorisations de compte de service" s'affiche.
- Cliquez sur Continuer. Une option "Autoriser les utilisateurs à accéder à ce compte de service" écran s'affiche.
- Cliquez sur CRÉER UNE CLÉ, puis sur OK. Une "clé privée enregistrée dans votre ordinateur" et une copie de la clé privée est téléchargée ordinateur.
- Cliquez sur Fermer.
Pour en savoir plus sur les comptes de service, consultez Comptes de service, applications Web et applications installées
4. Identifier l'adresse e-mail
- Depuis la console Google Cloud, sélectionnez le projet que vous avez créé en haut de la page.
- Cliquez sur le menu de navigation à gauche de la bannière de la console Google Cloud.
- Cliquez sur IAM et administration > Comptes de service :
- Dans la liste, sous "ID de compte de service", notez l'e-mail généré qui identifie le compte de service que vous avez configuré. Cette adresse e-mail est utilisé lors de l'ajout d'une source de données à Cloud Search.
5. Initialiser la compatibilité tierce
Avant de pouvoir appeler d'autres API Cloud Search, vous devez initialiser des API tierces de Google Cloud Search.
Pour initialiser la compatibilité tierce avec Cloud Search:
Votre projet Cloud Search Platform contient les identifiants du compte de service. Toutefois, pour initialiser la prise en charge tierce, vous devez créer des métriques les identifiants de l'application. Pour obtenir des instructions sur la création d'une application Web les identifiants, consultez Créez des identifiants. Une fois cette étape terminée, vous devez disposer d'un fichier d'ID client et de code secret du client.
Utilisez OAuth 2 Playground de Google pour obtenir un jeton d'accès:
- Cliquez sur "Paramètres", puis cochez la case Utilisez vos propres identifiants d'authentification.
- Saisissez l'ID client et le code secret du client de l'étape 1.
- Cliquez sur Fermer.
- Dans le champ "Champs d'application", saisissez
https://www.googleapis.com/auth/cloud_search.settings
. puis cliquez sur Autoriser. OAuth 2 Playground renvoie un code d'autorisation. - Cliquez sur Exchange authorization code for tokens (Échanger le code d'autorisation contre des jetons). Un jeton est renvoyé.
Pour initialiser la compatibilité tierce avec Cloud Search, utilisez la commande curl suivante . Veillez à remplacer
[YOUR_ACCESS_TOKEN]
par le jeton obtenu dans Étape 2.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 contient une instance d'
operation
. Exemple :{ name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY" }
En cas d'échec, contactez l'assistance Cloud Search.
Utilisez la méthode operations.get pour vérifier que la prise en charge tierce est initialisée:
curl \ 'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key= [YOUR_API_KEY]' \ --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \ --header 'Accept: application/json' \ --compressed
Lorsque l'initialisation du service tiers est terminée, champ
done
défini surtrue
. Exemple :{ name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY" done: true }
Étapes suivantes
Voici les prochaines étapes que vous pouvez suivre:
Si vous envisagez d'utiliser Google Cloud Search avec un référentiel de données autre que Google, Microsoft® SharePoint®, par exemple, doit créer une source de données. Pour obtenir des instructions ajouter une source de données, reportez-vous Ajoutez une source de données pour la recherche.
Une fois votre source de données configurée, vous pouvez créer et enregistrer un schéma pour identifier comment Google Cloud Search devrait représenter les données du référentiel.