仅当人工创建的消息已包含卡片,且这些卡片是由 Chat 应用创建时,Chat 应用才能替换该消息中的卡片。
如果应用使用空列表替换卡券,则卡券会被移除。移除卡片后,应用无法将卡片重新添加到消息中。
需要使用以下授权范围进行应用身份验证:- https://www.googleapis.com/auth/chat.bot
HTTP 请求
POST https://chat.googleapis.com/v1/{name=spaces/*/messages/*}:replaceCards
网址采用 gRPC 转码语法。
路径参数
| 参数 | |
|---|---|
name |
必需。消息的资源名称。 格式: |
请求正文
请求正文中包含结构如下的数据:
| JSON 表示法 |
|---|
{
"cardsV2": [
{
object ( |
| 字段 | |
|---|---|
cardsV2[] |
可选。要包含在消息中的卡片数组。这些卡片将替换消息的现有卡片。如果为空,则会清除消息中包含的原始卡片。 |
响应正文
如果成功,则响应正文为空。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/chat.bot
如需了解详情,请参阅授权指南。