Configura un datastore Google Workspace Calendar

Questa pagina descrive come creare un datastore e connettere Google Calendar a Gemini Enterprise.

Prima di iniziare

  • Accedi alla console Google Cloud con lo stesso account che utilizzi per l'istanza di Google Workspace che prevedi di connettere. Vertex AI Search utilizza l'ID cliente Google Workspace per connettersi a Google Calendar.

  • Per applicare il controllo dell'accesso all'origine dati e proteggere i dati in Gemini Enterprise, assicurati di aver configurato il tuo provider di identità.

  • Prima di aggiungere azioni al datastore Google Calendar, un Google Cloud amministratore deve completare i passaggi descritti nella sezione Configurare l'autenticazione e le autorizzazioni per Google Calendar per configurare l'autenticazione OAuth 2.0 in modo da fornirti l'ID client e il client secret e per configurare gli ambiti.

Crea il datastore Google Calendar

Per creare il datastore Google Calendar, svolgi i seguenti passaggi:

  1. Nella console Google Google Cloud , vai alla pagina Gemini Enterprise. Gemini Enterprise

  2. Seleziona o crea un Google Cloud progetto.

  3. Nel menu di navigazione, fai clic su Datastore.

  4. Fai clic su Crea datastore.

  5. In Origine, cerca Google Calendar e fai clic su Seleziona.

  6. Nella sezione Azioni:

    1. Inserisci l'ID client e il client secret ottenuti dall'applicazione OAuth 2.0, quindi fai clic su Verifica autenticazione.

      Per saperne di più, vedi Creare le credenziali client OAuth. Per gli ambiti richiesti per la ricerca e le azioni, vedi Ambiti obbligatori.

    2. (Facoltativo) Espandi Impostazioni avanzate e inserisci il nome del servizio, il nome della risorsa del servizio creato in Service Directory all'interno del tuo progetto Google Cloud . Questo campo è obbligatorio quando i Controlli di servizio VPC sono abilitati.

    3. Scegli le azioni dall'elenco per attivarle per il connettore Google Calendar.

    Per visualizzare l'elenco delle azioni, vedi Visualizzare le azioni.

  7. Fai clic su Continua.

  8. Nella sezione Configurazione:

    1. Dall'elenco Multiregionale, seleziona la posizione per il connettore dati.
    2. Nel campo Nome connettore dati, inserisci un nome per il connettore.
    3. Se hai selezionato US o EU come posizione, configura le impostazioni di crittografia:
      • Seleziona Chiave di crittografia gestita daGoogle o Chiave Cloud KMS.
      • Se hai selezionato Chiave Cloud KMS:
        • Nell'elenco Tipo di gestione delle chiavi, seleziona il tipo appropriato.
        • Nell'elenco Chiave Cloud KMS, seleziona la chiave.
      Per saperne di più, vedi Chiavi di crittografia gestite dal cliente.

  9. Fai clic su Continua.

  10. Nella sezione Fatturazione, seleziona Prezzi generali o Prezzi configurabili. Per saperne di più, consulta Verifica lo stato di fatturazione dei progetti e Licenze.

  11. Fai clic su Crea. Gemini Enterprise crea il datastore e mostra i datastore nella pagina Data Stores (Datastore).

Nella pagina Datastore, fai clic sul nome del datastore per visualizzarne lo stato. Quando lo stato del datastore passa da Creazione ad Attivo, il Google connettore di Calendar è pronto per essere utilizzato.

Dopo aver creato il datastore, crea un'app e collegala al datastore Google Calendar prima di eseguire la query.

Esecuzione delle query

Dopo aver autorizzato Google Calendar, quando inserisci una query di ricerca:

  1. Gemini Enterprise invia la query di ricerca all'API Google Calendar.

  2. Gemini Enterprise combina i risultati con quelli di altre fonti e li visualizza.

Messaggi di errore e risoluzione dei problemi

La tabella seguente descrive i messaggi di errore, inclusi i codici di errore HTTP e i passaggi consigliati per la risoluzione dei problemi, che potresti riscontrare quando utilizzi questa origine dati Google .

Codice di errore Messaggio di errore Descrizione Risoluzione dei problemi
403 Autorizzazione negata La ricerca utilizzando le credenziali del service account non è supportata per i datastore Google Workspace. Il motore in cui viene eseguita la ricerca dispone di datastore Google Workspace e le credenziali trasmesse sono di un service account. La ricerca utilizzando le credenziali dell'account di servizio nei datastore di Google Workspace non è supportata. Chiama la ricerca utilizzando le credenziali utente o rimuovi i datastore di Google Workspace dal motore.
403 Autorizzazione negata Gli account consumer non sono supportati per i datastore Google Workspace. La ricerca viene chiamata utilizzando una credenziale di account consumer (@gmail.com), che non è supportata per i datastore Google Workspace. Rimuovi i datastore di Google Workspace dal motore o utilizza un Account Google gestito. Google
403 Autorizzazione negata ID cliente non corrispondente per il datastore La ricerca è consentita solo agli utenti che appartengono alla stessa organizzazione dei datastore di Google Workspace. Rimuovi i datastore di Google Workspace dal motore o contatta l'assistenza se l'utente e i datastore di Google Workspace devono trovarsi in organizzazioni diverse.
403 Autorizzazione negata L'accesso a Workspace per Agentspace è stato disattivato dall'amministratore dell'organizzazione. Un amministratore di Google Workspace ha disattivato l'accesso ai dati di Google Workspace per Gemini Enterprise. Contatta l'amministratore di Google Workspace per [attivare l'accesso](https://support.google.com/a/answer/16479199).

Passaggi successivi