Files

برنامج التفاف لقائمة من الملفات

تمثيل JSON 
{

  // Union field file_type can be only one of the following:
  "configFiles": {
    object (ConfigFiles)
  },
  "dataFiles": {
    object (DataFiles)
  }
  // End of list of possible types for union field file_type.
}
الحقول
حقل الاتحاد file_type. يمكن إرسال نوع واحد فقط من الملفات إلى الخادم في كل مرة، أو ملفات التهيئة أو ملفات البيانات. يمكن أن يكون file_type واحدًا فقط مما يلي:
configFiles

object (ConfigFiles)

قائمة بملفات الإعداد ويشمل ذلك البيان والإعدادات وحِزم موارد نماذج التفاعل وغير ذلك.
dataFiles

object (DataFiles)

قائمة بملفات البيانات. ويتضمن ذلك الصورة والملف الصوتي ورمز مصدر وظيفة السحابة الإلكترونية.

ConfigFiles

مغلف لملفات الإعداد المتكررة. لا يمكن أن تتوفّر الحقول المتكرّرة في إحداها.

تمثيل JSON 
{
  "configFiles": [
    {
      object (ConfigFile)
    }
  ]
}
الحقول
configFiles[]

object (ConfigFile)

عدة ملفات إعداد.

ConfigFile

ويمثل ملفًا واحدًا يحتوي على بيانات منظَّمة. يمكن للمطوّرين تحديد معظم محتوى مشاريعهم باستخدام الإعدادات المنظَّمة التي تشمل الإجراءات والإعدادات وعملية التنفيذ.

تمثيل JSON 
{
  "filePath": string,

  // Union field file can be only one of the following:
  "manifest": {
    object (Manifest)
  },
  "actions": {
    object (Actions)
  },
  "settings": {
    object (Settings)
  },
  "webhook": {
    object (Webhook)
  },
  "intent": {
    object (Intent)
  },
  "type": {
    object (Type)
  },
  "entitySet": {
    object (EntitySet)
  },
  "globalIntentEvent": {
    object (GlobalIntentEvent)
  },
  "scene": {
    object (Scene)
  },
  "staticPrompt": {
    object (StaticPrompt)
  },
  "accountLinkingSecret": {
    object (AccountLinkingSecret)
  },
  "resourceBundle": {
    object
  }
  // End of list of possible types for union field file.
}
الحقول
filePath

string

المسار النسبي لملف الإعداد من جذر المشروع في بنية ملف SDK. لكل نوع من أنواع الملفات أدناه مسار ملف مسموح به. على سبيل المثال: settings/settings.yaml
حقل الاتحاد file. يجب أن يحتوي كل نوع من ملفات الإعداد على حقل مقابل في كل نوع. يمكن أن يكون file واحدًا فقط مما يلي:
manifest

object (Manifest)

ملف بيان واحد. مسار الملف المسموح به: manifest.yaml
actions

object (Actions)

ملف إجراءات واحد يضم جميع الإجراءات المحددة مسارات الملفات المسموح بها: actions/{language}?/actions.yaml
settings

object (Settings)

تكوين الإعدادات الفردية التي تتضمن الإعدادات غير القابلة للترجمة والإعدادات للغة التلقائية للمشروع (إذا تم تحديدها). بالنسبة إلى ملف إلغاء اللغة، ستتم تعبئة حقل localizedSettings فقط. مسارات الملفات المسموح بها: settings/{language}?/settings.yaml يُرجى العلم أنّ ملف الإعدادات غير المترجَم settings/settings.yaml يجب أن يكون متوفرًا في طلبات مسار الكتابة.
webhook

object (Webhook)

تعريف واحد للردّ التلقائي على الويب. مسار الملف المسموح به: webhooks/{WebhookName}.yaml
intent

object (Intent)

تعريف أحادي النية بالشراء مسارات الملفات المسموح بها: custom/intents/{language}?/{IntentName}.yaml
type

object (Type)

تعريف من نوع واحد مسارات الملفات المسموح بها: custom/types/{language}?/{TypeName}.yaml
entitySet

object (EntitySet)

تعريف مجموعة كيانات فردية. مسارات الملفات المسموح بها: custom/entitySets/{language}?/{EntitySetName}.yaml
globalIntentEvent

object (GlobalIntentEvent)

تعريف حدث عالمي واحد حسب النية بالشراء مسارات الملفات المسموح بها: custom/global/{GlobalIntentEventName}.yaml يجب أن يكون اسم الملف (GlobalIntentEventName) هو اسم الغرض الذي يقابله حدث الغرض العام هذا.
scene

object (Scene)

تعريف مشهد واحد مسارات الملفات المسموح بها: custom/scenes/{SceneName}.yaml
staticPrompt

object (StaticPrompt)

تعريف طلب ثابت واحد مسارات الملفات المسموح بها: custom/prompts/{language}?/{StaticPromptName}.yaml
accountLinkingSecret

object (AccountLinkingSecret)

البيانات الوصفية المقابلة لسر العميل المُستخدَم في ربط الحساب مسار الملف المسموح به: settings/accountLinkingSecret.yaml
resourceBundle

object (Struct format)

حزمة موارد واحدة، وهي خريطة من سلسلة إلى سلسلة أو قائمة من السلاسل. يمكن استخدام حِزم الموارد لترجمة السلاسل في الطلبات الثابتة. مسارات الملفات المسموح بها: resources/strings/{language}?/{multiple directories}?/{BundleName}.yaml

البيان

تحتوي على معلومات يمكن نقلها أي ليست خاصة بأي مشروع معين ويمكن نقلها بين المشروعات.

تمثيل JSON 
{
  "version": string
}
الحقول
version

string

تمثّل هذه السمة إصدار تنسيق الملف. إصدار تنسيق الملف الحالي هو 1.0 مثال: "1.0"

المهام

يمثل قائمة الإجراءات المحددة في مشروع.

تمثيل JSON 
{
  "custom": {
    string: {
      object (CustomAction)
    },
    ...
  }
}
الحقول
custom

map (key: string, value: object (CustomAction))

يمكنك الربط من الأهداف إلى الإجراءات المخصّصة لضبط استدعاء المشروع. يمكن أن تكون أغراض الاستدعاء إما نظامًا أو أغراضًا مخصصة تم تحديدها في العمود "custom/intents/". طرد. يجب أن يكون لجميع الأهداف المحدّدة هنا (أهداف النظام والأهداف المخصّصة) ملف هدف مقابل في السمة "custom/global/ " طرد.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

CustomAction

تفاصيل حول إجراء مخصّص

تمثيل JSON 
{
  "engagement": {
    object (Engagement)
  }
}
الحقول
engagement

object (Engagement)

آليات التفاعل المرتبطة بالإجراء لمساعدة المستخدمين النهائيين على الاشتراك في الإشعارات الفورية وآخر الأخبار اليومية. تجدر الإشارة إلى أنّ اسم الغرض المحدّد في إعدادات خانة الإشعارات الفورية أو التحديثات اليومية يجب أن يتطابق مع الغرض المقابل لهذا الإجراء كي يتمكّن المستخدمون النهائيون من الاشتراك في هذه التعديلات.

الجذب

تحدد آليات التفاعل المرتبطة بهذا الإجراء. يتيح ذلك للمستخدمين النهائيين الاشتراك في الإشعارات الفورية وآخر الأخبار اليومية.

تمثيل JSON 
{
  "title": string,
  "pushNotification": {
    object (PushNotification)
  },
  "actionLink": {
    object (ActionLink)
  },
  "assistantLink": {
    object (AssistantLink)
  },
  "dailyUpdate": {
    object (DailyUpdate)
  }
}
الحقول
title

string

عنوان التفاعل الذي سيتم إرساله إلى المستخدمين النهائيين لطلب إذنهم بتلقّي التعديلات ستظهر رسالة الطلب المُرسلة إلى المستخدمين النهائيين للحصول على التعديلات اليومية على النحو التالي: "في أي وقت تريد مني أن أرسل بيانات {title} اليومية؟". وبالنسبة إلى الإشعارات الفورية، ستظهر العبارة "هل يمكنني إرسال إشعارات فورية بشأن {title}". يمكن ترجمة هذا الحقل.
pushNotification

object (PushNotification)

إعدادات الإشعارات الفورية المتاحة في هذا التفاعل
dailyUpdate

object (DailyUpdate)

إعدادات التعديل اليومي المتاحة في هذا التفاعل

PushNotification

تحدد إعدادات الإشعارات الفورية المتاحة في هذا التفاعل.

DailyUpdate

يتم تحديد إعدادات التعديلات اليومية المتوافقة مع هذا التفاعل.

الإعدادات

يمثل هذا الإعداد إعدادات مشروع إجراءات غير محلية. العلامة التالية: 22

