Questa pagina fornisce una panoramica su come utilizzare l'API Google Chat e la relativa documentazione di riferimento.
L'API Google Chat dispone di interfacce gRPC e REST e 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 di chiamare l'API Google Chat è con le nostre librerie client di Cloud supportate ufficialmente per il linguaggio che preferisci, come Python, Java o Node.js.
Se codifichi con Google Apps Script, utilizza il servizio Chat avanzato anziché installare una libreria client.
Tipo, metodo e nomi dei campi
A seconda che utilizzi librerie client, gRPC o REST, il tipo, il metodo e i nomi dei campi 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 di Google sono organizzate come servizi che contengono oggetti o classi corrispondenti alle risorse REST, che a loro volta contengono 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 camel case, anche se il servizio API accetta sia la notazione camel case che snake case.
- I nomi dei campi della libreria client utilizzano la notazione title case, camel case o snake case, a seconda del nome idiomatico per la lingua.
Buffer di protocollo
Che tu utilizzi librerie client, REST o gRPC, il servizio sottostante è definito utilizzando buffer di protocollo. In particolare, il servizio utilizza proto3.
Quando chiami l'API, alcuni campi di richiesta o risposta possono richiedere una comprensione di base dei tipi noti di protocol buffer.
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, pertanto non sono inclusi nella risposta.
Versioni API
Sono disponibili le seguenti versioni dell'API:
- v1: stabile.
Anteprima per gli sviluppatori
Nella documentazione potresti vedere metodi o campi API disponibili solo tramite il programma di anteprima per gli sviluppatori. Per testare, visualizzare in anteprima e fornire feedback sulle funzionalità in anteprima più recenti, partecipa al programma Anteprima per sviluppatori.