Cette page fournit un aperçu de l'utilisation de l'API Google Chat et des références dans la documentation Google Cloud.
L'API Google Chat dispose à la fois de gRPC et Les interfaces REST Bibliothèques clientes compatibles avec les deux. Éventuellement, si les bibliothèques clientes fournies ne répondent pas à vos besoins, vous pouvez écrire vos propres qui utilisent l'interface gRPC ou REST.
Bibliothèques clientes
La méthode recommandée pour que la plupart des développeurs appellent l'API Google Chat est le numéro de téléphone officiel Bibliothèques clientes Cloud dans le langage de votre choix, comme Python, Java ou Node.js.
Si vous codez avec Google Apps Script, utilisez la Service Chat avancé au lieu d'installer une bibliothèque cliente.
Noms de type, de méthode et de champs
Selon que vous utilisez des bibliothèques clientes, gRPC ou REST, le type et les noms des champs de l'API Google Chat varient légèrement:
- Les bibliothèques clientes Cloud sont organisées par services gRPC et leurs méthodes. Les bibliothèques clientes des API Google sont organisées en tant que services contenant des objets ou qui correspondent aux ressources REST, qui contiennent également méthodes.
- gRPC est organisé par services et par méthodes.
- REST est organisé en fonction des hiérarchies de ressources et de leurs méthodes.
- Les noms de champs gRPC utilisent le snake case.
- Les noms de champs REST utilisent la casse Camel, bien que le service de l'API accepte l'une des deux Camel Case ou Snake Case.
- Les noms des champs de la bibliothèque cliente utilisent la casse de titre, de chameau ou de snake. en fonction du nom idiomatique de la langue.
Protocol Buffers
Que vous utilisiez des bibliothèques clientes, REST ou gRPC, le service sous-jacent est définis à l'aide de tampons de protocole. En particulier, le service utilise proto3.
Lorsque vous appelez l'API, certains champs de requête ou de réponse peuvent nécessiter un de mieux comprendre types connus de tampon de protocole.
De plus, lorsque vous appelez l'API REST, Comportement de la valeur par défaut pour le protocole peut entraîner des champs manquants dans une réponse JSON. Ces champs sont défini sur la valeur par défaut, afin qu'ils ne soient pas inclus dans la réponse.
Versions d'API
Les versions d'API suivantes sont disponibles:
- v1: stable.
Version Preview développeur
Dans la documentation, vous verrez peut-être des méthodes ou des champs d'API qui ne sont disponibles via le programme Preview développeur. Pour tester, prévisualiser et proposer commentaires sur les dernières fonctionnalités en preview, rejoignez la Programme Preview développeur.