تمثيل JSON 
{
  "projectId": string,
  "defaultLocale": string,
  "enabledRegions": [
    string
  ],
  "disabledRegions": [
    string
  ],
  "category": enum (Category),
  "usesTransactionsApi": boolean,
  "usesDigitalPurchaseApi": boolean,
  "usesInteractiveCanvas": boolean,
  "usesHomeStorage": boolean,
  "designedForFamily": boolean,
  "containsAlcoholOrTobaccoContent": boolean,
  "keepsMicOpen": boolean,
  "surfaceRequirements": {
    object (SurfaceRequirements)
  },
  "testingInstructions": string,
  "localizedSettings": {
    object (LocalizedSettings)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "selectedAndroidApps": [
    string
  ]
}
الحقول
projectId

string

رقم تعريف مشروع الإجراءات
defaultLocale

string

اللغة التي تكون تلقائية للمشروع. بالنسبة إلى جميع الملفات باستثناء resources/ التي لا تحتوي على لغة في المسار، يتم تحديد مصدر البيانات المترجَمة إلى defaultLocale. بالنسبة إلى الملفات ضمن resources/، لا تعني أي لغة أنّ المورد متوافق مع جميع اللغات.
enabledRegions[]

string

يمثّل هذا الحقل المناطق التي يمكن للمستخدمين فيها استدعاء إجراءاتك، استنادًا إلى موقع تواجد المستخدم. لا يمكن ضبطها في حال ضبط disabledRegions. إذا لم يتم تحديد كل من enabledRegions وdisabledRegions، يمكن للمستخدمين استدعاء الإجراءات التي تتخذها في جميع المناطق. يتم تمثيل كل منطقة باستخدام الاسم الأساسي للاستهدافات الجغرافية في AdWords. راجع https://developers.google.com/adwords/api/docs/appendix/geotargeting الأمثلة: - "ألمانيا" - "غانا" - "اليونان" - "غرينادا" - "المملكة المتحدة" - "الولايات المتحدة" - "جزر الولايات المتحدة الصغيرة النائية" - "أورغواي"
disabledRegions[]

string

يمثّل هذا القسم المناطق التي يتم فيها حظر الإجراءات استنادًا إلى الموقع الجغرافي الذي تواجد فيه المستخدم. لا يمكن ضبطها في حال ضبط enabledRegions. يتم تمثيل كل منطقة باستخدام الاسم الأساسي للاستهدافات الجغرافية في AdWords. راجع https://developers.google.com/adwords/api/docs/appendix/geotargeting الأمثلة: - "ألمانيا" - "غانا" - "اليونان" - "غرينادا" - "المملكة المتحدة" - "الولايات المتحدة" - "جزر الولايات المتحدة الصغيرة النائية" - "أورغواي"
category

enum (Category)

فئة مشروع "الإجراءات" هذا
usesTransactionsApi

boolean

ما إذا كان بإمكان "المهام" استخدام المعاملات (على سبيل المثال، إجراء الحجوزات أو تلقّي الطلبات وما إلى ذلك). إذا كانت القيمة "خطأ"، ستتعذّر محاولات استخدام واجهات برمجة التطبيقات للمعاملات.
usesDigitalPurchaseApi

boolean

ما إذا كان يمكن لـ "المهام" إجراء معاملات للسلع الرقمية.
usesInteractiveCanvas

boolean

ما إذا كانت المهام تستخدم "لوحة الرسم التفاعلية" أم لا.
usesHomeStorage

boolean

تحديد ما إذا كانت الإجراءات تستخدم ميزة تخزين المنزل
designedForFamily

boolean

ما إذا كان محتوى المهام مخصّصًا للعائلات (DFF)
containsAlcoholOrTobaccoContent

boolean

ما إذا كانت الإجراءات تتضمن محتوًى مرتبطًا بالكحول أو التبغ
keepsMicOpen

boolean

يمكنك اختيار ما إذا كان بإمكان المهام ترك الميكروفون مفتوحًا بدون إشعار صريح أثناء المحادثة.
surfaceRequirements

object (SurfaceRequirements)

المتطلبات السطحية التي يجب أن يدعمها العميل لتنفيذ الإجراءات في هذا المشروع.
testingInstructions

string

تعليمات الاختبار الحرة لمراجع المهام (مثل تعليمات ربط الحساب)
localizedSettings

object (LocalizedSettings)

الإعدادات المترجَمة للغة التلقائية للمشروع يجب أن يكون لكل لغة إضافية ملف الإعدادات الخاص بها في دليلها.
accountLinking

object (AccountLinking)

السماح للمستخدمين بإنشاء الحسابات أو ربطها من خلال تسجيل الدخول بحساب Google و/أو خدمة OAuth الخاصة بك
selectedAndroidApps[]

string

تطبيقات Android المحدَّدة للوصول إلى عمليات الشراء على Google Play لإجراء المعاملات هذه مجموعة مختارة من تطبيقات Android المرتبطة بمشروع الإجراءات لإثبات ملكية العلامة التجارية وتفعيل ميزات إضافية. يمكنك الانتقال إلى https://developers.google.com/assistant/console/brand-verification للحصول على مزيد من المعلومات.

الفئة

اختيارات الفئات لمشروع "المهام"

عمليات التعداد
CATEGORY_UNSPECIFIED غير معروفة / غير محدّدة
BUSINESS_AND_FINANCE فئة "أعمال وشؤون مالية".
EDUCATION_AND_REFERENCE فئة التعليم والمراجع.
FOOD_AND_DRINK فئة "أطعمة ومشروبات".
GAMES_AND_TRIVIA فئة الألعاب والمعلومات العامة.
HEALTH_AND_FITNESS فئة الصحة واللياقة البدنية.
KIDS_AND_FAMILY فئة الأطفال والعائلة.
LIFESTYLE فئة أسلوب الحياة.
LOCAL الفئة المحلية.
MOVIES_AND_TV فئة الأفلام والبرامج التلفزيونية.
MUSIC_AND_AUDIO فئة الموسيقى والمحتوى الصوتي
NEWS فئة الأخبار
NOVELTY_AND_HUMOR ضمن فئة "الابتكار والفكاهة".
PRODUCTIVITY فئة الإنتاجية.
SHOPPING فئة Shopping.
SOCIAL الفئة الاجتماعية.
SPORTS فئة الرياضة.
TRAVEL_AND_TRANSPORTATION فئة السفر ووسائل النقل.
UTILITIES فئة برامج الخدمات.
WEATHER فئة الطقس.
HOME_CONTROL فئة الإدارة الآلية للمنزل.

SurfaceRequirements

تحتوي على مجموعة من المتطلبات التي يجب أن يدعمها سطح العميل لاستدعاء الإجراءات في مشروعك.

تمثيل JSON 
{
  "minimumRequirements": [
    {
      object (CapabilityRequirement)
    }
  ]
}
الحقول
minimumRequirements[]

object (CapabilityRequirement)

يشير إلى الحد الأدنى من مجموعة الإمكانات اللازمة لاستدعاء الإجراءات في مشروعك. إذا كان سطح العرض ينقص أيًّا من هذه العناصر، لن يتم تنفيذ الإجراء.

CapabilityRequirement

تمثّل هذه السمة متطلبات حول توفّر إمكانية معيّنة.

تمثيل JSON 
{
  "capability": enum (SurfaceCapability)
}
الحقول
capability

enum (SurfaceCapability)

تمثّل هذه السمة نوع القدرة.

SurfaceCapability

مجموعة محتملة من إمكانات مساحة العرض

عمليات التعداد
SURFACE_CAPABILITY_UNSPECIFIED غير معروفة / غير محدّدة
AUDIO_OUTPUT يتوافق تطبيق Surface مع إخراج الصوت.
SCREEN_OUTPUT يتوافق سطح العرض مع محتوى الشاشة والإخراج المرئي.
MEDIA_RESPONSE_AUDIO يتوافق تطبيق Surface مع صوت الاستجابة للوسائط.
WEB_BROWSER يتوافق تطبيق Surface مع متصفّحات الويب.
ACCOUNT_LINKING يتيح تطبيق Surface ربط الحسابات.
INTERACTIVE_CANVAS يتوافق تطبيق Surface مع "لوحة الرسم التفاعلية".
HOME_STORAGE يتيح تطبيق Surface مساحة تخزين في المنزل.

LocalizedSettings

يمثل هذا الإعداد إعدادات مشروع إجراءات خاصة بلغة المستخدم. في هذه الحالة، يعني "المستخدم" المستخدم النهائي الذي يستدعي إجراءاتك. هذه الرسالة قابلة للترجمة.

تمثيل JSON 
{
  "displayName": string,
  "pronunciation": string,
  "shortDescription": string,
  "fullDescription": string,
  "smallLogoImage": string,
  "largeBannerImage": string,
  "developerName": string,
  "developerEmail": string,
  "termsOfServiceUrl": string,
  "voice": string,
  "voiceLocale": string,
  "privacyPolicyUrl": string,
  "sampleInvocations": [
    string
  ],
  "themeCustomization": {
    object (ThemeCustomization)
  }
}
الحقول
displayName

string

مطلوب. الاسم المعروض التلقائي لمشروع الإجراءات هذا (في حال عدم توفُّر ترجمة)
pronunciation

string

مطلوب. طريقة لفظ الاسم المعروض لاستدعاءه ضمن سياق صوتي (منطوق).
shortDescription

string

مطلوب. الوصف الموجز التلقائي لمشروع "المهام" (في حال عدم توفُّر ترجمة). عدد الأحرف المسموح به هو 80.
fullDescription

string

مطلوب. الوصف الطويل التلقائي لمشروع "المهام" (في حال عدم توفُّر ترجمة). عدد الأحرف المسموح به هو 4,000 حرف.
smallLogoImage

string

مطلوب. صورة مربّعة صغيرة الحجم 192 × 192 بكسل يجب تحديد ذلك كمرجع للصورة المقابلة في دليل resources/images/. على سبيل المثال، $resources.images.foo (بدون الإضافة) للصورة في resources/images/foo.jpg عند العمل على مشروع تم سحبه من Console، يمكن استخدام عنوان URL المسحوب الذي تديره Google. لا يُسمح بعناوين URL من مصادر خارجية.
largeBannerImage

string

اختياريّ. صورة أفقية كبيرة بدقة 1920 × 1080 بكسل يجب تحديد ذلك كمرجع للصورة المقابلة في دليل resources/images/. على سبيل المثال، $resources.images.foo (بدون الإضافة) للصورة في resources/images/foo.jpg عند العمل على مشروع تم سحبه من Console، يمكن استخدام عنوان URL المسحوب الذي تديره Google. لا يُسمح بعناوين URL من مصادر خارجية.
developerName

string

مطلوب. اسم المطوِّر الذي سيتم عرضه للمستخدمين
developerEmail

string

مطلوب. عنوان البريد الإلكتروني المخصّص للتواصل مع المطوِّر
termsOfServiceUrl

string

اختياريّ. تمثّل هذه السمة عنوان URL لبنود الخدمة.
voice

string

مطلوب. نوع صوت "مساعد Google" الذي يسمعه المستخدمون عند تفاعلهم مع "مهامك". القيم المسموح بها هي "male_1" و"male_2" و"female_1" و"female_2".
voiceLocale

string

اختياريّ. لغة الصوت المحدد. وفي حال عدم تحديد هذه السياسة، يؤدّي ذلك إلى تعديل لغة "مساعد Google" لدى المستخدم. يجب أن يكون للغة الصوت في حال تحديدها، اللغة الجذر نفسها للّغة المحدّدة في LocalizedSettings.
privacyPolicyUrl

string

مطلوب. تمثّل هذه السمة عنوان URL لسياسة الخصوصية.
sampleInvocations[]

string

اختياريّ. تظهر أمثلة لعبارات الاستدعاء ضمن وصف مشروع "المهام" في دليل "مساعد Google". سيساعد هذا المستخدمين في تعلم كيفية استخدامه.
themeCustomization

object (ThemeCustomization)

اختياريّ. عمليات تخصيص المظاهر للمكوّنات المرئية ضمن "المهام"

ThemeCustomization

الأنماط المطبَّقة على البطاقات المقدَّمة للمستخدمين

تمثيل JSON 
{
  "backgroundColor": string,
  "primaryColor": string,
  "fontFamily": string,
  "imageCornerStyle": enum (ImageCornerStyle),
  "landscapeBackgroundImage": string,
  "portraitBackgroundImage": string
}
الحقول
backgroundColor

string

لون خلفية البطاقات يمكن استخدام العنصر كإجراء احتياطي إذا كان background_image لا يوفّره المطوّرون أو إذا كان العنصر background_image غير ملائم لمساحات عرض معيّنة. مثال على الاستخدام: #FAFAFA
primaryColor

string

سيتم استخدام لون المظهر الأساسي للإجراء لضبط لون نص العنوان ولون خلفية عنصر العمل لبطاقات "المهام مع مساعد Google". مثال على الاستخدام: #FAFAFA
fontFamily

string

مجموعة الخطوط التي سيتم استخدامها لعنوان البطاقات. الخطوط المتوافقة: - Sans Serif - Sans Serif Medium - Sans Serif غامق - Sans Serif Black - Sans Serif مكثف - Sans Serif مكثف - Serif - Serif غامق - Monospace - Cursive - Sans Serif Smallcaps
imageCornerStyle

enum (ImageCornerStyle)

نمط حدود الصورة الأمامية للبطاقات على سبيل المثال، يمكن استخدامها على الصورة الأمامية لبطاقة أساسية أو بطاقة لوحة عرض دوّارة.
landscapeBackgroundImage

string

الوضع الأفقي (1920×1200 بكسل على الأقل) يجب تحديد ذلك كمرجع للصورة المقابلة في دليل resources/images/. على سبيل المثال: $resources.images.foo (بدون الامتداد) للصورة في resources/images/foo.jpg عند العمل على مشروع تم سحبه من Console، يمكن استخدام عنوان URL الذي تديره Google.
portraitBackgroundImage

string

وضع "بورتريه" (1200×1920 بكسل على الأقل) يجب تحديد ذلك كمرجع للصورة المقابلة في دليل resources/images/. على سبيل المثال: $resources.images.foo (بدون الامتداد) للصورة في resources/images/foo.jpg عند العمل على مشروع تم سحبه من Console، يمكن استخدام عنوان URL الذي تديره Google.

ImageCornerStyle

يصف كيفية عرض حدود الصور.

عمليات التعداد
IMAGE_CORNER_STYLE_UNSPECIFIED حالة غير محدَّدة / غير محدّدة
CURVED زاوية دائرية للصورة.
ANGLED زاوية مستطيلة للصورة.

AccountLinking

يتيح ربط الحساب لـ Google توجيه المستخدم لتسجيل الدخول إلى خدمات التطبيق على الويب.

بالنسبة إلى نوعَي ربط "تسجيل الدخول بحساب Google" و"بروتوكول OAuth" و"تسجيل الدخول بحساب Google"، تُنشئ Google معرّف عميل يحدِّد تطبيقك لـ Google ("معرّف العميل الصادر عن Google إلى "الإجراءات" في واجهة مستخدم Console). هذا الحقل للقراءة فقط ويمكن التحقق منه من خلال الانتقال إلى صفحة "ربط الحساب" في واجهة مستخدم Console. يمكنك الانتقال إلى: https://developers.google.com/assistant/identity/google-sign-in.

ملاحظة: بالنسبة إلى جميع أنواع إعدادات ربط الحسابات (باستثناء إعدادات تسجيل الدخول بحساب Google)، عليك تقديم اسم مستخدم وكلمة مرور لحساب تجريبي في Settings.testing_instructions حتى يتمكن فريق المراجعة من مراجعة التطبيق (لن تظهر للمستخدمين).

تمثيل JSON 
{
  "enableAccountCreation": boolean,
  "linkingType": enum (LinkingType),
  "authGrantType": enum (AuthGrantType),
  "appClientId": string,
  "authorizationUrl": string,
  "tokenUrl": string,
  "scopes": [
    string
  ],
  "learnMoreUrl": string,
  "useBasicAuthHeader": boolean
}
الحقول
enableAccountCreation

boolean

مطلوب. في حال true، سيتم السماح للمستخدمين بالاشتراك في حسابات جديدة من خلال الصوت. إذا كان false، لن يُسمح بإنشاء الحساب إلا على موقعك الإلكتروني. حدِّد هذا الخيار إذا كنت تريد عرض بنود الخدمة أو الحصول على موافقات المستخدمين أثناء الاشتراك. لا يمكن أن يكون linkedType GOOGLE_SIGN_IN عندما يكون هذا false. لا يمكن أن يكون linkedType هو OAUTH عندما يكون هذا الحقل true.
linkingType

enum (LinkingType)

مطلوب. نوع الربط المطلوب استخدامه. يمكنك الانتقال إلى https://developers.google.com/assistant/identity لمعرفة المزيد من التفاصيل حول أنواع الربط.
authGrantType

enum (AuthGrantType)

اختياريّ. يشير إلى نوع المصادقة لـ OAUTH LinkingType.
appClientId

string

اختياريّ. معرِّف العميل الصادر عن تطبيقك إلى Google. هذا هو معرِّف عميل OAuth2 الذي يحدّد Google لخدمتك. يتم الضبط عند استخدام OAuth فقط.
authorizationUrl

string

اختياريّ. نقطة نهاية لصفحة الويب لتسجيل الدخول التي تتوافق مع رمز OAuth2 أو التدفقات الضمنية. يجب أن يستخدم عنوان URL بروتوكول HTTPS. يتم الضبط عند استخدام OAuth فقط.
tokenUrl

string

اختياريّ. نقطة نهاية OAuth2 لتبادل الرمز المميز. يجب أن يستخدم عنوان URL بروتوكول HTTPS. لا يتم ضبط هذا الإعداد عند استخدام OAuth فقط مع منح IMPLICIT كنوع الربط. يتم الضبط عند استخدام OAuth فقط.
scopes[]

string

اختياريّ. قائمة الأذونات التي يجب أن يوافق عليها المستخدم من أجل استخدام خدمتك يتم الضبط عند استخدام OAuth فقط. تأكَّد من تقديم بنود الخدمة في معلومات الدليل في القسم LocalizedSettings.terms_of_service_url في حال تحديد هذا الحقل.
learnMoreUrl

string

اختياريّ. هذه صفحة الويب الخاصة بخدمتك والتي تصف الأذونات التي يمنحها المستخدم إلى Google. لا يتم ضبط هذا الإعداد إلا في حال استخدام OAuth و"تسجيل الدخول بحساب Google". تأكَّد من تقديم بنود الخدمة في معلومات الدليل في القسم LocalizedSettings.terms_of_service_url في حال تحديد هذا الحقل.
useBasicAuthHeader

boolean

اختياريّ. إذا كانت القيمة true، اسمح لـ Google بنقل مُعرّف العميل والسر عبر رأس مصادقة HTTP الأساسية. بخلاف ذلك، تستخدم Google معرِّف العميل والسر داخل نص المنشور. يتم الضبط عند استخدام OAuth فقط. تأكَّد من تقديم بنود الخدمة في معلومات الدليل في القسم LocalizedSettings.terms_of_service_url في حال تحديد هذا الحقل.

LinkingType

نوع "ربط الحساب" المطلوب تنفيذه.

عمليات التعداد
LINKING_TYPE_UNSPECIFIED غير محدد
GOOGLE_SIGN_IN نوع ربط "تسجيل الدخول بحساب Google" عند استخدام نوع الربط هذا، لا يلزم إعداد أي حقول متعلقة ببروتوكول OAuth أدناه.
OAUTH_AND_GOOGLE_SIGN_IN نوع ربط OAuth و"تسجيل الدخول باستخدام حساب Google"
OAUTH نوع ربط OAuth

AuthGrantType

نوع منح OAuth2 الذي تستخدمه Google لتوجيه المستخدم لتسجيل الدخول إلى خدمة الويب لتطبيقك.

عمليات التعداد
AUTH_GRANT_TYPE_UNSPECIFIED غير محدد
AUTH_CODE منح رمز التفويض. يتطلب منك تقديم عنوان URL للمصادقة وعنوان URL لرمز الدخول.
IMPLICIT منح رمز ضمني. لا يتطلّب ذلك سوى تقديم عنوان URL للمصادقة.

الردّ التلقائي على الويب

البيانات الوصفية لأنواع مختلفة من الردود التلقائية على الويب. إذا كنت تستخدم inlineCloudFunction، يجب أن يكون رمز المصدر في دليل يحمل الاسم نفسه لقيمة المفتاح executeFunction. على سبيل المثال، يجب أن تكون قيمة المفتاح executeFunction باللغة my_webhook على النحو التالي: - /webhooks/my_webhook.yaml - /webhooks/my_webhook/index.js - /webhooks/my_webhook/package.json

تمثيل JSON 
{
  "handlers": [
    {
      object (Handler)
    }
  ],

  // Union field webhook_type can be only one of the following:
  "httpsEndpoint": {
    object (HttpsEndpoint)
  },
  "inlineCloudFunction": {
    object (InlineCloudFunction)
  }
  // End of list of possible types for union field webhook_type.
}
الحقول
handlers[]

object (Handler)

قائمة معالِجات هذا الرد التلقائي على الويب
حقل الاتحاد webhook_type. لا يتوفّر سوى نوع واحد فقط من الردود التلقائية على الويب. يمكن أن يكون webhook_type واحدًا فقط مما يلي:
httpsEndpoint

object (HttpsEndpoint)

نقطة نهاية HTTPS مخصّصة للردّ التلقائي على الويب.
inlineCloudFunction

object (InlineCloudFunction)

البيانات الوصفية لدالة السحابة الإلكترونية المنشورة من الرمز البرمجي في مجلد الردود التلقائية على الويب

المعالج

يفصح عن اسم معالِج webhoook. يمكن أن يحتوي الرد التلقائي على الويب على معالِجات متعددة مسجَّلة. ويمكن استدعاء هذه المعالجات من أماكن متعددة في مشروع المهام.

تمثيل JSON 
{
  "name": string
}
الحقول
name

string

مطلوب. اسم المعالج يجب أن يكون فريدًا على مستوى جميع معالِجات مشروع المهام. يمكنك التحقّق من اسم هذا المعالِج لاستدعاء الدالة الصحيحة في رمز مصدر التنفيذ.

HttpsEndpoint

نقطة نهاية REST للإشعار في حال عدم استخدام المحرِّر المضمّن.

تمثيل JSON 
{
  "baseUrl": string,
  "httpHeaders": {
    string: string,
    ...
  },
  "endpointApiVersion": integer
}
الحقول
baseUrl

string

عنوان URL الأساسي لبروتوكول HTTPS لنقطة نهاية التنفيذ (بروتوكول HTTP غير متوافق). يتم إلحاق أسماء المعالجات بمسار عنوان URL الأساسي بعد نقطتين (باتّباع دليل النمط في https://cloud.google.com/apis/design/custom_methods). على سبيل المثال، عنوان URL الأساسي هو "https://gactions.service.com/api" طلبات ذات عنوان URL التالي: "https://gactions.service.com/api:{method}".
httpHeaders

map (key: string, value: string)

خريطة مَعلمات HTTP التي سيتم تضمينها في طلب POST

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
endpointApiVersion

integer

إصدار البروتوكول الذي تستخدمه نقطة النهاية. وهذا هو البروتوكول الذي تشاركه جميع أنواع طريقة التنفيذ، وليس خاصًا بنوع طريقة التنفيذ في Google.

InlineCloudFunction

يحتوي على البيانات الوصفية لدالة سحابية مضمّنة تم نشرها من مجلد الردود التلقائية على الويب.

تمثيل JSON 
{
  "executeFunction": string
}
الحقول
executeFunction

string

اسم نقطة إدخال "دالة السحابة الإلكترونية". يجب أن تتطابق قيمة هذا الحقل مع اسم الطريقة التي تم تصديرها من رمز المصدر.

النيّة بالشراء

تربط أهدافًا إدخال المستخدم المفتوح للكائنات المنظَّمة. تتم مطابقة العبارات الشفهية مع الأهداف من خلال ميزة "فهم اللغات الطبيعية" (NLU) من Google. يمكن أن تؤدي مطابقات الأهداف إلى تشغيل أحداث في تصميم محادثتك لإحراز تقدّم في محادثة المستخدم. ويتم تحديد اسم الغرض في اسم الملف.

تمثيل JSON 
{
  "parameters": [
    {
      object (IntentParameter)
    }
  ],
  "trainingPhrases": [
    string
  ]
}
الحقول
parameters[]

object (IntentParameter)

تمثّل هذه السمة قائمة بالمعلَمات ضمن عبارات التدريب. يجب تحديد جميع المَعلمات هنا لاستخدامها في عبارة التدريب.
trainingPhrases[]

string

تتيح العبارات التدريبية لـ NLU من Google مطابقة الأهداف تلقائيًا مع البيانات التي أدخلها المستخدم. وكلما زاد عدد العبارات الفريدة التي يتم تقديمها، زادت فرصة مطابقة هذا الهدف. في ما يلي تنسيق جزء العبارة التدريبية المُشار إليه في تعليقات توضيحية. تجدر الإشارة إلى أنّ الحقل auto اختياري وأنّ السلوك التلقائي في حال عدم تحديد auto يعادل auto=false. تعني ($<paramName> '<sample text>' auto=<true or false>) auto = true أنه تمت إضافة تعليقات توضيحية تلقائيًا إلى الجزء من قِبل NLU. تشير القيمة auto = false إلى أنّ المستخدم أضاف تعليقًا توضيحيًا إلى الجزء. ويكون هذا هو الخيار التلقائي عندما لا يتم تحديد الخيار "تلقائي". مثال: "حجز رحلة جوية من ($source 'San Francisco' auto=false) إلى ($dest 'Vancouver')"

IntentParameter

يشير ذلك المصطلح إلى تعريف معلَمة يمكن استخدامها داخل عبارات التدريب.

تمثيل JSON 
{
  "name": string,

  // Union field parameter_type can be only one of the following:
  "type": {
    object (ClassReference)
  },
  "entitySetReferences": {
    object (EntitySetReferences)
  }
  // End of list of possible types for union field parameter_type.
}
الحقول
name

string

مطلوب. اسم فريد لمعلَمة intent. يمكن استخدامها في الشروط والردود على مَعلمات الأهداف المرجعية المستخرجة من وحدة NLU باستخدام $intent.params.[name].resolved
حقل الاتحاد parameter_type. نوع معلَمة intent. يمكن أن يكون parameter_type واحدًا فقط مما يلي:
type

object (ClassReference)

اختياريّ. لتعريف نوع البيانات لهذه المَعلمة. لا يجب ضبط هذا الخيار على الأهداف المضمّنة.
entitySetReferences

object (EntitySetReferences)

اختياريّ. إحالات إلى مجموعات الكيانات المسموح بها لمعلَمة الغرض هذه صالحة فقط لمعلمات هدف مدمج. وتشير هذه المراجع إلى مجموعات الكيانات في الحقل "custom/entitySets" الدليل.

ClassReference

يشير ذلك المصطلح إلى مرجع إلى فئة يُستخدَم للإشارة إلى نوع حقل أو قيمة معروضة. التعدادات هي أيضًا نوع من الفئات التي يمكن الرجوع إليها باستخدام ClassReference.

تمثيل JSON 
{
  "name": string,
  "list": boolean
}
الحقول
name

string

مطلوب. اسم النوع المضمّن أو النوع المخصّص للمَعلمة أمثلة: PizzaToppings، actions.type.Number
list

boolean

اختياريّ. يشير إلى ما إذا كان نوع البيانات يمثل قائمة من القيم.

EntitySetReferences

مراجع مجموعة الكيانات لمعلَمة intent.

تمثيل JSON 
{
  "entitySetReferences": [
    {
      object (EntitySetReference)
    }
  ]
}
الحقول
entitySetReferences[]

object (EntitySetReference)

مطلوب. مراجع مجموعة الكيانات لمعلَمة intent.

EntitySetReference

مرجع إلى مجموعة الكيانات المسموح بها لمعلَمة الغرض هذه.

تمثيل JSON 
{
  "entitySet": string
}
الحقول
entitySet

string

مطلوب. تحدّد المجموعة المحدّدة من الكيانات التي يجب أخذها في الاعتبار لمَعلمة معيّنة. يجب أن يتوفّر تعريف مجموعة الكيانات المقابل في الدليل custom/entitySets/.

النوع

تعريف النوع المخصّص، وليس الأنواع المضمّنة. يمكن تعيين الأنواع لخانات في مشهد أو معلمات عبارات التدريب الخاصة بالهدف. من الناحية العملية، يمكن اعتبار الأنواع على أنها تعدادات. لاحظ أنه يتم تحديد اسم النوع في اسم الملف.

تمثيل JSON 
{
  "exclusions": [
    string
  ],

  // Union field sub_type can be only one of the following:
  "synonym": {
    object (SynonymType)
  },
  "regularExpression": {
    object (RegularExpressionType)
  },
  "freeText": {
    object (FreeTextType)
  }
  // End of list of possible types for union field sub_type.
}
الحقول
exclusions[]

string

هي مجموعة من الكلمات أو العبارات الاستثنائية التي يجب عدم مطابقتها حسب النوع. ملاحظة: إذا تمت مطابقة الكلمة أو العبارة حسب النوع ولكن تم إدراجها كاستبعاد، لن يتم عرضها في نتيجة استخراج المَعلمة. يمكن ترجمة هذا الحقل.
حقل الاتحاد sub_type. يتم اختيار النوع الفرعي بناءً على نوع المطابقة المطلوب إجراؤها. يمكن أن يكون sub_type واحدًا فقط مما يلي:
synonym

object (SynonymType)

نوع المرادفات، وهو في الأساس تعداد.
regularExpression

object (RegularExpressionType)

نوع التعبير العادي: يسمح بمطابقة التعبير العادي.
freeText

object (FreeTextType)

نوع FreeText.

SynonymType

اكتب محتوى يطابق النص حسب مجموعة من المرادفات.

تمثيل JSON 
{
  "matchType": enum (MatchType),
  "acceptUnknownValues": boolean,
  "entities": {
    string: {
      object (Entity)
    },
    ...
  }
}
الحقول
matchType

enum (MatchType)

اختياريّ. نوع المطابقة للمرادف.
acceptUnknownValues

boolean

اختياريّ. عند ضبط هذه السياسة على "صحيح"، سيؤدي ذلك إلى مطابقة الكلمات أو العبارات غير المعروفة استنادًا إلى بيانات المدخلات والتدريب على النية في الشراء، مثل السلع التي قد تتم إضافتها إلى قائمة البقالة.
entities

map (key: string, value: object (Entity))

مطلوب. خريطة مُسَمّاة للكيانات المرادفات

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

MatchType

نوع التطابق الذي ستستخدمه الإدخالات في هذا النوع. سيضمن ذلك أن تستخدم جميع الأنواع طريقة المطابقة نفسها، كما يسمح بتنوع المطابقة لمطابقة المرادفات (أي ضبابي مقابل تام). إذا كانت القيمة هي UNSPECIFIED، سيتم ضبطها تلقائيًا على EXACT_MATCH.

عمليات التعداد
UNSPECIFIED وتكون القيمة التلقائية هي EXACT_MATCH.
EXACT_MATCH يبحث عن تطابق تام للمرادف أو الاسم.
FUZZY_MATCH أكثر من EXACT_MATCH. تبحث عن المطابقات المتشابهة وكذلك المطابقات التامة.

الكيان

يمثل حقل كيان مرادفات يحتوي على تفاصيل إدخال واحد داخل النوع.

تمثيل JSON 
{
  "display": {
    object (EntityDisplay)
  },
  "synonyms": [
    string
  ]
}
الحقول
display

object (EntityDisplay)

اختياريّ. تفاصيل عرض الكيان.
synonyms[]

string

اختياريّ. تمثّل هذه السمة قائمة المرادفات للكيان. يمكن ترجمة هذا الحقل.

EntityDisplay

العناصر التي سيتم عرضها على لوحة الرسم بمجرد استخراج كيان نوع معين من استعلام. مناسبة فقط للتطبيقات التي تفعِّل فيها لوحة الرسم. هذه الرسالة قابلة للترجمة.

تمثيل JSON 
{
  "iconTitle": string,
  "iconUrl": string
}
الحقول
iconTitle

string

اختياريّ. عنوان الرمز
iconUrl

string

مطلوب. تمثّل هذه السمة عنوان URL للرمز.

RegularExpressionType

اكتب يتطابق مع النص حسب التعبيرات العادية. هذه الرسالة قابلة للترجمة.

تمثيل JSON 
{
  "entities": {
    string: {
      object (Entity)
    },
    ...
  }
}
الحقول
entities

map (key: string, value: object (Entity))

مطلوب. خريطة مُسَمّاة للكيانات التي يحتوي كل منها على سلاسل تعبير عادي.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

الكيان

تمثل هذه السمة كائن كيان يحتوي على التعبير العادي الذي يُستخدَم للمقارنة.

تمثيل JSON 
{
  "display": {
    object (EntityDisplay)
  },
  "regularExpressions": [
    string
  ]
}
الحقول
display

object (EntityDisplay)

اختياريّ. العناصر التي سيتم عرضها على اللوحة بعد استخراج كيان من طلب بحث مناسبة فقط للتطبيقات التي تفعِّل فيها لوحة الرسم.
regularExpressions[]

string

مطلوب. لاستخدام بنية التعبير العادي RE2 (يمكنك الاطّلاع على https://github.com/google/re2/wiki/Syntax لمعرفة مزيد من التفاصيل)

FreeTextType

النوع الذي يتطابق مع أي نص إذا كان سياق الكلمات المحيطة قريبًا من أمثلة التدريب المقدَّمة

تمثيل JSON 
{
  "display": {
    object (EntityDisplay)
  }
}
الحقول
display

object (EntityDisplay)

اختياريّ. العناصر التي سيتم عرضها على اللوحة بعد استخراج كيان من طلب بحث مناسبة فقط للتطبيقات التي تفعِّل فيها لوحة الرسم.

EntitySet

تصف مجموعات الكيانات مجموعة محدّدة مسبقًا من الكيانات التي يمكن أن تأتي منها قيم مَعلمات النية المضمّنة. يمكن الإشارة إلى مجموعات الكيانات من كيان لتتمكن من استخدام الكيان في مَعلمات intent المضمّنة.

تمثيل JSON 
{
  "entities": [
    {
      object (Entity)
    }
  ]
}
الحقول
entities[]

object (Entity)

مطلوب. قائمة الكيانات التي تتوافق معها مجموعة الكيانات هذه.

الكيان

تمثّل هذه السمة كيانًا يمكن أن تأتي منه قيمة معلَمة الغرض المضمّنة.

تمثيل JSON 
{
  "id": string
}
الحقول
id

string

مطلوب. رقم تعريف الكيان. للحصول على قائمة بالمَعلمات المضمَّنة والكيانات المتوافقة معها، يُرجى الاطّلاع على https://developers.google.com/assistant/conversational/build/built-in-intents.

GlobalIntentEvent

إلى جانب معالج الأهداف العامة. يتم تحديد الأحداث العالمية حسب النية بالشراء على مشروع "المهام" بالكامل، وقد يتم تجاهلها من خلال معالِجات الأهداف في المشهد. يجب أن تكون أسماء الأهداف فريدة ضمن مشروع المهام.

يمكن مطابقة الأهداف العالمية في أي وقت خلال الجلسة، ما يسمح للمستخدمين بالوصول إلى المسارات الشائعة مثل "الحصول على المساعدة". أو "الرجوع إلى الصفحة الرئيسية". ويمكن استخدامها أيضًا لربط المستخدمين بصفحات معيّنة في تدفقات محدّدة عند استدعاء إجراء.

تجدر الإشارة إلى أنّه يتم تحديد اسم الغرض في اسم الملف.

تمثيل JSON 
{
  "transitionToScene": string,
  "handler": {
    object (EventHandler)
  }
}
الحقول
transitionToScene

string

اختياريّ. مشهد الوجهة الذي يجب أن تنتقل إليه المحادثة. يتم تدمير حالة المشهد الحالي عند الانتقال.
handler

object (EventHandler)

اختياريّ. معالِج الحدث الذي يتم تشغيله عند مطابقة الغرض يجب تنفيذه قبل الانتقال إلى مشهد الوجهة. يمكن الاستفادة من إنشاء الطلبات استجابةً للأحداث.

EventHandler

لتحديد معالجًا سيتم تنفيذه بعد حدث. ومن الأمثلة على الأحداث هي الأحداث القائمة على النية والحالة في مشهد.

تمثيل JSON 
{
  "webhookHandler": string,

  // Union field prompt can be only one of the following:
  "staticPrompt": {
    object (StaticPrompt)
  },
  "staticPromptName": string
  // End of list of possible types for union field prompt.
}
الحقول
webhookHandler

string

اسم معالِج الرد التلقائي على الويب المطلوب طلبه.
حقل الاتحاد prompt. يمكن تضمين المطالبات أو الإشارة إليها بالاسم. يمكن أن يكون prompt واحدًا فقط مما يلي:
staticPrompt

object (StaticPrompt)

طلب ثابت مضمّن ويمكن أن يحتوي على مراجع لموارد السلسلة في الحِزم.
staticPromptName

string

اسم الطلب الثابت الذي سيتم استدعاؤه

StaticPrompt

يمثّل هذا الحقل قائمة باقتراحات طلبات البحث، وسيتم اختيار إحداها كطلب لعرضها في الردّ على المستخدم. هذه الرسالة قابلة للترجمة.

تمثيل JSON 
{
  "candidates": [
    {
      object (StaticPromptCandidate)
    }
  ]
}
الحقول
candidates[]

object (StaticPromptCandidate)

قائمة بالطلبات المرشحة التي سيتم إرسالها إلى العميل. ويتضمّن كل طلب أداة اختيار لتحديد وقت استخدامه. سيتم إرسال أداة الاختيار الأولى التي تطابق أحد الطلبات وتجاهل الباقي.

StaticPromptCandidate

لتمثيل عنصر مرشّح للطلب الثابت

تمثيل JSON 
{
  "selector": {
    object (Selector)
  },
  "promptResponse": {
    object (StaticPromptResponse)
  }
}
الحقول
selector

object (Selector)

اختياريّ. معايير ما إذا كان هذا الطلب يتطابق مع طلب معيّن. إذا كانت أداة الاختيار فارغة، سيتم دائمًا تشغيل هذا الطلب.
promptResponse

object (StaticPromptResponse)

تمثّل هذه السمة استجابة الطلب المرتبطة بأداة الاختيار.

أداة الاختيار

تحدِّد هذه السياسة معايير ما إذا كان الطلب يتطابق مع طلب.

تمثيل JSON 
{
  "surfaceCapabilities": {
    object (SurfaceCapabilities)
  }
}
الحقول
surfaceCapabilities

object (SurfaceCapabilities)

مجموعة إمكانيات العرض المطلوبة

SurfaceCapabilities

يمثل المساحة التي يستخدمها المستخدم لتقديم طلب إلى الإجراء.

تمثيل JSON 
{
  "capabilities": [
    enum (Capability)
  ]
}
الحقول
capabilities[]

enum (Capability)

مطلوب. يشير هذا المصطلح إلى الإمكانات التي تتيحها مساحة تقديم طلب إلى الإجراء.

الإمكانية

الإمكانات التي تتوافق مع مساحة عرض الجهاز في وقت الطلب.

عمليات التعداد
UNSPECIFIED إمكانية سطح غير محدّدة
SPEECH يمكن للجهاز التحدث إلى المستخدم عبر تحويل النص إلى كلام أو SSML.
RICH_RESPONSE يمكن للجهاز عرض ردود غنية بصريًا، مثل البطاقات والقوائم والجداول.
LONG_FORM_AUDIO يمكن للجهاز تشغيل وسائط صوتية طويلة، مثل الموسيقى وملفات البودكاست.
INTERACTIVE_CANVAS يمكن للجهاز عرض استجابة لوحة تفاعلية.
HOME_STORAGE يمكن أن يتيح الجهاز حفظ مساحة التخزين في المنزل واسترجاعها.

StaticPromptResponse

تمثل هذه الميزة الردود المنظَّمة لإرسالها إلى المستخدم، مثل النصوص والكلام والبطاقات وبيانات لوحة الرسم وشرائح الاقتراحات وما إلى ذلك.

تمثيل JSON 
{
  "firstSimple": {
    object (StaticSimplePrompt)
  },
  "content": {
    object (StaticContentPrompt)
  },
  "lastSimple": {
    object (StaticSimplePrompt)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (StaticLinkPrompt)
  },
  "override": boolean,
  "canvas": {
    object (StaticCanvasPrompt)
  }
}
الحقول
firstSimple

object (StaticSimplePrompt)

اختياريّ. أول رد صوتي ونص فقط.
content

object (StaticContentPrompt)

اختياريّ. محتوى مثل بطاقة أو قائمة أو وسائط لعرضها للمستخدم.
lastSimple

object (StaticSimplePrompt)

اختياريّ. آخر رد صوتي ونص فقط.
suggestions[]

object (Suggestion)

اختياريّ. سيتم عرض الاقتراحات للمستخدم والتي ستظهر دائمًا في نهاية الردّ. إذا كان الحقل append في الطلب الذي يتضمّن الطلب هو true، ستتم إضافة العناوين المحدَّدة في هذا الحقل إلى العناوين المحدَّدة في أي طلبات اقتراحات محدَّدة مسبقًا، وستتم إزالة القيم المكرّرة.
override

boolean

اختياريّ. وضع لكيفية دمج هذه الرسائل مع الرسائل المحددة مسبقًا. سيمحو true جميع الرسائل المحدَّدة مسبقًا (الأولى والأخيرة البسيطة والأخيرة ورابط المحتوى والاقتراحات ولوحة الرسم) وسيضيف الرسائل المحدَّدة في هذا الطلب. سيضيف false الرسائل المحدَّدة في هذا الطلب إلى الرسائل المحدَّدة في الردود السابقة. سيؤدي ضبط هذا الحقل على false إلى تفعيل الإلحاق ببعض الحقول داخل "الطلبات البسيطة" ومطالبة "الاقتراحات" و"طلب لوحة الرسم" (جزء من مطالبة المحتوى). سيتم دائمًا استبدال رسائل "المحتوى" و"الروابط" إذا تم تحديدها في الطلب. القيمة التلقائية هي false.
canvas

object (StaticCanvasPrompt)

رد يتم استخدامه في تجربة اللوحة التفاعلية.

StaticSimplePrompt

يمثل طلبًا بسيطًا لإرساله إلى مستخدم.

تمثيل JSON 
{
  "variants": [
    {
      object (Variant)
    }
  ]
}
الحقول
variants[]

object (Variant)

قائمة بالصيغ المحتملة

الصيغة

يمثل هذا المتغير جزءًا من الطلب البسيط.

تمثيل JSON 
{
  "speech": string,
  "text": string
}
الحقول
speech

string

اختياريّ. تمثل الكلام الذي سيتم قوله للمستخدم. يمكن أن يكون SSML أو تحويل النص إلى كلام. سيتم تلقائيًا إلحاق الكلام بالكلام في الطلب البسيط السابق. إذا كان الحقل override في الطلب الذي يتضمّن الرسالة هو true، سيلغي الكلام المحدَّد في هذا الحقل كلام الطلب البسيط السابق.
text

string

اختياريّ. النص الذي سيتم عرضه في فقاعة المحادثة. وفي حال عدم إتاحته، سيتم عرض عرض لحقل الكلام أعلاه. يقتصر على 640 حرفًا. سيتم تلقائيًا إلحاق النص بنص الطلب البسيط السابق. إذا كان الحقل override في الطلب الذي يتضمّن الطلب هو true، سيلغي النص المحدَّد في هذا الحقل نص الطلب البسيط السابق.

StaticContentPrompt

تمثّل هذه السمة عنصرًا نائبًا لجزء "المحتوى" من StaticPrompt.

تمثيل JSON 
{

  // Union field content can be only one of the following:
  "card": {
    object (StaticCardPrompt)
  },
  "image": {
    object (StaticImagePrompt)
  },
  "table": {
    object (StaticTablePrompt)
  },
  "media": {
    object (StaticMediaPrompt)
  },
  "list": {
    object (StaticListPrompt)
  },
  "collection": {
    object (StaticCollectionPrompt)
  },
  "collectionBrowse": {
    object (StaticCollectionBrowsePrompt)
  }
  // End of list of possible types for union field content.
}
الحقول
حقل الاتحاد content. لا يمكن عرض سوى نوع واحد من المحتوى في الطلب. يمكن أن يكون content واحدًا فقط مما يلي:
card

object (StaticCardPrompt)

بطاقة أساسية
image

object (StaticImagePrompt)

صورة.
table

object (StaticTablePrompt)

بطاقة جدول.
media

object (StaticMediaPrompt)

استجابة تشير إلى مجموعة من الوسائط التي سيتم تشغيلها.
list

object (StaticListPrompt)

بطاقة لعرض قائمة بالخيارات للاختيار منها
collection

object (StaticCollectionPrompt)

بطاقة تعرض قائمة بالخيارات للاختيار منها.
collectionBrowse

object (StaticCollectionBrowsePrompt)

بطاقة تعرض مجموعة من صفحات الويب المراد فتحها

StaticCardPrompt

بطاقة أساسية لعرض بعض المعلومات، على سبيل المثال: صورة و/أو نص.

تمثيل JSON 
{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (StaticImagePrompt)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (StaticLinkPrompt)
  }
}
الحقول
title

string

اختياريّ. العنوان العام للبطاقة.
subtitle

string

اختياريّ. العنوان الفرعي للبطاقة
text

string

مطلوب. النص الأساسي للبطاقة مطلوب ما لم تكن الصورة موجودة. تتيح مجموعة محدودة من بنية markdown للتنسيق.
image

object (StaticImagePrompt)

اختياريّ. صورة الجزء الرئيسي للبطاقة تم تثبيت الارتفاع على 192 وحدة بكسل مستقلة الكثافة (dp).
imageFill

enum (ImageFill)

اختياريّ. طريقة ملء خلفية الصورة
button

object (StaticLinkPrompt)

اختياريّ. زرّ يمكن النقر عليه لعرضه في البطاقة

StaticImagePrompt

صورة معروضة في البطاقة

تمثيل JSON 
{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}
الحقول
url

string

مطلوب. عنوان URL المصدر الخاص بالصورة يمكن أن تكون الصور بتنسيق JPG وPNG وGIF (متحرّكة وغير متحركة). مثلاً: https://www.agentx.com/logo.png
alt

string

مطلوب. وصف نصي للصورة التي سيتم استخدامها لتسهيل الاستخدام، على سبيل المثال قارئات الشاشة.
height

integer

اختياريّ. ارتفاع الصورة بالبكسل.
width

integer

اختياريّ. عرض الصورة بالبكسل.

ImageFill

خيارات عرض الصور المحتملة التي تؤثر في طريقة عرض الصورة ويجب استخدام هذه السمة عندما لا تتطابق نسبة عرض الصورة إلى ارتفاعها مع نسبة العرض إلى الارتفاع لحاوية الصورة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد ImageFill.
GRAY املأ الفجوات بين الصورة وحاوية الصورة بأشرطة رمادية.
WHITE املأ الفجوات بين الصورة وحاوية الصورة بأشرطة بيضاء.
CROPPED يتم تغيير حجم الصورة بحيث يتطابق عرض الصورة وارتفاعها مع أبعاد الحاوية أو يتجاوزها. وقد يؤدي ذلك إلى اقتصاص الجزء العلوي والسفلي من الصورة إذا كان ارتفاع الصورة الذي تم تغيير حجمه أكبر من ارتفاع الحاوية، أو اقتصاص الجانبَين الأيسر والأيمن من الصورة إذا كان عرض الصورة الذي تم تغيير حجمه أكبر من عرض الحاوية. هذا مشابه لـ "وضع التكبير/التصغير" على تلفزيون بشاشة عريضة عند تشغيل فيديو بنسبة 4:3.

StaticLinkPrompt

تحدّد هذه السمة رابطًا سيتم عرضه كشريحة اقتراح ويمكن للمستخدم فتحه.

تمثيل JSON 
{
  "name": string,
  "open": {
    object (OpenUrl)
  }
}
الحقول
name

string

اسم الرابط
open

object (OpenUrl)

تحدِّد هذه السياسة السلوك عندما يفتح المستخدم الرابط.

OpenUrl

تحدِّد هذه السياسة السلوك عندما يفتح المستخدم الرابط.

تمثيل JSON 
{
  "url": string,
  "hint": enum (UrlHint)
}
الحقول
url

string

حقل عنوان URL الذي يمكن أن يكون أيًا مما يلي: - http/https عناوين URL لفتح تطبيق مرتبط بتطبيق أو صفحة ويب
hint

enum (UrlHint)

يشير هذا الحقل إلى تلميح لنوع عنوان URL.

UrlHint

الأنواع المختلفة من تلميحات عناوين URL:

عمليات التعداد
HINT_UNSPECIFIED غير محدّد
AMP يشير عنوان URL مباشرةً إلى محتوى AMP أو إلى عنوان URL أساسي يشير إلى محتوى AMP من خلال <link rel="amphtml">.

StaticTablePrompt

بطاقة جدول لعرض جدول نصوص

تمثيل JSON 
{
  "title": string,
  "subtitle": string,
  "image": {
    object (StaticImagePrompt)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (StaticLinkPrompt)
  }
}
الحقول
title

string

اختياريّ. تمثّل هذه السمة العنوان العام للجدول. يجب تعيينه في حال ضبط الترجمة.
subtitle

string

اختياريّ. عنوان فرعي للجدول.
image

object (StaticImagePrompt)

اختياريّ. صورة مرتبطة بالجدول
columns[]

object (TableColumn)

اختياريّ. عناوين الأعمدة ومحاذاة الأعمدة
rows[]

object (TableRow)

اختياريّ. بيانات الصف في الجدول يمكن ضمان عرض أول 3 صفوف، ولكن قد يتم اقتصاص الصفوف الأخرى على أسطح معيّنة. يُرجى إجراء الاختبار باستخدام المحاكي لمعرفة الصفوف التي سيتم عرضها لسطح معيَّن. وفي مساحات العرض التي تتيح ميزة WEB_BROWSER، يمكنك توجيه المستخدم إلى صفحة ويب تحتوي على المزيد من البيانات.
button

object (StaticLinkPrompt)

اختياريّ. زرّ

TableColumn

تصف عمودًا في الجدول.

تمثيل JSON 
{
  "header": string,
  "align": enum (HorizontalAlignment)
}
الحقول
header

string

نص عنوان العمود
align

enum (HorizontalAlignment)

محاذاة أفقية لعمود w.r.t المحتوى إذا لم يتم تحديد ذلك، ستتم محاذاة المحتوى مع الحافة الأمامية.

HorizontalAlignment

محاذاة المحتوى داخل الخلية.

عمليات التعداد
UNSPECIFIED محاذاة أفقية غير محدّدة.
LEADING الحافة البادئة للخلية. هذا هو الخيار التلقائي.
CENTER تتم محاذاة المحتوى مع وسط العمود.
TRAILING تتم محاذاة المحتوى مع الحافة اللاحقة للعمود.

TableRow

تصف صفًا في الجدول.

تمثيل JSON 
{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}
الحقول
cells[]

object (TableCell)

الخلايا في هذا الصف. يتم ضمان عرض أول 3 خلايا، ولكن قد يتم اقتصاص الخلايا الأخرى على أسطح معيّنة. يُرجى الاختبار باستخدام المحاكي لمعرفة الخلايا التي سيتم عرضها على سطح معيَّن.
divider

boolean

يشير إلى ما إذا كان يجب أن يكون هناك مُقسّم بعد كل صف.

TableCell

لوصف خلية على التوالي.

تمثيل JSON 
{
  "text": string
}
الحقول
text

string

المحتوى النصي للخلية.

StaticMediaPrompt

يحتوي على معلومات عن الوسائط، مثل الاسم والوصف وعنوان URL وما إلى ذلك. رقم التعريف التالي: 11

تمثيل JSON 
{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ],
  "repeatMode": enum (RepeatMode)
}
الحقول
mediaType

enum (MediaType)

نوع الوسائط لهذا الردّ.
startOffset

string (Duration format)

إزاحة بدء كائن الوسائط الأول.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى، ويتم إنهاؤها بعبارة "s". مثال: "3.5s"
optionalMediaControls[]

enum (OptionalMediaControls)

أنواع عناصر التحكم الاختيارية في الوسائط التي يمكن أن تدعمها جلسة الاستجابة للوسائط هذه. في حال ضبطها، سيتم تقديم الطلب إلى جهة خارجية عند وقوع حدث معيّن للوسائط. في حال ترك هذه السياسة بدون ضبط، يجب أن يتعامل الطرف الثالث مع نوعَي التحكّم التلقائيَّين، "تم الانتهاء" و"تعذّر الإجراء".
mediaObjects[]

object (MediaObject)

قائمة بكائنات الوسائط.
repeatMode

enum (RepeatMode)

وضع التكرار لقائمة عناصر الوسائط.

MediaType

نوع الوسائط لهذا الردّ.

عمليات التعداد
MEDIA_TYPE_UNSPECIFIED قيمة غير محدّدة
AUDIO ملف صوتي
MEDIA_STATUS_ACK الاستجابة للإقرار بتقرير حالة الوسائط.

OptionalMediaControls

أنواع عناصر التحكم في الوسائط التي يمكن دعمها استجابة الوسائط بشكل اختياري

عمليات التعداد
OPTIONAL_MEDIA_CONTROLS_UNSPECIFIED قيمة غير محدّدة
PAUSED تم إيقاف الحدث مؤقتًا. يتم تشغيله عندما يوقف المستخدم الوسائط مؤقتًا.
STOPPED تم إيقاف الحدث. يتم تشغيله عندما يخرج المستخدم من جلسة تابعة لجهة خارجية أثناء تشغيل الوسائط.

MediaObject

يمثل كائن وسائط واحدًا.

تمثيل JSON 
{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}
الحقول
name

string

اسم كائن الوسائط هذا.
description

string

وصف عنصر الوسائط هذا.
url

string

تمثّل هذه السمة عنوان URL الذي يشير إلى محتوى الوسائط.
image

object (MediaImage)

الصورة التي سيتم عرضها مع بطاقة الوسائط.

MediaImage

الصورة التي سيتم عرضها داخل MediaPrompt

تمثيل JSON 
{

  // Union field image can be only one of the following:
  "large": {
    object (StaticImagePrompt)
  },
  "icon": {
    object (StaticImagePrompt)
  }
  // End of list of possible types for union field image.
}
الحقول
حقل الاتحاد image. يُسمح باستخدام نوع واحد فقط من MediaImage. يمكن أن يكون image واحدًا فقط مما يلي:
large

object (StaticImagePrompt)

صورة كبيرة، مثل غلاف الألبوم، وما إلى ذلك
icon

object (StaticImagePrompt)

رمز صورة صغير يتم عرضه على يمين العنوان. ويتم تغيير حجمها إلى 36×36 بكسل مستقل الكثافة.

RepeatMode

أنواع وضع التكرار لقائمة من عناصر الوسائط.

عمليات التعداد
REPEAT_MODE_UNSPECIFIED يعادل إيقاف التشغيل.
OFF إنهاء جلسة الوسائط في نهاية كائن الوسائط الأخير.
ALL تكرار إلى بداية كائن الوسائط الأول عند الوصول إلى نهاية كائن الوسائط الأخير.

StaticListPrompt

بطاقة لعرض قائمة بالخيارات للاختيار منها

تمثيل JSON 
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}
الحقول
title

string

اختياريّ. عنوان القائمة
subtitle

string

اختياريّ. العنوان الفرعي للقائمة.
items[]

object (ListItem)

مطلوب. عناصر القائمة.

ListItem

تمثّل هذه السمة عنصرًا في القائمة.

تمثيل JSON 
{
  "key": string,
  "title": string,
  "description": string,
  "image": {
    object (StaticImagePrompt)
  }
}
الحقول
key

string

مطلوب. مفتاح NLU الذي يتطابق مع اسم مفتاح الإدخال في النوع المرتبط. عند النقر على العنصر، ستتم إعادة نشر هذا المفتاح كمَعلمة خيار تحديد.
title

string

مطلوب. عنوان السلعة عند النقر على هذا النص، سيتم نشره مرة أخرى على المحادثة حرفيًا كما لو كان المستخدم قد كتبه. يجب أن يكون كل عنوان فريدًا من بين مجموعة العناصر.
description

string

اختياريّ. النص الأساسي للعنصر
image

object (StaticImagePrompt)

اختياريّ. صورة العنصر

StaticCollectionPrompt

بطاقة لعرض مجموعة من الخيارات للاختيار منها

تمثيل JSON 
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}
الحقول
title

