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

Configurare 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 utilizzato dagli utenti quando interagiscono con la tua app Chat.
    • URL avatar: un URL HTTPS che rimanda a un'immagine grafica quadrata (ad esempio, PNG o JPEG), di dimensioni minime 128 x 128, che viene visualizzata come avatar della tua app di chat.
    • Descrizione: una descrizione dello scopo previsto dell'app di Chat, visualizzata sotto il nome dell'app.

  3. Per attivare le funzionalità interattive, fai clic sul pulsante di attivazione/disattivazione Abilita funzionalità interattive che consentono agli utenti di interagire con l'app Chat e di utilizzare la seguente tabella 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 l'app Chat e inviare messaggi direttamente in Google Chat.
    • Partecipare a spazi e conversazioni di gruppo: gli utenti possono aggiungere l'app Chat a spazi e 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 Chat sottoscrive come endpoint.
    • Dialogflow: registra l'app di Chat con un'integrazione Dialogflow. Per ulteriori informazioni, vedi Creare un'app Google Chat Dialogflow che comprende il linguaggio naturale.
    Comandi slash Comandi che possono essere mostrati agli utenti in 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 di chat riconosce e fornisce contenuti aggiuntivi per quando gli utenti inviano link. Per saperne di più, consulta la sezione Link alle anteprime.
    Visibilità Fino a cinque persone o uno o più gruppi Google che possono visualizzare e installare la tua app di chat. Utilizza questo campo per testare l'app Chat o condividerla con il tuo team. Per saperne di più, vedi Impostazioni di visibilità e pubblicazione per l'app Chat.

  4. Per registrare gli errori in Cloud Logging ogni volta che l'app Chat restituisce un errore, seleziona la casella di controllo Registra 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 di Chat è disponibile per gli utenti specificati nella tua organizzazione Google Workspace.

Concedi ad altri utenti l'autorizzazione a configurare un'app di Chat

Puoi concedere a utenti specifici l'accesso alla pagina di configurazione dell'app di Chat. Utilizzare 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 accedervi dalla console Google Cloud per il progetto Cloud host dell'app Chat nel seguente modo:

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 Chat.