我们将于 2024 年 7 月 31 日逐步淘汰 Google Business Messages。点击
此处了解详情。
Method: conversations.messages.updateReceipt
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
PATCH https://businessmessages.googleapis.com/v1/{receipt.name=conversations/*/messages/*/receipt}
网址采用 gRPC 转码语法。
路径参数
参数 |
receipt.name |
string
收据名称,由 Business Messages 设置。解析为“conversations/{conversationId}/messages/{messageId}/receipt”,其中 {conversationId} 是对话的唯一 ID,{messageId} 是消息的唯一 ID。
|
请求正文
请求正文包含一个 Receipt
实例。
响应正文
消息收据。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
{
"name": string,
"receiptType": enum (ReceiptType )
} |
字段 |
name |
string
收据名称,由 Business Messages 设置。解析为“conversations/{conversationId}/messages/{messageId}/receipt”,其中 {conversationId} 是对话的唯一 ID,{messageId} 是消息的唯一 ID。
|
receiptType |
enum (ReceiptType )
一种收据类型。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/businessmessages
如需了解详情,请参阅 OAuth 2.0 概览。
ReceiptType
枚举 |
RECEIPT_TYPE_UNSPECIFIED |
未指定的收据类型。 |
READ |
消息已读。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eSends a receipt to a user confirming an agent's message was received.\u003c/p\u003e\n"],["\u003cp\u003eUses a PATCH request to the specified URL with the receipt information in the request body.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/businessmessages\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eThe response body contains the receipt details, including its name and type (read or unspecified).\u003c/p\u003e\n"],["\u003cp\u003eReceipt types indicate whether the message was read by the user or remains unacknowledged.\u003c/p\u003e\n"]]],[],null,["# Method: conversations.messages.updateReceipt\n\nSends a receipt for a message from an agent to a user.\n\n### HTTP request\n\n`PATCH https://businessmessages.googleapis.com/v1/{receipt.name=conversations/*/messages/*/receipt}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `receipt.name` | `string` The name of the receipt, as set by Business Messages. Resolves to \"conversations/{conversationId}/messages/{messageId}/receipt\", where {conversationId} is the unique ID for the conversation and {messageId} is the unique ID for the message. |\n\n### Request body\n\nThe request body contains an instance of [Receipt](/business-communications/business-messages/reference/rest/v1/conversations.messages/updateReceipt#body.Receipt).\n\n### Response body\n\nA receipt of the message.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"receiptType\": enum (/business-communications/business-messages/reference/rest/v1/conversations.messages/updateReceipt#ReceiptType) } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The name of the receipt, as set by Business Messages. Resolves to \"conversations/{conversationId}/messages/{messageId}/receipt\", where {conversationId} is the unique ID for the conversation and {messageId} is the unique ID for the message. |\n| `receiptType` | `enum (`[ReceiptType](/business-communications/business-messages/reference/rest/v1/conversations.messages/updateReceipt#ReceiptType)`)` A receipt type. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/businessmessages`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nReceiptType\n-----------\n\nPossible receipt types.\n\n| Enums ||\n|----------------------------|---------------------------|\n| `RECEIPT_TYPE_UNSPECIFIED` | Unspecified receipt type. |\n| `READ` | Message read. |"]]