string

اختياريّ. تمثّل هذه السمة عنوان المجموعة.
subtitle

string

اختياريّ. العنوان الفرعي للمجموعة.
items[]

object (CollectionItem)

مطلوب. عناصر المجموعة
imageFill

enum (ImageFill)

اختياريّ. خيار عرض نوع الصورة

CollectionItem

تمثّل هذه السمة عنصرًا في المجموعة.

تمثيل JSON 
{
  "key": string,
  "title": string,
  "description": string,
  "image": {
    object (StaticImagePrompt)
  }
}
الحقول
key

string

مطلوب. مفتاح NLU الذي يتطابق مع اسم مفتاح الإدخال في النوع المرتبط. عند النقر على العنصر، ستتم إعادة نشر هذا المفتاح كمَعلمة خيار تحديد.
title

string

مطلوب. عنوان السلعة عند النقر على هذا النص، سيتم نشره مرة أخرى على المحادثة حرفيًا كما لو كان المستخدم قد كتبه. يجب أن يكون كل عنوان فريدًا من بين مجموعة العناصر.
description

string

اختياريّ. النص الأساسي للعنصر
image

object (StaticImagePrompt)

اختياريّ. صورة العنصر

StaticCollectionBrowsePrompt

تقدم مجموعة من مستندات الويب كمجموعة من العناصر ذات المربعات الكبيرة. يمكن اختيار العناصر لبدء عرض مستند الويب المرتبط بها في عارض ويب.

