Configurare l'API Google Chat

Ogni app di Google Chat che crei richiede una propria Progetto Google Cloud con l'API Chat abilitata e configurata. Questa pagina ti 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 quanto segue informazioni:

    • Nome app: il nome utilizzato dalle persone quando interagiscono con il tuo App Chat.
    • URL avatar: un URL HTTPS che rimanda a un'immagine grafica quadrata. (ad esempio, PNG o JPEG), di almeno 128 x 128, viene visualizzato come avatar per la tua app Chat.
    • Descrizione: una descrizione del La finalità prevista dell'app di chat, che viene visualizzata sotto il nome della tua app di Chat.

  3. Per attivare le funzionalità interattive, fai clic su Attiva le funzionalità interattive. pulsante di attivazione/disattivazione che consente agli utenti di interagire app Chat e utilizza la seguente tabella per completare l'operazione 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 gli errori in Cloud Logging ogni volta che L'app Chat restituisce un errore, seleziona Casella di controllo Registra gli errori in Logging. Per ulteriori informazioni, vedi Log degli errori delle query per le app di Chat.

  5. Fai clic su Salva. Quando salvi l'app Chat automatica, la tua app di Chat è disponibile specifici degli utenti 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 la IAM Proprietario app di chat e Visualizzatore app di chat ruoli. Gli utenti con questi ruoli non possono accedere alle app di chat di configurazione di Google Cloud utilizzando la funzionalità API e nella dashboard dei servizi, ma possono alla pagina di configurazione, accedendo alla console Google Cloud Progetto cloud host dell'app di Chat come segue:

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

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