google-api-python-client 2.125.0__py2.py3-none-any.whl → 2.126.0__py2.py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (229) hide show
  1. {google_api_python_client-2.125.0.dist-info → google_api_python_client-2.126.0.dist-info}/METADATA +3 -3
  2. {google_api_python_client-2.125.0.dist-info → google_api_python_client-2.126.0.dist-info}/RECORD +229 -226
  3. googleapiclient/discovery_cache/documents/abusiveexperiencereport.v1.json +1 -1
  4. googleapiclient/discovery_cache/documents/acceleratedmobilepageurl.v1.json +1 -1
  5. googleapiclient/discovery_cache/documents/accessapproval.v1.json +1 -1
  6. googleapiclient/discovery_cache/documents/acmedns.v1.json +1 -1
  7. googleapiclient/discovery_cache/documents/addressvalidation.v1.json +834 -0
  8. googleapiclient/discovery_cache/documents/adexchangebuyer2.v2beta1.json +1 -1
  9. googleapiclient/discovery_cache/documents/adexperiencereport.v1.json +1 -1
  10. googleapiclient/discovery_cache/documents/admin.datatransfer_v1.json +1 -1
  11. googleapiclient/discovery_cache/documents/admin.datatransferv1.json +1 -1
  12. googleapiclient/discovery_cache/documents/admin.directory_v1.json +1 -1
  13. googleapiclient/discovery_cache/documents/admin.directoryv1.json +1 -1
  14. googleapiclient/discovery_cache/documents/admin.reports_v1.json +1 -1
  15. googleapiclient/discovery_cache/documents/admin.reportsv1.json +1 -1
  16. googleapiclient/discovery_cache/documents/admob.v1.json +1 -1
  17. googleapiclient/discovery_cache/documents/admob.v1beta.json +1 -1
  18. googleapiclient/discovery_cache/documents/adsense.v2.json +1 -1
  19. googleapiclient/discovery_cache/documents/advisorynotifications.v1.json +61 -6
  20. googleapiclient/discovery_cache/documents/aiplatform.v1.json +666 -83
  21. googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json +348 -839
  22. googleapiclient/discovery_cache/documents/alertcenter.v1beta1.json +5 -1
  23. googleapiclient/discovery_cache/documents/analyticsadmin.v1alpha.json +245 -1
  24. googleapiclient/discovery_cache/documents/analyticsadmin.v1beta.json +245 -1
  25. googleapiclient/discovery_cache/documents/analyticsdata.v1beta.json +1 -1
  26. googleapiclient/discovery_cache/documents/androiddeviceprovisioning.v1.json +1 -1
  27. googleapiclient/discovery_cache/documents/androidenterprise.v1.json +2 -2
  28. googleapiclient/discovery_cache/documents/androidmanagement.v1.json +9 -8
  29. googleapiclient/discovery_cache/documents/androidpublisher.v3.json +23 -3
  30. googleapiclient/discovery_cache/documents/area120tables.v1alpha1.json +1 -1
  31. googleapiclient/discovery_cache/documents/assuredworkloads.v1.json +1 -1
  32. googleapiclient/discovery_cache/documents/assuredworkloads.v1beta1.json +1 -1
  33. googleapiclient/discovery_cache/documents/authorizedbuyersmarketplace.v1.json +1 -1
  34. googleapiclient/discovery_cache/documents/billingbudgets.v1.json +1 -1
  35. googleapiclient/discovery_cache/documents/billingbudgets.v1beta1.json +1 -1
  36. googleapiclient/discovery_cache/documents/binaryauthorization.v1.json +1 -1
  37. googleapiclient/discovery_cache/documents/binaryauthorization.v1beta1.json +1 -1
  38. googleapiclient/discovery_cache/documents/blogger.v2.json +1 -1
  39. googleapiclient/discovery_cache/documents/blogger.v3.json +1 -1
  40. googleapiclient/discovery_cache/documents/books.v1.json +1 -1
  41. googleapiclient/discovery_cache/documents/businessprofileperformance.v1.json +1 -1
  42. googleapiclient/discovery_cache/documents/calendar.v3.json +3 -3
  43. googleapiclient/discovery_cache/documents/chat.v1.json +189 -180
  44. googleapiclient/discovery_cache/documents/checks.v1alpha.json +11 -3
  45. googleapiclient/discovery_cache/documents/chromemanagement.v1.json +1 -1
  46. googleapiclient/discovery_cache/documents/chromepolicy.v1.json +1 -1
  47. googleapiclient/discovery_cache/documents/chromeuxreport.v1.json +1 -1
  48. googleapiclient/discovery_cache/documents/civicinfo.v2.json +1 -1
  49. googleapiclient/discovery_cache/documents/classroom.v1.json +1 -1
  50. googleapiclient/discovery_cache/documents/cloudbilling.v1.json +1 -1
  51. googleapiclient/discovery_cache/documents/cloudbilling.v1beta.json +2 -2
  52. googleapiclient/discovery_cache/documents/cloudchannel.v1.json +1 -1
  53. googleapiclient/discovery_cache/documents/cloudidentity.v1.json +1 -1
  54. googleapiclient/discovery_cache/documents/cloudidentity.v1beta1.json +1 -1
  55. googleapiclient/discovery_cache/documents/cloudprofiler.v2.json +1 -1
  56. googleapiclient/discovery_cache/documents/cloudsupport.v2.json +8 -7
  57. googleapiclient/discovery_cache/documents/cloudsupport.v2beta.json +8 -7
  58. googleapiclient/discovery_cache/documents/cloudtrace.v1.json +1 -1
  59. googleapiclient/discovery_cache/documents/cloudtrace.v2.json +1 -1
  60. googleapiclient/discovery_cache/documents/cloudtrace.v2beta1.json +1 -1
  61. googleapiclient/discovery_cache/documents/compute.alpha.json +90 -5
  62. googleapiclient/discovery_cache/documents/compute.beta.json +5 -5
  63. googleapiclient/discovery_cache/documents/compute.v1.json +131 -10
  64. googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json +1 -1
  65. googleapiclient/discovery_cache/documents/container.v1.json +112 -4
  66. googleapiclient/discovery_cache/documents/container.v1beta1.json +160 -4
  67. googleapiclient/discovery_cache/documents/content.v2.1.json +443 -17
  68. googleapiclient/discovery_cache/documents/contentwarehouse.v1.json +1667 -303
  69. googleapiclient/discovery_cache/documents/customsearch.v1.json +1 -1
  70. googleapiclient/discovery_cache/documents/datalineage.v1.json +1 -1
  71. googleapiclient/discovery_cache/documents/dataportability.v1.json +1 -15
  72. googleapiclient/discovery_cache/documents/dataportability.v1beta.json +1 -15
  73. googleapiclient/discovery_cache/documents/dataproc.v1.json +1 -1
  74. googleapiclient/discovery_cache/documents/deploymentmanager.alpha.json +1 -1
  75. googleapiclient/discovery_cache/documents/deploymentmanager.v2.json +1 -1
  76. googleapiclient/discovery_cache/documents/deploymentmanager.v2beta.json +1 -1
  77. googleapiclient/discovery_cache/documents/dialogflow.v2.json +1 -1
  78. googleapiclient/discovery_cache/documents/dialogflow.v2beta1.json +1 -1
  79. googleapiclient/discovery_cache/documents/dialogflow.v3.json +1 -1
  80. googleapiclient/discovery_cache/documents/dialogflow.v3beta1.json +1 -1
  81. googleapiclient/discovery_cache/documents/digitalassetlinks.v1.json +1 -1
  82. googleapiclient/discovery_cache/documents/discoveryengine.v1.json +10732 -0
  83. googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json +2358 -285
  84. googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json +3498 -1136
  85. googleapiclient/discovery_cache/documents/displayvideo.v2.json +13 -1
  86. googleapiclient/discovery_cache/documents/displayvideo.v3.json +15 -1
  87. googleapiclient/discovery_cache/documents/dlp.v2.json +676 -2
  88. googleapiclient/discovery_cache/documents/docs.v1.json +1 -1
  89. googleapiclient/discovery_cache/documents/documentai.v1.json +4 -3
  90. googleapiclient/discovery_cache/documents/documentai.v1beta2.json +1 -1
  91. googleapiclient/discovery_cache/documents/documentai.v1beta3.json +4 -3
  92. googleapiclient/discovery_cache/documents/domainsrdap.v1.json +1 -1
  93. googleapiclient/discovery_cache/documents/doubleclickbidmanager.v2.json +1 -1
  94. googleapiclient/discovery_cache/documents/doubleclicksearch.v2.json +1 -1
  95. googleapiclient/discovery_cache/documents/drive.v2.json +1 -1
  96. googleapiclient/discovery_cache/documents/drive.v3.json +1 -1
  97. googleapiclient/discovery_cache/documents/driveactivity.v2.json +1 -1
  98. googleapiclient/discovery_cache/documents/drivelabels.v2.json +1 -1
  99. googleapiclient/discovery_cache/documents/drivelabels.v2beta.json +1 -1
  100. googleapiclient/discovery_cache/documents/essentialcontacts.v1.json +1 -1
  101. googleapiclient/discovery_cache/documents/factchecktools.v1alpha1.json +1 -1
  102. googleapiclient/discovery_cache/documents/fcm.v1.json +1 -1
  103. googleapiclient/discovery_cache/documents/fcmdata.v1beta1.json +1 -1
  104. googleapiclient/discovery_cache/documents/firebase.v1beta1.json +1 -1
  105. googleapiclient/discovery_cache/documents/firebaseappcheck.v1.json +1 -1
  106. googleapiclient/discovery_cache/documents/firebaseappcheck.v1beta.json +1 -1
  107. googleapiclient/discovery_cache/documents/firebaseappdistribution.v1.json +1 -1
  108. googleapiclient/discovery_cache/documents/firebaseappdistribution.v1alpha.json +1 -1
  109. googleapiclient/discovery_cache/documents/firebasedatabase.v1beta.json +1 -1
  110. googleapiclient/discovery_cache/documents/firebasedynamiclinks.v1.json +1 -1
  111. googleapiclient/discovery_cache/documents/firebasehosting.v1.json +1 -1
  112. googleapiclient/discovery_cache/documents/firebasehosting.v1beta1.json +1 -1
  113. googleapiclient/discovery_cache/documents/firebaseml.v1.json +1 -1
  114. googleapiclient/discovery_cache/documents/firebaseml.v1beta2.json +1 -1
  115. googleapiclient/discovery_cache/documents/firebaseml.v2beta.json +1156 -0
  116. googleapiclient/discovery_cache/documents/firebasestorage.v1beta.json +1 -1
  117. googleapiclient/discovery_cache/documents/fitness.v1.json +1 -1
  118. googleapiclient/discovery_cache/documents/forms.v1.json +1 -1
  119. googleapiclient/discovery_cache/documents/games.v1.json +1 -1
  120. googleapiclient/discovery_cache/documents/gamesConfiguration.v1configuration.json +1 -1
  121. googleapiclient/discovery_cache/documents/gamesManagement.v1management.json +1 -1
  122. googleapiclient/discovery_cache/documents/gmail.v1.json +1 -1
  123. googleapiclient/discovery_cache/documents/gmailpostmastertools.v1.json +1 -1
  124. googleapiclient/discovery_cache/documents/gmailpostmastertools.v1beta1.json +1 -1
  125. googleapiclient/discovery_cache/documents/groupsmigration.v1.json +1 -1
  126. googleapiclient/discovery_cache/documents/healthcare.v1.json +1 -1
  127. googleapiclient/discovery_cache/documents/healthcare.v1beta1.json +1 -1
  128. googleapiclient/discovery_cache/documents/homegraph.v1.json +1 -1
  129. googleapiclient/discovery_cache/documents/iamcredentials.v1.json +1 -1
  130. googleapiclient/discovery_cache/documents/indexing.v3.json +1 -1
  131. googleapiclient/discovery_cache/documents/integrations.v1alpha.json +50 -6
  132. googleapiclient/discovery_cache/documents/keep.v1.json +1 -1
  133. googleapiclient/discovery_cache/documents/kmsinventory.v1.json +1 -1
  134. googleapiclient/discovery_cache/documents/language.v1.json +1 -1
  135. googleapiclient/discovery_cache/documents/language.v1beta2.json +1 -1
  136. googleapiclient/discovery_cache/documents/language.v2.json +1 -1
  137. googleapiclient/discovery_cache/documents/libraryagent.v1.json +1 -1
  138. googleapiclient/discovery_cache/documents/licensing.v1.json +1 -1
  139. googleapiclient/discovery_cache/documents/localservices.v1.json +1 -1
  140. googleapiclient/discovery_cache/documents/manufacturers.v1.json +1 -1
  141. googleapiclient/discovery_cache/documents/marketingplatformadmin.v1alpha.json +44 -1
  142. googleapiclient/discovery_cache/documents/migrationcenter.v1alpha1.json +1 -1
  143. googleapiclient/discovery_cache/documents/monitoring.v1.json +1 -1
  144. googleapiclient/discovery_cache/documents/monitoring.v3.json +26 -3
  145. googleapiclient/discovery_cache/documents/mybusinessaccountmanagement.v1.json +1 -1
  146. googleapiclient/discovery_cache/documents/mybusinessbusinessinformation.v1.json +1 -1
  147. googleapiclient/discovery_cache/documents/mybusinesslodging.v1.json +1 -1
  148. googleapiclient/discovery_cache/documents/mybusinessnotifications.v1.json +1 -1
  149. googleapiclient/discovery_cache/documents/mybusinessplaceactions.v1.json +1 -1
  150. googleapiclient/discovery_cache/documents/mybusinessqanda.v1.json +1 -1
  151. googleapiclient/discovery_cache/documents/mybusinessverifications.v1.json +1 -1
  152. googleapiclient/discovery_cache/documents/osconfig.v1.json +10 -10
  153. googleapiclient/discovery_cache/documents/osconfig.v1alpha.json +1 -1
  154. googleapiclient/discovery_cache/documents/osconfig.v1beta.json +1 -1
  155. googleapiclient/discovery_cache/documents/oslogin.v1.json +1 -1
  156. googleapiclient/discovery_cache/documents/pagespeedonline.v5.json +1 -1
  157. googleapiclient/discovery_cache/documents/paymentsresellersubscription.v1.json +6 -1
  158. googleapiclient/discovery_cache/documents/people.v1.json +1 -1
  159. googleapiclient/discovery_cache/documents/places.v1.json +2 -2
  160. googleapiclient/discovery_cache/documents/playcustomapp.v1.json +1 -1
  161. googleapiclient/discovery_cache/documents/playdeveloperreporting.v1alpha1.json +1 -1
  162. googleapiclient/discovery_cache/documents/playdeveloperreporting.v1beta1.json +1 -1
  163. googleapiclient/discovery_cache/documents/playgrouping.v1alpha1.json +1 -1
  164. googleapiclient/discovery_cache/documents/playintegrity.v1.json +1 -1
  165. googleapiclient/discovery_cache/documents/policyanalyzer.v1.json +1 -1
  166. googleapiclient/discovery_cache/documents/policyanalyzer.v1beta1.json +1 -1
  167. googleapiclient/discovery_cache/documents/policysimulator.v1.json +1 -1
  168. googleapiclient/discovery_cache/documents/policysimulator.v1alpha.json +1 -1
  169. googleapiclient/discovery_cache/documents/policysimulator.v1beta.json +1 -1
  170. googleapiclient/discovery_cache/documents/policytroubleshooter.v1.json +1 -1
  171. googleapiclient/discovery_cache/documents/policytroubleshooter.v1beta.json +1 -1
  172. googleapiclient/discovery_cache/documents/prod_tt_sasportal.v1alpha1.json +1 -1
  173. googleapiclient/discovery_cache/documents/publicca.v1.json +1 -1
  174. googleapiclient/discovery_cache/documents/publicca.v1alpha1.json +1 -1
  175. googleapiclient/discovery_cache/documents/publicca.v1beta1.json +1 -1
  176. googleapiclient/discovery_cache/documents/pubsublite.v1.json +1 -1
  177. googleapiclient/discovery_cache/documents/readerrevenuesubscriptionlinking.v1.json +1 -1
  178. googleapiclient/discovery_cache/documents/realtimebidding.v1.json +1 -1
  179. googleapiclient/discovery_cache/documents/recommendationengine.v1beta1.json +1 -1
  180. googleapiclient/discovery_cache/documents/recommender.v1.json +3 -3
  181. googleapiclient/discovery_cache/documents/reseller.v1.json +1 -1
  182. googleapiclient/discovery_cache/documents/resourcesettings.v1.json +1 -1
  183. googleapiclient/discovery_cache/documents/retail.v2.json +2 -2
  184. googleapiclient/discovery_cache/documents/retail.v2alpha.json +2 -2
  185. googleapiclient/discovery_cache/documents/retail.v2beta.json +2 -2
  186. googleapiclient/discovery_cache/documents/safebrowsing.v4.json +1 -1
  187. googleapiclient/discovery_cache/documents/safebrowsing.v5.json +6 -6
  188. googleapiclient/discovery_cache/documents/sasportal.v1alpha1.json +1 -1
  189. googleapiclient/discovery_cache/documents/script.v1.json +1 -1
  190. googleapiclient/discovery_cache/documents/searchads360.v0.json +238 -3
  191. googleapiclient/discovery_cache/documents/searchconsole.v1.json +1 -1
  192. googleapiclient/discovery_cache/documents/securitycenter.v1.json +821 -6
  193. googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json +765 -6
  194. googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json +765 -6
  195. googleapiclient/discovery_cache/documents/servicenetworking.v1.json +3 -3
  196. googleapiclient/discovery_cache/documents/servicenetworking.v1beta.json +3 -3
  197. googleapiclient/discovery_cache/documents/sheets.v4.json +5 -3
  198. googleapiclient/discovery_cache/documents/slides.v1.json +1 -1
  199. googleapiclient/discovery_cache/documents/solar.v1.json +1 -1
  200. googleapiclient/discovery_cache/documents/speech.v1.json +1 -1
  201. googleapiclient/discovery_cache/documents/speech.v1p1beta1.json +1 -1
  202. googleapiclient/discovery_cache/documents/sqladmin.v1.json +1 -1
  203. googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json +1 -1
  204. googleapiclient/discovery_cache/documents/storage.v1.json +2 -2
  205. googleapiclient/discovery_cache/documents/storagetransfer.v1.json +5 -5
  206. googleapiclient/discovery_cache/documents/streetviewpublish.v1.json +1 -1
  207. googleapiclient/discovery_cache/documents/tagmanager.v1.json +1 -1
  208. googleapiclient/discovery_cache/documents/tagmanager.v2.json +1 -1
  209. googleapiclient/discovery_cache/documents/tasks.v1.json +1 -1
  210. googleapiclient/discovery_cache/documents/testing.v1.json +1 -1
  211. googleapiclient/discovery_cache/documents/toolresults.v1beta3.json +1 -1
  212. googleapiclient/discovery_cache/documents/trafficdirector.v3.json +25 -2
  213. googleapiclient/discovery_cache/documents/travelimpactmodel.v1.json +1 -1
  214. googleapiclient/discovery_cache/documents/vault.v1.json +1 -1
  215. googleapiclient/discovery_cache/documents/verifiedaccess.v1.json +1 -1
  216. googleapiclient/discovery_cache/documents/verifiedaccess.v2.json +5 -1
  217. googleapiclient/discovery_cache/documents/versionhistory.v1.json +1 -1
  218. googleapiclient/discovery_cache/documents/vision.v1.json +1 -1
  219. googleapiclient/discovery_cache/documents/vision.v1p1beta1.json +1 -1
  220. googleapiclient/discovery_cache/documents/vision.v1p2beta1.json +1 -1
  221. googleapiclient/discovery_cache/documents/walletobjects.v1.json +1 -1
  222. googleapiclient/discovery_cache/documents/webfonts.v1.json +1 -1
  223. googleapiclient/discovery_cache/documents/webrisk.v1.json +1 -1
  224. googleapiclient/discovery_cache/documents/workspaceevents.v1.json +2 -2
  225. googleapiclient/discovery_cache/documents/youtube.v3.json +3 -1
  226. googleapiclient/version.py +1 -1
  227. {google_api_python_client-2.125.0.dist-info → google_api_python_client-2.126.0.dist-info}/LICENSE +0 -0
  228. {google_api_python_client-2.125.0.dist-info → google_api_python_client-2.126.0.dist-info}/WHEEL +0 -0
  229. {google_api_python_client-2.125.0.dist-info → google_api_python_client-2.126.0.dist-info}/top_level.txt +0 -0