تمثيل JSON 
{
  "items": [
    {
      object (CollectionBrowseItem)
    }
  ],
  "imageFill": enum (ImageFill)
}
الحقول
items[]

object (CollectionBrowseItem)

العناصر في مجموعة التصفّح يجب أن يكون حجم القائمة في النطاق [2، 10].
imageFill

enum (ImageFill)

خيار عرض الصور للصور في المجموعة.

CollectionBrowseItem

عنصر في المجموعة

تمثيل JSON 
{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (StaticImagePrompt)
  },
  "openUriAction": {
    object (OpenUrl)
  }
}
الحقول
title

string

مطلوب. عنوان عنصر المجموعة
description

string

تمثّل هذه السمة وصف عنصر المجموعة.
footer

string

نص التذييل لعنصر المجموعة، ويتم عرضه أسفل الوصف. سطر واحد من النص، تم اقتطاعه بعلامة الحذف.
image

object (StaticImagePrompt)

صورة للسلعة في المجموعة
openUriAction

object (OpenUrl)

مطلوب. معرف موارد منتظم (URI) للفتح إذا تم تحديد العنصر.

اقتراح

تمثل شريحة اقتراح، عنصر واجهة مستخدم يظهر للمستخدم لتيسير الأمر.

تمثيل JSON 
{
  "title": string
}
الحقول
title

