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