Configurare l'accesso all'API Google Cloud Search

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

1. Crea un progetto API

Per abilitare l'API, crea prima un progetto Google Cloud. Questo progetto è la base per utilizzare i servizi Google Cloud, gestire le API e impostare le autorizzazioni.

1. Apri la console Google Cloud.
2. Fai clic sul menu a discesa del progetto a destra di "Console Google Cloud" e seleziona NUOVO PROGETTO.
3. Inserisci un nome nel campo Nome progetto.
4. (Facoltativo) Fai clic su Modifica per modificare l'ID progetto. Non puoi modificare questo ID dopo la creazione.
5. Fai clic su SFOGLIA per scegliere una località, quindi fai clic su Seleziona.
6. Fai clic su Crea. Il progetto è in genere pronto in pochi minuti.

Per saperne di più, consulta Creare e gestire progetti.

2. Abilita l'API

Abilita l'API Cloud Search e crea un account di servizio per ottenere le credenziali.

1. Seleziona il nuovo progetto dal menu a discesa nel banner della console Google Cloud.
2. Fai clic su ABILITA API E SERVIZI.
3. Cerca e seleziona l' API Google Cloud Search.
4. Fai clic su Abilita.

Per saperne di più, 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 navigazione a sinistra.
2. Seleziona Service account dal menu a discesa Crea credenziali.
3. Inserisci un nome nel campo Nome service account.
4. (Facoltativo) Modifica l'ID del service account.
5. Fai clic su Crea e continua.
6. Fai clic su Fine per visualizzare l'elenco "Service account".
7. Fai clic sull'indirizzo email del nuovo service account, quindi seleziona la scheda Chiavi.
8. Fai clic su AGGIUNGI CHIAVE > Crea nuova chiave.
9. Seleziona JSON e fai clic su Crea. La chiave privata viene scaricata sul computer.

Per saperne di più, consulta Service account.

4. Identifica l'indirizzo email del service account

1. Nella console Google Cloud, seleziona il tuo progetto.
2. Fai clic su Menu di navigazione > IAM e amministrazione > Service account.
3. Prendi nota dell'indirizzo email del service account. Ti servirà per aggiungere un'origine dati a Cloud Search.

5. Inizializza il supporto di terze parti

Inizializza il supporto di terze parti per Google Cloud Search prima di chiamare altre API Cloud Search.

Per inizializzare il supporto di terze parti:

1. Crea le credenziali dell'applicazione web nel progetto della piattaforma Cloud Search. Consulta Creare le credenziali. Ti servono l'ID client e il client secret.
2. Ottieni un token di accesso utilizzando il OAuth 2.0 Playground:
   1. Fai clic su Configurazione OAuth 2.0 (icona delle impostazioni) e seleziona Utilizza le tue credenziali OAuth.
   2. Inserisci l'ID client e il client secret.
   3. Nel campo degli ambiti, inserisci https://www.googleapis.com/auth/cloud_search.settings e fai clic su Autorizza API.
   4. Fai clic su Scambia codice di autorizzazione per i token.

3. Esegui questo comando curl, sostituendo [YOUR_ACCESS_TOKEN] con il tuo token:

   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
   

   Se l'operazione va a buon fine, il corpo della risposta include un operation. In caso contrario, contatta l'assistenza di Cloud Search.

4. Utilizza operations.get per verificare l'inizializzazione:

   curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
   --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
   --header 'Accept: application/json' \
   --compressed
   

   L'inizializzazione è completa quando done è true.

Passaggi successivi

1. Per utilizzare Cloud Search con un repository non Google, ad esempio Microsoft® SharePoint®, devi creare un'origine dati. Consulta Aggiungere un'origine dati per la ricerca.
2. Dopo aver configurato l'origine dati, crea e registra uno schema. per identificare il modo in cui Cloud Search rappresenta i dati. il modo in cui Cloud Search dovrebbe rappresentare i dati.