- تمثيل JSON
- ExpectedInput
- InputPrompt
- SpeechResponse
- RichResponse
- العنصر
- SimpleResponse
- بطاقة أساسية
- الزر
- الاستجابة المنظَّمة
- OrderUpdate
- طلب
- تمثيل JSON
- الإجراء
- الإيصال
- الرفض
- معلومات الإلغاء
- InTransitInfo
- FulfillmentInfo
- ReturnInfo
- UserNotification
- MediaResponse
- MediaObject
- لوحة عرض دوّارة
- العنصر
- TableCard
- خصائص العمود
- الصف
- خلية
- HtmlResponse
- الاقتراح
- LinkOutSuggestion
- ExpectedIntent
- FinalResponse
- CustomPushMessage
- UserNotification
- الهدف
AppResponse هو الردّ الذي ترسله عملية توصيل الطلبات إلى "مساعد Google". للحصول على أمثلة حول طريقة استخدام هذه الميزة في "المهام مع مساعد Google"، يمكنك الاطّلاع على https://developers.google.com/assistant/df-asdk/reference/conversation-webblogspot-json#conversation-response-body
تمثيل JSON | |
---|---|
{ "conversationToken": string, "userStorage": string, "resetUserStorage": boolean, "expectUserResponse": boolean, "expectedInputs": [ { object ( |
الحقول | |
---|---|
conversationToken |
رمز مميز ومبهم تتم إعادة تداوله إلى "الإجراء" في كل محادثة. |
userStorage |
رمز مميز ومبهم يتحكّم فيه الإجراء، ويتم الاحتفاظ به في كل المحادثات لمستخدم معيّن. إذا كان الحقل فارغًا أو غير محدّد، لن يتم تغيير الرمز المميّز الحالي. الحد الأقصى لحجم السلسلة هو 10 كيلوبايت بايت. في حال حدوث مربّعات حوار متعددة بشكلٍ متزامن للمستخدم نفسه، يمكن أن تؤدي التعديلات على هذا الرمز المميّز إلى استبدال بعضها بعضًا بشكل غير متوقَّع. |
resetUserStorage |
ما إذا كان يجب محو مساحة التخزين الدائمة للمستخدم. في حال ضبط هذه السياسة على "صحيح"، سيصبح حقل userStorage فارغًا في التفاعل التالي مع المستخدم. |
expectUserResponse |
يشير إلى ما إذا كان الإجراء يتوقع استجابة مستخدم أم لا. يكون ذلك صحيحًا عندما تكون المحادثة جارية، ولا يكون صحيحًا عند انتهاء المحادثة. |
expectedInputs[] |
قائمة الإدخالات التي يتوقعها الإجراء، يمكن أن يكون كل إدخال إجراءات شائعة على نية Google (البدء بـ "الإجراءات"). لا يتوفّر في الوقت الحالي سوى إدخال واحد. |
finalResponse |
الاستجابة النهائية عندما لا يتوقع الإجراء إدخال المستخدم. |
customPushMessage |
هي رسالة فورية مخصَّصة تسمح لمطوّري البرامج بإرسال بيانات منظَّمة إلى إجراءات على Google. |
isInSandbox |
يشير إلى ما إذا كان يجب التعامل مع الاستجابة في وضع الحماية. يجب استخدام وحدة بت هذه لإرسال البيانات المنظَّمة إلى Google في وضع الحماية. |
القيمة المتوقَّعة للإدخال
تمثيل JSON | |
---|---|
{ "inputPrompt": { object ( |
الحقول | |
---|---|
inputPrompt |
يعرض هذا الإشعار رسالة المطالبة المخصَّصة التي تطلب من المستخدم إدخال بيانات. |
possibleIntents[] |
قائمة الأهداف التي يمكن استخدامها لتحقيق هذا الإدخال لعرض الإجراءات على Google، يتم فقط عرض القيمة الأولية للمستخدم، ويجب أن يطلب التطبيق هدف |
speechBiasingHints[] |
قائمة بالعبارات التي تريد "الإجراء" من Google استخدامها لانحياز الكلام الحد الأقصى المسموح به لعدد العبارات هو 1000 عبارة. |
رسالة الإدخال
رسالة المطالبة التي يتم استخدامها في "مساعد Google" لإرشاد المستخدم لتقديم إدخال لسؤال التطبيق
تمثيل JSON | |
---|---|
{ "initialPrompts": [ { object ( |
الحقول | |
---|---|
initialPrompts[] |
رسائل المطالبة الأولية التي تطلب من المستخدم تقديم إدخال لا يمكن استخدام سوى الحرف الأول من الاسم_promptt. |
richInitialPrompt |
الحمولة المطلوبة |
noInputPrompts[] |
إشعار يُستخدَم لطرح سؤال على المستخدم عندما لا يتوفّر إدخال من المستخدم |
الرد على الكلام
هي استجابة تتضمّن كلامًا فقط. متوقّف
تمثيل JSON | |
---|---|
{ // Union field |
الحقول | ||
---|---|---|
حقل الاتحاد type . أنواع إخراج الكلام: نص إلى كلام أو SSML. لا يمكن أن يكون type سوى واحد مما يلي: |
||
textToSpeech |
نص عادي في الناتج عن الكلام، على سبيل المثال، "إلى أين تريد الذهاب؟" |
|
ssml |
ردود منسّقة منظَّمة على المستخدم بتنسيق SSML، على سبيل المثال " |
الرد الغني
الرد الغني الذي يمكن أن يتضمن الصوت والنص والبطاقات والاقتراحات والبيانات المنظَّمة.
تمثيل JSON | |
---|---|
{ "items": [ { object ( |
الحقول | |
---|---|
items[] |
قائمة بعناصر واجهة المستخدم التي تنشئ الاستجابة. يجب أن تستوفي العناصر المتطلبات التالية: 1. يجب أن يكون العنصر الأول |
suggestions[] |
قائمة بالردود المقترَحة. وستظهر هذه التعليقات دائمًا في نهاية الرد. وفي حال استخدامها في |
linkOutSuggestion |
شريحة اقتراح إضافية يمكن أن ترتبط بالتطبيق أو الموقع الإلكتروني المرتبط |
المنتج/الخدمة
عناصر الردّ.
تمثيل JSON | |
---|---|
{ "name": string, // Union field |
الحقول | ||
---|---|---|
name |
معرِّف اختياري لهذا العنصر. |
|
حقل الاتحاد item . نوع العنصر. لا يمكن أن يكون item سوى واحد مما يلي: |
||
simpleResponse |
الرد الصوتي والمراسلة النصية فقط. |
|
basicCard |
بطاقة أساسية. |
|
structuredResponse |
الحمولة المنظَّمة التي تعالجها Google |
|
mediaResponse |
استجابة تشير إلى مجموعة من الوسائط التي سيتم تشغيلها. |
|
carouselBrowse |
بطاقة التصفّح في منصّة العرض بعناصر متغيّرة، يمكنك استخدام ميزة "تصفُّح المجموعة" بدلاً من ذلك. |
|
tableCard |
بطاقة جدول |
|
htmlResponse |
يتم استخدام استجابة Html للعرض على لوحة الرسم. |
الرد البسيط
رد بسيط يحتوي على كلام أو نص لعرض المستخدم.
تمثيل JSON | |
---|---|
{ "textToSpeech": string, "ssml": string, "displayText": string } |
الحقول | |
---|---|
textToSpeech |
نص عادي في الناتج عن الكلام، على سبيل المثال، "أين تريد الذهاب؟" حصريًا على نحو متبادل مع ssml |
ssml |
استجابة منسّقة منظَّمة للمستخدم بتنسيق SSML، مثل |
displayText |
نص اختياري يمكن عرضه في فقاعة المحادثة. في حال عدم ضبط هذه السياسة، سيتم استخدام العرض المعروض للنص TextToSpeech أو ssml أعلاه. يقتصر على 640 حرفًا. |
البطاقة الأساسية
بطاقة أساسية لعرض بعض المعلومات، على سبيل المثال صورة و/أو نص.
تمثيل JSON | |
---|---|
{ "title": string, "subtitle": string, "formattedText": string, "image": { object ( |
الحقول | |
---|---|
title |
العنوان العام للبطاقة اختياريّ. |
subtitle |
اختياريّ. |
formattedText |
النص الأساسي للبطاقة إتاحة مجموعة محدودة من بنية التنسيق. مطلوبة، ما لم تكن الصورة متاحة. |
image |
صورة رئيسية للبطاقة: يتم تثبيت الارتفاع على 192 بكسل مستقل الكثافة. اختياريّ. |
buttons[] |
الأزرار ويتوفّر حاليًا زر واحد على الأكثر. اختياريّ. |
imageDisplayOptions |
خيار عرض الصور اختياريّ. |
زرّ
عنصر زر يظهر عادةً في أسفل بطاقة.
تمثيل JSON | |
---|---|
{
"title": string,
"openUrlAction": {
object ( |
الحقول | |
---|---|
title |
عنوان الزر. مطلوبة. |
openUrlAction |
الإجراء الذي يتم اتخاذه عندما ينقر المستخدم على الزر. مطلوبة. |
الرد المنظم
الردّ المحدّد للتطبيق للاستجابة باستخدام البيانات المنظَّمة
تمثيل JSON | |
---|---|
{ // Union field |
الحقول | ||
---|---|---|
حقل الاتحاد data . حاوية استجابة الحمولة من وكلاء الجهات الخارجية لا يمكن أن يكون data سوى واحد مما يلي: |
||
orderUpdate |
يقدِّم التطبيق تعديلاً للطلب (مثلاً |
|
orderUpdateV3 |
يقدِّم التطبيق تحديثًا للطلب بتنسيق v3 API بعد استلام الطلب. |
تحديث الطلب
متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. يجب تعديل الطلب.
تمثيل JSON | |
---|---|
{ "googleOrderId": string, "actionOrderId": string, "orderState": { object ( |
الحقول | ||
---|---|---|
googleOrderId |
رقم تعريف الطلب هو رقم التعريف الصادر عن Google. |
|
actionOrderId |
مطلوبة. رقم تعريف الطلب الأساسي الذي يشير إلى هذا الطلب. إذا لم تُنشئ عمليات الدمج معرّف الطلب الأساسي في نظامها، يمكنك ببساطة نسخ قيم googleOrderId المضمّنة بالترتيب. |
|
orderState |
الحالة الجديدة للطلب |
|
orderManagementActions[] |
تم تعديل إجراءات الإدارة السارية للطلب، على سبيل المثال، الإدارة والتعديل والتواصل مع فريق الدعم. |
|
receipt |
إيصال الطلب. |
|
updateTime |
وقت تعديل الطلب من منظور التطبيق يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية. مثال: |
|
totalPrice |
السعر الإجمالي الجديد للطلب |
|
lineItemUpdates |
خريطة التغييرات على مستوى العنصر، مع ربطها بمعرّف العنصر. اختياريّ. عنصر يحتوي على قائمة بأزواج من |
|
userNotification |
إذا تم تحديد هذا الخيار، يتم إرسال إشعار إلى المستخدم بعنوان الإعلان والنص المحدّدَين. يعد تحديد إشعارًا اقتراحًا للإشعار وهو ليس مضمونًا أن يؤدي إلى ظهور إشعار. |
|
infoExtension |
بيانات إضافية استنادًا إلى حالة طلب مخصّصة أو بالإضافة إلى معلومات عن حالة عادية تمثّل هذه السمة عنصرًا يحتوي على حقول من النوع العشوائي. يحتوي حقل إضافي |
|
حقل الاتحاد info . معلومات إضافية مرتبطة بحالة الطلب لا يمكن أن يكون info سوى واحد مما يلي: |
||
rejectionInfo |
معلومات عن حالة الرفض. |
|
cancellationInfo |
معلومات عن حالة الإلغاء |
|
inTransitInfo |
معلومات عن حالة النقل العام |
|
fulfillmentInfo |
معلومات عن حالة توصيل الطلب |
|
returnInfo |
معلومات عن حالة الإرجاع |
الإجراء
إجراء متابعة مرتبط بتعديل الطلب
تمثيل JSON | |
---|---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع الإجراء |
button |
تصنيف الزر ورابط. |
إيصال
متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. إيصال مؤكَّد عندما تكون الولاية مؤكّدة أو أي ولاية أخرى (مثل IN_TRANSIT أو FULFILLED) تشمل الولاية المؤكّدة.
تمثيل JSON | |
---|---|
{ "confirmedActionOrderId": string, "userVisibleOrderId": string } |
الحقول | |
---|---|
confirmedActionOrderId |
تم تأكيد مُعرّف الطلب عند تلقّي الطلب من الجهة المسؤولة عن عملية الدمج. هذا هو مُعرّف الطلب الأساسي المُستخدَم في نظام عملية التكامل للإشارة إلى الطلب، وقد يتم استخدامه لاحقًا لتحديد الطلب يُرجى العلم بأنّ هذا الحقل تم إيقافه نهائيًا. يُرجى تمرير الحقل من خلال OrderUpdate.action_order_id بدلاً من ذلك. |
userVisibleOrderId |
اختياريّ. رقم تعريف المستخدم الذي يشير إلى الطلب الحالي، والذي سيظهر في بطاقة الإيصال عند توفّره. يجب أن يكون هذا هو المعرّف الذي يظهر عادةً في إيصال أو إيصال مُرسَل إلى عنوان البريد الإلكتروني للمستخدم. يجب أن يتمكّن المستخدم من استخدام هذا المعرِّف مع الإشارة إلى طلبه للحصول على خدمة العملاء التي تقدّمها الشركات المتكاملة. يجب ملء هذا الحقل في حال كان المسؤول عن عملية الدمج يُنشئ معرِّف المستخدم للمستخدم للطلب الذي يتضمّن إيصالاً إيصالاً / إيصالاً بالبريد الإلكتروني. |
معلومات الرفض
معلومات الرفض عند رفض الولاية. يمكن تعبئة هذه الرسالة في تحديث الطلب الأولي في المحادثة أو من خلال تحديث الطلب غير المتزامن.
تمثيل JSON | |
---|---|
{
"type": enum ( |
الحقول | |
---|---|
type |
نوع الرفض |
reason |
سبب الخطأ. |
معلومات الإلغاء
متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. معلومات الإلغاء عند إلغاء الولاية
تمثيل JSON | |
---|---|
{ "reason": string } |
الحقول | |
---|---|
reason |
سبب الإلغاء. |
معلومات النقل العام
متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. تتوفر معلومات النقل العام عندما تكون الحالة IN_TRANSIT.
تمثيل JSON | |
---|---|
{ "updatedTime": string } |
الحقول | |
---|---|
updatedTime |
تاريخ آخر تعديل للنقل العام يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية. مثال: |
توصيل المعلومات
متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. معلومات توصيل الطلب عندما تكون الولاية مكتملة.
تمثيل JSON | |
---|---|
{ "deliveryTime": string } |
الحقول | |
---|---|
deliveryTime |
وقت استيفاء الطلب يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية. مثال: |
معلومات الإرجاع
متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. معلومات الإرجاع عند رفض الحالة
تمثيل JSON | |
---|---|
{ "reason": string } |
الحقول | |
---|---|
reason |
سبب الإرجاع: |
إشعار المستخدم
إشعار اختياري عن مستخدم لعرضه كجزء من تحديث الطلب.
تمثيل JSON | |
---|---|
{ "title": string, "text": string } |
الحقول | |
---|---|
title |
عنوان إشعار المستخدم. |
text |
محتوى الإشعار |
MediaResponse
الرد الذي يشير إلى مجموعة من الوسائط التي سيتم تشغيلها ضمن المحادثة.
تمثيل JSON | |
---|---|
{ "mediaType": enum ( |
الحقول | |
---|---|
mediaType |
نوع الوسائط ضمن هذا الرد. |
mediaObjects[] |
قائمة عناصر الوسائط. |
كائن الوسائط
تمثل كائن وسائط واحد يتم عرضه باستخدام MediaResponse. يحتوي على معلومات عن الوسائط، مثل الاسم والوصف وعنوان URL وغير ذلك.
تمثيل JSON | |
---|---|
{ "name": string, "description": string, "contentUrl": string, // Union field |
الحقول | ||
---|---|---|
name |
اسم عنصر الوسائط هذا. |
|
description |
وصف عنصر الوسائط هذا. |
|
contentUrl |
عنوان URL الذي يشير إلى محتوى الوسائط |
|
حقل الاتحاد image . الصورة التي سيتم عرضها مع بطاقة الوسائط لا يمكن أن يكون image سوى واحد مما يلي: |
||
largeImage |
صورة كبيرة، مثل غلاف الألبوم، وما إلى ذلك. |
|
icon |
رمز صورة صغير يظهر على اليسار من العنوان. تم تغيير حجمها إلى 36 × 36 بكسل مستقل الكثافة. |
تصفُّح لوحة العرض الدوّارة
يقدم مجموعة من مستندات AMP كلوحة عرض دوّارة لعناصر كبيرة. قد يتم اختيار العناصر لتشغيل مستند AMP المرتبط بها في عارض صفحات AMP.
تمثيل JSON | |
---|---|
{ "items": [ { object ( |
الحقول | |
---|---|
items[] |
الحد الأدنى: 2. الحد الأقصى: 10. |
imageDisplayOptions |
خيار عرض الصور اختياريّ. |
المنتج/الخدمة
عنصر في لوحة العرض الدوّارة
تمثيل JSON | |
---|---|
{ "title": string, "description": string, "footer": string, "image": { object ( |
الحقول | |
---|---|
title |
عنوان العنصر في لوحة العرض الدوّارة. مطلوبة. |
description |
وصف عنصر لوحة العرض الدوّارة اختياريّ. |
footer |
نص تذييل عنصر لوحة العرض الدوّارة، يظهر أسفل الوصف. سطر واحد من النص مقتطع باستخدام علامة الحذف اختياريّ. |
image |
الصورة الرئيسية لعنصر في منصّة العرض بعناصر متغيّرة. اختياريّ. |
openUrlAction |
عنوان URL للمستند المرتبط بعنصر لوحة العرض الدوّارة قد يحتوي المستند على محتوى HTML أو إذا تم ضبط "urlTypeHint" على AMP_CONTENT، سيكون محتوى AMP. مطلوبة. |
بطاقة جدول
بطاقة جدول لعرض جدول نصي.
تمثيل JSON | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
الحقول | |
---|---|
title |
العنوان العام للجدول. تكون اختيارية، ولكن يجب ضبطها في حال ضبط العنوان الفرعي. |
subtitle |
عنوان فرعي للجدول. اختياريّ. |
image |
الصورة المرتبطة بالجدول. اختياريّ. |
columnProperties[] |
العناوين ومحاذاة الأعمدة |
rows[] |
بيانات الصف في الجدول. يمكن ضمان عرض أول 3 صفوف ولكن قد يتم اقتطاع صفوف أخرى. يُرجى اختبار المحاكي لمعرفة الصفوف التي سيتم عرضها لمساحة معيّنة. في مساحات العرض التي تتيح استخدام WEB_BROWSER، يمكنك توجيه المستخدم إلى صفحة ويب تتضمّن المزيد من البيانات. |
buttons[] |
الأزرار ويتوفّر حاليًا زر واحد على الأكثر. اختياريّ. |
خصائص الأعمدة
الاحتفاظ بخصائص الأعمدة (بما في ذلك العناوين).
تمثيل JSON | |
---|---|
{
"header": string,
"horizontalAlignment": enum ( |
الحقول | |
---|---|
header |
نص العنوان للعمود. |
horizontalAlignment |
محاذاة أفقية للمحتوى مع العمود في حال عدم تحديد هذا الحقل، ستتم محاذاة المحتوى مع الحافة البادئة. |
الصف
وصف صف في الجدول.
تمثيل JSON | |
---|---|
{
"cells": [
{
object ( |
الحقول | |
---|---|
cells[] |
الخلايا في هذا الصف. نضمن لك ظهور أول 3 خلايا، ولكن قد يتم اقتطاع خلايا أخرى على أسطح معيّنة. يُرجى الاختبار باستخدام المحاكي لمعرفة الخلايا التي سيتم عرضها لمساحة معيّنة. |
dividerAfter |
يشير هذا الإعداد إلى ما إذا كان يجب وضع فاصل بعد كل صف. |
خلية
لوصف خلية في الصف.
تمثيل JSON | |
---|---|
{ "text": string } |
الحقول | |
---|---|
text |
محتوى النص في الخلية |
استجابة HTML
استجابة تعرض HTML باستخدام ميزة لوحة الرسم التفاعلية الحد الأقصى لحجم الاستجابة هو 50 ألف بايت.
تمثيل JSON | |
---|---|
{ "updatedState": value, "suppressMic": boolean, "url": string } |
الحقول | |
---|---|
updatedState |
إبلاغ كائن JSON التالي بالتطبيق |
suppressMic |
أدخِل خيارًا حتى لا يتم فتح الميكروفون بعد هذه الاستجابة الشاملة. |
url |
عنوان URL للتطبيق |
اقتراح
شريحة اقتراح يمكن للمستخدم النقر عليها لنشر ردّ على المحادثة بسرعة.
تمثيل JSON | |
---|---|
{ "title": string } |
الحقول | |
---|---|
title |
ظهر النص في شريحة الاقتراح. وعند النقر عليه، سيتم نشر هذا النص حرفيًا مرة أخرى في المحادثة كما لو كان المستخدم قد كتبه. ويجب أن يكون كل عنوان فريدًا بين مجموعة شرائح الاقتراحات. يجب إدخال 25 حرفًا كحد أقصى. |
رابط الخروج
ينشئ شريحة اقتراح تسمح للمستخدم بالانتقال مباشرةً إلى التطبيق أو الموقع الإلكتروني المرتبط بهذا الوكيل.
تمثيل JSON | |
---|---|
{
"destinationName": string,
"url": string,
"openUrlAction": {
object ( |
الحقول | |
---|---|
destinationName |
اسم التطبيق أو الموقع الإلكتروني الذي ترتبط به هذه الشريحة. سيتم عرض الشريحة بعنوان "فتح |
url |
تمّ الإيقاف. يمكنك استخدام OpenUrlAction بدلاً من ذلك. |
openUrlAction |
عنوان URL للتطبيق أو الموقع الإلكتروني الذي سيتم فتحه عندما ينقر المستخدم على شريحة الاقتراح. يجب إثبات ملكية هذا التطبيق/عنوان URL في الإجراءات على Play Console، وإلا لن يتم عرض الاقتراح للمستخدم. يتيح "إجراء عنوان URL المفتوح" عناوين URL التي تتضمّن http وhttps وIntent، وذلك بالانتقال إلى: https://developer. chrome.com/Multidevice/android/intents. |
المتوقع intent
القصد من التطبيق هو أن يطلب من "مساعد Google" تقديم المساعدة.
تمثيل JSON | |
---|---|
{ "intent": string, "inputValueData": { "@type": string, field1: ..., ... }, "parameterName": string } |
الحقول | |
---|---|
intent |
اسم intent المضمّن، مثل |
inputValueData |
بيانات الإعداد الإضافية المطلوبة حسب النية بالشراء المضمّنة. القيم المحتملة للأهداف المضمّنة: تمثّل هذه السمة عنصرًا يحتوي على حقول من النوع العشوائي. يحتوي حقل إضافي |
parameterName |
اختياريًا، هي معلمة intent المطلوبة. صالحة فقط للأغراض المطلوبة. يُستخدَم لانحياز الكلام. |
الرد النهائي
الاستجابة النهائية عندما لا يكون من المتوقّع أن يُدخل المستخدم أي بيانات.
تمثيل JSON | |
---|---|
{ // Union field |
الحقول | ||
---|---|---|
حقل الاتحاد response . أنواع الردود المحتملة لا يمكن أن يكون response سوى واحد مما يلي: |
||
speechResponse |
استجابة منطوقة عندما لا يُطلب من المستخدم تقديم إدخال. |
|
richResponse |
يتم تقديم ردّ منسّق عندما لا يُطلب من المستخدم تقديم إدخال. |
رسالة مخصّصة
رسالة فورية مخصَّصة تتضمّن البيانات المنظَّمة التي تدفع المستخدمين إلى تنفيذ إجراءات واجهة برمجة التطبيقات Fulfillment API.
تمثيل JSON | |
---|---|
{ "target": { object ( |
الحقول | ||
---|---|---|
target |
الهدف المحدّد لطلب الدفع. |
|
حقل الاتحاد content . الأنواع المختلفة للحمولة لا يمكن أن يكون content سوى واحد مما يلي: |
||
orderUpdate |
تعديل على الطلب لتعديل الطلبات التي تم إجراؤها من خلال واجهات برمجة تطبيقات المعاملات |
|
userNotification |
وإذا تم تحديد هذا الخيار، يتم عرض إشعار للمستخدم بعنوان ونص محدّدَين. |
إشعار المستخدم
إشعار المستخدم لعرضه مع طلب.
تمثيل JSON | |
---|---|
{ "title": string, "text": string } |
الحقول | |
---|---|
title |
تمثّل هذه السمة عنوان الإشعار. |
text |
محتوى الإشعار. |
الهدف
الهدف المحدّد لطلب الدفع.
تمثيل JSON | |
---|---|
{
"userId": string,
"intent": string,
"argument": {
object ( |
الحقول | |
---|---|
userId |
المستخدِم المطلوب استهدافه |
intent |
الغرض من الاستهداف: |
argument |
الوسيطة لاستهدافها لغرض. بالنسبة إلى الإصدار 1، يمكن استخدام وسيطة واحدة فقط. |
locale |
اللغة المراد استهدافها ويتوافق مع رمز اللغة IETF BCP-47. يمكن استخدام هذا التطبيق في عدة لغات لاستهداف مستخدم على تطبيق مترجَم محدّد. وفي حال عدم تحديد هذا الخيار، سيتم ضبط الإعداد التلقائي على en-US. |