string

مطلوب. النص المعروض في شريحة الاقتراح عند النقر على هذا النص، سيتم نشره مرة أخرى على المحادثة حرفيًا كما لو كان المستخدم قد كتبه. يجب أن يكون كل عنوان فريدًا من بين مجموعة شرائح الاقتراحات. 25 حرفًا بحد أقصى

StaticCanvasPrompt

يمثل هذا النوع رد "لوحة الرسم" التفاعلي الذي سيتم إرساله إلى المستخدم. يمكن استخدامه مع الحقل firstSimple في الطلب الذي يتضمّن الطلب للتحدّث إلى المستخدم بالإضافة إلى عرض ردّ تفاعلي على اللوحة.

تمثيل JSON 
{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "sendStateDataToCanvasApp": boolean,
  "enableFullScreen": boolean
}
الحقول
url

string

مطلوب. عنوان URL لعرض الويب المطلوب تحميله.
data[]

value (Value format)

اختياريّ. يتم تمرير بيانات JSON إلى صفحة الويب للتجربة الشاملة كفعالية. إذا كان الحقل override في الطلب الذي يتضمّن الطلب هو false من قيم البيانات المحدّدة في طلب لوحة الرسم هذا، ستتم إضافة قيم البيانات المحدّدة في طلبات "لوحة الرسم" السابقة.
suppressMic

