Questa pagina fornisce una panoramica su come utilizzare l'API Google Chat e la relativa documentazione di riferimento.
L'API Google Chat ha interfacce gRPC e REST, nonché librerie client che supportano entrambe. Se le librerie client fornite non soddisfano le tue esigenze, puoi scrivere le tue librerie client che utilizzano l'interfaccia gRPC o REST.
Librerie client
Il modo consigliato per la maggior parte degli sviluppatori di chiamare l'API Google Chat è utilizzare le librerie client di Cloud supportate ufficialmente per il linguaggio che preferisci, ad esempio Python, Java o Node.js.
Se stai programmando con Google Apps Script, utilizza il servizio Chat avanzato anziché installare una libreria client.
Nomi di tipi, metodi e campi
A seconda che tu stia utilizzando librerie client, gRPC o REST, i nomi di tipi, metodi e campi per l'API Google Chat variano leggermente:
- Le librerie client di Cloud sono organizzate in base ai servizi gRPC e ai relativi metodi. Le librerie client delle API di Google sono organizzate come servizi che contengono oggetti o classi che corrispondono alle risorse REST, che contengono anche i metodi corrispondenti.
- gRPC è organizzato in base ai servizi e ai relativi metodi.
- REST è organizzato in base alle gerarchie delle risorse e ai relativi metodi.
- I nomi dei campi gRPC utilizzano la notazione snake_case.
- I nomi dei campi REST utilizzano la notazione camelCase, anche se il servizio API accetterà sia la notazione camelCase sia la notazione snake_case.
- I nomi dei campi delle librerie client utilizzano la notazione Title Case, camelCase o snake_case, a seconda del nome idiomatico per la lingua.
Buffer di protocollo
Indipendentemente dal fatto che tu stia utilizzando librerie client, REST o gRPC, il servizio sottostante è definito utilizzando i buffer di protocollo. In particolare, il servizio utilizza proto3.
Quando chiami l'API, alcuni campi di richiesta o risposta possono richiedere una conoscenza di base di tipi noti dei buffer di protocollo.
Inoltre, quando chiami l'API REST, il comportamento del valore predefinito per i buffer di protocollo potrebbe comportare la mancanza di campi in una risposta JSON. Questi campi sono impostati sul valore predefinito, quindi non sono inclusi nella risposta.
Versioni API
Sono disponibili le seguenti versioni API:
- v1: stabile.
Anteprima per gli sviluppatori
Nella documentazione, potresti vedere metodi o campi API disponibili solo tramite il Programma Anteprima per gli sviluppatori. Per testare, visualizzare in anteprima e fornire feedback sulle funzionalità di anteprima più recenti, partecipa al Programma Anteprima per gli sviluppatori.