@@ -178,7 +178,7 @@
178
178
  "supportsMediaDownload": true
179
179
  },
180
180
  "upload": {
181
- "description": "Uploads an attachment. For an example, see [Upload media as a file attachment](https://developers.google.com/chat/api/guides/v1/media-and-attachments/upload). Requires user [authentication](https://developers.google.com/chat/api/guides/auth/users). You can upload attachments up to 200 MB. Certain file types aren't supported. For details, see [File types blocked by Google Chat](https://support.google.com/chat/answer/7651457?&co=GENIE.Platform%3DDesktop#File%20types%20blocked%20in%20Google%20Chat).",
181
+ "description": "Uploads an attachment. For an example, see [Upload media as a file attachment](https://developers.google.com/workspace/chat/upload-media-attachments). Requires user [authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). You can upload attachments up to 200 MB. Certain file types aren't supported. For details, see [File types blocked by Google Chat](https://support.google.com/chat/answer/7651457?&co=GENIE.Platform%3DDesktop#File%20types%20blocked%20in%20Google%20Chat).",
182
182
  "flatPath": "v1/spaces/{spacesId}/attachments:upload",
183
183
  "httpMethod": "POST",
184
184
  "id": "chat.media.upload",
@@ -229,7 +229,7 @@
229
229
  "spaces": {
230
230
  "methods": {
231
231
  "completeImport": {
232
- "description": "Completes the [import process](https://developers.google.com/chat/api/guides/import-data) for the specified space and makes it visible to users. Requires app authentication and domain-wide delegation. For more information, see [Authorize Google Chat apps to import data](https://developers.google.com/chat/api/guides/authorize-import).",
232
+ "description": "Completes the [import process](https://developers.google.com/workspace/chat/import-data) for the specified space and makes it visible to users. Requires app authentication and domain-wide delegation. For more information, see [Authorize Google Chat apps to import data](https://developers.google.com/workspace/chat/authorize-import).",
233
233
  "flatPath": "v1/spaces/{spacesId}:completeImport",
234
234
  "httpMethod": "POST",
235
235
  "id": "chat.spaces.completeImport",
@@ -257,7 +257,7 @@
257
257
  ]
258
258
  },
259
259
  "create": {
260
- "description": "Creates a named space. Spaces grouped by topics aren't supported. For an example, see [Create a space](https://developers.google.com/chat/api/guides/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
260
+ "description": "Creates a named space. Spaces grouped by topics aren't supported. For an example, see [Create a space](https://developers.google.com/workspace/chat/create-spaces). If you receive the error message `ALREADY_EXISTS` when creating a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
261
261
  "flatPath": "v1/spaces",
262
262
  "httpMethod": "POST",
263
263
  "id": "chat.spaces.create",
@@ -283,7 +283,7 @@
283
283
  ]
284
284
  },
285
285
  "delete": {
286
- "description": "Deletes a named space. Always performs a cascading delete, which means that the space's child resources\u2014like messages posted in the space and memberships in the space\u2014are also deleted. For an example, see [Delete a space](https://developers.google.com/chat/api/guides/v1/spaces/delete). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) from a user who has permission to delete the space.",
286
+ "description": "Deletes a named space. Always performs a cascading delete, which means that the space's child resources\u2014like messages posted in the space and memberships in the space\u2014are also deleted. For an example, see [Delete a space](https://developers.google.com/workspace/chat/delete-spaces). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) from a user who has permission to delete the space.",
287
287
  "flatPath": "v1/spaces/{spacesId}",
288
288
  "httpMethod": "DELETE",
289
289
  "id": "chat.spaces.delete",
@@ -309,14 +309,14 @@
309
309
  ]
310
310
  },
311
311
  "findDirectMessage": {
312
- "description": "Returns the existing direct message with the specified user. If no direct message space is found, returns a `404 NOT_FOUND` error. For an example, see [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message). With [user authentication](https://developers.google.com/chat/api/guides/auth/users), returns the direct message space between the specified user and the authenticated user. With [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts), returns the direct message space between the specified user and the calling Chat app. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) or [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).",
312
+ "description": "Returns the existing direct message with the specified user. If no direct message space is found, returns a `404 NOT_FOUND` error. For an example, see [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message). With [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), returns the direct message space between the specified user and the authenticated user. With [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app), returns the direct message space between the specified user and the calling Chat app. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) or [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).",
313
313
  "flatPath": "v1/spaces:findDirectMessage",
314
314
  "httpMethod": "GET",
315
315
  "id": "chat.spaces.findDirectMessage",
316
316
  "parameterOrder": [],
317
317
  "parameters": {
318
318
  "name": {
319
- "description": "Required. Resource name of the user to find direct message with. Format: `users/{user}`, where `{user}` is either the `id` for the [person](https://developers.google.com/people/api/rest/v1/people) from the People API, or the `id` for the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Directory API. For example, if the People API profile ID is `123456789`, you can find a direct message with that person by using `users/123456789` as the `name`. When [authenticated as a user](https://developers.google.com/chat/api/guides/auth/users), you can use the email as an alias for `{user}`. For example, `users/example@gmail.com` where `example@gmail.com` is the email of the Google Chat user.",
319
+ "description": "Required. Resource name of the user to find direct message with. Format: `users/{user}`, where `{user}` is either the `id` for the [person](https://developers.google.com/people/api/rest/v1/people) from the People API, or the `id` for the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Directory API. For example, if the People API profile ID is `123456789`, you can find a direct message with that person by using `users/123456789` as the `name`. When [authenticated as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), you can use the email as an alias for `{user}`. For example, `users/example@gmail.com` where `example@gmail.com` is the email of the Google Chat user.",
320
320
  "location": "query",
321
321
  "type": "string"
322
322
  }
@@ -332,7 +332,7 @@
332
332
  ]
333
333
  },
334
334
  "get": {
335
- "description": "Returns details about a space. For an example, see [Get a space](https://developers.google.com/chat/api/guides/v1/spaces/get). Requires [authentication](https://developers.google.com/chat/api/guides/auth). Supports [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts) and [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
335
+ "description": "Returns details about a space. For an example, see [Get details about a space](https://developers.google.com/workspace/chat/get-spaces). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
336
336
  "flatPath": "v1/spaces/{spacesId}",
337
337
  "httpMethod": "GET",
338
338
  "id": "chat.spaces.get",
@@ -359,14 +359,14 @@
359
359
  ]
360
360
  },
361
361
  "list": {
362
- "description": "Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see [List spaces](https://developers.google.com/chat/api/guides/v1/spaces/list). Requires [authentication](https://developers.google.com/chat/api/guides/auth). Supports [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts) and [user authentication](https://developers.google.com/chat/api/guides/auth/users). Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent.",
362
+ "description": "Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see [List spaces](https://developers.google.com/workspace/chat/list-spaces). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent.",
363
363
  "flatPath": "v1/spaces",
364
364
  "httpMethod": "GET",
365
365
  "id": "chat.spaces.list",
366
366
  "parameterOrder": [],
367
367
  "parameters": {
368
368
  "filter": {
369
- "description": "Optional. A query filter. You can filter spaces by the space type ([`space_type`](https://developers.google.com/chat/api/reference/rest/v1/spaces#spacetype)). To filter by space type, you must specify valid enum value, such as `SPACE` or `GROUP_CHAT` (the `space_type` can't be `SPACE_TYPE_UNSPECIFIED`). To query for multiple space types, use the `OR` operator. For example, the following queries are valid: ``` space_type = \"SPACE\" spaceType = \"GROUP_CHAT\" OR spaceType = \"DIRECT_MESSAGE\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.",
369
+ "description": "Optional. A query filter. You can filter spaces by the space type ([`space_type`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces#spacetype)). To filter by space type, you must specify valid enum value, such as `SPACE` or `GROUP_CHAT` (the `space_type` can't be `SPACE_TYPE_UNSPECIFIED`). To query for multiple space types, use the `OR` operator. For example, the following queries are valid: ``` space_type = \"SPACE\" spaceType = \"GROUP_CHAT\" OR spaceType = \"DIRECT_MESSAGE\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.",
370
370
  "location": "query",
371
371
  "type": "string"
372
372
  },
@@ -393,7 +393,7 @@
393
393
  ]
394
394
  },
395
395
  "patch": {
396
- "description": "Updates a space. For an example, see [Update a space](https://developers.google.com/chat/api/guides/v1/spaces/update). If you're updating the `displayName` field and receive the error message `ALREADY_EXISTS`, try a different display name.. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
396
+ "description": "Updates a space. For an example, see [Update a space](https://developers.google.com/workspace/chat/update-spaces). If you're updating the `displayName` field and receive the error message `ALREADY_EXISTS`, try a different display name.. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
397
397
  "flatPath": "v1/spaces/{spacesId}",
398
398
  "httpMethod": "PATCH",
399
399
  "id": "chat.spaces.patch",
@@ -428,7 +428,7 @@
428
428
  ]
429
429
  },