boolean

اختياريّ. وتعني القيمة الحقيقية أنّه لن يتم فتح الميكروفون لالتقاط الإدخال بعد تقديم هذا الردّ الغامر للمستخدم.
sendStateDataToCanvasApp

boolean

اختياريّ. في حال true، يتم تضمين البيانات الوصفية المتعلقة بالمحادثة وإرسالها إلى تطبيق لوحة الرسم.
enableFullScreen

boolean

اختياريّ. في حال true، شغل تطبيق لوحة الرسم وضع ملء الشاشة ولن يكون له عنوان في أعلى الشاشة. وستظهر أيضًا رسالة إشعار منبثق على شاشة التحميل تتضمّن الاسم المعروض للإجراء واسم المطوّر وتعليمات عن كيفية الخروج منه. القيمة التلقائية: false.

منظر

المشهد هو الوحدة الأساسية لتدفق التحكم عند تصميم محادثة. يمكن ربطها كسلاسل مع مشاهد أخرى وإنشاء مطالبات للمستخدم النهائي وتحديد خانات. يتم تحديد اسم المشهد في اسم الملف.

تمثيل JSON 
{
  "onEnter": {
    object (EventHandler)
  },
  "intentEvents": [
    {
      object (IntentEvent)
    }
  ],
  "conditionalEvents": [
    {
      object (ConditionalEvent)
    }
  ],
  "slots": [
    {
      object (Slot)
    }
  ],
  "onSlotUpdated": {
    object (EventHandler)
  }
}
الحقول
onEnter

