Configurare l'accesso all'API Google Cloud Search

Devi configurare l'accesso all'API Google Cloud Search prima di poter utilizzare questa API direttamente o tramite un SDK. Questo documento descrive 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 costituisce la base per la creazione, l'abilitazione e l'utilizzo di tutti i servizi Google Cloud, tra cui la gestione delle API, l'abilitazione 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 a destra di "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 tutta la 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 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 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'abilitazione e la disabilitazione delle API, consulta Gestire le API nella console Google Cloud

3. Crea le credenziali dell'account di servizio

  1. Nella console Google Cloud, fai clic su Credenziali nel menu 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 tuo computer" e una copia dei download della chiave privata sul tuo computer.
  8. Fai clic su Chiudi.

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

4. Identifica l'indirizzo email

  1. Dalla 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 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 l'assistenza di terze parti, devi creare credenziali per applicazioni web. Per istruzioni su come creare le credenziali per applicazioni web, consulta Creare credenziali. Una volta completato questo passaggio, dovresti avere un ID client e un file client secret.

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

    1. Fai clic su Impostazioni e seleziona Utilizza le tue credenziali di autorizzazione.
    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. Il parco giochi 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"
}

    Se l'operazione non va a buon fine, 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

    Quando l'inizializzazione di terze parti è completa, contiene il campo done impostato su true. Ad esempio:

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

Passaggi successivi

Di seguito sono riportati alcuni passaggi che potresti eseguire:

  1. Se prevedi di utilizzare Google Cloud Search con un repository di dati non Google, come Microsoft® SharePoint®, devi creare un'origine dati. Per istruzioni sull'aggiunta di un'origine dati, consulta Aggiungere un'origine dati alla ricerca.

  2. Una volta configurata l'origine dati, puoi creare e registrare uno schema per identificare in che modo Google Cloud Search deve rappresentare i dati nel repository.