Questa pagina fornisce una panoramica su come utilizzare l'API Google Chat e relativi riferimenti documentazione.
L'API Google Chat ha sia gRPC e interfacce REST e librerie client che supportano entrambi. Facoltativamente, se le librerie client fornite non soddisfano le tue esigenze, puoi scrivere librerie client che utilizzano l'interfaccia gRPC o REST.
Librerie client
Il metodo consigliato per la maggior parte degli sviluppatori di chiamare l'API Google Chat è con il nostro supporto ufficiale Librerie client di Cloud per il tuo linguaggio preferito, come Python, Java o Node.js.
Se scrivi codice con Google Apps Script, utilizza la 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 e i nomi dei campi per l'API Google Chat sono leggermente diversi:
- Le librerie client di Cloud sono organizzate dai servizi gRPC e dai relativi metodi. Le librerie client delle API di Google sono disposte come servizi che contengono oggetti che corrispondono alle risorse REST, che contengono anche le classi di classificazione.
- gRPC è organizzato in base ai servizi e ai relativi metodi.
- REST è organizzato in base alle gerarchie di risorse e ai relativi metodi.
- I nomi dei campi gRPC usano caratteri maiuscoli e minuscoli.
- Per i nomi dei campi REST viene utilizzato il caso cammello, sebbene il servizio API accetterà custodia a cammello o custodia a forma di serpente.
- Per i nomi dei campi della libreria client vengono utilizzati iniziali maiuscole o minuscole o a forma di cammello. a seconda di quale nome è idiomatico per la lingua.
Buffer di protocollo
Sia che utilizzi librerie client, REST o gRPC, il servizio sottostante definiti mediante buffer di protocollo. In particolare, il servizio utilizza proto3.
Quando chiami l'API, alcuni campi di richiesta o risposta possono richiedere una la comprensione delle tipi di buffer di protocollo molto noti.
Inoltre, quando chiami l'API REST, Comportamento del valore predefinito per il protocollo nei buffer potrebbero mancare campi in una risposta JSON. Questi campi sono è impostato sul valore predefinito, quindi non vengono 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 dell'API che disponibili tramite il Programma Anteprima per gli sviluppatori. Per testare, visualizzare l'anteprima e offrire feedback sulle funzionalità in anteprima, unisciti al Programma Anteprima per gli sviluppatori.