Actions
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Reprezentuje listę działań zdefiniowanych w projekcie.
| Pola |
custom |
map (key: string, value: object (CustomAction))
Zmapuj z intencji na działania niestandardowe, aby skonfigurować wywoływanie w projekcie. Intencje wywołania mogą obejmować intencje systemowe lub intencje niestandardowe zdefiniowane w sekcji „custom/intents/” pakietu SDK. Wszystkie zdefiniowane tutaj intencje (intencje systemowe i niestandardowe intencje) muszą mieć odpowiedni plik intencji w katalogu „custom/global/” pakietu SDK. Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
|
CustomAction
Szczegóły dotyczące działania niestandardowego.
| Reprezentacja YAML |
engagement:
object (Engagement) |
| Pola |
engagement |
object (Engagement)
Mechanizmy angażowania powiązane z działaniem, które pomagają użytkownikom w zasubskrybowaniu powiadomień push i codziennych aktualności. Pamiętaj, że nazwa intencji podana w konfiguracji przedziału aktualizacji dziennych/powiadomień push musi odpowiadać intencji odpowiadającej temu działaniu, aby użytkownicy końcowi subskrybowali te aktualizacje.
|
Zaangażowanie
Definiuje mechanizmy zaangażowania powiązane z tym działaniem. Dzięki temu użytkownicy mogą subskrybować powiadomienia push i codzienną aktualizację.
| Pola |
title |
string
Tytuł zaangażowania, który zostanie wysłany do użytkowników z prośbą o zgodę na otrzymywanie aktualizacji. Prośba wysyłana do użytkowników w przypadku codziennych aktualizacji będzie wyglądać tak: „O której godzinie mam wysyłać codzienne {title}” W przypadku powiadomień push będzie to wyglądać tak: „Czy mogę wysyłać powiadomienia push dotyczące tytułu {title}”? To pole można zlokalizować.
|
pushNotification |
object (PushNotification)
Ustawienia powiadomień push obsługiwane przez to zaangażowanie.
|
actionLink
(deprecated) |
object (ActionLink)
Konfiguracja linku dla działania, która określa, czy linki udostępniania są włączone dla tej czynności, a jeśli tak, zawiera łatwą w obsłudze nazwę wyświetlaną linku. Interfejs ActionLink został wycofany. Zamiast tego użyj AssistantLink.
|
assistantLink |
object (AssistantLink)
Konfiguracja linku dla działania, która określa, czy linki udostępniania są włączone dla tej czynności, a jeśli tak, zawiera łatwą w obsłudze nazwę wyświetlaną linku.
|
dailyUpdate |
object (DailyUpdate)
Ustawienia codziennej aktualizacji obsługiwane przez to zaangażowanie.
|
PushNotification
Określa ustawienia powiadomień push obsługiwane przez to zaangażowanie.
DailyUpdate
Określa ustawienia codziennych aktualizacji obsługiwanych przez to zaangażowanie.
ActionLink
Wskazuje, czy udostępnianie linków jest włączone w przypadku tej czynności i powiązanych ustawień. Linki do działań służą do precyzyjnego łączenia użytkownika z konkretnym działaniem. Interfejs ActionLink został wycofany. Zamiast tego użyj AssistantLink.
| Reprezentacja YAML |
title: string |
| Pola |
title |
string
Przyjazny dla użytkownika tytuł wyświetlany linku.
|
AssistantLink
Wskazuje, czy udostępnianie linków jest włączone w przypadku tej czynności i powiązanych ustawień. Linki Asystenta służą do precyzyjnego linku do konkretnego działania użytkownika.
| Reprezentacja YAML |
title: string |
| Pola |
title |
string
Przyjazny dla użytkownika tytuł wyświetlany linku.
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
