Configurare l'accesso all'API Google Cloud Search

Devi configurare l'accesso all'API Google Cloud Search prima di poterla utilizzare direttamente o tramite un SDK. Questo documento illustra i passaggi necessari per utilizzare l'API REST di Google Cloud Search.

1. Creare un progetto API

Per attivare l'API, devi prima creare un progetto Google Cloud. Questo progetto costituisce la base per creare, abilitare e utilizzare tutti i servizi Google Cloud, tra cui la gestione delle API, l'attivazione della fatturazione, l'aggiunta e la rimozione di collaboratori e la gestione delle autorizzazioni.

  1. Apri la console Google Cloud.

  2. Nella parte superiore della pagina, fai clic su accanto a "Console Google Cloud". Viene visualizzata una finestra di dialogo che elenca i progetti attuali.

  3. Fai clic su NUOVO PROGETTO. Viene visualizzata la schermata "Nuovo progetto".

  4. Inserisci un nome per il progetto nel campo Nome progetto.

  5. (Facoltativo) Fai clic su Modifica per modificare l'ID progetto. L'ID progetto non può essere modificato dopo la creazione del progetto, quindi scegli un ID che soddisfi le tue esigenze per l'intera durata del progetto.

  6. Per sfogliare le località del progetto, fai clic su SFOGLIA.

  7. Fai clic su una località per il progetto e poi su Seleziona.

  8. Fai clic su Crea. La console passa alla pagina Dashboard. Il progetto viene creato entro pochi minuti.

Per ulteriori informazioni sulla creazione e sulla gestione dei progetti, consulta la pagina Creare e gestire progetti.

2. Abilita l'API

Devi attivare l'API Google Cloud Search e creare un account di servizio per ottenere le credenziali.

  1. Per assicurarti di essere nel progetto appena creato, fai clic sull'icona a destra del banner della console Google Cloud e seleziona il progetto appena creato.
  2. Fai clic su ABILITA API E SERVIZI. Viene visualizzata la pagina "Ti diamo il benvenuto nella Libreria API".
  3. Vai all'API Google Cloud Search.
  4. Fai clic su Abilita. Viene visualizzata la pagina "Panoramica".

Per ulteriori informazioni sull'attivazione e la disattivazione delle API, consulta Gestire le API nella console Google Cloud

3. Crea le credenziali del service account

  1. Nella console Google Cloud, fai clic su Credenziali nel riquadro di navigazione a sinistra. Viene visualizzata la pagina delle credenziali.
  2. Nell'elenco a discesa Crea credenziali, seleziona Account di servizio. Viene visualizzata la pagina "Crea account di servizio".
  3. Inserisci un nome nel campo Nome account di servizio.
  4. (Facoltativo) Modifica l'ID account di servizio.
  5. Fai clic su Crea. Viene visualizzata la schermata "Autorizzazioni account di servizio".
  6. Fai clic su Continua. Viene visualizzata la schermata "Concedi agli utenti l'accesso a questo account di servizio".
  7. Fai clic su CREA CHIAVE e poi su Fine. Viene visualizzata la finestra di dialogo "Chiave privata salvata nel computer" e una copia della chiave privata viene scaricata sul computer.
  8. Fai clic su Chiudi.

Per ulteriori informazioni sugli account di servizio, consulta Account di servizio, applicazioni web e applicazioni installate

4. Identificare l'indirizzo email

  1. Nella console Google Cloud, seleziona il progetto che hai creato nella parte superiore della pagina.
  2. Fai clic sul menu di navigazione a sinistra del banner della console Google Cloud.
  3. Fai clic su IAM e amministrazione > Account di servizio.
  4. Nell'elenco, in "ID account di servizio", prendi nota dell'indirizzo email generato che identifica l'account di servizio che hai configurato. Questo indirizzo email viene utilizzato per aggiungere un'origine dati a Cloud Search.

5. Inizializzare l'assistenza di terze parti

Prima di poter chiamare altre API Cloud Search, devi inizializzare il supporto di terze parti per Google Cloud Search.

Per inizializzare il supporto di terze parti per Cloud Search:

  1. Il progetto della piattaforma Cloud Search contiene le credenziali dell'account di servizio. Tuttavia, per inizializzare il supporto di terze parti, devi creare le credenziali dell'applicazione web. Per istruzioni su come creare le credenziali per le applicazioni web, consulta Creare le credenziali. Al termine di questo passaggio, dovresti avere un file ID client e un file client secret.

  2. Utilizza OAuth 2 Playground di Google per ottenere un token di accesso:

    1. Fai clic su Impostazioni e seleziona Utilizza le tue credenziali di autenticazione.
    2. Inserisci l'ID client e il client secret del passaggio 1.
    3. Fai clic su Chiudi.
    4. Nel campo degli ambiti, digita https://www.googleapis.com/auth/cloud_search.settings e fai clic su Autorizza. OAuth 2 Playground restituisce un codice di autorizzazione.
    5. Fai clic su Exchange authorization code for tokens (Scambia codice di autorizzazione per i token). Viene restituito un token.

  3. Per inizializzare il supporto di terze parti per Cloud Search, utilizza il seguente comando curl. Assicurati di sostituire [YOUR_ACCESS_TOKEN] con il token ottenuto nel passaggio 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

    In caso di esito positivo, il corpo della risposta contiene un'istanza di operation. Ad esempio:

    {
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
}

    Se non va a buon fine, contatta l'assistenza di Cloud Search.

  4. Utilizza operations.get per verificare che il supporto di terze parti sia stato inizializzato:

    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

    Al termine dell'inizializzazione di terze parti, contiene il campo done impostato su true. Ad esempio:

    {
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
done: true
}

Passaggi successivi

Ecco alcuni passaggi che potresti seguire:

  1. Se prevedi di utilizzare Ricerca Google Cloud con un repository di dati non Google, come Microsoft® SharePoint®, devi creare un'origine dati. Per istruzioni su come aggiungere un'origine dati, consulta Aggiungere un'origine dati per la ricerca.

  2. Dopo aver configurato l'origine dati, puoi creare e registrare uno schema per identificare come Google Cloud Search deve rappresentare i dati nel repository.