Configurare l'accesso all'API Google Cloud Search

Prima di poter utilizzare questa API direttamente o tramite un SDK, devi configurare l'accesso all'API Google Cloud Search. Questo documento illustra i passaggi necessari per utilizzare l'API REST dell'API Google Cloud Search.

1. Crea un progetto API

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

  1. Apri la console Google Cloud.

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

  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 tutta la durata del progetto.

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

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

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

Per ulteriori informazioni sulla creazione e la gestione dei progetti, consulta Creazione e gestione dei progetti.

2. Abilita l'API

Per ottenere le credenziali, devi abilitare l'API Google Cloud Search e creare un account di servizio.

  1. Per assicurarti di trovarti 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 saperne di più sull'abilitazione e la disabilitazione 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 nella barra di navigazione a sinistra. Viene visualizzata la pagina Credenziale.
  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 sul 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. Identifica 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, nella sezione "ID account di servizio", prendi nota dell'indirizzo email generato che identifica l'account di servizio che hai configurato. Questo indirizzo email viene utilizzato quando si aggiunge un'origine dati a Cloud Search.

5. Inizializzare l'assistenza di terze parti

Prima di poter chiamare qualsiasi altra 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 per l'applicazione web. Per istruzioni su come creare le credenziali dell'applicazione web, consulta la pagina Creare credenziali. Una volta completato questo passaggio, dovresti avere un ID cliente 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 Ambiti, digita https://www.googleapis.com/auth/cloud_search.settings e fai clic su Autorizza. Il Playground OAuth 2 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"
}

    In caso contrario, contatta l'assistenza di Cloud Search.

  4. Utilizza operations.get per verificare che il supporto di terze parti sia 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

    Una volta completata l'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 dei passaggi successivi che puoi eseguire:

  1. Se prevedi di utilizzare Google Cloud Search con un repository di dati non Google, ad esempio 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 in che modo Google Cloud Search dovrebbe rappresentare i dati nel repository.