Configurare l'accesso all'API Google Cloud Search

Devi configurare l'accesso all'API Google Cloud Search prima di utilizzarla direttamente o tramite un SDK. Questo documento descrive 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à, poi fai clic su Seleziona.
  6. Fai clic su Crea. Il progetto è in genere pronto in pochi minuti.

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

2. Abilita l'API

Attiva l'API Cloud Search e crea un service account 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ù, vedi 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.
  2. Seleziona Service account dal menu a discesa Crea credenziali.
  3. Inserisci un nome nel campo Nome service account.
  4. (Facoltativo) Modifica l'ID service account.
  5. Fai clic su Crea e continua.
  6. Fai clic su Fine per raggiungere 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'email del service account

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

5. Inizializzare l'assistenza di terze parti

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

Per inizializzare l'assistenza di terze parti:

  1. Crea le credenziali dell'applicazione web nel progetto della piattaforma Cloud Search. Vedi Crea credenziali. Ti servono l'ID client e il client secret.
  2. Ottieni un token di accesso utilizzando 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 Exchange authorization code for tokens (Scambio 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
    

    In caso di esito positivo, il corpo della risposta include un operation. Se non va a buon fine, contatta l'assistenza 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 è completata quando done è true.

Passaggi successivi

  1. Per utilizzare Cloud Search con un repository non Google come Microsoft® SharePoint®, devi creare un'origine dati. Vedi 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 tuoi dati.