430
430
  "setup": {
431
- "description": "Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see [Set up a space](https://developers.google.com/chat/api/guides/v1/spaces/set-up). To specify the human members to add, add memberships with the appropriate `member.name` in the `SetUpSpaceRequest`. To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. For a space or group chat, if the caller blocks or is blocked by some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to `true` and don't specify any memberships. You can only use this method to set up a DM with the calling app. To add the calling app as a member of a space or an existing DM between two human users, see [create a membership](https://developers.google.com/chat/api/guides/v1/members/create). If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies aren't supported. If you receive the error message `ALREADY_EXISTS` when setting up a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
431
+ "description": "Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see [Set up a space with initial members](https://developers.google.com/workspace/chat/set-up-spaces). To specify the human members to add, add memberships with the appropriate `member.name` in the `SetUpSpaceRequest`. To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. For a space or group chat, if the caller blocks or is blocked by some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to `true` and don't specify any memberships. You can only use this method to set up a DM with the calling app. To add the calling app as a member of a space or an existing DM between two human users, see [Invite or add a user or app to a space](https://developers.google.com/workspace/chat/create-members). If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies aren't supported. If you receive the error message `ALREADY_EXISTS` when setting up a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
432
432
  "flatPath": "v1/spaces:setup",
433
433
  "httpMethod": "POST",
434
434
  "id": "chat.spaces.setup",
@@ -451,7 +451,7 @@
451
451
  "members": {
452
452
  "methods": {
453
453
  "create": {
454
- "description": "Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see [ Create a membership](https://developers.google.com/chat/api/guides/v1/members/create). When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users). To specify the member to add, set the `membership.member.name` in the `CreateMembershipRequest`: - To add the calling app to a space or a direct message between two human users, use `users/app`. Unable to add other apps to the space. - To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`.",
454
+ "description": "Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see [Invite or add a user or a Google Chat app to a space](https://developers.google.com/workspace/chat/create-members). When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). To specify the member to add, set the `membership.member.name` in the `CreateMembershipRequest`: - To add the calling app to a space or a direct message between two human users, use `users/app`. Unable to add other apps to the space. - To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`.",
455
455
  "flatPath": "v1/spaces/{spacesId}/members",
456
456
  "httpMethod": "POST",
457
457
  "id": "chat.spaces.members.create",
@@ -481,7 +481,7 @@
481
481
  ]
482
482
  },
483
483
  "delete": {
484
- "description": "Deletes a membership. For an example, see [Delete a membership](https://developers.google.com/chat/api/guides/v1/members/delete). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
484
+ "description": "Deletes a membership. For an example, see [Remove a user or a Google Chat app from a space](https://developers.google.com/workspace/chat/delete-members). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
485
485
  "flatPath": "v1/spaces/{spacesId}/members/{membersId}",
486
486
  "httpMethod": "DELETE",
487
487
  "id": "chat.spaces.members.delete",
@@ -508,7 +508,7 @@
508
508
  ]
509
509
  },
510
510
  "get": {
511
- "description": "Returns details about a membership. For an example, see [Get a membership](https://developers.google.com/chat/api/guides/v1/members/get). Requires [authentication](https://developers.google.com/chat/api/guides/auth). Supports [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts) and [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
511
+ "description": "Returns details about a membership. For an example, see [Get details about a user's or Google Chat app's membership](https://developers.google.com/workspace/chat/get-members). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
512
512
  "flatPath": "v1/spaces/{spacesId}/members/{membersId}",
513
513
  "httpMethod": "GET",
514
514
  "id": "chat.spaces.members.get",
@@ -517,7 +517,7 @@
517
517
  ],
518
518
  "parameters": {
519
519
  "name": {
520
- "description": "Required. Resource name of the membership to retrieve. To get the app's own membership, you can optionally use `spaces/{space}/members/app`. Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app` When [authenticated as a user](https://developers.google.com/chat/api/guides/auth/users), you can use the user's email as an alias for `{member}`. For example, `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the email of the Google Chat user.",
520
+ "description": "Required. Resource name of the membership to retrieve. To get the app's own membership, you can optionally use `spaces/{space}/members/app`. Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app` When [authenticated as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), you can use the user's email as an alias for `{member}`. For example, `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the email of the Google Chat user.",
521
521
  "location": "path",
522
522
  "pattern": "^spaces/[^/]+/members/[^/]+$",
523
523
  "required": true,
@@ -535,7 +535,7 @@
535
535
  ]
536
536
  },
537
537
  "list": {
538
- "description": "Lists memberships in a space. For an example, see [List memberships](https://developers.google.com/chat/api/guides/v1/members/list). Listing memberships with [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/chat/api/guides/auth/users) lists memberships in spaces that the authenticated user has access to. Requires [authentication](https://developers.google.com/chat/api/guides/auth). Supports [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts) and [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
538
+ "description": "Lists memberships in a space. For an example, see [List users and Google Chat apps in a space](https://developers.google.com/workspace/chat/list-members). Listing memberships with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships in spaces that the authenticated user has access to. Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
539
539
  "flatPath": "v1/spaces/{spacesId}/members",
540
540
  "httpMethod": "GET",
541
541
  "id": "chat.spaces.members.list",
@@ -544,7 +544,7 @@
544
544
  ],
545
545
  "parameters": {
546
546
  "filter": {
547
- "description": "Optional. A query filter. You can filter memberships by a member's role ([`role`](https://developers.google.com/chat/api/reference/rest/v1/spaces.members#membershiprole)) and type ([`member.type`](https://developers.google.com/chat/api/reference/rest/v1/User#type)). To filter by role, set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`. To filter by type, set `member.type` to `HUMAN` or `BOT`. To filter by both role and type, use the `AND` operator. To filter by either role or type, use the `OR` operator. For example, the following queries are valid: ``` role = \"ROLE_MANAGER\" OR role = \"ROLE_MEMBER\" member.type = \"HUMAN\" AND role = \"ROLE_MANAGER\" ``` The following queries are invalid: ``` member.type = \"HUMAN\" AND member.type = \"BOT\" role = \"ROLE_MANAGER\" AND role = \"ROLE_MEMBER\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.",
547
+ "description": "Optional. A query filter. You can filter memberships by a member's role ([`role`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.members#membershiprole)) and type ([`member.type`](https://developers.google.com/workspace/chat/api/reference/rest/v1/User#type)). To filter by role, set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`. To filter by type, set `member.type` to `HUMAN` or `BOT`. To filter by both role and type, use the `AND` operator. To filter by either role or type, use the `OR` operator. For example, the following queries are valid: ``` role = \"ROLE_MANAGER\" OR role = \"ROLE_MEMBER\" member.type = \"HUMAN\" AND role = \"ROLE_MANAGER\" ``` The following queries are invalid: ``` member.type = \"HUMAN\" AND member.type = \"BOT\" role = \"ROLE_MANAGER\" AND role = \"ROLE_MEMBER\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.",
548
548
  "location": "query",
549
549
  "type": "string"
550
550
  },
@@ -572,7 +572,7 @@
572
572
  "type": "boolean"
573
573
  },
574
574
  "showInvited": {
575
- "description": "Optional. When `true`, also returns memberships associated with invited members, in addition to other types of memberships. If a filter is set, invited memberships that don't match the filter criteria aren't returned. Currently requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
575
+ "description": "Optional. When `true`, also returns memberships associated with invited members, in addition to other types of memberships. If a filter is set, invited memberships that don't match the filter criteria aren't returned. Currently requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
576
576
  "location": "query",
577
577
  "type": "boolean"
578
578
  }
@@ -593,7 +593,7 @@
593
593
  "messages": {
594
594
  "methods": {
595
595
  "create": {
596
- "description": "Creates a message in a Google Chat space. For an example, see [Create a message](https://developers.google.com/chat/api/guides/v1/messages/create). Calling this method requires [authentication](https://developers.google.com/chat/api/guides/auth) and supports the following authentication types: - For text messages, user authentication or app authentication are supported. - For card messages, only app authentication is supported. (Only Chat apps can create card messages.)",
596
+ "description": "Creates a message in a Google Chat space. For an example, see [Send a message](https://developers.google.com/workspace/chat/create-messages). Calling this method requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize) and supports the following authentication types: - For text messages, user authentication or app authentication are supported. - For card messages, only app authentication is supported. (Only Chat apps can create card messages.)",
597
597
  "flatPath": "v1/spaces/{spacesId}/messages",
598
598
  "httpMethod": "POST",
599
599
  "id": "chat.spaces.messages.create",
@@ -602,7 +602,7 @@
602
602
  ],
603
603
  "parameters": {
604
604
  "messageId": {
605
- "description": "Optional. A custom ID for a message. Lets Chat apps get, update, or delete a message without needing to store the system-assigned ID in the message's resource name (represented in the message `name` field). The value for this field must meet the following requirements: * Begins with `client-`. For example, `client-custom-name` is a valid custom ID, but `custom-name` is not. * Contains up to 63 characters and only lowercase letters, numbers, and hyphens. * Is unique within a space. A Chat app can't use the same custom ID for different messages. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).",
605
+ "description": "Optional. A custom ID for a message. Lets Chat apps get, update, or delete a message without needing to store the system-assigned ID in the message's resource name (represented in the message `name` field). The value for this field must meet the following requirements: * Begins with `client-`. For example, `client-custom-name` is a valid custom ID, but `custom-name` is not. * Contains up to 63 characters and only lowercase letters, numbers, and hyphens. * Is unique within a space. A Chat app can't use the same custom ID for different messages. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
606
606
  "location": "query",
607
607
  "type": "string"
608
608
  },
@@ -635,7 +635,7 @@
635
635
  },
636
636
  "threadKey": {
637
637
  "deprecated": true,
638
- "description": "Optional. Deprecated: Use thread.thread_key instead. ID for the thread. Supports up to 4000 characters. To start or add to a thread, create a message and specify a `threadKey` or the thread.name. For example usage, see [Start or reply to a message thread](https://developers.google.com/chat/api/guides/v1/messages/create#create-message-thread).",
638
+ "description": "Optional. Deprecated: Use thread.thread_key instead. ID for the thread. Supports up to 4000 characters. To start or add to a thread, create a message and specify a `threadKey` or the thread.name. For example usage, see [Start or reply to a message thread](https://developers.google.com/workspace/chat/create-messages#create-message-thread).",
639
639
  "location": "query",
640
640
  "type": "string"
641
641
  }
@@ -655,7 +655,7 @@
655
655
  ]
656
656
  },
657
657
  "delete": {
658
- "description": "Deletes a message. For an example, see [Delete a message](https://developers.google.com/chat/api/guides/v1/messages/delete). Requires [authentication](https://developers.google.com/chat/api/guides/auth). Supports [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts) and [user authentication](https://developers.google.com/chat/api/guides/auth/users). When using app authentication, requests can only delete messages created by the calling Chat app.",
658
+ "description": "Deletes a message. For an example, see [Delete a message](https://developers.google.com/workspace/chat/delete-messages). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). When using app authentication, requests can only delete messages created by the calling Chat app.",
659
659
  "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}",
660
660
  "httpMethod": "DELETE",
661
661
  "id": "chat.spaces.messages.delete",
@@ -664,12 +664,12 @@
664
664
  ],
665
665
  "parameters": {
666
666
  "force": {
667
- "description": "When `true`, deleting a message also deletes its threaded replies. When `false`, if a message has threaded replies, deletion fails. Only applies when [authenticating as a user](https://developers.google.com/chat/api/guides/auth/users). Has no effect when [authenticating as a Chat app] (https://developers.google.com/chat/api/guides/auth/service-accounts).",
667
+ "description": "When `true`, deleting a message also deletes its threaded replies. When `false`, if a message has threaded replies, deletion fails. Only applies when [authenticating as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). Has no effect when [authenticating as a Chat app] (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).",
668
668
  "location": "query",
669
669
  "type": "boolean"
670
670
  },
671
671
  "name": {
672
- "description": "Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `clientAssignedMessageId` field for `{message}`. For details, see [Name a message] (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).",
672
+ "description": "Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `clientAssignedMessageId` field for `{message}`. For details, see [Name a message] (https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
673
673
  "location": "path",
674
674
  "pattern": "^spaces/[^/]+/messages/[^/]+$",
675
675
  "required": true,
@@ -687,7 +687,7 @@
687
687
  ]
688
688
  },
689
689
  "get": {
690
- "description": "Returns details about a message. For an example, see [Read a message](https://developers.google.com/chat/api/guides/v1/messages/get). Requires [authentication](https://developers.google.com/chat/api/guides/auth). Supports [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts) and [user authentication](https://developers.google.com/chat/api/guides/auth/users). Note: Might return a message from a blocked member or space.",
690
+ "description": "Returns details about a message. For an example, see [Get details about a message](https://developers.google.com/workspace/chat/get-messages). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). Note: Might return a message from a blocked member or space.",
691
691
  "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}",
692
692
  "httpMethod": "GET",
693
693
  "id": "chat.spaces.messages.get",
@@ -696,7 +696,7 @@
696
696
  ],
697
697
  "parameters": {
698
698
  "name": {
699
- "description": "Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `clientAssignedMessageId` field for `{message}`. For details, see [Name a message] (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).",
699
+ "description": "Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `clientAssignedMessageId` field for `{message}`. For details, see [Name a message] (https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
700
700
  "location": "path",
701
701
  "pattern": "^spaces/[^/]+/messages/[^/]+$",
702
702
  "required": true,
@@ -714,7 +714,7 @@
714
714
  ]
715
715
  },
716
716
  "list": {
717
- "description": "Lists messages in a space that the caller is a member of, including messages from blocked members and spaces. For an example, see [List messages](/chat/api/guides/v1/messages/list). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
717
+ "description": "Lists messages in a space that the caller is a member of, including messages from blocked members and spaces. For an example, see [List messages](/chat/api/guides/v1/messages/list). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
718
718
  "flatPath": "v1/spaces/{spacesId}/messages",
719
719
  "httpMethod": "GET",
720
720
  "id": "chat.spaces.messages.list",
@@ -767,7 +767,7 @@
767
767
  ]
768
768
  },
769
769
  "patch": {
770
- "description": "Updates a message. There's a difference between the `patch` and `update` methods. The `patch` method uses a `patch` request while the `update` method uses a `put` request. We recommend using the `patch` method. For an example, see [Update a message](https://developers.google.com/chat/api/guides/v1/messages/update). Requires [authentication](https://developers.google.com/chat/api/guides/auth). Supports [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts) and [user authentication](https://developers.google.com/chat/api/guides/auth/users). When using app authentication, requests can only update messages created by the calling Chat app.",
770
+ "description": "Updates a message. There's a difference between the `patch` and `update` methods. The `patch` method uses a `patch` request while the `update` method uses a `put` request. We recommend using the `patch` method. For an example, see [Update a message](https://developers.google.com/workspace/chat/update-messages). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). When using app authentication, requests can only update messages created by the calling Chat app.",
771
771
  "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}",
772
772
  "httpMethod": "PATCH",
773
773
  "id": "chat.spaces.messages.patch",
@@ -776,12 +776,12 @@
776
776
  ],
777
777
  "parameters": {
778
778
  "allowMissing": {
779
- "description": "Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message) or the request fails.",
779
+ "description": "Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https://developers.google.com/workspace/chat/create-messages#name_a_created_message) or the request fails.",
780
780
  "location": "query",
781
781
  "type": "boolean"
782
782
  },
783
783
  "name": {
784
- "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).",
784
+ "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
785
785
  "location": "path",
786
786
  "pattern": "^spaces/[^/]+/messages/[^/]+$",
787
787
  "required": true,
@@ -808,7 +808,7 @@
808
808
  ]
809
809
  },
810
810
  "update": {
811
- "description": "Updates a message. There's a difference between the `patch` and `update` methods. The `patch` method uses a `patch` request while the `update` method uses a `put` request. We recommend using the `patch` method. For an example, see [Update a message](https://developers.google.com/chat/api/guides/v1/messages/update). Requires [authentication](https://developers.google.com/chat/api/guides/auth). Supports [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts) and [user authentication](https://developers.google.com/chat/api/guides/auth/users). When using app authentication, requests can only update messages created by the calling Chat app.",
811
+ "description": "Updates a message. There's a difference between the `patch` and `update` methods. The `patch` method uses a `patch` request while the `update` method uses a `put` request. We recommend using the `patch` method. For an example, see [Update a message](https://developers.google.com/workspace/chat/update-messages). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). When using app authentication, requests can only update messages created by the calling Chat app.",
812
812
  "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}",
813
813
  "httpMethod": "PUT",
814
814
  "id": "chat.spaces.messages.update",
@@ -817,12 +817,12 @@
817
817
  ],
