Configurare l'accesso all'API Google Cloud Search

Prima di poter accedere all'API Google Cloud Search, devi configurare usare questa API direttamente o tramite un SDK. 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 è la base per creare, abilitare e utilizzare tutte le funzionalità di Google Cloud, tra cui la gestione delle API, l'abilitazione della fatturazione, l'aggiunta rimuovere collaboratori e gestire le autorizzazioni.

  1. Apri la console Google Cloud.

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

  3. Fai clic su NUOVO PROGETTO. Il "Nuovo progetto" viene visualizzata la schermata iniziale.

  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 è cambiato dopo la creazione del progetto, quindi scegli ID che soddisfa 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 vengono create in pochi minuti.

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

2. Abilita l'API

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

  1. Per assicurarti di trovarti nel progetto appena creato, fai clic sull'icona a destra di Banner della console Google Cloud e seleziona il progetto appena creato.
  2. Fai clic su ABILITA API E SERVIZI. Il riquadro "Welcome to API Library" (Ti diamo il benvenuto nella libreria API) pagina .
  3. Vai all'API Google Cloud Search.
  4. Fai clic su Abilita. La scheda "Panoramica" .

Per ulteriori informazioni sull'abilitazione e la disabilitazione delle API, consulta Gestisci 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 Credenziale.
  2. Nell'elenco a discesa Crea credenziali, seleziona Account di servizio. La "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. Un campo "Autorizzazioni account di servizio" viene visualizzata la schermata iniziale.
  6. Fai clic su Continua. Un'opzione "Concedi agli utenti l'accesso a questo account di servizio" schermata .
  7. Fai clic su CREA CHIAVE e poi su Fine. Una "Chiave privata salvata sul tuo computer" e una copia della chiave privata viene scaricata sul tuo 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. 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, nella sezione "ID account di servizio", prendi nota dell'email generata che identifica l'account di servizio che hai configurato. Questo indirizzo email che 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 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 impostazioni le credenziali dell'applicazione. Per istruzioni su come creare un'applicazione web le credenziali, consulta Crea le credenziali. Una volta completato questo passaggio, dovresti avere un ID cliente e un file client secret.

  2. Utilizza le funzionalità di Il parco giochi OAuth 2 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 in 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. Usa operations.get per verificare che il supporto di terze parti viene 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, 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, come Microsoft® SharePoint®, devi creare un'origine dati. Per istruzioni su aggiungi un'origine dati, consulta Aggiungi un'origine dati per la ricerca.

  2. Dopo aver configurato l'origine dati, puoi crea e registra lo schema per identificare il modo in cui Google Cloud Search dovrebbe rappresentare i dati nel repository.