Panoramica dell'API Google Chat

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 e 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 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 la notazione camel case, anche se il servizio API accetterà la notazione camel case o 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 conoscenza 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.