Actions
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Đại diện cho danh sách Hành động được xác định trong một dự án.
| Trường |
custom |
map (key: string, value: object (CustomAction))
Liên kết từ ý định đến Hành động tuỳ chỉnh để định cấu hình lệnh gọi cho dự án. Ý định gọi có thể là ý định hệ thống hoặc ý định tuỳ chỉnh được xác định trong phần tử "custom/intents/" . Tất cả ý định được xác định ở đây (ý định của hệ thống và đối tượng có ý định tuỳ chỉnh) phải có một tệp ý định tương ứng trong thuộc tính "custom/global/" . Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
|
CustomAction
Thông tin chi tiết về một thao tác tuỳ chỉnh.
| Trình bày theo YAML |
engagement:
object (Engagement) |
| Trường |
engagement |
object (Engagement)
Cơ chế tương tác liên quan đến hành động giúp người dùng cuối đăng ký nhận thông báo đẩy và thông tin cập nhật hằng ngày. Xin lưu ý rằng tên ý định được chỉ định trong cấu hình vùng thông báo đẩy/cập nhật hằng ngày cần phải khớp với ý định tương ứng với hành động này để người dùng cuối đăng ký nhận các nội dung cập nhật này.
|
Mức độ tương tác
Xác định các cơ chế tương tác liên quan đến hành động này. Việc này cho phép người dùng cuối đăng ký nhận thông báo đẩy và thông tin cập nhật hằng ngày.
| Trường |
title |
string
Tiêu đề của hoạt động tương tác sẽ được gửi cho người dùng cuối để yêu cầu họ cho phép nhận thông tin cập nhật. Lời nhắc gửi cho người dùng cuối về thông tin cập nhật hằng ngày sẽ có dạng như sau: "Bạn muốn tôi gửi {title}" hằng ngày vào lúc nào còn đối với thông báo đẩy thì thông báo sẽ có dạng như "Tôi có thể gửi thông báo đẩy cho {title}" không. Trường này có thể bản địa hoá.
|
pushNotification |
object (PushNotification)
Các chế độ cài đặt thông báo đẩy mà hoạt động tương tác này hỗ trợ.
|
actionLink
(deprecated) |
object (ActionLink)
Cấu hình đường liên kết cho một thao tác giúp xác định xem bạn có bật tính năng chia sẻ đường liên kết cho thao tác đó hay không. Nếu có, thì thao tác này sẽ chứa tên hiển thị cho đường liên kết thân thiện với người dùng. ActionLink không còn được dùng nữa. Hãy chuyển sang dùng AssistantLink.
|
assistantLink |
object (AssistantLink)
Cấu hình đường liên kết cho một thao tác giúp xác định xem bạn có bật tính năng chia sẻ đường liên kết cho thao tác đó hay không. Nếu có, thì thao tác này sẽ chứa tên hiển thị cho đường liên kết thân thiện với người dùng.
|
dailyUpdate |
object (DailyUpdate)
Chế độ cài đặt cập nhật hằng ngày mà hoạt động tương tác này hỗ trợ.
|
PushNotification
Xác định chế độ cài đặt thông báo đẩy mà hoạt động tương tác này hỗ trợ.
DailyUpdate
Xác định chế độ cài đặt cập nhật hằng ngày mà lượt tương tác này hỗ trợ.
ActionLink
Cho biết liệu tính năng chia sẻ đường liên kết có được bật cho tác vụ này hay không và các chế độ cài đặt tương ứng. Đường liên kết hành động được dùng để liên kết sâu người dùng đến một hành động cụ thể. ActionLink không còn được dùng nữa. Hãy chuyển sang dùng AssistantLink.
| Trình bày theo YAML |
title: string |
| Trường |
title |
string
Tiêu đề hiển thị thân thiện với người dùng cho đường liên kết.
|
AssistantLink
Cho biết liệu tính năng chia sẻ đường liên kết có được bật cho tác vụ này hay không và các chế độ cài đặt tương ứng. Đường liên kết đến Trợ lý được dùng để liên kết sâu người dùng đến một hành động cụ thể.
| Trình bày theo YAML |
title: string |
| Trường |
title |
string
Tiêu đề hiển thị thân thiện với người dùng cho đường liên kết.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eThis document outlines the schema for defining Actions within a project, including custom actions, engagement mechanisms, and supporting features.\u003c/p\u003e\n"],["\u003cp\u003eActions can be customized by mapping intents to specific functionalities and configuring engagement features like push notifications and daily updates.\u003c/p\u003e\n"],["\u003cp\u003eEngagement features allow users to subscribe to updates and are controlled through settings like titles and notification preferences.\u003c/p\u003e\n"],["\u003cp\u003eAssistant Links enable deep linking into specific actions, providing a streamlined user experience.\u003c/p\u003e\n"],["\u003cp\u003eThe schema utilizes YAML for representation and provides detailed descriptions for each field and its purpose.\u003c/p\u003e\n"]]],["The content outlines various action types and their configurations within a project. `CustomAction` maps intents to actions, and `Engagement` handles user subscriptions to updates. `Engagement` includes `title`, `pushNotification`, `dailyUpdate`, and `assistantLink` (replaces deprecated `actionLink`). `AssistantLink` and `ActionLink` define link sharing settings. `PushNotification` and `DailyUpdate` define settings for respective engagements. Configuration is represented in YAML and explained in detail with fields and data types.\n"],null,["# Actions\n\n- [YAML representation](#SCHEMA_REPRESENTATION)\n- [CustomAction](#CustomAction)\n - [YAML representation](#CustomAction.SCHEMA_REPRESENTATION)\n- [Engagement](#Engagement)\n - [YAML representation](#Engagement.SCHEMA_REPRESENTATION)\n- [PushNotification](#PushNotification)\n- [DailyUpdate](#DailyUpdate)\n- [ActionLink](#ActionLink)\n - [YAML representation](#ActionLink.SCHEMA_REPRESENTATION)\n- [AssistantLink](#AssistantLink)\n - [YAML representation](#AssistantLink.SCHEMA_REPRESENTATION)\n\nRepresents the list of Actions defined in a project.\n\n| YAML representation ||\n|-------------------------------------------------------------------------------------------------|---|\n| custom: string: object (/assistant/actionssdk/reference/rest/Shared.Types/Actions#CustomAction) |\n\n| Fields ||\n|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `custom` | `map (key: string, value: object (`[CustomAction](/assistant/actionssdk/reference/rest/Shared.Types/Actions#CustomAction)`))` Map from intents to custom Actions to configure invocation for the project. The invocation intents could either be system or custom intents defined in the \"custom/intents/\" package. All intents defined here (system intents \\& custom intents) must have a corresponding intent file in the \"custom/global/\" package. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n\nCustomAction\n------------\n\nDetails regarding a custom action.\n\n| YAML representation ||\n|---------------------------------------------------------------------------------------------------|---|\n| ``` engagement: object (/assistant/actionssdk/reference/rest/Shared.Types/Actions#Engagement) ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `engagement` | `object (`[Engagement](/assistant/actionssdk/reference/rest/Shared.Types/Actions#Engagement)`)` Engagement mechanisms associated with the action to help end users subscribe to push notifications and daily updates. Note that the intent name specified in daily updates/push notifications slot config needs to match the intent corresponding to this action for end users to subscribe to these updates. |\n\nEngagement\n----------\n\nDefines the engagement mechanisms associated with this action. This allows end users to subscribe to push notification and daily update.\n\n| YAML representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` title: string pushNotification: object (/assistant/actionssdk/reference/rest/Shared.Types/Actions#PushNotification) actionLink: object (/assistant/actionssdk/reference/rest/Shared.Types/Actions#ActionLink) assistantLink: object (/assistant/actionssdk/reference/rest/Shared.Types/Actions#AssistantLink) dailyUpdate: object (/assistant/actionssdk/reference/rest/Shared.Types/Actions#DailyUpdate) ``` |\n\n| Fields ||\n|-------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `title` | `string` The title of the engagement that will be sent to end users asking for their permission to receive updates. The prompt sent to end users for daily updates will look like \"What time would you like me to send your daily {title}\" and for push notifications will look like \"Is it ok if I send push notifications for {title}\". **This field is localizable.** |\n| `pushNotification` | `object (`[PushNotification](/assistant/actionssdk/reference/rest/Shared.Types/Actions#PushNotification)`)` Push notification settings that this engagement supports. |\n| `actionLink` **(deprecated)** | `object (`[ActionLink](/assistant/actionssdk/reference/rest/Shared.Types/Actions#ActionLink)`)` | This item is deprecated! Link config for an action which determines whether sharing links is enabled for the action and if so, contains the user friendly display name for the link. ActionLink is deprecated. Use AssistantLink instead. |\n| `assistantLink` | `object (`[AssistantLink](/assistant/actionssdk/reference/rest/Shared.Types/Actions#AssistantLink)`)` Link config for an action which determines whether sharing links is enabled for the action and if so, contains the user friendly display name for the link. |\n| `dailyUpdate` | `object (`[DailyUpdate](/assistant/actionssdk/reference/rest/Shared.Types/Actions#DailyUpdate)`)` Daily update settings that this engagement supports. |\n\nPushNotification\n----------------\n\nDefines push notification settings that this engagement supports.\n\nDailyUpdate\n-----------\n\nDefines daily update settings that this engagement supports.\n\nActionLink\n----------\n\n| This item is deprecated!\nIndicates whether sharing links is enabled for this action and the corresponding settings. Action links are used to deep link a user into a specific action. ActionLink is deprecated. Use AssistantLink instead.\n\n| YAML representation ||\n|-----------------------|---|\n| ``` title: string ``` |\n\n| Fields ||\n|---------|----------------------------------------------------|\n| `title` | `string` User friendly display title for the link. |\n\nAssistantLink\n-------------\n\nIndicates whether sharing links is enabled for this action and the corresponding settings. Assistant links are used to deep link a user into a specific action.\n\n| YAML representation ||\n|-----------------------|---|\n| ``` title: string ``` |\n\n| Fields ||\n|---------|----------------------------------------------------|\n| `title` | `string` User friendly display title for the link. |"]]
