Configurare l'API Google Chat

Ogni app Google Chat che crei richiede un proprio progetto Google Cloud con l'API Chat abilitata e configurata. Questa pagina mostra come configurare l'API Chat.

Prerequisiti

Configura l'API Chat

  1. Nella console Google Cloud, cerca "API Google Chat" e fai clic su API Google Chat, quindi fai clic su Gestisci.

    Vai all'API Chat

  2. Fai clic sulla scheda Configurazione e inserisci le seguenti informazioni richieste:

    • Nome app: il nome che le persone utilizzano quando interagiscono con l'app Chat.
    • URL avatar: un URL HTTPS che rimanda a un'immagine grafica quadrata (ad esempio, PNG o JPEG), di almeno 128 x 128, che appare come avatar per l'app Chat.
    • Descrizione: una descrizione dello scopo previsto dell'app Chat, visualizzata sotto il nome dell'app.

  3. Per attivare le funzionalità interattive, fai clic sull'opzione di attivazione/disattivazione Attiva le funzionalità interattive che consente agli utenti di interagire con l'app Chat e utilizza la tabella seguente per completare la configurazione:

    Campo Descrizione
    Funzionalità Un insieme di campi che determinano in che modo l'app di Chat può interagire con gli utenti:
    • Ricevere messaggi 1:1: gli utenti possono trovare e inviare messaggi all'app Chat direttamente in Google Chat.
    • Partecipare a spazi e conversazioni di gruppo: gli utenti possono aggiungere l'app Chat agli spazi e alle conversazioni di gruppo.
    Impostazioni di connessione L'endpoint per l'app Chat, che è uno dei seguenti:
    • URL app: un endpoint HTTPS che ospita l'implementazione dell'app Chat.
    • Progetto Apps Script: un ID deployment per un progetto Apps Script che implementa un'app di Chat.
    • Nome argomento Cloud Pub/Sub: un argomento Pub/Sub a cui l'app di Chat si abbona come endpoint.
    • Dialogflow: registra l'app Chat con un'integrazione Dialogflow. Per saperne di più, consulta Creare un'app Google Chat Dialogflow che capisce il linguaggio naturale.
    Comandi slash Comandi che possono essere mostrati agli utenti all'interno di Google Chat. Consente agli utenti di visualizzare le azioni principali della tua app Chat in Google Chat e di scegliere un'azione specifica con cui vogliono interagire. Per ulteriori informazioni, vedi Rispondere ai comandi slash come app di chat.
    Anteprime link Pattern URL che l'app Chat riconosce e fornisce contenuti aggiuntivi per quando gli utenti inviano link. Per ulteriori informazioni, consulta la sezione Link di anteprima.
    Visibilità Fino a 5 persone o uno o più gruppi Google che possono visualizzare e installare la tua app Chat. Utilizza questo campo per testare l'app Chat o per condividerla con il tuo team. Per saperne di più, vedi Impostazioni di visibilità e pubblicazione per l'app di Chat.

  4. Per registrare errori in Cloud Logging ogni volta che l'app Chat restituisce un errore, seleziona la casella di controllo Registra gli errori in Logging. Per maggiori informazioni, consulta Log degli errori delle query per le app di Chat.

  5. Fai clic su Salva. Quando salvi la configurazione dell'app di Chat, l'app Chat diventa disponibile per gli utenti specificati nella tua organizzazione Google Workspace.

Concedere ad altri utenti l'autorizzazione per configurare un'app di chat

Puoi concedere a utenti specifici l'accesso alla pagina di configurazione dell'app di chat. Utilizza i ruoli IAM Proprietario app di chat e Visualizzatore app di chat. Gli utenti con questi ruoli non possono accedere alla pagina di configurazione delle app di chat utilizzando la dashboard API e servizi, ma possono accedere alla pagina di configurazione passando alla console Google Cloud per il progetto Cloud dell'host dell'app Chat, come descritto di seguito:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

Dove PROJECT_ID è l'ID del progetto Google Cloud che ospita l'app di Chat.