818
818
  "parameters": {
819
819
  "allowMissing": {
820
- "description": "Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message) or the request fails.",
820
+ "description": "Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https://developers.google.com/workspace/chat/create-messages#name_a_created_message) or the request fails.",
821
821
  "location": "query",
822
822
  "type": "boolean"
823
823
  },
824
824
  "name": {
825
- "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).",
825
+ "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
826
826
  "location": "path",
827
827
  "pattern": "^spaces/[^/]+/messages/[^/]+$",
828
828
  "required": true,
@@ -853,7 +853,7 @@
853
853
  "attachments": {
854
854
  "methods": {
855
855
  "get": {
856
- "description": "Gets the metadata of a message attachment. The attachment data is fetched using the [media API](https://developers.google.com/chat/api/reference/rest/v1/media/download). For an example, see [Get a message attachment](https://developers.google.com/chat/api/guides/v1/media-and-attachments/get). Requires [app authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).",
856
+ "description": "Gets the metadata of a message attachment. The attachment data is fetched using the [media API](https://developers.google.com/workspace/chat/api/reference/rest/v1/media/download). For an example, see [Get metadata about a message attachment](https://developers.google.com/workspace/chat/get-media-attachments). Requires [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).",
857
857
  "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}/attachments/{attachmentsId}",
858
858
  "httpMethod": "GET",
859
859
  "id": "chat.spaces.messages.attachments.get",
@@ -882,7 +882,7 @@
882
882
  "reactions": {
883
883
  "methods": {
884
884
  "create": {
885
- "description": "Creates a reaction and adds it to a message. For an example, see [Create a reaction](https://developers.google.com/chat/api/guides/v1/reactions/create). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users). Only unicode emoji are supported.",
885
+ "description": "Creates a reaction and adds it to a message. Only unicode emojis are supported. For an example, see [Add a reaction to a message](https://developers.google.com/workspace/chat/create-reactions). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
886
886
  "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}/reactions",
887
887
  "httpMethod": "POST",
888
888
  "id": "chat.spaces.messages.reactions.create",
@@ -913,7 +913,7 @@
913
913
  ]
914
914
  },
915
915
  "delete": {
916
- "description": "Deletes a reaction to a message. For an example, see [Delete a reaction](https://developers.google.com/chat/api/guides/v1/reactions/delete). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
916
+ "description": "Deletes a reaction to a message. Only unicode emojis are supported. For an example, see [Delete a reaction](https://developers.google.com/workspace/chat/delete-reactions). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
917
917
  "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}/reactions/{reactionsId}",
918
918
  "httpMethod": "DELETE",
919
919
  "id": "chat.spaces.messages.reactions.delete",
@@ -940,7 +940,7 @@
940
940
  ]
941
941
  },
942
942
  "list": {
943
- "description": "Lists reactions to a message. For an example, see [List reactions](https://developers.google.com/chat/api/guides/v1/reactions/list). Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
943
+ "description": "Lists reactions to a message. For an example, see [List reactions for a message](https://developers.google.com/workspace/chat/list-reactions). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
944
944
  "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}/reactions",
945
945
  "httpMethod": "GET",
946
946
  "id": "chat.spaces.messages.reactions.list",
@@ -949,7 +949,7 @@
949
949
  ],
950
950
  "parameters": {
951
951
  "filter": {
952
- "description": "Optional. A query filter. You can filter reactions by [emoji](https://developers.google.com/chat/api/reference/rest/v1/Emoji) (either `emoji.unicode` or `emoji.custom_emoji.uid`) and [user](https://developers.google.com/chat/api/reference/rest/v1/User) (`user.name`). To filter reactions for multiple emojis or users, join similar fields with the `OR` operator, such as `emoji.unicode = \"\ud83d\ude42\" OR emoji.unicode = \"\ud83d\udc4d\"` and `user.name = \"users/AAAAAA\" OR user.name = \"users/BBBBBB\"`. To filter reactions by emoji and user, use the `AND` operator, such as `emoji.unicode = \"\ud83d\ude42\" AND user.name = \"users/AAAAAA\"`. If your query uses both `AND` and `OR`, group them with parentheses. For example, the following queries are valid: ``` user.name = \"users/{user}\" emoji.unicode = \"\ud83d\ude42\" emoji.custom_emoji.uid = \"{uid}\" emoji.unicode = \"\ud83d\ude42\" OR emoji.unicode = \"\ud83d\udc4d\" emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\" emoji.unicode = \"\ud83d\ude42\" AND user.name = \"users/{user}\" (emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\") AND user.name = \"users/{user}\" ``` The following queries are invalid: ``` emoji.unicode = \"\ud83d\ude42\" AND emoji.unicode = \"\ud83d\udc4d\" emoji.unicode = \"\ud83d\ude42\" AND emoji.custom_emoji.uid = \"{uid}\" emoji.unicode = \"\ud83d\ude42\" OR user.name = \"users/{user}\" emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\" OR user.name = \"users/{user}\" emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\" AND user.name = \"users/{user}\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.",
952
+ "description": "Optional. A query filter. You can filter reactions by [emoji](https://developers.google.com/workspace/chat/api/reference/rest/v1/Emoji) (either `emoji.unicode` or `emoji.custom_emoji.uid`) and [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) (`user.name`). To filter reactions for multiple emojis or users, join similar fields with the `OR` operator, such as `emoji.unicode = \"\ud83d\ude42\" OR emoji.unicode = \"\ud83d\udc4d\"` and `user.name = \"users/AAAAAA\" OR user.name = \"users/BBBBBB\"`. To filter reactions by emoji and user, use the `AND` operator, such as `emoji.unicode = \"\ud83d\ude42\" AND user.name = \"users/AAAAAA\"`. If your query uses both `AND` and `OR`, group them with parentheses. For example, the following queries are valid: ``` user.name = \"users/{user}\" emoji.unicode = \"\ud83d\ude42\" emoji.custom_emoji.uid = \"{uid}\" emoji.unicode = \"\ud83d\ude42\" OR emoji.unicode = \"\ud83d\udc4d\" emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\" emoji.unicode = \"\ud83d\ude42\" AND user.name = \"users/{user}\" (emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\") AND user.name = \"users/{user}\" ``` The following queries are invalid: ``` emoji.unicode = \"\ud83d\ude42\" AND emoji.unicode = \"\ud83d\udc4d\" emoji.unicode = \"\ud83d\ude42\" AND emoji.custom_emoji.uid = \"{uid}\" emoji.unicode = \"\ud83d\ude42\" OR user.name = \"users/{user}\" emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\" OR user.name = \"users/{user}\" emoji.unicode = \"\ud83d\ude42\" OR emoji.custom_emoji.uid = \"{uid}\" AND user.name = \"users/{user}\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.",
953
953
  "location": "query",
954
954
  "type": "string"
955
955
  },
@@ -990,7 +990,7 @@
990
990
  "spaceEvents": {
991
991
  "methods": {
992
992
  "get": {
993
- "description": "Returns a SpaceEvent. You can request events from up to 28 days before the time of the request. The server will return the most recent version of the resource. For example, if a `google.workspace.chat.message.v1.created` event is requested and the message has since been deleted, the returned event will contain the deleted message resource in the payload. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
993
+ "description": "Returns an event from a Google Chat space. The [event payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload) contains the most recent version of the resource that changed. For example, if you request an event about a new message but the message was later updated, the server returns the updated `Message` resource in the event payload. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). To get an event, the authenticated user must be a member of the space. For an example, see [Get details about an event from a Google Chat space](https://developers.google.com/workspace/chat/get-space-event).",
994
994
  "flatPath": "v1/spaces/{spacesId}/spaceEvents/{spaceEventsId}",
995
995
  "httpMethod": "GET",
996
996
  "id": "chat.spaces.spaceEvents.get",
@@ -999,7 +999,7 @@
999
999
  ],
1000
1000
  "parameters": {
1001
1001
  "name": {
1002
- "description": "Required. The resource name of the event. Format: `spaces/{space}/spaceEvents/{spaceEvent}`",
1002
+ "description": "Required. The resource name of the space event. Format: `spaces/{space}/spaceEvents/{spaceEvent}`",
1003
1003
  "location": "path",
1004
1004
  "pattern": "^spaces/[^/]+/spaceEvents/[^/]+$",
1005
1005
  "required": true,
@@ -1022,7 +1022,7 @@
1022
1022
  ]
1023
1023
  },
1024
1024
  "list": {
1025
- "description": "Lists SpaceEvents in a space that the caller is a member of. You can request events from up to 28 days before the time of the request. The server will return the most recent version of the resources. For example, if a `google.workspace.chat.message.v1.created` event is requested and the message has since been deleted, the returned event will contain the deleted message resource in the payload. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users).",
1025
+ "description": "Lists events from a Google Chat space. For each event, the [payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload) contains the most recent version of the Chat resource. For example, if you list events about new space members, the server returns `Membership` resources that contain the latest membership details. If new members were removed during the requested period, the event payload contains an empty `Membership` resource. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). To list events, the authenticated user must be a member of the space. For an example, see [List events from a Google Chat space](https://developers.google.com/workspace/chat/list-space-events).",
1026
1026
  "flatPath": "v1/spaces/{spacesId}/spaceEvents",
1027
1027
  "httpMethod": "GET",
1028
1028
  "id": "chat.spaces.spaceEvents.list",
@@ -1031,12 +1031,12 @@
1031
1031
  ],
1032
1032
  "parameters": {
1033
1033
  "filter": {
1034
- "description": "Required. A query filter. This method supports filtering by: `event_types`, `start_time`, and `end_time`. `event_types`: You must specify at least one event type in your query. `event_types` supports the has `:` operator. To filter by multiple event types, use the `OR` operator. To see the list of currently supported event types, see google.chat.v1.SpaceEvent.event_type `start_time`: Exclusive timestamp from which to start listing space events. You can list events that occurred up to 28 days ago. If unspecified, lists space events from the 28 days ago up to end time. `end_time`: Inclusive timestamp up to which space events are listed. Default value is the present. `start_time` and `end_time` accept a timestamp in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and support the equals `=` comparison operator. To filter by both `start_time` and `end_time`, use the `AND` operator. For example, the following queries are valid: ``` start_time=\"2023-08-23T19:20:33+00:00\" AND end_time=\"2023-08-23T19:21:54+00:00\" ``` ``` start_time=\"2023-08-23T19:20:33+00:00\" AND (event_types:\"google.workspace.chat.space.v1.updated\" OR event_types:\"google.workspace.chat.message.v1.created\") ``` The following queries are invalid: ``` start_time=\"2023-08-23T19:20:33+00:00\" OR end_time=\"2023-08-23T19:21:54+00:00\" ``` ``` event_types:\"google.workspace.chat.space.v1.updated\" AND event_types:\"google.workspace.chat.message.v1.created\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.",
1034
+ "description": "Required. A query filter. You must specify at least one event type (`event_type`) using the has `:` operator. To filter by multiple event types, use the `OR` operator. Omit batch event types in your filter. The request automatically returns any related batch events. For example, if you filter by new reactions (`google.workspace.chat.reaction.v1.created`), the server also returns batch new reactions events (`google.workspace.chat.reaction.v1.batchCreated`). For a list of supported event types, see the [`SpaceEvents` reference documentation](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.event_type). Optionally, you can also filter by start time (`start_time`) and end time (`end_time`): * `start_time`: Exclusive timestamp from which to start listing space events. You can list events that occurred up to 28 days ago. If unspecified, lists space events from the past 28 days. * `end_time`: Inclusive timestamp until which space events are listed. If unspecified, lists events up to the time of the request. To specify a start or end time, use the equals `=` operator and format in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339). To filter by both `start_time` and `end_time`, use the `AND` operator. For example, the following queries are valid: ``` start_time=\"2023-08-23T19:20:33+00:00\" AND end_time=\"2023-08-23T19:21:54+00:00\" ``` ``` start_time=\"2023-08-23T19:20:33+00:00\" AND (event_types:\"google.workspace.chat.space.v1.updated\" OR event_types:\"google.workspace.chat.message.v1.created\") ``` The following queries are invalid: ``` start_time=\"2023-08-23T19:20:33+00:00\" OR end_time=\"2023-08-23T19:21:54+00:00\" ``` ``` event_types:\"google.workspace.chat.space.v1.updated\" AND event_types:\"google.workspace.chat.message.v1.created\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.",
1035
1035
  "location": "query",
1036
1036
  "type": "string"
1037
1037
  },
1038
1038
  "pageSize": {
1039
- "description": "Optional. The maximum number of space events returned. The service may return fewer than this value. Negative values return an `INVALID_ARGUMENT` error.",
1039
+ "description": "Optional. The maximum number of space events returned. The service might return fewer than this value. Negative values return an `INVALID_ARGUMENT` error.",
1040
1040
  "format": "int32",
1041
1041
  "location": "query",
1042
1042
  "type": "integer"
@@ -1047,7 +1047,7 @@
1047
1047
  "type": "string"
1048
1048
  },
1049
1049
  "parent": {
1050
- "description": "Required. The resource name of the space from which to list events. Format: `spaces/{space}`.",
1050
+ "description": "Required. Resource name of the [Google Chat space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) where the events occurred. Format: `spaces/{space}`.",
1051
1051
  "location": "path",
1052
1052
  "pattern": "^spaces/[^/]+$",
1053
1053
  "required": true,
@@ -1074,7 +1074,7 @@
1074
1074
  }
1075
1075
  }
1076
1076
  },
1077
- "revision": "20240326",
1077
+ "revision": "20240411",
1078
1078
  "rootUrl": "https://chat.googleapis.com/",
1079
1079
  "schemas": {
1080
1080
  "AccessoryWidget": {
@@ -1109,7 +1109,7 @@
1109
1109
  "properties": {
1110
1110
  "dialogAction": {
1111
1111
  "$ref": "DialogAction",
1112
- "description": "Input only. A response to an interaction event related to a [dialog](https://developers.google.com/chat/how-tos/dialogs). Must be accompanied by `ResponseType.Dialog`."
1112
+ "description": "Input only. A response to an interaction event related to a [dialog](https://developers.google.com/workspace/chat/dialogs). Must be accompanied by `ResponseType.Dialog`."
1113
1113
  },
1114
1114
  "type": {
1115
1115
  "description": "Input only. The type of Chat app response.",
@@ -1128,7 +1128,7 @@
1128
1128
  "Update the Chat app's message. This is only permitted on a `CARD_CLICKED` event where the message sender type is `BOT`.",
1129
1129
  "Update the cards on a user's message. This is only permitted as a response to a `MESSAGE` event with a matched url, or a `CARD_CLICKED` event where the message sender type is `HUMAN`. Text is ignored.",
1130
1130
  "Privately ask the user for additional authentication or configuration.",
1131
- "Presents a [dialog](https://developers.google.com/chat/how-tos/dialogs).",
1131
+ "Presents a [dialog](https://developers.google.com/workspace/chat/dialogs).",
1132
1132
  "Widget text autocomplete options query."
1133
1133
  ],
1134
1134
  "type": "string"
@@ -1145,7 +1145,7 @@
1145
1145
  "type": "object"
1146
1146
  },
1147
1147
  "ActionStatus": {
1148
- "description": "Represents the status for a request to either invoke or submit a [dialog](https://developers.google.com/chat/how-tos/dialogs).",
1148
+ "description": "Represents the status for a request to either invoke or submit a [dialog](https://developers.google.com/workspace/chat/dialogs).",
1149
1149
  "id": "ActionStatus",
1150
1150
  "properties": {
1151
1151
  "statusCode": {
@@ -1198,7 +1198,7 @@
1198
1198
  "type": "object"
1199
1199
  },
1200
1200
  "Annotation": {
1201
- "description": "Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!\" ``` The corresponding annotations metadata: ``` \"annotations\":[{ \"type\":\"USER_MENTION\", \"startIndex\":6, \"length\":7, \"userMention\": { \"user\": { \"name\":\"users/{user}\", \"displayName\":\"FooBot\", \"avatarUrl\":\"https://goo.gl/aeDtrS\", \"type\":\"BOT\" }, \"type\":\"MENTION\" } }] ```",
1201
+ "description": "Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!\" ``` The corresponding annotations metadata: ``` \"annotations\":[{ \"type\":\"USER_MENTION\", \"startIndex\":6, \"length\":7, \"userMention\": { \"user\": { \"name\":\"users/{user}\", \"displayName\":\"FooBot\", \"avatarUrl\":\"https://goo.gl/aeDtrS\", \"type\":\"BOT\" }, \"type\":\"MENTION\" } }] ```",
1202
1202
  "id": "Annotation",
1203
1203
  "properties": {
1204
1204
  "length": {
@@ -1294,9 +1294,9 @@
1294
1294
  "UPLOADED_CONTENT"
1295
1295
  ],
1296
1296
  "enumDescriptions": [
1297
- "",
1298
- "",
1299
- ""
1297
+ "Reserved.",
1298
+ "The file is a Google Drive file.",
1299
+ "The file is uploaded to Chat."
1300
1300
  ],
1301
1301
  "readOnly": true,
1302
1302
  "type": "string"
@@ -1310,6 +1310,7 @@
1310
1310
  "type": "object"
1311
1311
  },
1312
1312
  "AttachmentDataRef": {
1313
+ "description": "A reference to the attachment data.",
1313
1314
  "id": "AttachmentDataRef",
1314
1315
  "properties": {
1315
1316
  "attachmentUploadToken": {
@@ -1415,7 +1416,7 @@
1415
1416
  "type": "object"
1416
1417
  },
1417
1418
  "CardWithId": {
1418
- "description": "A [card](https://developers.google.com/chat/api/reference/rest/v1/cards) in a Google Chat message. Only Chat apps can create cards. If your Chat app [authenticates as a user](https://developers.google.com/chat/api/guides/auth/users), the message can't contain cards. [Card builder](https://addons.gsuite.google.com/uikit/builder)",
1419
+ "description": "A [card](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards) in a Google Chat message. Only Chat apps can create cards. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the message can't contain cards. [Card builder](https://addons.gsuite.google.com/uikit/builder)",
1419
1420
  "id": "CardWithId",
1420
1421
  "properties": {
1421
1422
  "card": {
@@ -1572,6 +1573,7 @@
1572
1573
  "type": "object"
1573
1574
  },
1574
1575
  "CompleteImportSpaceResponse": {
1576
+ "description": "Response message for completing the import process for a space.",
1575
1577
  "id": "CompleteImportSpaceResponse",
1576
1578
  "properties": {
1577
1579
  "space": {
@@ -1659,18 +1661,18 @@
1659
1661
  "properties": {
1660
1662
  "action": {
1661
1663
  "$ref": "FormAction",
1662
- "description": "For `CARD_CLICKED` interaction events, the form action data associated when a user clicks a card or dialog. To learn more, see [Read form data input by users on cards](https://developers.google.com/chat/ui/read-form-data)."
1664
+ "description": "For `CARD_CLICKED` interaction events, the form action data associated when a user clicks a card or dialog. To learn more, see [Read form data input by users on cards](https://developers.google.com/workspace/chat/read-form-data)."
1663
1665
  },
1664
1666
  "common": {
1665
1667
  "$ref": "CommonEventObject",
1666
- "description": "Represents information about the user's client, such as locale, host app, and platform. For Chat apps, `CommonEventObject` includes information submitted by users interacting with [dialogs](https://developers.google.com/chat/how-tos/dialogs), like data entered on a card."
1668
+ "description": "Represents information about the user's client, such as locale, host app, and platform. For Chat apps, `CommonEventObject` includes information submitted by users interacting with [dialogs](https://developers.google.com/workspace/chat/dialogs), like data entered on a card."
1667
1669
  },
1668
1670
  "configCompleteRedirectUrl": {
1669
- "description": "The URL the Chat app should redirect the user to after they have completed an authorization or configuration flow outside of Google Chat. For more information, see [Connect a Chat app with other services & tools](https://developers.google.com/chat/how-tos/connect-web-services-tools).",
1671
+ "description": "The URL the Chat app should redirect the user to after they have completed an authorization or configuration flow outside of Google Chat. For more information, see [Connect a Chat app with other services & tools](https://developers.google.com/workspace/chat/connect-web-services-tools).",
1670
1672
  "type": "string"
1671
1673
  },
1672
1674
  "dialogEventType": {
1673
- "description": "The type of [dialog](https://developers.google.com/chat/how-tos/dialogs) interaction event received.",
1675
+ "description": "The type of [dialog](https://developers.google.com/workspace/chat/dialogs) interaction event received.",
1674
1676
  "enum": [
1675
1677
  "TYPE_UNSPECIFIED",
1676
1678
  "REQUEST_DIALOG",
@@ -1691,7 +1693,7 @@
1691
1693
  "type": "string"
1692
1694
  },
1693
1695
  "isDialogEvent": {
1694
- "description": "For `CARD_CLICKED` interaction events, whether the user interacted with a [dialog](https://developers.google.com/chat/how-tos/dialogs).",
1696
+ "description": "For `CARD_CLICKED` interaction events, whether the user interacted with a [dialog](https://developers.google.com/workspace/chat/dialogs).",
1695
1697
  "type": "boolean"
1696
1698
  },
1697
1699
  "message": {
@@ -1725,7 +1727,7 @@
1725
1727
  "A user sends the Chat app a message, or invokes the Chat app in a space.",
1726
1728
  "A user adds the Chat app to a space, or a Google Workspace administrator installs the Chat app in direct message spaces for users in their organization.",
1727
1729
  "A user removes the Chat app from a space.",
1728
- "A user clicks an interactive element of a card or dialog from a Chat app, such as a button. If a user interacts with a dialog, the `CARD_CLICKED` interaction event's `isDialogEvent` field is set to `true` and includes a [`DialogEventType`](https://developers.google.com/chat/api/reference/rest/v1/DialogEventType).",
1730
+ "A user clicks an interactive element of a card or dialog from a Chat app, such as a button. If a user interacts with a dialog, the `CARD_CLICKED` interaction event's `isDialogEvent` field is set to `true` and includes a [`DialogEventType`](https://developers.google.com/workspace/chat/api/reference/rest/v1/DialogEventType).",
1729
1731
  "A user updates a widget in a card message or dialog."
1730
1732
  ],
1731
1733
  "type": "string"
@@ -1749,16 +1751,16 @@
1749
1751
  "type": "object"
1750
1752
  },
1751
1753
  "DialogAction": {
1752
- "description": "Contains a [dialog](https://developers.google.com/chat/how-tos/dialogs) and request status code.",
1754
+ "description": "Contains a [dialog](https://developers.google.com/workspace/chat/dialogs) and request status code.",
1753
1755
  "id": "DialogAction",
1754
1756
  "properties": {
1755
1757
  "actionStatus": {
1756
1758
  "$ref": "ActionStatus",
1757
- "description": "Input only. Status for a request to either invoke or submit a [dialog](https://developers.google.com/chat/how-tos/dialogs). Displays a status and message to users, if necessary. For example, in case of an error or success."
1759
+ "description": "Input only. Status for a request to either invoke or submit a [dialog](https://developers.google.com/workspace/chat/dialogs). Displays a status and message to users, if necessary. For example, in case of an error or success."
1758
1760
  },
1759
1761
  "dialog": {
1760
1762
  "$ref": "Dialog",
1761
- "description": "Input only. [Dialog](https://developers.google.com/chat/how-tos/dialogs) for the request."
1763
+ "description": "Input only. [Dialog](https://developers.google.com/workspace/chat/dialogs) for the request."
1762
1764
  }
1763
1765
  },
1764
1766
  "type": "object"
@@ -1780,7 +1782,7 @@
1780
1782
  "properties": {
1781
1783
  "driveDataRef": {
1782
1784
  "$ref": "DriveDataRef",
1783
- "description": "A [DriveDataRef](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages.attachments#drivedataref) which references a Google Drive file."
1785
+ "description": "A [DriveDataRef](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments#drivedataref) which references a Google Drive file."
1784
1786
  },
1785
1787
  "mimeType": {
1786
1788
  "description": "The mime type of the linked Google Drive resource.",
@@ -1850,18 +1852,18 @@
1850
1852
  "id": "GoogleAppsCardV1Action",
1851
1853
  "properties": {
1852
1854
  "function": {
1853
- "description": "A custom function to invoke when the containing element is clicked or othrwise activated. For example usage, see [Create interactive cards](https://developers.google.com/chat/how-tos/cards-onclick).",
1855
+ "description": "A custom function to invoke when the containing element is clicked or othrwise activated. For example usage, see [Read form data](https://developers.google.com/workspace/chat/read-form-data).",
1854
1856
  "type": "string"
1855
1857
  },
1856
1858
  "interaction": {
1857
- "description": "Optional. Required when opening a [dialog](https://developers.google.com/chat/how-tos/dialogs). What to do in response to an interaction with a user, such as a user clicking a button in a card message. If unspecified, the app responds by executing an `action`\u2014like opening a link or running a function\u2014as normal. By specifying an `interaction`, the app can respond in special interactive ways. For example, by setting `interaction` to `OPEN_DIALOG`, the app can open a [dialog](https://developers.google.com/chat/how-tos/dialogs). When specified, a loading indicator isn't shown. If specified for an add-on, the entire card is stripped and nothing is shown in the client. [Google Chat apps](https://developers.google.com/workspace/chat):",
1859
+ "description": "Optional. Required when opening a [dialog](https://developers.google.com/workspace/chat/dialogs). What to do in response to an interaction with a user, such as a user clicking a button in a card message. If unspecified, the app responds by executing an `action`\u2014like opening a link or running a function\u2014as normal. By specifying an `interaction`, the app can respond in special interactive ways. For example, by setting `interaction` to `OPEN_DIALOG`, the app can open a [dialog](https://developers.google.com/workspace/chat/dialogs). When specified, a loading indicator isn't shown. If specified for an add-on, the entire card is stripped and nothing is shown in the client. [Google Chat apps](https://developers.google.com/workspace/chat):",
1858
1860
  "enum": [
1859
1861
  "INTERACTION_UNSPECIFIED",
1860
1862
  "OPEN_DIALOG"
1861
1863
  ],
1862
1864
  "enumDescriptions": [
1863
1865
  "Default value. The `action` executes as normal.",
1864
- "Opens a [dialog](https://developers.google.com/chat/how-tos/dialogs), a windowed, card-based interface that Chat apps use to interact with users. Only supported by Chat apps in response to button-clicks on card messages. If specified for an add-on, the entire card is stripped and nothing is shown in the client. [Google Chat apps](https://developers.google.com/workspace/chat):"
1866
+ "Opens a [dialog](https://developers.google.com/workspace/chat/dialogs), a windowed, card-based interface that Chat apps use to interact with users. Only supported by Chat apps in response to button-clicks on card messages. If specified for an add-on, the entire card is stripped and nothing is shown in the client. [Google Chat apps](https://developers.google.com/workspace/chat):"
1865
1867
  ],
1866
1868
  "type": "string"
1867
1869
  },
@@ -1885,14 +1887,14 @@
1885
1887
  "type": "array"
1886
1888
  },
1887
1889
  "persistValues": {
1888
- "description": "Indicates whether form values persist after the action. The default value is `false`. If `true`, form values remain after the action is triggered. To let the user make changes while the action is being processed, set [`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `NONE`. For [card messages](https://developers.google.com/chat/api/guides/v1/messages/create#create) in Chat apps, you must also set the action's [`ResponseType`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages#responsetype) to `UPDATE_MESSAGE` and use the same [`card_id`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages#CardWithId) from the card that contained the action. If `false`, the form values are cleared when the action is triggered. To prevent the user from making changes while the action is being processed, set [`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `SPINNER`.",
1890
+ "description": "Indicates whether form values persist after the action. The default value is `false`. If `true`, form values remain after the action is triggered. To let the user make changes while the action is being processed, set [`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `NONE`. For [card messages](https://developers.google.com/workspace/chat/api/guides/v1/messages/create#create) in Chat apps, you must also set the action's [`ResponseType`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#responsetype) to `UPDATE_MESSAGE` and use the same [`card_id`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#CardWithId) from the card that contained the action. If `false`, the form values are cleared when the action is triggered. To prevent the user from making changes while the action is being processed, set [`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `SPINNER`.",
1889
1891
  "type": "boolean"
1890
1892
  }
1891
1893
  },
1892
1894
  "type": "object"
1893
1895
  },
1894
1896
  "GoogleAppsCardV1ActionParameter": {
1895
- "description": "List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze one day, or snooze next week. You might use `action method = snooze()`, passing the snooze type and snooze time in the list of string parameters. To learn more, see [`CommonEventObject`](https://developers.google.com/chat/api/reference/rest/v1/Event#commoneventobject). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
1897
+ "description": "List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze one day, or snooze next week. You might use `action method = snooze()`, passing the snooze type and snooze time in the list of string parameters. To learn more, see [`CommonEventObject`](https://developers.google.com/workspace/chat/api/reference/rest/v1/Event#commoneventobject). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
1896
1898
  "id": "GoogleAppsCardV1ActionParameter",
1897
1899
  "properties": {
1898
1900
  "key": {
@@ -1937,11 +1939,11 @@
1937
1939
  "type": "object"
1938
1940
  },
1939
1941
  "GoogleAppsCardV1Button": {
1940
- "description": "A text, icon, or text and icon button that users can click. For an example in Google Chat apps, see [Button list](https://developers.google.com/chat/ui/widgets/button-list). To make an image a clickable button, specify an `Image` (not an `ImageComponent`) and set an `onClick` action. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
1942
+ "description": "A text, icon, or text and icon button that users can click. For an example in Google Chat apps, see [Add a button](https://developers.google.com/workspace/chat/design-interactive-card-dialog#add_a_button). To make an image a clickable button, specify an `Image` (not an `ImageComponent`) and set an `onClick` action. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
1941
1943
  "id": "GoogleAppsCardV1Button",
1942
1944
  "properties": {
1943
1945
  "altText": {
1944
- "description": "The alternative text that's used for accessibility. Set descriptive text that lets users know what the button does. For example, if a button opens a hyperlink, you might write: \"Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat\".",
1946
+ "description": "The alternative text that's used for accessibility. Set descriptive text that lets users know what the button does. For example, if a button opens a hyperlink, you might write: \"Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat\".",
1945
1947
  "type": "string"
1946
1948
  },
1947
1949
  "color": {
@@ -1968,7 +1970,7 @@
1968
1970
  "type": "object"
1969
1971
  },
1970
1972
  "GoogleAppsCardV1ButtonList": {
1971
- "description": "A list of buttons layed out horizontally. For an example in Google Chat apps, see [Button list](https://developers.google.com/chat/ui/widgets/button-list). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
1973
+ "description": "A list of buttons layed out horizontally. For an example in Google Chat apps, see [Add a button](https://developers.google.com/workspace/chat/design-interactive-card-dialog#add_a_button). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
1972
1974
  "id": "GoogleAppsCardV1ButtonList",
1973
1975
  "properties": {
1974
1976
  "buttons": {
@@ -1982,7 +1984,7 @@
1982
1984
  "type": "object"
1983
1985
  },
1984
1986
  "GoogleAppsCardV1Card": {
1985
- "description": "A card interface displayed in a Google Chat message or Google Workspace Add-on. Cards support a defined layout, interactive UI elements like buttons, and rich media like images. Use cards to present detailed information, gather information from users, and guide users to take a next step. [Card builder](https://addons.gsuite.google.com/uikit/builder) To learn how to build cards, see the following documentation: * For Google Chat apps, see [Design dynamic, interactive, and consistent UIs with cards](https://developers.google.com/chat/ui). * For Google Workspace Add-ons, see [Card-based interfaces](https://developers.google.com/apps-script/add-ons/concepts/cards). **Example: Card message for a Google Chat app** ![Example contact card](https://developers.google.com/chat/images/card_api_reference.png) To create the sample card message in Google Chat, use the following JSON: ``` { \"cardsV2\": [ { \"cardId\": \"unique-card-id\", \"card\": { \"header\": { \"title\": \"Sasha\", \"subtitle\": \"Software Engineer\", \"imageUrl\": \"https://developers.google.com/chat/images/quickstart-app-avatar.png\", \"imageType\": \"CIRCLE\", \"imageAltText\": \"Avatar for Sasha\" }, \"sections\": [ { \"header\": \"Contact Info\", \"collapsible\": true, \"uncollapsibleWidgetsCount\": 1, \"widgets\": [ { \"decoratedText\": { \"startIcon\": { \"knownIcon\": \"EMAIL\" }, \"text\": \"sasha@example.com\" } }, { \"decoratedText\": { \"startIcon\": { \"knownIcon\": \"PERSON\" }, \"text\": \"Online\" } }, { \"decoratedText\": { \"startIcon\": { \"knownIcon\": \"PHONE\" }, \"text\": \"+1 (555) 555-1234\" } }, { \"buttonList\": { \"buttons\": [ { \"text\": \"Share\", \"onClick\": { \"openLink\": { \"url\": \"https://example.com/share\" } } }, { \"text\": \"Edit\", \"onClick\": { \"action\": { \"function\": \"goToView\", \"parameters\": [ { \"key\": \"viewType\", \"value\": \"EDIT\" } ] } } } ] } } ] } ] } } ] } ```",
1987
+ "description": "A card interface displayed in a Google Chat message or Google Workspace Add-on. Cards support a defined layout, interactive UI elements like buttons, and rich media like images. Use cards to present detailed information, gather information from users, and guide users to take a next step. [Card builder](https://addons.gsuite.google.com/uikit/builder) To learn how to build cards, see the following documentation: * For Google Chat apps, see [Design the components of a card or dialog](https://developers.google.com/workspace/chat/design-components-card-dialog). * For Google Workspace Add-ons, see [Card-based interfaces](https://developers.google.com/apps-script/add-ons/concepts/cards). **Example: Card message for a Google Chat app** ![Example contact card](https://developers.google.com/workspace/chat/images/card_api_reference.png) To create the sample card message in Google Chat, use the following JSON: ``` { \"cardsV2\": [ { \"cardId\": \"unique-card-id\", \"card\": { \"header\": { \"title\": \"Sasha\", \"subtitle\": \"Software Engineer\", \"imageUrl\": \"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png\", \"imageType\": \"CIRCLE\", \"imageAltText\": \"Avatar for Sasha\" }, \"sections\": [ { \"header\": \"Contact Info\", \"collapsible\": true, \"uncollapsibleWidgetsCount\": 1, \"widgets\": [ { \"decoratedText\": { \"startIcon\": { \"knownIcon\": \"EMAIL\" }, \"text\": \"sasha@example.com\" } }, { \"decoratedText\": { \"startIcon\": { \"knownIcon\": \"PERSON\" }, \"text\": \"Online\" } }, { \"decoratedText\": { \"startIcon\": { \"knownIcon\": \"PHONE\" }, \"text\": \"+1 (555) 555-1234\" } }, { \"buttonList\": { \"buttons\": [ { \"text\": \"Share\", \"onClick\": { \"openLink\": { \"url\": \"https://example.com/share\" } } }, { \"text\": \"Edit\", \"onClick\": { \"action\": { \"function\": \"goToView\", \"parameters\": [ { \"key\": \"viewType\", \"value\": \"EDIT\" } ] } } } ] } } ] } ] } } ] } ```",
1986
1988
  "id": "GoogleAppsCardV1Card",
1987
1989
  "properties": {
1988
1990
  "cardActions": {
@@ -2008,7 +2010,7 @@
2008
2010
  },
2009
2011
  "fixedFooter": {
2010
2012
  "$ref": "GoogleAppsCardV1CardFixedFooter",
2011
- "description": "The fixed footer shown at the bottom of this card. Setting `fixedFooter` without specifying a `primaryButton` or a `secondaryButton` causes an error. For Chat apps, you can use fixed footers in [dialogs](https://developers.google.com/chat/how-tos/dialogs), but not [card messages](https://developers.google.com/chat/api/guides/v1/messages/create#create). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):"
2013
+ "description": "The fixed footer shown at the bottom of this card. Setting `fixedFooter` without specifying a `primaryButton` or a `secondaryButton` causes an error. For Chat apps, you can use fixed footers in [dialogs](https://developers.google.com/workspace/chat/dialogs), but not [card messages](https://developers.google.com/workspace/chat/create-messages#create). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):"
2012
2014
  },
2013
2015
  "header": {
2014
2016
  "$ref": "GoogleAppsCardV1CardHeader",
@@ -2037,7 +2039,7 @@
2037
2039
  "type": "string"
2038
2040
  },
2039
2041
  "sections": {
2040
- "description": "Contains a collection of widgets. Each section has its own, optional header. Sections are visually separated by a line divider. For an example in Google Chat apps, see [Card section](https://developers.google.com/chat/ui/widgets/card-section).",
2042
+ "description": "Contains a collection of widgets. Each section has its own, optional header. Sections are visually separated by a line divider. For an example in Google Chat apps, see [Define a section of a card](https://developers.google.com/workspace/chat/design-components-card-dialog#define_a_section_of_a_card).",
2041
2043
  "items": {
2042
2044
  "$ref": "GoogleAppsCardV1Section"
2043
2045
  },
@@ -2062,7 +2064,7 @@
2062
2064
  "type": "object"
2063
2065
  },
2064
2066
  "GoogleAppsCardV1CardFixedFooter": {
2065
- "description": "A persistent (sticky) footer that that appears at the bottom of the card. Setting `fixedFooter` without specifying a `primaryButton` or a `secondaryButton` causes an error. For Chat apps, you can use fixed footers in [dialogs](https://developers.google.com/chat/how-tos/dialogs), but not [card messages](https://developers.google.com/chat/api/guides/v1/messages/create#create). For an example in Google Chat apps, see [Card footer](https://developers.google.com/chat/ui/widgets/card-fixed-footer). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2067
+ "description": "A persistent (sticky) footer that that appears at the bottom of the card. Setting `fixedFooter` without specifying a `primaryButton` or a `secondaryButton` causes an error. For Chat apps, you can use fixed footers in [dialogs](https://developers.google.com/workspace/chat/dialogs), but not [card messages](https://developers.google.com/workspace/chat/create-messages#create). For an example in Google Chat apps, see [Add a persistent footer](https://developers.google.com/workspace/chat/design-components-card-dialog#add_a_persistent_footer). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2066
2068
  "id": "GoogleAppsCardV1CardFixedFooter",
2067
2069
  "properties": {
2068
2070
  "primaryButton": {
@@ -2077,7 +2079,7 @@
2077
2079
  "type": "object"
2078
2080
  },
2079
2081
  "GoogleAppsCardV1CardHeader": {
2080
- "description": "Represents a card header. For an example in Google Chat apps, see [Card header](https://developers.google.com/chat/ui/widgets/card-header). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2082
+ "description": "Represents a card header. For an example in Google Chat apps, see [Add a header](https://developers.google.com/workspace/chat/design-components-card-dialog#add_a_header). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2081
2083
  "id": "GoogleAppsCardV1CardHeader",
2082
2084
  "properties": {
2083
2085
  "imageAltText": {
@@ -2172,7 +2174,7 @@
2172
2174
  "type": "object"
2173
2175
  },
2174
2176
  "GoogleAppsCardV1Columns": {
2175
- "description": "The `Columns` widget displays up to 2 columns in a card or dialog. You can add widgets to each column; the widgets appear in the order that they are specified. For an example in Google Chat apps, see [Columns](https://developers.google.com/chat/ui/widgets/columns). The height of each column is determined by the taller column. For example, if the first column is taller than the second column, both columns have the height of the first column. Because each column can contain a different number of widgets, you can't define rows or align widgets between the columns. Columns are displayed side-by-side. You can customize the width of each column using the `HorizontalSizeStyle` field. If the user's screen width is too narrow, the second column wraps below the first: * On web, the second column wraps if the screen width is less than or equal to 480 pixels. * On iOS devices, the second column wraps if the screen width is less than or equal to 300 pt. * On Android devices, the second column wraps if the screen width is less than or equal to 320 dp. To include more than 2 columns, or to use rows, use the `Grid` widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): Columns for Google Workspace Add-ons are in Developer Preview.",
2177
+ "description": "The `Columns` widget displays up to 2 columns in a card or dialog. You can add widgets to each column; the widgets appear in the order that they are specified. For an example in Google Chat apps, see [Display cards and dialogs in columns](https://developers.google.com/workspace/chat/format-structure-card-dialog#display_cards_and_dialogs_in_columns). The height of each column is determined by the taller column. For example, if the first column is taller than the second column, both columns have the height of the first column. Because each column can contain a different number of widgets, you can't define rows or align widgets between the columns. Columns are displayed side-by-side. You can customize the width of each column using the `HorizontalSizeStyle` field. If the user's screen width is too narrow, the second column wraps below the first: * On web, the second column wraps if the screen width is less than or equal to 480 pixels. * On iOS devices, the second column wraps if the screen width is less than or equal to 300 pt. * On Android devices, the second column wraps if the screen width is less than or equal to 320 dp. To include more than 2 columns, or to use rows, use the `Grid` widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): Columns for Google Workspace Add-ons are in Developer Preview.",
2176
2178
  "id": "GoogleAppsCardV1Columns",
2177
2179
  "properties": {
2178
2180
  "columnItems": {
@@ -2186,7 +2188,7 @@
2186
2188
  "type": "object"
2187
2189
  },
2188
2190
  "GoogleAppsCardV1DateTimePicker": {
2189
- "description": "Lets users input a date, a time, or both a date and a time. For an example in Google Chat apps, see [Date time picker](https://developers.google.com/chat/ui/widgets/date-time-picker). Users can input text or use the picker to select dates and times. If users input an invalid date or time, the picker shows an error that prompts users to input the information correctly. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2191
+ "description": "Lets users input a date, a time, or both a date and a time. For an example in Google Chat apps, see [Let a user pick a date and time](https://developers.google.com/workspace/chat/design-interactive-card-dialog#let_a_user_pick_a_date_and_time). Users can input text or use the picker to select dates and times. If users input an invalid date or time, the picker shows an error that prompts users to input the information correctly. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2190
2192
  "id": "GoogleAppsCardV1DateTimePicker",
2191
2193
  "properties": {
2192
2194
  "label": {
@@ -2194,7 +2196,7 @@
2194
2196
  "type": "string"
2195
2197
  },
2196
2198
  "name": {
2197
- "description": "The name by which the `DateTimePicker` is identified in a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data).",
2199
+ "description": "The name by which the `DateTimePicker` is identified in a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data).",
2198
2200
  "type": "string"
2199
2201
  },
2200
2202
  "onChangeAction": {
@@ -2229,7 +2231,7 @@
2229
2231
  "type": "object"
2230
2232
  },
2231
2233
  "GoogleAppsCardV1DecoratedText": {
2232
- "description": "A widget that displays text with optional decorations such as a label above or below the text, an icon in front of the text, a selection widget, or a button after the text. For an example in Google Chat apps, see [Decorated text](https://developers.google.com/chat/ui/widgets/decorated-text). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2234
+ "description": "A widget that displays text with optional decorations such as a label above or below the text, an icon in front of the text, a selection widget, or a button after the text. For an example in Google Chat apps, see [Display text with decorative text](https://developers.google.com/workspace/chat/add-text-image-card-dialog#display_text_with_decorative_elements). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2233
2235
  "id": "GoogleAppsCardV1DecoratedText",
2234
2236
  "properties": {
2235
2237
  "bottomLabel": {
@@ -2242,7 +2244,7 @@
2242
2244
  },
2243
2245
  "endIcon": {
2244
2246
  "$ref": "GoogleAppsCardV1Icon",
2245
- "description": "An icon displayed after the text. Supports [built-in](https://developers.google.com/chat/format-messages#builtinicons) and [custom](https://developers.google.com/chat/format-messages#customicons) icons."
2247
+ "description": "An icon displayed after the text. Supports [built-in](https://developers.google.com/workspace/chat/format-messages#builtinicons) and [custom](https://developers.google.com/workspace/chat/format-messages#customicons) icons."
2246
2248
  },
2247
2249
  "icon": {
2248
2250
  "$ref": "GoogleAppsCardV1Icon",
@@ -2262,7 +2264,7 @@
2262
2264
  "description": "A switch widget that a user can click to change its state and trigger an action."
2263
2265
  },
2264
2266
  "text": {
2265
- "description": "Required. The primary text. Supports simple formatting. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
2267
+ "description": "Required. The primary text. Supports simple formatting. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
2266
2268
  "type": "string"
2267
2269
  },
2268
2270
  "topLabel": {
@@ -2277,13 +2279,13 @@
2277
2279
  "type": "object"
2278
2280
  },
2279
2281
  "GoogleAppsCardV1Divider": {
2280
- "description": "Displays a divider between widgets as a horizontal line. For an example in Google Chat apps, see [Divider](https://developers.google.com/chat/ui/widgets/divider). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): For example, the following JSON creates a divider: ``` \"divider\": {} ```",
2282
+ "description": "Displays a divider between widgets as a horizontal line. For an example in Google Chat apps, see [Add a horizontal divider between widgets](https://developers.google.com/workspace/chat/format-structure-card-dialog#add_a_horizontal_divider_between_widgets). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): For example, the following JSON creates a divider: ``` \"divider\": {} ```",
2281
2283
  "id": "GoogleAppsCardV1Divider",
2282
2284
  "properties": {},
2283
2285
  "type": "object"
2284
2286
  },
2285
2287
  "GoogleAppsCardV1Grid": {
2286
- "description": "Displays a grid with a collection of items. Items can only include text or images. For responsive columns, or to include more than text or images, use `Columns`. For an example in Google Chat apps, see [Grid](https://developers.google.com/chat/ui/widgets/grid). A grid supports any number of columns and items. The number of rows is determined by items divided by columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns has 6 rows. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): For example, the following JSON creates a 2 column grid with a single item: ``` \"grid\": { \"title\": \"A fine collection of items\", \"columnCount\": 2, \"borderStyle\": { \"type\": \"STROKE\", \"cornerRadius\": 4 }, \"items\": [ { \"image\": { \"imageUri\": \"https://www.example.com/image.png\", \"cropStyle\": { \"type\": \"SQUARE\" }, \"borderStyle\": { \"type\": \"STROKE\" } }, \"title\": \"An item\", \"textAlignment\": \"CENTER\" } ], \"onClick\": { \"openLink\": { \"url\": \"https://www.example.com\" } } } ```",
2288
+ "description": "Displays a grid with a collection of items. Items can only include text or images. For responsive columns, or to include more than text or images, use `Columns`. For an example in Google Chat apps, see [Display a Grid with a collection of items](https://developers.google.com/workspace/chat/format-structure-card-dialog#display_a_grid_with_a_collection_of_items). A grid supports any number of columns and items. The number of rows is determined by items divided by columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns has 6 rows. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): For example, the following JSON creates a 2 column grid with a single item: ``` \"grid\": { \"title\": \"A fine collection of items\", \"columnCount\": 2, \"borderStyle\": { \"type\": \"STROKE\", \"cornerRadius\": 4 }, \"items\": [ { \"image\": { \"imageUri\": \"https://www.example.com/image.png\", \"cropStyle\": { \"type\": \"SQUARE\" }, \"borderStyle\": { \"type\": \"STROKE\" } }, \"title\": \"An item\", \"textAlignment\": \"CENTER\" } ], \"onClick\": { \"openLink\": { \"url\": \"https://www.example.com\" } } } ```",
2287
2289
  "id": "GoogleAppsCardV1Grid",
2288
2290
  "properties": {
2289
2291
  "borderStyle": {
@@ -2351,15 +2353,15 @@
2351
2353
  "type": "object"
2352
2354
  },
2353
2355
  "GoogleAppsCardV1Icon": {
2354
- "description": "An icon displayed in a widget on a card. For an example in Google Chat apps, see [Icon](https://developers.google.com/chat/ui/widgets/icon). Supports [built-in](https://developers.google.com/chat/format-messages#builtinicons) and [custom](https://developers.google.com/chat/format-messages#customicons) icons. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2356
+ "description": "An icon displayed in a widget on a card. For an example in Google Chat apps, see [Add an icon](https://developers.google.com/workspace/chat/add-text-image-card-dialog#add_an_icon). Supports [built-in](https://developers.google.com/workspace/chat/format-messages#builtinicons) and [custom](https://developers.google.com/workspace/chat/format-messages#customicons) icons. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2355
2357
  "id": "GoogleAppsCardV1Icon",
2356
2358
  "properties": {
2357
2359
  "altText": {
2358
- "description": "Optional. A description of the icon used for accessibility. If unspecified, the default value `Button` is provided. As a best practice, you should set a helpful description for what the icon displays, and if applicable, what it does. For example, `A user's account portrait`, or `Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat`. If the icon is set in a `Button`, the `altText` appears as helper text when the user hovers over the button. However, if the button also sets `text`, the icon's `altText` is ignored.",
2360
+ "description": "Optional. A description of the icon used for accessibility. If unspecified, the default value `Button` is provided. As a best practice, you should set a helpful description for what the icon displays, and if applicable, what it does. For example, `A user's account portrait`, or `Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat`. If the icon is set in a `Button`, the `altText` appears as helper text when the user hovers over the button. However, if the button also sets `text`, the icon's `altText` is ignored.",
2359
2361
  "type": "string"
2360
2362
  },
2361
2363
  "iconUrl": {
2362
- "description": "Display a custom icon hosted at an HTTPS URL. For example: ``` \"iconUrl\": \"https://developers.google.com/chat/images/quickstart-app-avatar.png\" ``` Supported file types include `.png` and `.jpg`.",
2364
+ "description": "Display a custom icon hosted at an HTTPS URL. For example: ``` \"iconUrl\": \"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png\" ``` Supported file types include `.png` and `.jpg`.",
2363
2365
  "type": "string"
2364
2366
  },
2365
2367
  "imageType": {
@@ -2375,7 +2377,7 @@
2375
2377
  "type": "string"
2376
2378
  },
2377
2379
  "knownIcon": {
2378
- "description": "Display one of the built-in icons provided by Google Workspace. For example, to display an airplane icon, specify `AIRPLANE`. For a bus, specify `BUS`. For a full list of supported icons, see [built-in icons](https://developers.google.com/chat/format-messages#builtinicons).",
2380
+ "description": "Display one of the built-in icons provided by Google Workspace. For example, to display an airplane icon, specify `AIRPLANE`. For a bus, specify `BUS`. For a full list of supported icons, see [built-in icons](https://developers.google.com/workspace/chat/format-messages#builtinicons).",
2379
2381
  "type": "string"
2380
2382
  },
2381
2383
  "materialIcon": {
@@ -2386,7 +2388,7 @@
2386
2388
  "type": "object"
2387
2389
  },
2388
2390
  "GoogleAppsCardV1Image": {
2389
- "description": "An image that is specified by a URL and can have an `onClick` action. For an example, see [Image](https://developers.google.com/chat/ui/widgets/image). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2391
+ "description": "An image that is specified by a URL and can have an `onClick` action. For an example, see [Add an image](https://developers.google.com/workspace/chat/add-text-image-card-dialog#add_an_image). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2390
2392
  "id": "GoogleAppsCardV1Image",
2391
2393
  "properties": {
2392
2394
  "altText": {
@@ -2394,7 +2396,7 @@
2394
2396
  "type": "string"
2395
2397
  },
2396
2398
  "imageUrl": {
2397
- "description": "The HTTPS URL that hosts the image. For example: ``` https://developers.google.com/chat/images/quickstart-app-avatar.png ```",
2399
+ "description": "The HTTPS URL that hosts the image. For example: ``` https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png ```",
2398
2400
  "type": "string"
2399
2401
  },
2400
2402
  "onClick": {
@@ -2572,7 +2574,7 @@
2572
2574
  "type": "boolean"
2573
2575
  },
2574
2576
  "header": {
2575
- "description": "Text that appears at the top of a section. Supports simple HTML formatted text. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
2577
+ "description": "Text that appears at the top of a section. Supports simple HTML formatted text. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
2576
2578
  "type": "string"
2577
2579
  },
2578
2580
  "uncollapsibleWidgetsCount": {
@@ -2591,7 +2593,7 @@
2591
2593
  "type": "object"
2592
2594
  },
2593
2595
  "GoogleAppsCardV1SelectionInput": {
2594
- "description": "A widget that creates one or more UI items that users can select. For example, a dropdown menu or checkboxes. You can use this widget to collect data that can be predicted or enumerated. For an example in Google Chat apps, see [Selection input](https://developers.google.com/chat/ui/widgets/selection-input). Chat apps can process the value of items that users select or input. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data). To collect undefined or abstract data from users, use the TextInput widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2596
+ "description": "A widget that creates one or more UI items that users can select. For example, a dropdown menu or checkboxes. You can use this widget to collect data that can be predicted or enumerated. For an example in Google Chat apps, see [Add selectable UI elements](/workspace/chat/design-interactive-card-dialog#add_selectable_ui_elements). Chat apps can process the value of items that users select or input. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data). To collect undefined or abstract data from users, use the TextInput widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2595
2597
  "id": "GoogleAppsCardV1SelectionInput",
2596
2598
  "properties": {
2597
2599
  "externalDataSource": {
@@ -2620,12 +2622,12 @@
2620
2622
  "type": "integer"
2621
2623
  },
2622
2624
  "name": {
2623
- "description": "The name that identifies the selection input in a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data).",
2625
+ "description": "The name that identifies the selection input in a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data).",
2624
2626
  "type": "string"
2625
2627
  },
2626
2628
  "onChangeAction": {
2627
2629
  "$ref": "GoogleAppsCardV1Action",
2628
- "description": "If specified, the form is submitted when the selection changes. If not specified, you must specify a separate button that submits the form. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data)."
2630
+ "description": "If specified, the form is submitted when the selection changes. If not specified, you must specify a separate button that submits the form. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data)."
2629
2631
  },
2630
2632
  "platformDataSource": {
2631
2633
  "$ref": "GoogleAppsCardV1PlatformDataSource",
@@ -2645,7 +2647,7 @@
2645
2647
  "A set of radio buttons. Users can select one radio button.",
2646
2648
  "A set of switches. Users can turn on one or more switches.",
2647
2649
  "A dropdown menu. Users can select one item from the menu.",
2648
- "A multiselect menu for static or dynamic data. From the menu bar, users select one or more items. Users can also input values to populate dynamic data. For example, users can start typing the name of a Google Chat space and the widget autosuggests the space. To populate items for a multiselect menu, you can use one of the following types of data sources: * Static data: Items are specified as `SelectionItem` objects in the widget. Up to 100 items. * Google Workspace data: Items are populated using data from Google Workspace, such as Google Workspace users or Google Chat spaces. * External data: Items are populated from an external data source outside of Google Workspace. For examples of how to implement multiselect menus, see the [`SelectionInput` widget page](https://developers.google.com/chat/ui/widgets/selection-input#multiselect-menu). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): Multiselect for Google Workspace Add-ons are in Developer Preview."
2650
+ "A multiselect menu for static or dynamic data. From the menu bar, users select one or more items. Users can also input values to populate dynamic data. For example, users can start typing the name of a Google Chat space and the widget autosuggests the space. To populate items for a multiselect menu, you can use one of the following types of data sources: * Static data: Items are specified as `SelectionItem` objects in the widget. Up to 100 items. * Google Workspace data: Items are populated using data from Google Workspace, such as Google Workspace users or Google Chat spaces. * External data: Items are populated from an external data source outside of Google Workspace. For examples of how to implement multiselect menus, see [Add a multiselect menu](https://developers.google.com/workspace/chat/design-interactive-card-dialog#multiselect-menu). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): Multiselect for Google Workspace Add-ons are in Developer Preview."
2649
2651
  ],
2650
2652
  "type": "string"
2651
2653
  }
@@ -2665,7 +2667,7 @@
2665
2667
  "type": "boolean"
2666
2668
  },
2667
2669
  "startIconUri": {
2668
- "description": "For multiselect menus, the URL for the icon displayed next to the item's `text` field. Supports PNG and JPEG files. Must be an `HTTPS` URL. For example, `https://developers.google.com/chat/images/quickstart-app-avatar.png`.",
2670
+ "description": "For multiselect menus, the URL for the icon displayed next to the item's `text` field. Supports PNG and JPEG files. Must be an `HTTPS` URL. For example, `https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png`.",
2669
2671
  "type": "string"
2670
2672
  },
2671
2673
  "text": {
@@ -2673,7 +2675,7 @@
2673
2675
  "type": "string"
2674
2676
  },
2675
2677
  "value": {
2676
- "description": "The value associated with this item. The client should use this as a form input value. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data).",
2678
+ "description": "The value associated with this item. The client should use this as a form input value. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data).",
2677
2679
  "type": "string"
2678
2680
  }
2679
2681
  },
@@ -2723,7 +2725,7 @@
2723
2725
  "type": "string"
2724
2726
  },
2725
2727
  "name": {
2726
- "description": "The name by which the switch widget is identified in a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data).",
2728
+ "description": "The name by which the switch widget is identified in a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data).",
2727
2729
  "type": "string"
2728
2730
  },
2729
2731
  "onChangeAction": {
@@ -2735,14 +2737,14 @@
2735
2737
  "type": "boolean"
2736
2738
  },
2737
2739
  "value": {
2738
- "description": "The value entered by a user, returned as part of a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data).",
2740
+ "description": "The value entered by a user, returned as part of a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data).",
2739
2741
  "type": "string"
2740
2742
  }
2741
2743
  },
2742
2744
  "type": "object"
2743
2745
  },
2744
2746
  "GoogleAppsCardV1TextInput": {
2745
- "description": "A field in which users can enter text. Supports suggestions and on-change actions. For an example in Google Chat apps, see [Text input](https://developers.google.com/chat/ui/widgets/text-input). Chat apps receive and can process the value of entered text during form input events. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data). When you need to collect undefined or abstract data from users, use a text input. To collect defined or enumerated data from users, use the SelectionInput widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2747
+ "description": "A field in which users can enter text. Supports suggestions and on-change actions. For an example in Google Chat apps, see [Add a field in which a user can enter text](https://developers.google.com/workspace/chat/design-interactive-card-dialog#add_a_field_in_which_a_user_can_enter_text). Chat apps receive and can process the value of entered text during form input events. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data). When you need to collect undefined or abstract data from users, use a text input. To collect defined or enumerated data from users, use the SelectionInput widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2746
2748
  "id": "GoogleAppsCardV1TextInput",
2747
2749
  "properties": {
2748
2750
  "autoCompleteAction": {
@@ -2762,12 +2764,12 @@
2762
2764
  "type": "string"
2763
2765
  },
2764
2766
  "name": {
2765
- "description": "The name by which the text input is identified in a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data).",
2767
+ "description": "The name by which the text input is identified in a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data).",
2766
2768
  "type": "string"
2767
2769
  },
2768
2770
  "onChangeAction": {
2769
2771
  "$ref": "GoogleAppsCardV1Action",
2770
- "description": "What to do when a change occurs in the text input field. For example, a user adding to the field or deleting text. Examples of actions to take include running a custom function or opening a [dialog](https://developers.google.com/chat/how-tos/dialogs) in Google Chat."
2772
+ "description": "What to do when a change occurs in the text input field. For example, a user adding to the field or deleting text. Examples of actions to take include running a custom function or opening a [dialog](https://developers.google.com/workspace/chat/dialogs) in Google Chat."
2771
2773
  },
2772
2774
  "placeholderText": {
2773
2775
  "description": "Text that appears in the text input field when the field is empty. Use this text to prompt users to enter a value. For example, `Enter a number from 0 to 100`. [Google Chat apps](https://developers.google.com/workspace/chat):",
@@ -2786,14 +2788,14 @@
2786
2788
  "type": "string"
2787
2789
  },
2788
2790
  "value": {
2789
- "description": "The value entered by a user, returned as part of a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data).",
2791
+ "description": "The value entered by a user, returned as part of a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data).",
2790
2792
  "type": "string"
2791
2793
  }
2792
2794
  },
2793
2795
  "type": "object"
2794
2796
  },
2795
2797
  "GoogleAppsCardV1TextParagraph": {
2796
- "description": "A paragraph of text that supports formatting. For an example in Google Chat apps, see [Text paragraph](https://developers.google.com/chat/ui/widgets/text-paragraph). For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2798
+ "description": "A paragraph of text that supports formatting. For an example in Google Chat apps, see [Add a paragraph of formatted text](https://developers.google.com/workspace/chat/add-text-image-card-dialog#add_a_paragraph_of_formatted_text). For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):",
2797
2799
  "id": "GoogleAppsCardV1TextParagraph",
2798
2800
  "properties": {
2799
2801
  "text": {
@@ -2849,7 +2851,7 @@
2849
2851
  },
2850
2852
  "image": {
2851
2853
  "$ref": "GoogleAppsCardV1Image",
2852
- "description": "Displays an image. For example, the following JSON creates an image with alternative text: ``` \"image\": { \"imageUrl\": \"https://developers.google.com/chat/images/quickstart-app-avatar.png\", \"altText\": \"Chat app avatar\" } ```"
2854
+ "description": "Displays an image. For example, the following JSON creates an image with alternative text: ``` \"image\": { \"imageUrl\": \"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png\", \"altText\": \"Chat app avatar\" } ```"
2853
2855
  },
2854
2856
  "selectionInput": {
2855
2857
  "$ref": "GoogleAppsCardV1SelectionInput",
@@ -2861,7 +2863,7 @@
2861
2863
  },
2862
2864
  "textParagraph": {
2863
2865
  "$ref": "GoogleAppsCardV1TextParagraph",
2864
- "description": "Displays a text paragraph. Supports simple HTML formatted text. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). For example, the following JSON creates a bolded text: ``` \"textParagraph\": { \"text\": \" *bold text*\" } ```"
2866
+ "description": "Displays a text paragraph. Supports simple HTML formatted text. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). For example, the following JSON creates a bolded text: ``` \"textParagraph\": { \"text\": \" *bold text*\" } ```"
2865
2867
  }
2866
2868
  },
2867
2869
  "type": "object"
@@ -3060,7 +3062,7 @@
3060
3062
  "id": "KeyValue",
3061
3063
  "properties": {
3062
3064
  "bottomLabel": {
3063
- "description": "The text of the bottom label. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
3065
+ "description": "The text of the bottom label. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
3064
3066
  "type": "string"
3065
3067
  },
3066
3068
  "button": {
@@ -3068,7 +3070,7 @@
3068
3070
  "description": "A button that can be clicked to trigger an action."
3069
3071
  },
3070
3072
  "content": {
3071
- "description": "The text of the content. Formatted text supported and always required. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
3073
+ "description": "The text of the content. Formatted text supported and always required. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
3072
3074
  "type": "string"
3073
3075
  },
3074
3076
  "contentMultiline": {
@@ -3154,13 +3156,14 @@
3154
3156
  "description": "The `onclick` action. Only the top label, bottom label, and content region are clickable."
3155
3157
  },
3156
3158
  "topLabel": {
3157
- "description": "The text of the top label. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
3159
+ "description": "The text of the top label. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
3158
3160
  "type": "string"
3159
3161
  }
3160
3162
  },
3161
3163
  "type": "object"
3162
3164
  },
3163
3165
  "ListMembershipsResponse": {
3166
+ "description": "Response to list memberships of the space.",
3164
3167
  "id": "ListMembershipsResponse",
3165
3168
  "properties": {
3166
3169
  "memberships": {
@@ -3178,6 +3181,7 @@
3178
3181
  "type": "object"
3179
3182
  },
3180
3183
  "ListMessagesResponse": {
3184
+ "description": "Response message for listing messages.",
3181
3185
  "id": "ListMessagesResponse",
3182
3186
  "properties": {
3183
3187
  "messages": {
@@ -3195,6 +3199,7 @@
3195
3199
  "type": "object"
3196
3200
  },
3197
3201
  "ListReactionsResponse": {
3202
+ "description": "Response to a list reactions request.",
3198
3203
  "id": "ListReactionsResponse",
3199
3204
  "properties": {
3200
3205
  "nextPageToken": {
@@ -3230,6 +3235,7 @@
3230
3235
  "type": "object"
3231
3236
  },
3232
3237
  "ListSpacesResponse": {
3238
+ "description": "The response for a list spaces request.",
3233
3239
  "id": "ListSpacesResponse",
3234
3240
  "properties": {
3235
3241
  "nextPageToken": {
@@ -3289,7 +3295,7 @@
3289
3295
  },
3290
3296
  "member": {
3291
3297
  "$ref": "User",
3292
- "description": "The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/chat/api/guides/auth/users), the output populates the [user](https://developers.google.com/chat/api/reference/rest/v1/User) `name` and `type`."
3298
+ "description": "The Google Chat user or app the membership corresponds to. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type`."
3293
3299
  },
3294
3300
  "name": {
3295
3301
  "description": "Resource name of the membership, assigned by the server. Format: `spaces/{space}/members/{member}`",
@@ -3330,11 +3336,11 @@
3330
3336
  "type": "object"
3331
3337
  },
3332
3338
  "MembershipBatchCreatedEventData": {
3333
- "description": "Payload for batch new membership events where the `EventType` field is `google.workspace.chat.membership.v1.batchCreated`.",
3339
+ "description": "Event payload for multiple new memberships. Event type: `google.workspace.chat.membership.v1.batchCreated`",
3334
3340
  "id": "MembershipBatchCreatedEventData",
3335
3341
  "properties": {
3336
3342
  "memberships": {
3337
- "description": "A list of created memberships.",
3343
+ "description": "A list of new memberships.",
3338
3344
  "items": {
3339
3345
  "$ref": "MembershipCreatedEventData"
3340
3346
  },
@@ -3344,7 +3350,7 @@
3344
3350
  "type": "object"
3345
3351
  },
3346
3352
  "MembershipBatchDeletedEventData": {
3347
- "description": "Payload for batch deleted membership events where the `EventType` field is `google.workspace.chat.membership.v1.batchDeleted`.",
3353
+ "description": "Event payload for multiple deleted memberships. Event type: `google.workspace.chat.membership.v1.batchDeleted`",
3348
3354
  "id": "MembershipBatchDeletedEventData",
3349
3355
  "properties": {
3350
3356
  "memberships": {
@@ -3358,7 +3364,7 @@
3358
3364
  "type": "object"
3359
3365
  },
3360
3366
  "MembershipBatchUpdatedEventData": {
3361
- "description": "Payload for batch updated membership events where the `EventType` field is `google.workspace.chat.membership.v1.batchUpdated`.",
3367
+ "description": "Event payload for multiple updated memberships. Event type: `google.workspace.chat.membership.v1.batchUpdated`",
3362
3368
  "id": "MembershipBatchUpdatedEventData",
3363
3369
  "properties": {
3364
3370
  "memberships": {
@@ -3372,34 +3378,34 @@
3372
3378
  "type": "object"
3373
3379
  },
3374
3380
  "MembershipCreatedEventData": {
3375
- "description": "Payload for new membership events where the `EventType` field is `google.workspace.chat.membership.v1.created`.",
3381
+ "description": "Event payload for a new membership. Event type: `google.workspace.chat.membership.v1.created`.",
3376
3382
  "id": "MembershipCreatedEventData",
3377
3383
  "properties": {
3378
3384
  "membership": {
3379
3385
  "$ref": "Membership",
3380
- "description": "The most recent version of membership."
3386
+ "description": "The new membership."
3381
3387
  }
3382
3388
  },
3383
3389
  "type": "object"
3384
3390
  },
3385
3391
  "MembershipDeletedEventData": {
3386
- "description": "Payload for deleted membership events where the `EventType` field is `google.workspace.chat.membership.v1.deleted`.",
3392
+ "description": "Event payload for a deleted membership. Event type: `google.workspace.chat.membership.v1.deleted`",
3387
3393
  "id": "MembershipDeletedEventData",
3388
3394
  "properties": {
3389
3395
  "membership": {
3390
3396
  "$ref": "Membership",
3391
- "description": "The deleted membership. Only `name` and `state` are populated."
3397
+ "description": "The deleted membership. Only the `name` and `state` fields are populated."
3392
3398
  }
3393
3399
  },
3394
3400
  "type": "object"
3395
3401
  },
3396
3402
  "MembershipUpdatedEventData": {
3397
- "description": "Payload for updated membership events where the `EventType` field is `google.workspace.chat.membership.v1.updated`.",
3403
+ "description": "Event payload for an updated membership. Event type: `google.workspace.chat.membership.v1.updated`",
3398
3404
  "id": "MembershipUpdatedEventData",
3399
3405
  "properties": {
3400
3406
  "membership": {
3401
3407
  "$ref": "Membership",
3402
- "description": "The most recent version of membership."
3408
+ "description": "The updated membership."
3403
3409
  }
3404
3410
  },
3405
3411
  "type": "object"
@@ -3409,7 +3415,7 @@
3409
3415
  "id": "Message",
3410
3416
  "properties": {
3411
3417
  "accessoryWidgets": {
3412
- "description": "One or more interactive widgets that appear at the bottom of a message. You can add accessory widgets to messages that contain text, cards, or both text and cards. Not supported for messages that contain dialogs. For details, see [Add interactive widgets at the bottom of a message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets). Creating a message with accessory widgets requires [app authentication] (https://developers.google.com/chat/api/guides/auth/service-accounts).",
3418
+ "description": "One or more interactive widgets that appear at the bottom of a message. You can add accessory widgets to messages that contain text, cards, or both text and cards. Not supported for messages that contain dialogs. For details, see [Add interactive widgets at the bottom of a message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets). Creating a message with accessory widgets requires [app authentication] (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).",
3413
3419
  "items": {
3414
3420
  "$ref": "AccessoryWidget"
3415
3421
  },
@@ -3456,14 +3462,14 @@
3456
3462
  "type": "array"
3457
3463
  },
3458
3464
  "cardsV2": {
3459
- "description": "An array of [cards](https://developers.google.com/chat/api/reference/rest/v1/cards). Only Chat apps can create cards. If your Chat app [authenticates as a user](https://developers.google.com/chat/api/guides/auth/users), the messages can't contain cards. To learn about cards and how to create them, see [Design dynamic, interactive, and consistent UIs with cards](https://developers.google.com/chat/ui). [Card builder](https://addons.gsuite.google.com/uikit/builder)",
3465
+ "description": "An array of [cards](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards). Only Chat apps can create cards. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the messages can't contain cards. To learn about cards and how to create them, see [Send card messages](https://developers.google.com/workspace/chat/create-messages#create). [Card builder](https://addons.gsuite.google.com/uikit/builder)",
3460
3466
  "items": {
3461
3467
  "$ref": "CardWithId"
3462
3468
  },
3463
3469
  "type": "array"
3464
3470
  },
3465
3471
  "clientAssignedMessageId": {
3466
- "description": "Optional. A custom ID for the message. You can use field to identify a message, or to get, delete, or update a message. To set a custom ID, specify the [`messageId`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages/create#body.QUERY_PARAMETERS.message_id) field when you create the message. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).",
3472
+ "description": "Optional. A custom ID for the message. You can use field to identify a message, or to get, delete, or update a message. To set a custom ID, specify the [`messageId`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#body.QUERY_PARAMETERS.message_id) field when you create the message. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
3467
3473
  "type": "string"
3468
3474
  },
3469
3475
  "createTime": {
@@ -3495,7 +3501,7 @@
3495
3501
  "type": "string"
3496
3502
  },
3497
3503
  "formattedText": {
3498
- "description": "Output only. Contains the message `text` with markups added to communicate formatting. This field might not capture all formatting visible in the UI, but includes the following: * [Markup syntax](https://developers.google.com/chat/format-messages) for bold, italic, strikethrough, monospace, monospace block, and bulleted list. * [User mentions](https://developers.google.com/chat/format-messages#messages-@mention) using the format ``. * Custom hyperlinks using the format `<{url}|{rendered_text}>` where the first string is the URL and the second is the rendered text\u2014for example, ``. * Custom emoji using the format `:{emoji_name}:`\u2014for example, `:smile:`. This doesn't apply to Unicode emoji, such as `U+1F600` for a grinning face emoji. For more information, see [View text formatting sent in a message](https://developers.google.com/chat/format-messages#view_text_formatting_sent_in_a_message)",
3504
+ "description": "Output only. Contains the message `text` with markups added to communicate formatting. This field might not capture all formatting visible in the UI, but includes the following: * [Markup syntax](https://developers.google.com/workspace/chat/format-messages) for bold, italic, strikethrough, monospace, monospace block, and bulleted list. * [User mentions](https://developers.google.com/workspace/chat/format-messages#messages-@mention) using the format ``. * Custom hyperlinks using the format `<{url}|{rendered_text}>` where the first string is the URL and the second is the rendered text\u2014for example, ``. * Custom emoji using the format `:{emoji_name}:`\u2014for example, `:smile:`. This doesn't apply to Unicode emoji, such as `U+1F600` for a grinning face emoji. For more information, see [View text formatting sent in a message](https://developers.google.com/workspace/chat/format-messages#view_text_formatting_sent_in_a_message)",
3499
3505
  "readOnly": true,
3500
3506
  "type": "string"
3501
3507
  },
@@ -3507,16 +3513,16 @@
3507
3513
  },
3508
3514
  "matchedUrl": {
3509
3515
  "$ref": "MatchedUrl",
3510
- "description": "Output only. A URL in `spaces.messages.text` that matches a link preview pattern. For more information, see [Preview links](https://developers.google.com/chat/how-tos/preview-links).",
3516
+ "description": "Output only. A URL in `spaces.messages.text` that matches a link preview pattern. For more information, see [Preview links](https://developers.google.com/workspace/chat/preview-links).",
3511
3517
  "readOnly": true
3512
3518
  },
3513
3519
  "name": {
3514
- "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).",
3520
+ "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
3515
3521
  "type": "string"
3516
3522
  },
3517
3523
  "privateMessageViewer": {
3518
3524
  "$ref": "User",
3519
- "description": "Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/chat/api/guides/auth/users) to send a message, the message can't be private and must omit this field. For details, see [Send private messages to Google Chat users](https://developers.google.com/chat/api/guides/v1/messages/private)."
3525
+ "description": "Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send private messages to Google Chat users](https://developers.google.com/workspace/chat/private-messages)."
3520
3526
  },
3521
3527
  "quotedMessageMetadata": {
3522
3528
  "$ref": "QuotedMessageMetadata",
@@ -3525,7 +3531,7 @@
3525
3531
  },
3526
3532
  "sender": {
3527
3533
  "$ref": "User",
3528
- "description": "Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/chat/api/guides/auth/users), the output populates the [user](https://developers.google.com/chat/api/reference/rest/v1/User) `name` and `type`.",
3534
+ "description": "Output only. The user who created the message. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User) `name` and `type`.",
3529
3535
  "readOnly": true
3530
3536
  },
3531
3537
  "slashCommand": {
@@ -3535,15 +3541,15 @@
3535
3541
  },
3536
3542
  "space": {
3537
3543
  "$ref": "Space",
3538
- "description": "If your Chat app [authenticates as a user](https://developers.google.com/chat/api/guides/auth/users), the output populates the [space](https://developers.google.com/chat/api/reference/rest/v1/spaces) `name`."
3544
+ "description": "If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`."
3539
3545
  },
3540
3546
  "text": {
3541
- "description": "Plain-text body of the message. The first link to an image, video, or web page generates a [preview chip](https://developers.google.com/chat/how-tos/preview-links). You can also [@mention a Google Chat user](https://developers.google.com/chat/format-messages#messages-@mention), or everyone in the space. To learn about creating text messages, see [Send a text message](https://developers.google.com/chat/api/guides/v1/messages/create#create-text-messages).",
3547
+ "description": "Plain-text body of the message. The first link to an image, video, or web page generates a [preview chip](https://developers.google.com/workspace/chat/preview-links). You can also [@mention a Google Chat user](https://developers.google.com/workspace/chat/format-messages#messages-@mention), or everyone in the space. To learn about creating text messages, see [Send a text message](https://developers.google.com/workspace/chat/create-messages#create-text-messages).",
3542
3548
  "type": "string"
3543
3549
  },
3544
3550
  "thread": {
3545
3551
  "$ref": "Thread",
3546
- "description": "The thread the message belongs to. For example usage, see [Start or reply to a message thread](https://developers.google.com/chat/api/guides/v1/messages/create#create-message-thread)."
3552
+ "description": "The thread the message belongs to. For example usage, see [Start or reply to a message thread](https://developers.google.com/workspace/chat/create-messages#create-message-thread)."
3547
3553
  },
3548
3554
  "threadReply": {
3549
3555
  "description": "Output only. When `true`, the message is a response in a reply thread. When `false`, the message is visible in the space's top-level conversation as either the first message of a thread or a message with no threaded replies. If the space doesn't support reply in threads, this field is always `false`.",
@@ -3554,11 +3560,11 @@
3554
3560
  "type": "object"
3555
3561
  },
3556
3562
  "MessageBatchCreatedEventData": {
3557
- "description": "Payload for batch new message events where the `EventType` field is `google.workspace.chat.message.v1.batchCreated`.",
3563
+ "description": "Event payload for multiple new messages. Event type: `google.workspace.chat.message.v1.batchCreated`",
3558
3564
  "id": "MessageBatchCreatedEventData",
3559
3565
  "properties": {
3560
3566
  "messages": {
3561
- "description": "A list of created messages.",
3567
+ "description": "A list of new messages.",
3562
3568
  "items": {
3563
3569
  "$ref": "MessageCreatedEventData"
3564
3570
  },
@@ -3568,7 +3574,7 @@
3568
3574
  "type": "object"
3569
3575
  },
3570
3576
  "MessageBatchDeletedEventData": {
3571
- "description": "Payload for batch deleted message events where the `EventType` field is `google.workspace.chat.message.v1.batchDeleted`.",
3577
+ "description": "Event payload for multiple deleted messages. Event type: `google.workspace.chat.message.v1.batchDeleted`",
3572
3578
  "id": "MessageBatchDeletedEventData",
3573
3579
  "properties": {
3574
3580
  "messages": {
@@ -3582,7 +3588,7 @@
3582
3588
  "type": "object"
3583
3589
  },
3584
3590
  "MessageBatchUpdatedEventData": {
3585
- "description": "Payload for batch updated message events where the `EventType` field is `google.workspace.chat.message.v1.batchUpdated`.",
3591
+ "description": "Event payload for multiple updated messages. Event type: `google.workspace.chat.message.v1.batchUpdated`",
3586
3592
  "id": "MessageBatchUpdatedEventData",
3587
3593
  "properties": {
3588
3594
  "messages": {
@@ -3596,34 +3602,34 @@
3596
3602
  "type": "object"
3597
3603
  },
3598
3604
  "MessageCreatedEventData": {
3599
- "description": "Payload for new message events where the `EventType` field is `google.workspace.chat.message.v1.created`.",
3605
+ "description": "Event payload for a new message. Event type: `google.workspace.chat.message.v1.created`",
3600
3606
  "id": "MessageCreatedEventData",
3601
3607
  "properties": {
3602
3608
  "message": {
3603
3609
  "$ref": "Message",
3604
- "description": "The most recent version of the message."
3610
+ "description": "The new message."
3605
3611
  }
3606
3612
  },
3607
3613
  "type": "object"
3608
3614
  },
3609
3615
  "MessageDeletedEventData": {
3610
- "description": "Payload for deleted message events where the `EventType` field is `google.workspace.chat.message.v1.deleted`.",
3616
+ "description": "Event payload for a deleted message. Event type: `google.workspace.chat.message.v1.deleted`",
3611
3617
  "id": "MessageDeletedEventData",
3612
3618
  "properties": {
3613
3619
  "message": {
3614
3620
  "$ref": "Message",
3615
- "description": "The deleted message. Only `name`, `createTime`, `deleteTime`, and `deletionMetadata` are populated."
3621
+ "description": "The deleted message. Only the `name`, `createTime`, `deleteTime`, and `deletionMetadata` fields are populated."
3616
3622
  }
3617
3623
  },
3618
3624
  "type": "object"
3619
3625
  },
3620
3626
  "MessageUpdatedEventData": {
3621
- "description": "Payload for updated message events where the `EventType` field is `google.workspace.chat.message.v1.updated`.",
3627
+ "description": "Event payload for an updated message. Event type: `google.workspace.chat.message.v1.updated`",
3622
3628
  "id": "MessageUpdatedEventData",
3623
3629
  "properties": {
3624
3630
  "message": {
3625
3631
  "$ref": "Message",
3626
- "description": "The most recent version of the message."
3632
+ "description": "The updated message."
3627
3633
  }
3628
3634
  },
3629
3635
  "type": "object"
@@ -3693,11 +3699,11 @@
3693
3699
  "type": "object"
3694
3700
  },
3695
3701
  "ReactionBatchCreatedEventData": {
3696
- "description": "Payload for batch new reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.batchCreated`.",
3702
+ "description": "Event payload for multiple new reactions. Event type: `google.workspace.chat.reaction.v1.batchCreated`",
3697
3703
  "id": "ReactionBatchCreatedEventData",
3698
3704
  "properties": {
3699
3705
  "reactions": {
3700
- "description": "A list of created reactions.",
3706
+ "description": "A list of new reactions.",
3701
3707
  "items": {
3702
3708
  "$ref": "ReactionCreatedEventData"
3703
3709
  },
@@ -3707,7 +3713,7 @@
3707
3713
  "type": "object"
3708
3714
  },
3709
3715
  "ReactionBatchDeletedEventData": {
3710
- "description": "Payload for batch deleted reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.batchDeleted`.",
3716
+ "description": "Event payload for multiple deleted reactions. Event type: `google.workspace.chat.reaction.v1.batchDeleted`",
3711
3717
  "id": "ReactionBatchDeletedEventData",
3712
3718
  "properties": {
3713
3719
  "reactions": {
@@ -3721,18 +3727,18 @@
3721
3727
  "type": "object"
3722
3728
  },
3723
3729
  "ReactionCreatedEventData": {
3724
- "description": "Payload for new reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.created`.",
3730
+ "description": "Event payload for a new reaction. Event type: `google.workspace.chat.reaction.v1.created`",
3725
3731
  "id": "ReactionCreatedEventData",
3726
3732
  "properties": {
3727
3733
  "reaction": {
3728
3734
  "$ref": "Reaction",
3729
- "description": "The created reaction."
3735
+ "description": "The new reaction."
3730
3736
  }
3731
3737
  },
3732
3738
  "type": "object"
3733
3739
  },
3734
3740
  "ReactionDeletedEventData": {
3735
- "description": "Payload for deleted reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.deleted`.",
3741
+ "description": "Event payload for a deleted reaction. Type: `google.workspace.chat.reaction.v1.deleted`",
3736
3742
  "id": "ReactionDeletedEventData",
3737
3743
  "properties": {
3738
3744
  "reaction": {
@@ -3774,7 +3780,7 @@
3774
3780
  "id": "Section",
3775
3781
  "properties": {
3776
3782
  "header": {
3777
- "description": "The header of the section. Formatted text is supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
3783
+ "description": "The header of the section. Formatted text is supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
3778
3784
  "type": "string"
3779
3785
  },
3780
3786
  "widgets": {
@@ -3802,6 +3808,7 @@
3802
3808
  "type": "object"
3803
3809
  },
3804
3810
  "SetUpSpaceRequest": {
3811
+ "description": "Request to create a space and add specified users to it.",
3805
3812
  "id": "SetUpSpaceRequest",
3806
3813
  "properties": {
3807
3814
  "memberships": {
@@ -3823,7 +3830,7 @@
3823
3830
  "type": "object"
3824
3831
  },
3825
3832
  "SlashCommand": {
3826
- "description": "A [slash command](https://developers.google.com/chat/how-tos/slash-commands) in Google Chat.",
3833
+ "description": "A [slash command](https://developers.google.com/workspace/chat/slash-commands) in Google Chat.",
3827
3834
  "id": "SlashCommand",
3828
3835
  "properties": {
3829
3836
  "commandId": {
@@ -3887,11 +3894,11 @@
3887
3894
  "type": "string"
3888
3895
  },
3889
3896
  "displayName": {
3890
- "description": "The space's display name. Required when [creating a space](https://developers.google.com/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.",
3897
+ "description": "The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.",
3891
3898
  "type": "string"
3892
3899
  },
3893
3900
  "externalUserAllowed": {
3894
- "description": "Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview). Import mode spaces must only permit members from the same Google Workspace organization. For existing spaces, this field is output only.",
3901
+ "description": "Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. * The space is used to [import data to Google Chat] (https://developers.google.com/chat/api/guides/import-data-overview) because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces. For existing spaces, this field is output only.",
3895
3902
  "type": "boolean"
3896
3903
  },
3897
3904
  "importMode": {
@@ -3972,7 +3979,7 @@
3972
3979
  "DM"
3973
3980
  ],
3974
3981
  "enumDescriptions": [
3975
- "",
3982
+ "Reserved.",
3976
3983
  "Conversations between two or more humans.",
3977
3984
  "1:1 Direct Message between a human and a Chat app, where all messages are flat. Note that this doesn't include direct messages between two humans."
3978
3985
  ],
@@ -3983,7 +3990,7 @@
3983
3990
  "type": "object"
3984
3991
  },
3985
3992
  "SpaceBatchUpdatedEventData": {
3986
- "description": "Payload for batch updated space events where the `EventType` field is `google.workspace.chat.space.v1.batchUpdated`.",
3993
+ "description": "Event payload for multiple updates to a space. Event type: `google.workspace.chat.space.v1.batchUpdated`",
3987
3994
  "id": "SpaceBatchUpdatedEventData",
3988
3995
  "properties": {
3989
3996
  "spaces": {
@@ -4023,104 +4030,104 @@
4023
4030
  "type": "object"
4024
4031
  },
4025
4032
  "SpaceEvent": {
4026
- "description": "An event that happens in a specific space.",
4033
+ "description": "An event that represents a change or activity in a Google Chat space. To learn more, see [Work with events from Google Chat](https://developers.google.com/workspace/chat/events-overview).",
4027
4034
  "id": "SpaceEvent",
4028
4035
  "properties": {
4029
4036
  "eventTime": {
4030
- "description": "Time of the event.",
4037
+ "description": "Time when the event occurred.",
4031
4038
  "format": "google-datetime",
4032
4039
  "type": "string"
4033
4040
  },
4034
4041
  "eventType": {
4035
- "description": "Type of the space event. The following event types are supported: * New membership: `google.workspace.chat.membership.v1.created` * Deleted membership: `google.workspace.chat.membership.v1.deleted` * Updated membership: `google.workspace.chat.membership.v1.updated` * New message: `google.workspace.chat.message.v1.created` * Deleted message: `google.workspace.chat.message.v1.deleted` * Updated message: `google.workspace.chat.message.v1.updated` * New reaction: `google.workspace.chat.reaction.v1.created` * Deleted reaction: `google.workspace.chat.reaction.v1.deleted` * Updated space: `google.workspace.chat.space.v1.updated` Note that requesting or subscribing to the preceding event types automatically sets up the subscription or response to also return batched versions of the event type. For example, if you subscribe to `google.workspace.chat.membership.v1.created`, you also receive events for `google.workspace.chat.membership.v1.batchCreated`. For more details see https://developers.google.com/workspace/events/guides/events-chat#output_only_event_types.",
4042
+ "description": "Type of space event. Each event type has a batch version, which represents multiple instances of the event type that occur in a short period of time. For `spaceEvents.list()` requests, omit batch event types in your query filter. By default, the server returns both event type and its batch version. Supported event types for [messages](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages): * New message: `google.workspace.chat.message.v1.created` * Updated message: `google.workspace.chat.message.v1.updated` * Deleted message: `google.workspace.chat.message.v1.deleted` * Multiple new messages: `google.workspace.chat.message.v1.batchCreated` * Multiple updated messages: `google.workspace.chat.message.v1.batchUpdated` * Multiple deleted messages: `google.workspace.chat.message.v1.batchDeleted` Supported event types for [memberships](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.members): * New membership: `google.workspace.chat.membership.v1.created` * Updated membership: `google.workspace.chat.membership.v1.updated` * Deleted membership: `google.workspace.chat.membership.v1.deleted` * Multiple new memberships: `google.workspace.chat.membership.v1.batchCreated` * Multiple updated memberships: `google.workspace.chat.membership.v1.batchUpdated` * Multiple deleted memberships: `google.workspace.chat.membership.v1.batchDeleted` Supported event types for [reactions](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.reactions): * New reaction: `google.workspace.chat.reaction.v1.created` * Deleted reaction: `google.workspace.chat.reaction.v1.deleted` * Multiple new reactions: `google.workspace.chat.reaction.v1.batchCreated` * Multiple deleted reactions: `google.workspace.chat.reaction.v1.batchDeleted` Supported event types about the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces): * Updated space: `google.workspace.chat.space.v1.updated` * Multiple space updates: `google.workspace.chat.space.v1.batchUpdated`",
4036
4043
  "type": "string"
4037
4044
  },
4038
4045
  "membershipBatchCreatedEventData": {
4039
4046
  "$ref": "MembershipBatchCreatedEventData",
4040
- "description": "Payload for batch new membership events where the `EventType` field is `google.workspace.chat.membership.v1.batchCreated`."
4047
+ "description": "Event payload for multiple new memberships. Event type: `google.workspace.chat.membership.v1.batchCreated`"
4041
4048
  },
4042
4049
  "membershipBatchDeletedEventData": {
4043
4050
  "$ref": "MembershipBatchDeletedEventData",
4044
- "description": "Payload for batch deleted membership events where the `EventType` field is `google.workspace.chat.membership.v1.batchDeleted`."
4051
+ "description": "Event payload for multiple deleted memberships. Event type: `google.workspace.chat.membership.v1.batchDeleted`"
4045
4052
  },
4046
4053
  "membershipBatchUpdatedEventData": {
4047
4054
  "$ref": "MembershipBatchUpdatedEventData",
4048
- "description": "Payload for batch updated membership events where the `EventType` field is `google.workspace.chat.membership.v1.batchUpdated`."
4055
+ "description": "Event payload for multiple updated memberships. Event type: `google.workspace.chat.membership.v1.batchUpdated`"
4049
4056
  },
4050
4057
  "membershipCreatedEventData": {
4051
4058
  "$ref": "MembershipCreatedEventData",
4052
- "description": "Payload for new membership events where the `EventType` field is `google.workspace.chat.membership.v1.created`."
4059
+ "description": "Event payload for a new membership. Event type: `google.workspace.chat.membership.v1.created`"
4053
4060
  },
4054
4061
  "membershipDeletedEventData": {
4055
4062
  "$ref": "MembershipDeletedEventData",
4056
- "description": "Payload for deleted membership events where the `EventType` field is `google.workspace.chat.membership.v1.deleted`."
4063
+ "description": "Event payload for a deleted membership. Event type: `google.workspace.chat.membership.v1.deleted`"
4057
4064
  },
4058
4065
  "membershipUpdatedEventData": {
4059
4066
  "$ref": "MembershipUpdatedEventData",
4060
- "description": "Payload for updated membership events where the `EventType` field is `google.workspace.chat.membership.v1.updated`."
4067
+ "description": "Event payload for an updated membership. Event type: `google.workspace.chat.membership.v1.updated`"
4061
4068
  },
4062
4069
  "messageBatchCreatedEventData": {
4063
4070
  "$ref": "MessageBatchCreatedEventData",
4064
- "description": "Payload for batch new message events where the `EventType` field is `google.workspace.chat.message.v1.batchCreated`."
4071
+ "description": "Event payload for multiple new messages. Event type: `google.workspace.chat.message.v1.batchCreated`"
4065
4072
  },
4066
4073
  "messageBatchDeletedEventData": {
4067
4074
  "$ref": "MessageBatchDeletedEventData",
4068
- "description": "Payload for batch deleted message events where the `EventType` field is `google.workspace.chat.message.v1.batchDeleted`."
4075
+ "description": "Event payload for multiple deleted messages. Event type: `google.workspace.chat.message.v1.batchDeleted`"
4069
4076
  },
4070
4077
  "messageBatchUpdatedEventData": {
4071
4078
  "$ref": "MessageBatchUpdatedEventData",
4072
- "description": "Payload for batch updated message events where the `EventType` field is `google.workspace.chat.message.v1.batchUpdated`."
4079
+ "description": "Event payload for multiple updated messages. Event type: `google.workspace.chat.message.v1.batchUpdated`"
4073
4080
  },
4074
4081
  "messageCreatedEventData": {
4075
4082
  "$ref": "MessageCreatedEventData",
4076
- "description": "Payload for new message events where the `EventType` field is `google.workspace.chat.message.v1.created`."
4083
+ "description": "Event payload for a new message. Event type: `google.workspace.chat.message.v1.created`"
4077
4084
  },
4078
4085
  "messageDeletedEventData": {
4079
4086
  "$ref": "MessageDeletedEventData",
4080
- "description": "Payload for deleted message events where the `EventType` field is `google.workspace.chat.message.v1.deleted`."
4087
+ "description": "Event payload for a deleted message. Event type: `google.workspace.chat.message.v1.deleted`"
4081
4088
  },
4082
4089
  "messageUpdatedEventData": {
4083
4090
  "$ref": "MessageUpdatedEventData",
4084
- "description": "Payload for updated message events where the `EventType` field is `google.workspace.chat.message.v1.updated`."
4091
+ "description": "Event payload for an updated message. Event type: `google.workspace.chat.message.v1.updated`"
4085
4092
  },
4086
4093
  "name": {
4087
- "description": "The resource name of the space event. Format: `spaces/{space}/spaceEvents/{spaceEvent}`",
4094
+ "description": "Resource name of the space event. Format: `spaces/{space}/spaceEvents/{spaceEvent}`",
4088
4095
  "type": "string"
4089
4096
  },
4090
4097
  "reactionBatchCreatedEventData": {
4091
4098
  "$ref": "ReactionBatchCreatedEventData",
4092
- "description": "Payload for batch new reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.batchCreated`."
4099
+ "description": "Event payload for multiple new reactions. Event type: `google.workspace.chat.reaction.v1.batchCreated`"
4093
4100
  },
4094
4101
  "reactionBatchDeletedEventData": {
4095
4102
  "$ref": "ReactionBatchDeletedEventData",
4096
- "description": "Payload for batch deleted reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.batchDeleted`."
4103
+ "description": "Event payload for multiple deleted reactions. Event type: `google.workspace.chat.reaction.v1.batchDeleted`"
4097
4104
  },
4098
4105
  "reactionCreatedEventData": {
4099
4106
  "$ref": "ReactionCreatedEventData",
4100
- "description": "Payload for new reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.created`."
4107
+ "description": "Event payload for a new reaction. Event type: `google.workspace.chat.reaction.v1.created`"
4101
4108
  },
4102
4109
  "reactionDeletedEventData": {
4103
4110
  "$ref": "ReactionDeletedEventData",
4104
- "description": "Payload for deleted reaction events where the `EventType` field is `google.workspace.chat.reaction.v1.deleted`."
4111
+ "description": "Event payload for a deleted reaction. Event type: `google.workspace.chat.reaction.v1.deleted`"
4105
4112
  },
4106
4113
  "spaceBatchUpdatedEventData": {
4107
4114
  "$ref": "SpaceBatchUpdatedEventData",
4108
- "description": "Payload for batch updated space events where the `EventType` field is `google.workspace.chat.space.v1.batchUpdated`."
4115
+ "description": "Event payload for multiple updates to a space. Event type: `google.workspace.chat.space.v1.batchUpdated`"
4109
4116
  },
4110
4117
  "spaceUpdatedEventData": {
4111
4118
  "$ref": "SpaceUpdatedEventData",
4112
- "description": "Payload for updated space events where the `EventType` field is `google.workspace.chat.space.v1.updated`."
4119
+ "description": "Event payload for a space update. Event type: `google.workspace.chat.space.v1.updated`"
4113
4120
  }
4114
4121
  },
4115
4122
  "type": "object"
4116
4123
  },
4117
4124
  "SpaceUpdatedEventData": {
4118
- "description": "Payload for updated space events where the `EventType` field is `google.workspace.chat.space.v1.updated`.",
4125
+ "description": "Event payload for an updated space. Event type: `google.workspace.chat.space.v1.updated`",
4119
4126
  "id": "SpaceUpdatedEventData",
4120
4127
  "properties": {
4121
4128
  "space": {
4122
4129
  "$ref": "Space",
4123
- "description": "The recent version of the space."
4130
+ "description": "The updated space."
4124
4131
  }
4125
4132
  },
4126
4133
  "type": "object"
@@ -4182,7 +4189,7 @@
4182
4189
  "type": "object"
4183
4190
  },
4184
4191
  "TextParagraph": {
4185
- "description": "A paragraph of text. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
4192
+ "description": "A paragraph of text. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
4186
4193
  "id": "TextParagraph",
4187
4194
  "properties": {
4188
4195
  "text": {
@@ -4192,7 +4199,7 @@
4192
4199
  "type": "object"
4193
4200
  },
4194
4201
  "Thread": {
4195
- "description": "A thread in a Google Chat space. For example usage, see [Start or reply to a message thread](https://developers.google.com/chat/api/guides/v1/messages/create#create-message-thread). If you specify a thread when creating a message, you can set the [`messageReplyOption`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages/create#messagereplyoption) field to determine what happens if no matching thread is found.",
4202
+ "description": "A thread in a Google Chat space. For example usage, see [Start or reply to a message thread](https://developers.google.com/workspace/chat/create-messages#create-message-thread). If you specify a thread when creating a message, you can set the [`messageReplyOption`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#messagereplyoption) field to determine what happens if no matching thread is found.",
4196
4203
  "id": "Thread",
4197
4204
  "properties": {
4198
4205
  "name": {
@@ -4255,6 +4262,7 @@
4255
4262
  "type": "object"
4256
4263
  },
4257
4264
  "UploadAttachmentRequest": {
4265
+ "description": "Request to upload an attachment.",
4258
4266
  "id": "UploadAttachmentRequest",
4259
4267
  "properties": {
4260
4268
  "filename": {
@@ -4265,6 +4273,7 @@
4265
4273
  "type": "object"
4266
4274
  },
4267
4275
  "UploadAttachmentResponse": {
4276
+ "description": "Response of uploading an attachment.",
4268
4277
  "id": "UploadAttachmentResponse",
4269
4278
  "properties": {
4270
4279
  "attachmentDataRef": {
@@ -4275,7 +4284,7 @@
4275
4284
  "type": "object"
4276
4285
  },
4277
4286
  "User": {
4278
- "description": "A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/chat/api/guides/auth/users), the output for a `User` resource only populates the user's `name` and `type`.",
4287
+ "description": "A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`.",
4279
4288
  "id": "User",
4280
4289
  "properties": {
4281
4290
  "displayName": {