OrderUpdate
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
JSON 表示法 |
{
"type": enum (Type ),
"order": {
object (Order )
},
"updateMask": string,
"userNotification": {
object (UserNotification )
},
"reason": string
} |
字段 |
type (deprecated) |
enum (Type )
已弃用:请改用 OrderUpdate.update_mask。如果 type = SNAPSHOT,则 OrderUpdate.order 应为整个订单。如果 type = ORDER_STATUS,则表示订单级状态更改。只提取 order.last_update_time 和此行业状态。注意:type.ORDER_STATUS 仅支持 PurcahaseOrderExtension 状态更新,并且没有延长此支持的计划。我们建议使用 updateMask,因为它更通用、可扩展,并且适用于所有行业。
|
order |
object (Order )
|
updateMask |
string (FieldMask format)
注意:对于以下特殊字段,有以下注意事项/建议:1. order.last_update_time 将始终作为更新请求的一部分进行更新。2. 如果 order.create_time、order.google_order_id 和 order.merchant_order_id 作为 updateMask 的一部分提供,则将被忽略。 以逗号分隔的完全限定字段名称列表。示例:"user.displayName,photo" 。
|
userNotification |
object (UserNotification )
指定此标志时,系统会向用户显示一条包含指定标题和文本的通知。指定通知只是建议发送通知,并不保证一定会带来通知。
|
reason |
string
更改/更新的原因。
|
UserNotification
JSON 表示法 |
{
"title": string,
"text": string
} |
字段 |
title |
string
用户通知的标题。允许的长度上限为 30 个字符。
|
text |
string
通知的内容。允许的长度上限为 100 个字符。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003eOrderUpdate\u003c/code\u003e conveys changes to an existing order, encompassing details like order status, user notifications, and the reason for the update.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes \u003ccode\u003eupdateMask\u003c/code\u003e to specify the fields being modified, offering flexibility and extensibility for various updates.\u003c/p\u003e\n"],["\u003cp\u003eAn optional \u003ccode\u003euserNotification\u003c/code\u003e field enables displaying a message to the user with a designated title and text, enhancing communication.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ereason\u003c/code\u003e field provides context for the update, improving transparency and understanding of order changes.\u003c/p\u003e\n"]]],[],null,["# OrderUpdate\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [UserNotification](#UserNotification)\n - [JSON representation](#UserNotification.SCHEMA_REPRESENTATION)\n\nUpdate to an order.\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"type\": enum (`Type`), \"order\": { object (/assistant/df-asdk/reference/webhook/rest/Shared.Types/Order) }, \"updateMask\": string, \"userNotification\": { object (/assistant/df-asdk/reference/webhook/rest/Shared.Types/OrderUpdate#UserNotification) }, \"reason\": string } ``` |\n\n| Fields ||\n|-------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `type` **(deprecated)** | `enum (``Type``)` | This item is deprecated! Deprecated: Use OrderUpdate.update_mask instead. If type = SNAPSHOT, OrderUpdate.order should be the entire order. If type = ORDER_STATUS, this is the order level status change. Only order.last_update_time and this vertical status are picked up. Note: type.ORDER_STATUS only supports PurcahaseOrderExtension status updates and there is no plan to extend this support. Instead, we recommend using updateMask as it is more generic, extensible and can be used for all verticals. |\n| `order` | `object (`[Order](/assistant/df-asdk/reference/webhook/rest/Shared.Types/Order)`)` |\n| `updateMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Note: There are following consideration/recommendations for following special fields: 1. order.last_update_time will always be updated as part of the update request. 2. order.create_time, order.google_order_id and order.merchant_order_id will be ignored if provided as part of the updateMask. A comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `userNotification` | `object (`[UserNotification](/assistant/df-asdk/reference/webhook/rest/Shared.Types/OrderUpdate#UserNotification)`)` If specified, displays a notification to the user with the specified title and text. Specifying a notification is a suggestion to notify and is not guaranteed to result in a notification. |\n| `reason` | `string` Reason for the change/update. |\n\nUserNotification\n----------------\n\nOptional user notification to display as part of the Order update.\n\n| JSON representation ||\n|---------------------------------------------|---|\n| ``` { \"title\": string, \"text\": string } ``` |\n\n| Fields ||\n|---------|-------------------------------------------------------------------------------|\n| `title` | `string` The title for the user notification. Max allowed length is 30 chars. |\n| `text` | `string` The contents of the notification. Max allowed length is 100 chars. |"]]