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

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 App 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.
Figura 1. Il messaggio di attribuzione che Chat viene visualizzato quando si utilizza il metodo 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:

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

    Vai alla pagina di configurazione dell'API Chat

  2. In Application info (Informazioni applicazione), compila App name (Nome app), Avatar URL (URL avatar), e Description (Descrizione).

  3. Nella sezione Funzionalità interattive, fai clic sul pulsante di attivazione/disattivazione Attiva le funzionalità interattive. in posizione off per disattivare le funzionalità interattive per App 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.

  4. (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.

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