Questa pagina fornisce una panoramica su come utilizzare l'API Google Chat e la relativa documentazione di riferimento.
L'API Google Chat dispone sia di interfacce gRPC sia di REST, nonché di 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 per chiamare l'API Google Chat è tramite le nostre librerie client Cloud supportate ufficialmente per il linguaggio che preferisci, ad esempio Python, Java o Node.js.
Se scrivi codice con Google Apps Script, utilizza il servizio Chat avanzato instead of installing a client library.
Nomi di tipo, metodo e campo
A seconda che tu utilizzi librerie client, gRPC o REST, i nomi di tipo, metodo e campo per l'API Google Chat variano leggermente:
- Le librerie client Cloud sono organizzate in base ai servizi gRPC e ai relativi metodi. Le librerie client delle API Google sono organizzate come servizi che contengono oggetti o classi corrispondenti alle risorse REST, che contengono anche 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 il camel case, anche se il servizio API accetta sia il camel case che lo snake case.
- I nomi dei campi della libreria client utilizzano lettere maiuscole, lettere maiuscole iniziali o lettere minuscole iniziali, a seconda del nome idiomatico per la lingua.
Buffer di protocollo
Indipendentemente dall'utilizzo di 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 dei tipi noti del buffer del protocollo.
Inoltre, quando chiami l'API REST, il comportamento del valore predefinito per i buffer del protocollo può comportare la mancanza di campi in una risposta JSON. Questi campi sono impostati sul valore predefinito, pertanto non sono inclusi nella risposta.
Versioni dell'API
Sono disponibili le seguenti versioni dell'API:
- v1: stabile.
Anteprima per gli sviluppatori
Nella documentazione potresti trovare metodi o campi dell'API disponibili solo tramite il Programma di anteprima per gli sviluppatori. Per testare e visualizzare l'anteprima delle ultime funzionalità in anteprima e offrire feedback, partecipa al programma Anteprima per gli sviluppatori.