تم إيقاف إجراءات المحادثات نهائيًا في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة.
Actions
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمثل قائمة الإجراءات المحددة في مشروع.
| الحقول |
custom |
map (key: string, value: object (CustomAction))
يمكنك الربط من الأهداف إلى الإجراءات المخصّصة لضبط استدعاء المشروع. يمكن أن تكون أغراض الاستدعاء إما نظامًا أو أغراضًا مخصصة تم تحديدها في العمود "custom/intents/". طرد. يجب أن يكون لجميع الأهداف المحدّدة هنا (أهداف النظام والأهداف المخصّصة) ملف هدف مقابل في السمة "custom/global/ " طرد. عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
|
CustomAction
| الحقول |
engagement |
object (Engagement)
آليات التفاعل المرتبطة بالإجراء لمساعدة المستخدمين النهائيين على الاشتراك في الإشعارات الفورية وآخر الأخبار اليومية. تجدر الإشارة إلى أنّ اسم الغرض المحدّد في إعدادات خانة الإشعارات الفورية أو التحديثات اليومية يجب أن يتطابق مع الغرض المقابل لهذا الإجراء كي يتمكّن المستخدمون النهائيون من الاشتراك في هذه التعديلات.
|
الجذب
تحدد آليات التفاعل المرتبطة بهذا الإجراء. يتيح ذلك للمستخدمين النهائيين الاشتراك في الإشعارات الفورية وآخر الأخبار اليومية.
| الحقول |
title |
string
عنوان التفاعل الذي سيتم إرساله إلى المستخدمين النهائيين لطلب إذنهم بتلقّي التعديلات ستظهر رسالة الطلب المُرسلة إلى المستخدمين النهائيين للحصول على التعديلات اليومية على النحو التالي: "في أي وقت تريد مني أن أرسل بيانات {title} اليومية؟". وبالنسبة إلى الإشعارات الفورية، ستظهر العبارة "هل يمكنني إرسال إشعارات فورية بشأن {title}". يمكن ترجمة هذا الحقل.
|
pushNotification |
object (PushNotification)
إعدادات الإشعارات الفورية المتاحة في هذا التفاعل
|
actionLink
(deprecated) |
object (ActionLink)
إعدادات الربط لإجراء يحدد ما إذا كانت روابط المشاركة مفعّلة لهذا الإجراء، وفي حال تفعيلها، تحتوي على الاسم المعروض للرابط سهل الاستخدام. تم إيقاف ActionLink نهائيًا. يمكنك استخدام AssistantLink بدلاً من ذلك.
|
assistantLink |
object (AssistantLink)
إعدادات الربط لإجراء يحدد ما إذا كانت روابط المشاركة مفعّلة لهذا الإجراء، وفي حال تفعيلها، تحتوي على الاسم المعروض للرابط سهل الاستخدام.
|
dailyUpdate |
object (DailyUpdate)
إعدادات التعديل اليومي المتاحة في هذا التفاعل
|
PushNotification
تحدد إعدادات الإشعارات الفورية المتاحة في هذا التفاعل.
DailyUpdate
يتم تحديد إعدادات التعديلات اليومية المتوافقة مع هذا التفاعل.
ActionLink
تشير هذه السمة إلى ما إذا كانت روابط المشاركة مفعّلة لهذا الإجراء والإعدادات المقابلة. تُستخدم روابط الإجراءات لربط المستخدم بإجراء محدّد في التطبيق. تم إيقاف ActionLink نهائيًا. يمكنك استخدام AssistantLink بدلاً من ذلك.
| الحقول |
title |
string
عنوان معروض سهل الاستخدام للرابط
|
AssistantLink
تشير هذه السمة إلى ما إذا كانت روابط المشاركة مفعّلة لهذا الإجراء والإعدادات المقابلة. تُستخدَم روابط "مساعد Google" لربط المستخدم بإجراءات معيّنة في التطبيق.
| الحقول |
title |
string
عنوان معروض سهل الاستخدام للرابط
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
