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
- Un'azienda o un'impresa Google Workspace con accesso a Google Chat.
- Creare un progetto Google Cloud.
- Configura la schermata per il consenso OAuth.
- Abilitare l'API Google Chat.
Scegli un nome visualizzato, un avatar e una descrizione per l'app Chat
Per chiamare l'API Chat, devi configurare un app Google Chat con le seguenti informazioni:
Campo | Descrizione | Formato |
---|---|---|
Nome dell'app | Il nome visualizzato dell'app Chat. | Fino a 25 caratteri alfanumerici |
URL avatar | L'immagine visualizzata come avatar. | Un URL HTTPS che rimanda a un'immagine grafica quadrata (PNG o JPEG). Le dimensioni consigliate sono almeno 256 x 256 pixel. |
Descrizione | Una breve descrizione che lo scopo Chat. | Fino a 40 caratteri alfanumerici |
Il nome, l'avatar e la descrizione dell'app di Chat sono mostrati agli utenti nella UI di Chat. Per alcune API Chat di scrittura, Chat usa queste informazioni per attribuire azioni eseguite da un'app di Chat in Chat.
Ad esempio, se chiami il metodo spaces.create()
, Chat
include il nome dell'app di Chat nella
descrizione di chi ha creato lo spazio, come mostrato nell'immagine seguente:
![L'app Google Chat crea uno spazio per un utente.](https://developers-dot-devsite-v2-prod.appspot.com/static/workspace/chat/images/auth-user-create-space.png?authuser=19&hl=it)
spaces.create()
per creare
per conto di un utente.
Per interagire con le app di chat, gli utenti possono anche vedere o utilizzare questa informazioni nei seguenti modi:
- Richiama l'app Chat @menzionando il nome.
- Trova e avvia un messaggio diretto con l'app Chat. Nel menu App, i messaggi diretti mostrano la Il nome e l'avatar dell'app di chat.
- Dalla barra di scrittura, gli utenti possono sfogliare le app di Chat e visualizzare il nome, l'avatar e la descrizione.
Configura l'app di Chat nella console Google Cloud
Una volta disponibili i dettagli dell'app Chat, apri il Cloud e configurare l'API Chat:
Nella console Google Cloud, vai alla pagina dell'API Chat e fai clic sull'icona Pagina Configurazione:
In Application info (Informazioni applicazione), compila App name (Nome app), Avatar URL (URL avatar), e Description (Descrizione).
Nella sezione Funzionalità interattive, fai clic sul pulsante di attivazione/disattivazione Attiva le funzionalità interattive. in posizione off per disattivare le funzionalità interattive per Chat. Puoi eseguire la configurazione in un secondo momento. Per saperne di più configurazione e creazione di funzionalità interattive, Ricevere e rispondere alle interazioni degli utenti.
(Facoltativo) In Log, seleziona la casella di controllo Registra errori in Logging per usano Google Cloud Logging. Per ulteriori informazioni, vedi Log degli errori delle query per le app di Chat.
Fai clic su Salva.
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.
Argomenti correlati
- Scegliere un'architettura dell'app di Chat
- Per configurare le funzionalità interattive nell'app Chat: Consulta Ricevere e rispondere alle interazioni degli utenti.