Aggiungere il widget di ricerca a una pagina web

Questa pagina descrive come aggiungere la funzionalità di ricerca a un sito web utilizzando il widget di ricerca.

Prima di iniziare

Prima di aggiungere un widget di ricerca alla tua pagina web, assicurati di configurarlo, iniziando da Configurare i risultati per il widget di ricerca. Tieni presente che non è possibile modificare lo stile del widget di ricerca nella pagina web.

Procedure

La procedura per aggiungere il widget di ricerca alla tua pagina web varia a seconda del tipo di autorizzazione scelto:

• Token di autorizzazione: il widget utilizza un token JWT o OAuth fornito dal codebase. Devi avere un tuo server che puoi utilizzare per generare un token. Il token di autenticazione viene utilizzato per effettuare una chiamata API per conto dell'account utente o di servizio. Quando generi il token di autorizzazione, utilizza l'ambito OAuthhttps://www.googleapis.com/auth/cloud-platform.

  • Per le interazioni server-to-server con gli account di servizio: consulta Utilizzo di OAuth 2.0 per applicazioni da server a server nella documentazione sull'autorizzazione.

  • Per le applicazioni web JavaScript: consulta OAuth 2.0 per applicazioni web lato client nella documentazione sull'autorizzazione.

  Nota: se hai selezionato un pool di personale per controllare l'accesso ai dati della tua app, ottieni token di breve durata per la federazione delle identità della forza lavoro.

• Accesso pubblico: il widget non limiterà gli utenti che possono ottenere risultati da una query di ricerca.

Aggiungere un widget che utilizza un token di autorizzazione

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

2. Fai clic sul nome dell'app da modificare.

3. Fai clic su Integration (Integrazione).

4. Fai clic sulla scheda Widget.

5. Seleziona Basato su JWT o OAuth come tipo di autorizzazione del widget.

6. Specifica il nome di dominio della pagina del widget:

   1. Inserisci il nome di dominio della pagina in cui verrà visualizzato il widget.

      Ad esempio, se vuoi copiare il widget nelle pagine example.com/ai.html e cymbal.example.com/search.html, inserisci example.com come dominio. Se vuoi che il widget funzioni solo su una pagina nel sottodominio, inserisci cymbal.example.com.

      Se vuoi testare il widget su localhost, inserisci localhost.

   2. Fai clic su Aggiungi.

7. Ripeti il passaggio 6 per ogni dominio in cui verrà visualizzato il widget.

8. Fai clic su Salva.

9. Copia lo snippet di codice fornito nella sezione Copia il seguente codice nella tua applicazione web.

10. Nel codebase, genera un token di autorizzazione.

    Nota: se hai selezionato un pool di personale per controllare l'accesso ai dati della tua app, ottieni token di breve durata per la federazione delle identità della forza lavoro.

11. Per passare il token di autorizzazione al widget, utilizza il secondo snippet di codice "// Set authorization token" fornito nella sezione Copia il seguente codice nella tua applicazione web e sostituisci il testo <JWT or OAuth token provided by you backend> con il token di autorizzazione.

12. Imposta periodicamente un token nuovo ripetendo il passaggio precedente prima che scada il token corrente.

Aggiungere un widget con accesso pubblico

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

2. Fai clic sul nome dell'app da modificare.

   Per l'accesso pubblico, assicurati che l'app di ricerca non sia associata a nessun datastore sottoposto a controllo dell'accesso.

3. Fai clic su Integration (Integrazione).

4. Fai clic sulla scheda Widget.

5. Seleziona Accesso pubblico come tipo di autorizzazione del widget.

6. Specifica il nome di dominio per la pagina del widget:

   1. Inserisci il nome di dominio della pagina in cui verrà visualizzato il widget.

      Ad esempio, se vuoi copiare il widget nelle pagine example.com/ai.html e cymbal.example.com/search.html, inserisci example.com come dominio. Se vuoi che il widget funzioni solo nelle pagine nel sottodominio, inserisci cymbal.example.com.

      Se vuoi testare il widget su localhost, inserisci localhost.

   2. Fai clic su Aggiungi.

7. Ripeti il passaggio 6 per ogni dominio in cui verrà visualizzato il widget.

8. Fai clic su Salva.

9. Copia lo snippet di codice fornito nella sezione Copia il seguente codice nella tua applicazione web e incollalo nella pagina web.