Ajouter le widget Recherche à une page Web

Cette page explique comment ajouter une fonctionnalité de recherche à un site Web à l'aide du widget de recherche.

Avant de commencer

Avant d'ajouter un widget de recherche à votre page Web, assurez-vous de le configurer, en commençant par Configurer les résultats du widget de recherche. Notez qu'il n'est pas possible d'ajuster le style du widget de recherche sur votre page Web.

Procédures

La procédure d'ajout du widget Recherche à votre page Web diffère en fonction de le type d'autorisation choisi:

• Jeton d'autorisation: le widget utilise un jeton JWT ou OAuth fourni par votre codebase. Vous devez disposer de votre propre serveur pour générer un jeton. Le jeton d'autorisation permet d'effectuer un appel d'API au nom de l'utilisateur ou du compte de service. Lors de la génération du jeton d'authentification, utilisez le champ d'application OAuth https://www.googleapis.com/auth/cloud-platform

  • Pour les interactions de serveur à serveur avec des comptes de service : consultez Utiliser OAuth 2.0 pour les applications de serveur à serveur dans la documentation sur l'autorisation.

  • Pour les applications Web JavaScript:consultez la page OAuth 2.0 pour l'authentification Web côté client Applications dans la documentation sur les autorisations.

  Remarque :Si vous avez sélectionné un pool d'employés pour contrôler l'accès aux données de votre application, puis obtenir des jetons de courte durée pour l'identité des employés fédération.

• Accès public : le widget n'applique pas de restriction concernant les personnes pouvant obtenir les résultats d'une requête de recherche.

Ajouter un widget qui utilise un jeton d'autorisation

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Cliquez sur le nom de l'application que vous souhaitez modifier.

3. Cliquez sur Integration (Intégration).

4. Cliquez sur l'onglet Widget.

5. Sélectionnez le type d'autorisation de widget Basé sur JWT ou OAuth.

6. Indiquez le nom de domaine de la page de widgets:

   1. Saisissez le nom de domaine de la page sur laquelle le widget s'affichera.

      Par exemple, si vous copiez le widget dans les pages example.com/ai.html et cymbal.example.com/search.html, saisissez example.com. Si vous ne souhaitez que le widget fonctionne sur une page du sous-domaine, saisissez cymbal.example.com.

      Si vous souhaitez tester le widget sur votre localhost, saisissez localhost.

   2. Cliquez sur Ajouter.

7. Répétez l'étape 6 pour chaque domaine où le widget doit apparaître.

8. Cliquez sur Enregistrer.

9. Copiez l'extrait de code fourni dans la section Copiez le code suivant dans votre application Web.

10. Dans votre codebase, générez un jeton d'autorisation.

    Remarque : Si vous avez sélectionné un pool de personnel pour contrôler l'accès aux données de votre application, obtenez des jetons de courte durée pour la fédération d'identité de personnel.

11. Pour transmettre le jeton d'autorisation à votre widget, utilisez le deuxième extrait de code, "// Set authorization token", fourni dans la section Copier le code suivant dans votre application Web et remplacez le texte <JWT or OAuth token provided by you backend> par votre jeton d'autorisation.

12. Configurez régulièrement un nouveau jeton en répétant l'étape précédente avant la le jeton actuel expire.

Ajouter un widget accessible au public

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Cliquez sur le nom de l'application que vous souhaitez modifier.

3. Cliquez sur Integration (Intégration).

4. Cliquez sur l'onglet Widget.

5. Sélectionnez Accès public comme type d'autorisation de widget.

6. Spécifiez le nom de domaine de la page du widget :

   1. Saisissez le nom de domaine de la page sur laquelle le widget s'affichera.

      Par exemple, si vous copiez le widget dans les pages example.com/ai.html et cymbal.example.com/search.html, saisissez example.com. Si vous souhaitez que le widget ne fonctionne que sur les pages dans le sous-domaine, saisissez cymbal.example.com.

      Si vous souhaitez tester le widget sur votre localhost, saisissez localhost.

   2. Cliquez sur Ajouter.

7. Répétez l'étape 6 pour chaque domaine où le widget doit apparaître.

8. Cliquez sur Enregistrer.

9. Copiez l'extrait de code fourni dans la section Copier le code suivant dans votre application Web, puis collez-le dans votre page Web.