Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page présente l'API Google Chat et sa documentation de référence.
L'API Google Chat dispose d'interfaces gRPC et REST, ainsi que de bibliothèques clientes compatibles avec les deux. Si les bibliothèques clientes fournies ne répondent pas à vos besoins, vous pouvez également écrire vos propres bibliothèques clientes qui utilisent l'interface gRPC ou REST.
Bibliothèques clientes
Pour la plupart des développeurs, la méthode recommandée pour appeler l'API Google Chat consiste à utiliser nos bibliothèques clientes Cloud officiellement compatibles pour le langage de votre choix, comme Python, Java ou Node.js.
Si vous codez avec Google Apps Script, utilisez le 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, les noms de type, de méthode et de champ de l'API Google Chat varient légèrement :
Les bibliothèques clientes Cloud sont organisées par services gRPC et par leurs méthodes.
Les bibliothèques clientes des API Google sont organisées en services qui contiennent des objets ou des classes correspondant aux ressources REST, qui contiennent également des méthodes correspondantes.
gRPC est organisé par services et par leurs méthodes.
L'architecture REST est organisée par hiérarchies de ressources et leurs méthodes.
Les noms de champs gRPC utilisent snake case.
Les noms de champs REST utilisent la convention typographique camel case, mais le service d'API accepte aussi bien camel case que snake case.
Les noms de champs de la bibliothèque cliente utilisent soit la casse du titre, soit camel case ou snake case, selon le caractère idiomatique du nom dans le langage concerné.
Protocol Buffers
Que vous utilisiez des bibliothèques clientes, REST ou gRPC, le service sous-jacent est défini à 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 une compréhension de base des types connus de tampon de protocole.
De plus, lorsque vous appelez l'API REST, le comportement de la valeur par défaut pour les tampons de protocole peut entraîner l'absence de certains champs dans une réponse JSON. Ces champs sont définis sur la valeur par défaut et ne sont donc 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 pouvez voir des méthodes ou des champs d'API qui ne sont disponibles que dans le programme Preview développeur. Pour tester les dernières fonctionnalités en preview, les prévisualiser et nous faire part de vos commentaires, rejoignez le programme Preview développeur.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eThis page offers guidance on utilizing the Google Chat API and navigating its reference documentation, including gRPC and REST interfaces.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers are encouraged to use the provided client libraries for Python, Java, Node.js, or the Advanced Chat service for Google Apps Script.\u003c/p\u003e\n"],["\u003cp\u003eType, method, and field names may vary slightly depending on whether you are using client libraries, gRPC, or REST, with details provided on their respective conventions.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Chat API is built upon protocol buffers, specifically proto3, which may require a basic understanding for certain request and response fields.\u003c/p\u003e\n"],["\u003cp\u003eStable API version v1 is currently available, with access to developer preview features obtainable through the Developer Preview Program.\u003c/p\u003e\n"]]],["The Google Chat API offers gRPC and REST interfaces, with corresponding client libraries or the option to create custom ones. Developers can use Cloud Client Libraries, or the Advanced Chat service with Google Apps Script. Type, method, and field names vary across libraries, gRPC, and REST. The API relies on protocol buffers (proto3), which can impact JSON responses due to default value behavior. The current stable version is v1, with a Developer Preview program for testing new features.\n"],null,["# Google Chat API overview\n\nThis page provides an overview of how to use Google Chat API and its reference\ndocumentation.\n\nGoogle Chat API has both [gRPC](/workspace/chat/api/reference/rpc) and\n[REST](/workspace/chat/api/reference/rest) interfaces, and\n[client libraries](/workspace/chat/libraries) that support both. Optionally, if\nthe provided client libraries don't meet your needs, you can write your own\nclient libraries that use the gRPC or REST interface.\n\nClient libraries\n----------------\n\nThe recommended way for most developers to call the Google Chat API\nis with our officially supported\n[Cloud Client Libraries](/workspace/chat/libraries)\nfor your preferred language, like Python, Java, or Node.js.\n\nIf you're coding with Google Apps Script, use the\n[Advanced Chat service](/apps-script/advanced/chat)\ninstead of installing a client library.\n\nType, method, and field names\n-----------------------------\n\nDepending on whether you're using client libraries, gRPC, or REST, the type,\nmethod, and field names for the Google Chat API vary somewhat:\n\n- Cloud Client Libraries are arranged by gRPC services and their methods. Google API Client Libraries are arranged as services that contain objects or classes that correspond with REST resources, which also contain corresponding methods.\n- gRPC is arranged by services and their methods.\n- REST is arranged by resource hierarchies and their methods.\n- gRPC field names use snake case.\n- REST field names use camel case, though the API service will accept either camel case or snake case.\n- Client library field names use either title case, camel case or snake case, depending on which name is idiomatic for the language.\n\nProtocol buffers\n----------------\n\nWhether you are using client libraries, REST, or gRPC, the underlying service is\ndefined using [protocol buffers](/protocol-buffers). In particular, the service\nuses [proto3](/protocol-buffers/docs/proto3).\n\nWhen calling the API, some request or response fields can require a basic\nunderstanding of\n[protocol buffer well-known types](/protocol-buffers/docs/reference/google.protobuf).\n\nIn addition, when calling the REST API, the\n[default value](/protocol-buffers/docs/proto3#default) behavior for protocol\nbuffers may result in missing fields in a JSON response. These fields are\nset to the default value, so they are not included in the response.\n\nAPI versions\n------------\n\nThe following API versions are available:\n\n- **v1**: Stable.\n\nDeveloper Preview\n-----------------\n\nIn the documentation, you might see API methods or fields that are only\navailable through the Developer Preview Program. To test and preview and offer\nfeedback on the latest preview features, join the\n[Developer Preview Program](/workspace/preview).\n\nRelated topics\n--------------\n\n- [Call the Google Chat API](/workspace/chat/api-overview)"]]