object (EventHandler)

المعالجة التي سيتم استدعاؤها عند الانتقال إلى هذا المشهد.
intentEvents[]

object (IntentEvent)

قائمة الأحداث التي يتم تشغيلها استنادًا إلى الأهداف. يمكن بدء هذه الأحداث في أي وقت بعد استدعاء معالج on_load. ملاحظة مهمة: تحدّد هذه الأحداث مجموعة الأهداف المرتبطة بهذا المشهد، وستحظى بالأولوية على أي أحداث محدّدة عالميًا لها الأهداف نفسها أو العبارات التي تؤدّي إلى الأحداث. يجب أن تكون أسماء الأهداف فريدة ضمن مشهد.
conditionalEvents[]

object (ConditionalEvent)

تمثّل هذه السمة قائمة الأحداث المطلوب تشغيلها استنادًا إلى العبارات الشرطية. يتم تقييمها بعد ملء النموذج أو مباشرة بعد on_load إذا لم يكن هذا المشهد يحتوي على نموذج (يتم التقييم مرة واحدة فقط). سيتم تشغيل أول حدث مطابق فقط.
slots[]

object (Slot)

تم ترتيب قائمة الخانات. تحدّد كل خانة نوع البيانات التي سيتم تحليلها وإعدادها لتخصيص تجربة درجة الدقة هذه (مثل الطلبات).
onSlotUpdated

object (EventHandler)

يتم استدعاء المعالج عند حدوث تغيير في حالة خانة لا ناتجة عن التحديثات داخل معالِج آخر. يتيح ذلك إلغاء صلاحية الخانات أو إلغاء صلاحية المشهد أو إجراء تغييرات أخرى على حالة المشهد.

IntentEvent

