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 spiega come configurare l'API Chat.

Prerequisiti

Scegliere 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 dell'app Chat. Un URL HTTPS che rimanda a un'immagine grafica quadrata (PNG o JPEG). Le dimensioni consigliate sono 256 x 256 pixel o più.
Descrizione Una breve descrizione dello scopo dell'app Chat. Fino a 40 caratteri alfanumerici

Il nome, l'avatar e la descrizione dell'app Chat vengono visualizzati agli utenti nell'interfaccia utente di Chat. Per alcune richieste di scrittura dell'API Chat, Chat utilizza queste informazioni per attribuire le azioni intraprese da un'app di Chat in Chat.

Ad esempio, se chiami il metodo spaces.create(), Chat include il nome dell'app Chat nella descrizione di chi ha creato lo spazio, come mostrato nell'immagine seguente:

L'app Google Chat crea uno spazio per un utente.
Figura 1. Il messaggio di attribuzione visualizzato da Chat quando viene utilizzato il metodo spaces.create() per creare uno spazio per conto di un utente.

Per interagire con le app di Chat, gli utenti possono anche visualizzare o utilizzare queste informazioni nei seguenti modi:

  • Richiama l'app Chat menzionando il suo nome.
  • Trova e avvia un messaggio diretto con l'app Chat. Nel menu App, i messaggi diretti mostrano il nome e l'avatar dell'app Chat.
  • Dalla barra di composizione, gli utenti possono sfogliare le app di Chat e vedere il nome, l'avatar e la descrizione.

Configurare l'app Chat nella console Google Cloud

Una volta ottenuti i dettagli dell'app di Chat, apri il progetto Cloud e configura l'API Chat:

  1. Nella console Google Cloud, vai alla pagina dell'API Chat e fai clic sulla pagina Configurazione:

    Vai alla pagina di configurazione dell'API Chat

  2. In Informazioni sull'applicazione, compila i campi Nome app, URL avatar e Descrizione.

  3. In Funzionalità interattive, fai clic sul pulsante di attivazione/disattivazione Attiva funzionalità interattive in posizione di disattivazione per disattivare le funzionalità interattive per l'app Chat. Puoi configurare questa opzione in un secondo momento. Per scoprire di più sulla configurazione e sulla creazione di funzionalità interattive, consulta Ricevere e rispondere alle interazioni degli utenti.

  4. (Facoltativo) In Log, seleziona la casella di controllo Registra gli errori in Logging per utilizzare Google Cloud Logging. Per ulteriori informazioni, consulta Eseguire query sui log degli errori per le app di chat.

  5. Fai clic su Salva.

Concedi ad altre persone l'autorizzazione per configurare l'API Chat

Puoi concedere l'accesso a utenti specifici alla pagina di configurazione dell'app Chat concedendo loro il ruolo IAM (Identity Access Management) di Google CloudProprietario di app di Chat o Visualizzatore di app di Chat. Gli utenti con questi ruoli non possono accedere alla pagina di configurazione delle app Chat utilizzando la dashboard API e servizi, ma possono accedere alla pagina di configurazione accedendo alla console Google Cloud del progetto Cloud host dell'app 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.