لتسجيل الأحداث التي يتم تشغيلها بسبب مطابقة النية.

تمثيل JSON 
{
  "intent": string,
  "transitionToScene": string,
  "handler": {
    object (EventHandler)
  }
}
الحقول
intent

string

مطلوب. الغرض من الحدث هو تشغيل الحدث.
transitionToScene

string

اختياريّ. مشهد الوجهة الذي يجب أن تنتقل إليه المحادثة. يتم تدمير حالة المشهد الحالي عند الانتقال.
handler

object (EventHandler)

اختياريّ. معالِج الحدث الذي يتم تشغيله عند مطابقة الغرض يجب تنفيذه قبل الانتقال إلى مشهد الوجهة. ويكون مفيدًا لإنشاء طلبات استجابةً للأحداث.

ConditionalEvent

لتسجيل الأحداث التي يتم تشغيلها كنتيجة لشرط صحيح.

تمثيل JSON 
{
  "condition": string,
  "transitionToScene": string,
  "handler": {
    object (EventHandler)
  }
}
الحقول
condition

string

مطلوب. شرط الفلتر لتشغيل هذا الحدث إذا تم تقييم الشرط على "صحيح"، سيتم تشغيل سمة handler المرتبطة. يُسمح باستخدام مراجع المتغيّرات التالية: $session - للإشارة إلى البيانات في مساحة تخزين الجلسة. $user: للإشارة إلى البيانات في مساحة تخزين المستخدم يمكن استخدام عوامل التشغيل المنطقية التالية (مع أمثلة): && - session.params.counter > 0 && session.params.counter < 100 || - session.params.foo == "John" || session.params.counter == "Adam" ! - !(session.params.counter == 5) المقارنات التالية متاحة: == و!= و< و> و<= و>= ويمكن استخدام القائمة التالية وعوامل السلسلة (مع أمثلة): in - "البطيخ" في session.params.fruitList size - size(session.params.fruitList) > 2 substring - session.params.fullName.contains("John")
transitionToScene

string

اختياريّ. مشهد الوجهة الذي يجب أن تنتقل المحادثة إليه عندما يتم تقييم الشرط المرتبط على أنه "صحيح". يتم تدمير حالة المشهد الحالي عند الانتقال.
handler

object (EventHandler)

اختياريّ. معالج الحدث الذي يتم تشغيله عند تقييم الشرط المرتبط إلى true يجب تنفيذه قبل الانتقال إلى مشهد الوجهة. يمكن الاستفادة من إنشاء الطلبات استجابةً للأحداث.

الحيز

إعدادات خانة. الشرائح هي وحدات فردية من البيانات يمكن ملؤها بلغة طبيعية (أي معلَمات الغرض) ومعلَمات الجلسات وغيرها من المصادر.

تمثيل JSON 
{
  "name": string,
  "type": {
    object (ClassReference)
  },
  "required": boolean,
  "promptSettings": {
    object (PromptSettings)
  },
  "commitBehavior": {
    object (CommitBehavior)
  },
  "config": value,
  "defaultValue": {
    object (DefaultValue)
  }
}
الحقول
name

string

مطلوب. اسم الخانة
type

object (ClassReference)

مطلوب. تحدد نوع البيانات لهذه الخانة.
required

boolean

اختياريّ. يشير إلى ما إذا كان يجب ملء الخانة قبل التقدّم. ستؤدي الخانات المطلوبة غير المكتمِلة إلى عرض إشعار قابل للتخصيص للمستخدم.
promptSettings

object (PromptSettings)

اختياريّ. لتسجيل المطالبات لمراحل مختلفة من ملء الخانات.
commitBehavior

object (CommitBehavior)

اختياريّ. سلوك التنفيذ المرتبط بالخانة
config

value (Value format)

اختياريّ. إعدادات إضافية مرتبطة بالخانة المستخدَمة لملء الخانة ويكون تنسيق الإعداد خاصًا بنوع الخانة. يمكن إضافة مراجع الموارد إلى مَعلمة المستخدِم أو الجلسة إلى هذه الإعدادات. هذا الإعداد مطلوب لملء الخانات ذات الصلة بالمعاملات وتفاعل المستخدمين.

مثال: بالنسبة إلى خانة من النوع actions.type.CompletePurchaseValue، تقترح الإعدادات التالية طلبًا رقميًا جيدًا مع إشارة إلى مَعلمة الجلسة التي يحدّدها العميل userSelectedSkuId:

{ &quot;@type&quot;: &quot;type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec&quot;, &quot;skuId&quot;: { &quot;skuType&quot;: &quot;SKU_TYPE_IN_APP&quot;, &quot;id&quot;: &quot;$session.params.userSelectedSkuId&quot;, &quot;packageName&quot;: &quot;com.example.company&quot; } }
defaultValue

object (DefaultValue)

اختياريّ. إعدادات لتعبئة قيمة تلقائية لهذه الخانة

PromptSettings

مكان واحد يتم فيه تحديد مطالبات الخانات

تمثيل JSON 
{
  "initialPrompt": {
    object (EventHandler)
  },
  "noMatchPrompt1": {
    object (EventHandler)
  },
  "noMatchPrompt2": {
    object (EventHandler)
  },
  "noMatchFinalPrompt": {
    object (EventHandler)
  },
  "noInputPrompt1": {
    object (EventHandler)
  },
  "noInputPrompt2": {
    object (EventHandler)
  },
  "noInputFinalPrompt": {
    object (EventHandler)
  }
}
الحقول
initialPrompt

object (EventHandler)

طلب قيمة الخانة نفسها مثال: "ما الحجم الذي تريده؟"
noMatchPrompt1

object (EventHandler)

يتم عرض هذا الطلب عندما لا يتطابق إدخال المستخدم مع نوع القيمة المتوقّعة للخانة لأول مرة. مثال: "عذرًا، لم أفهم ذلك."
noMatchPrompt2

object (EventHandler)

يتم عرض هذا الطلب عندما لا يتطابق إدخال المستخدم مع نوع القيمة المتوقّعة للخانة للمرة الثانية. مثال: "عذرًا، لم أفهم ذلك."
noMatchFinalPrompt

object (EventHandler)

يتم عرض هذا الطلب عندما لا يتطابق إدخال المستخدم مع نوع القيمة المتوقّعة للخانة في آخر مرة. مثال: "عذرًا، لم أفهم ذلك."
noInputPrompt1

object (EventHandler)

طلب إعطاء عندما لا يقدّم المستخدم إدخالاً لأول مرة مثال: "عذرًا، لم أفهم ذلك."
noInputPrompt2

object (EventHandler)

يتم عرض هذا الطلب عندما لا يقدّم المستخدم إدخالاً للمرة الثانية. مثال: "عذرًا، لم أفهم ذلك."
noInputFinalPrompt

object (EventHandler)

يتم عرض هذا الطلب عندما لا يقدّم المستخدم إدخالاً للمرة الأخيرة. مثال: "عذرًا، لم أفهم ذلك."

CommitBehavior

رسالة تصف سلوك التنفيذ المرتبط بالخانة بعد أن يتم ملؤها بنجاح.

تمثيل JSON 
{
  "writeSessionParam": string
}
الحقول
writeSessionParam

string

مَعلمة الجلسة اللازمة لكتابة قيمة الخانة بعد تعبئتها. يُرجى العلم أنّ المسارات المدمجة غير متاحة حاليًا. "$$" تُستخدم لكتابة قيمة الخانة على معلمة جلسة بنفس اسم الفتحة. على سبيل المثال: writeSessionParam = "fruit" مع "$session.params.fruit". writeSessionParam = "تذكرة" مع "$session.params.ticket".

DefaultValue

إعدادات لتعبئة قيمة تلقائية لهذه الخانة

تمثيل JSON 
{
  "sessionParam": string,
  "constant": value
}
الحقول
sessionParam

string

اختياريّ. معلمة الجلسة المطلوب استخدامها لإعداد قيمة الخانة، إذا كانت لها قيمة غير فارغة. يجب أن يتطابق نوع القيمة مع نوع الخانة. يُرجى العلم أنّ المسارات المدمجة غير متاحة حاليًا. على سبيل المثال: sessionParam = "fruit" يتجاوب مع $session.params.fruit. sessionParam = "ticket" يتجاوب مع $session.params.ticket.
constant

value (Value format)

اختياريّ. قيمة تلقائية ثابتة للخانة. لن يتم استخدام هذه السمة إلا إذا لم تتم تعبئة قيمة لهذه الخانة من خلال sessionParam. يجب أن يتطابق نوع هذه القيمة مع نوع الخانة.

DataFiles

مغلف لملف البيانات المتكرر. لا يمكن أن تتوفّر الحقول المتكرّرة في إحداها.

تمثيل JSON 
{
  "dataFiles": [
    {
      object (DataFile)
    }
  ]
}
الحقول
dataFiles[]

object (DataFile)

ملفات بيانات متعددة.

DataFile

ويمثل ملفًا واحدًا يحتوي على بيانات غير مهيكلة. وتشمل الأمثلة ملفات الصور وملفات الصوت ورمز مصدر دالّة السحابة الإلكترونية.

تمثيل JSON 
{
  "filePath": string,
  "contentType": string,
  "payload": string
}
الحقول
filePath

string

المسار النسبي لملف البيانات من جذر المشروع في بنية ملف SDK. مسارات الملفات المسموح بها: - الصور: resources/images/{multiple directories}?/{ImageName}.{extension} - الصوت: resources/audio/{multiple directories}?/{AudioFileName}.{extension} - رمز دالة السحابة الإلكترونية المضمّنة: webhooks/{WebhookName}.zip الإضافات المسموح بها: - الصور: png، jpg، jpeg - الصوت: mp3، mpeg - دوال السحابة الإلكترونية المضمّنة: zip
contentType

string

مطلوب. نوع محتوى مادة العرض هذه مثال: text/html يجب أن يلتزم نوع المحتوى بالمواصفات (http://www.w3.org/Protocols/rfc1341/4_Content-Type.html). يجب أن تكون الدوال السحابية بتنسيق ZIP ويجب أن يكون نوع المحتوى application/zip;zip_type=cloud_function. تشير المعلمة zip_type إلى أن الرمز zip لدالة في السحابة الإلكترونية.
payload

string (bytes format)

محتوى ملف البيانات. ومن الأمثلة على ذلك وحدات البايت الأولية للصور أو الملفات الصوتية أو تنسيق ZIP لدالة السحابة الإلكترونية. يبلغ الحد الصارم لحجم الحمولة 10 ميغابايت.

سلسلة بترميز base64.