AppResponse

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 (ExpectedInput)
    }
  ],
  "finalResponse": {
    object (FinalResponse)
  },
  "customPushMessage": {
    object (CustomPushMessage)
  },
  "isInSandbox": boolean
}
الحقول
conversationToken

string

رمز مميز ومبهم تتم إعادة تداوله إلى "الإجراء" في كل محادثة.

userStorage

string

رمز مميز ومبهم يتحكّم فيه الإجراء، ويتم الاحتفاظ به في كل المحادثات لمستخدم معيّن. إذا كان الحقل فارغًا أو غير محدّد، لن يتم تغيير الرمز المميّز الحالي. الحد الأقصى لحجم السلسلة هو 10 كيلوبايت بايت. في حال حدوث مربّعات حوار متعددة بشكلٍ متزامن للمستخدم نفسه، يمكن أن تؤدي التعديلات على هذا الرمز المميّز إلى استبدال بعضها بعضًا بشكل غير متوقَّع.

resetUserStorage

boolean

ما إذا كان يجب محو مساحة التخزين الدائمة للمستخدم. في حال ضبط هذه السياسة على "صحيح"، سيصبح حقل userStorage فارغًا في التفاعل التالي مع المستخدم.

expectUserResponse

boolean

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

expectedInputs[]

object (ExpectedInput)

قائمة الإدخالات التي يتوقعها الإجراء، يمكن أن يكون كل إدخال إجراءات شائعة على نية Google (البدء بـ "الإجراءات"). لا يتوفّر في الوقت الحالي سوى إدخال واحد.

finalResponse

object (FinalResponse)

الاستجابة النهائية عندما لا يتوقع الإجراء إدخال المستخدم.

customPushMessage

object (CustomPushMessage)

هي رسالة فورية مخصَّصة تسمح لمطوّري البرامج بإرسال بيانات منظَّمة إلى إجراءات على Google.

isInSandbox

boolean

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

القيمة المتوقَّعة للإدخال

تمثيل JSON
{
  "inputPrompt": {
    object (InputPrompt)
  },
  "possibleIntents": [
    {
      object (ExpectedIntent)
    }
  ],
  "speechBiasingHints": [
    string
  ]
}
الحقول
inputPrompt

object (InputPrompt)

يعرض هذا الإشعار رسالة المطالبة المخصَّصة التي تطلب من المستخدم إدخال بيانات.

possibleIntents[]

object (ExpectedIntent)

قائمة الأهداف التي يمكن استخدامها لتحقيق هذا الإدخال لعرض الإجراءات على Google، يتم فقط عرض القيمة الأولية للمستخدم، ويجب أن يطلب التطبيق هدف actions.intent.TEXT.

speechBiasingHints[]

string

قائمة بالعبارات التي تريد "الإجراء" من Google استخدامها لانحياز الكلام الحد الأقصى المسموح به لعدد العبارات هو 1000 عبارة.

رسالة الإدخال

رسالة المطالبة التي يتم استخدامها في "مساعد Google" لإرشاد المستخدم لتقديم إدخال لسؤال التطبيق

تمثيل JSON
{
  "initialPrompts": [
    {
      object (SpeechResponse)
    }
  ],
  "richInitialPrompt": {
    object (RichResponse)
  },
  "noInputPrompts": [
    {
      object (SimpleResponse)
    }
  ]
}
الحقول
initialPrompts[]
(deprecated)

object (SpeechResponse)

رسائل المطالبة الأولية التي تطلب من المستخدم تقديم إدخال لا يمكن استخدام سوى الحرف الأول من الاسم_promptt.

richInitialPrompt

object (RichResponse)

الحمولة المطلوبة

noInputPrompts[]

object (SimpleResponse)

إشعار يُستخدَم لطرح سؤال على المستخدم عندما لا يتوفّر إدخال من المستخدم

الرد على الكلام

هي استجابة تتضمّن كلامًا فقط. متوقّف

تمثيل JSON
{

  // Union field type can be only one of the following:
  "textToSpeech": string,
  "ssml": string
  // End of list of possible types for union field type.
}
الحقول
حقل الاتحاد type. أنواع إخراج الكلام: نص إلى كلام أو SSML. لا يمكن أن يكون type سوى واحد مما يلي:
textToSpeech

string

نص عادي في الناتج عن الكلام، على سبيل المثال، "إلى أين تريد الذهاب؟"

ssml

string

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

الرد الغني

الرد الغني الذي يمكن أن يتضمن الصوت والنص والبطاقات والاقتراحات والبيانات المنظَّمة.

تمثيل JSON
{
  "items": [
    {
      object (Item)
    }
  ],
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "linkOutSuggestion": {
    object (LinkOutSuggestion)
  }
}
الحقول
items[]

object (Item)

قائمة بعناصر واجهة المستخدم التي تنشئ الاستجابة. يجب أن تستوفي العناصر المتطلبات التالية: 1. يجب أن يكون العنصر الأول SimpleResponse 2. اثنان على الأكثر SimpleResponse 3- عنصر استجابة واحد واحد على الأكثر (مثل BasicCard أو StructuredResponse أو MediaResponse أو HtmlResponse) 4- لا يمكنك استخدام عنصر استجابة منسّقة إذا كنت تستخدم action.intent.option النية، أي ListSelect أو CarouselSelect.

suggestions[]

object (Suggestion)

قائمة بالردود المقترَحة. وستظهر هذه التعليقات دائمًا في نهاية الرد. وفي حال استخدامها في FinalResponse، سيتم تجاهلها.

المنتج/الخدمة

عناصر الردّ.

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

  // Union field item can be only one of the following:
  "simpleResponse": {
    object (SimpleResponse)
  },
  "basicCard": {
    object (BasicCard)
  },
  "structuredResponse": {
    object (StructuredResponse)
  },
  "mediaResponse": {
    object (MediaResponse)
  },
  "carouselBrowse": {
    object (CarouselBrowse)
  },
  "tableCard": {
    object (TableCard)
  },
  "htmlResponse": {
    object (HtmlResponse)
  }
  // End of list of possible types for union field item.
}
الحقول
name

string

معرِّف اختياري لهذا العنصر.

حقل الاتحاد item. نوع العنصر. لا يمكن أن يكون item سوى واحد مما يلي:
simpleResponse

object (SimpleResponse)

الرد الصوتي والمراسلة النصية فقط.

basicCard

object (BasicCard)

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

structuredResponse

object (StructuredResponse)

الحمولة المنظَّمة التي تعالجها Google

mediaResponse

object (MediaResponse)

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

carouselBrowse

object (CarouselBrowse)

بطاقة التصفّح في منصّة العرض بعناصر متغيّرة، يمكنك استخدام ميزة "تصفُّح المجموعة" بدلاً من ذلك.

tableCard

object (TableCard)

بطاقة جدول

htmlResponse

object (HtmlResponse)

يتم استخدام استجابة Html للعرض على لوحة الرسم.

الرد البسيط

رد بسيط يحتوي على كلام أو نص لعرض المستخدم.

تمثيل JSON
{
  "textToSpeech": string,
  "ssml": string,
  "displayText": string
}
الحقول
textToSpeech

string

نص عادي في الناتج عن الكلام، على سبيل المثال، "أين تريد الذهاب؟" حصريًا على نحو متبادل مع ssml

ssml

string

استجابة منسّقة منظَّمة للمستخدم بتنسيق SSML، مثل <speak> Say animal name after the sound. <audio src = 'https://www.pullstring.com/moo.mps' />, what’s the animal? </speak>. استخدام تبادلي مع النص "تحويل الكلام إلى نص"

displayText

string

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

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

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

تمثيل JSON
{
  "title": string,
  "subtitle": string,
  "formattedText": string,
  "image": {
    object (Image)
  },
  "buttons": [
    {
      object (Button)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}
الحقول
title

string

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

subtitle

string

اختياريّ.

formattedText

string

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

image

object (Image)

صورة رئيسية للبطاقة: يتم تثبيت الارتفاع على 192 بكسل مستقل الكثافة. اختياريّ.

buttons[]

object (Button)

الأزرار ويتوفّر حاليًا زر واحد على الأكثر. اختياريّ.

imageDisplayOptions

enum (ImageDisplayOptions)

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

زرّ

عنصر زر يظهر عادةً في أسفل بطاقة.

تمثيل JSON
{
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  }
}
الحقول
title

string

عنوان الزر. مطلوبة.

openUrlAction

object (OpenUrlAction)

الإجراء الذي يتم اتخاذه عندما ينقر المستخدم على الزر. مطلوبة.

الرد المنظم

الردّ المحدّد للتطبيق للاستجابة باستخدام البيانات المنظَّمة

تمثيل JSON
{

  // Union field data can be only one of the following:
  "orderUpdate": {
    object (OrderUpdate)
  },
  "orderUpdateV3": {
    object (OrderUpdate)
  }
  // End of list of possible types for union field data.
}
الحقول
حقل الاتحاد data. حاوية استجابة الحمولة من وكلاء الجهات الخارجية لا يمكن أن يكون data سوى واحد مما يلي:
orderUpdate

object (OrderUpdate)

يقدِّم التطبيق تعديلاً للطلب (مثلاً Receipt) بعد تلقّي الطلب.

orderUpdateV3

object (OrderUpdate)

يقدِّم التطبيق تحديثًا للطلب بتنسيق v3 API بعد استلام الطلب.

تحديث الطلب

متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. يجب تعديل الطلب.

تمثيل JSON
{
  "googleOrderId": string,
  "actionOrderId": string,
  "orderState": {
    object (OrderState)
  },
  "orderManagementActions": [
    {
      object (Action)
    }
  ],
  "receipt": {
    object (Receipt)
  },
  "updateTime": string,
  "totalPrice": {
    object (Price)
  },
  "lineItemUpdates": {
    string: {
      object(LineItemUpdate)
    },
    ...
  },
  "userNotification": {
    object (UserNotification)
  },
  "infoExtension": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field info can be only one of the following:
  "rejectionInfo": {
    object (RejectionInfo)
  },
  "cancellationInfo": {
    object (CancellationInfo)
  },
  "inTransitInfo": {
    object (InTransitInfo)
  },
  "fulfillmentInfo": {
    object (FulfillmentInfo)
  },
  "returnInfo": {
    object (ReturnInfo)
  }
  // End of list of possible types for union field info.
}
الحقول
googleOrderId

string

رقم تعريف الطلب هو رقم التعريف الصادر عن Google.

actionOrderId

string

مطلوبة. رقم تعريف الطلب الأساسي الذي يشير إلى هذا الطلب. إذا لم تُنشئ عمليات الدمج معرّف الطلب الأساسي في نظامها، يمكنك ببساطة نسخ قيم googleOrderId المضمّنة بالترتيب.

orderState

object (OrderState)

الحالة الجديدة للطلب

orderManagementActions[]

object (Action)

تم تعديل إجراءات الإدارة السارية للطلب، على سبيل المثال، الإدارة والتعديل والتواصل مع فريق الدعم.

receipt

object (Receipt)

إيصال الطلب.

updateTime

string (Timestamp format)

وقت تعديل الطلب من منظور التطبيق

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "2014-10-02T15:01:23.045123456Z"

totalPrice

object (Price)

السعر الإجمالي الجديد للطلب

lineItemUpdates

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

خريطة التغييرات على مستوى العنصر، مع ربطها بمعرّف العنصر. اختياريّ.

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

userNotification

object (UserNotification)

إذا تم تحديد هذا الخيار، يتم إرسال إشعار إلى المستخدم بعنوان الإعلان والنص المحدّدَين. يعد تحديد إشعارًا اقتراحًا للإشعار وهو ليس مضمونًا أن يؤدي إلى ظهور إشعار.

infoExtension

object

بيانات إضافية استنادًا إلى حالة طلب مخصّصة أو بالإضافة إلى معلومات عن حالة عادية

تمثّل هذه السمة عنصرًا يحتوي على حقول من النوع العشوائي. يحتوي حقل إضافي "@type" على معرّف موارد منتظم (URI) يحدد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }.

حقل الاتحاد info. معلومات إضافية مرتبطة بحالة الطلب لا يمكن أن يكون info سوى واحد مما يلي:
rejectionInfo

object (RejectionInfo)

معلومات عن حالة الرفض.

cancellationInfo

object (CancellationInfo)

معلومات عن حالة الإلغاء

inTransitInfo

object (InTransitInfo)

معلومات عن حالة النقل العام

fulfillmentInfo

object (FulfillmentInfo)

معلومات عن حالة توصيل الطلب

returnInfo

object (ReturnInfo)

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

الإجراء

إجراء متابعة مرتبط بتعديل الطلب

تمثيل JSON
{
  "type": enum (ActionType),
  "button": {
    object (Button)
  }
}
الحقول
type

enum (ActionType)

نوع الإجراء

button

object (Button)

تصنيف الزر ورابط.

إيصال

متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. إيصال مؤكَّد عندما تكون الولاية مؤكّدة أو أي ولاية أخرى (مثل IN_TRANSIT أو FULFILLED) تشمل الولاية المؤكّدة.

تمثيل JSON
{
  "confirmedActionOrderId": string,
  "userVisibleOrderId": string
}
الحقول
confirmedActionOrderId
(deprecated)

string

تم تأكيد مُعرّف الطلب عند تلقّي الطلب من الجهة المسؤولة عن عملية الدمج. هذا هو مُعرّف الطلب الأساسي المُستخدَم في نظام عملية التكامل للإشارة إلى الطلب، وقد يتم استخدامه لاحقًا لتحديد الطلب actionOrderId.

يُرجى العلم بأنّ هذا الحقل تم إيقافه نهائيًا. يُرجى تمرير الحقل من خلال OrderUpdate.action_order_id بدلاً من ذلك.

userVisibleOrderId

string

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

معلومات الرفض

معلومات الرفض عند رفض الولاية. يمكن تعبئة هذه الرسالة في تحديث الطلب الأولي في المحادثة أو من خلال تحديث الطلب غير المتزامن.

تمثيل JSON
{
  "type": enum (ReasonType),
  "reason": string
}
الحقول
type

enum (ReasonType)

نوع الرفض

reason

string

سبب الخطأ.

معلومات الإلغاء

متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. معلومات الإلغاء عند إلغاء الولاية

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

string

سبب الإلغاء.

معلومات النقل العام

متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. تتوفر معلومات النقل العام عندما تكون الحالة IN_TRANSIT.

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

string (Timestamp format)

تاريخ آخر تعديل للنقل العام

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "2014-10-02T15:01:23.045123456Z"

توصيل المعلومات

متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. معلومات توصيل الطلب عندما تكون الولاية مكتملة.

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

string (Timestamp format)

وقت استيفاء الطلب

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "2014-10-02T15:01:23.045123456Z"

معلومات الإرجاع

متوقّف نهائيًا: استخدِم الإصدار 3 من Proto بدلاً من ذلك. معلومات الإرجاع عند رفض الحالة

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

string

سبب الإرجاع:

إشعار المستخدم

إشعار اختياري عن مستخدم لعرضه كجزء من تحديث الطلب.

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

string

عنوان إشعار المستخدم.

text

string

محتوى الإشعار

MediaResponse

الرد الذي يشير إلى مجموعة من الوسائط التي سيتم تشغيلها ضمن المحادثة.

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

enum (MediaType)

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

mediaObjects[]

object (MediaObject)

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

كائن الوسائط

تمثل كائن وسائط واحد يتم عرضه باستخدام MediaResponse. يحتوي على معلومات عن الوسائط، مثل الاسم والوصف وعنوان URL وغير ذلك.

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

  // Union field image can be only one of the following:
  "largeImage": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}
الحقول
name

string

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

description

string

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

contentUrl

string

عنوان URL الذي يشير إلى محتوى الوسائط

حقل الاتحاد image. الصورة التي سيتم عرضها مع بطاقة الوسائط لا يمكن أن يكون image سوى واحد مما يلي:
largeImage

object (Image)

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

icon

object (Image)

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

تصفُّح لوحة العرض الدوّارة

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

تمثيل JSON
{
  "items": [
    {
      object (Item)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}
الحقول
items[]

object (Item)

الحد الأدنى: 2. الحد الأقصى: 10.

imageDisplayOptions

enum (ImageDisplayOptions)

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

المنتج/الخدمة

عنصر في لوحة العرض الدوّارة

تمثيل JSON
{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (Image)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  }
}
الحقول
title

string

عنوان العنصر في لوحة العرض الدوّارة. مطلوبة.

description

string

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

footer

string

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

image

object (Image)

الصورة الرئيسية لعنصر في منصّة العرض بعناصر متغيّرة. اختياريّ.

openUrlAction

object (OpenUrlAction)

عنوان URL للمستند المرتبط بعنصر لوحة العرض الدوّارة قد يحتوي المستند على محتوى HTML أو إذا تم ضبط "urlTypeHint" على AMP_CONTENT، سيكون محتوى AMP. مطلوبة.

بطاقة جدول

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

تمثيل JSON
{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columnProperties": [
    {
      object (ColumnProperties)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "buttons": [
    {
      object (Button)
    }
  ]
}
الحقول
title

string

العنوان العام للجدول. تكون اختيارية، ولكن يجب ضبطها في حال ضبط العنوان الفرعي.

subtitle

string

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

image

object (Image)

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

columnProperties[]

object (ColumnProperties)

العناوين ومحاذاة الأعمدة

rows[]

object (Row)

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

buttons[]

object (Button)

الأزرار ويتوفّر حاليًا زر واحد على الأكثر. اختياريّ.

خصائص الأعمدة

الاحتفاظ بخصائص الأعمدة (بما في ذلك العناوين).

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

string

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

horizontalAlignment

enum (HorizontalAlignment)

محاذاة أفقية للمحتوى مع العمود في حال عدم تحديد هذا الحقل، ستتم محاذاة المحتوى مع الحافة البادئة.

الصف

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

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

object (Cell)

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

dividerAfter

boolean

يشير هذا الإعداد إلى ما إذا كان يجب وضع فاصل بعد كل صف.

خلية

لوصف خلية في الصف.

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

string

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

استجابة HTML

استجابة تعرض HTML باستخدام ميزة لوحة الرسم التفاعلية الحد الأقصى لحجم الاستجابة هو 50 ألف بايت.

تمثيل JSON
{
  "updatedState": value,
  "suppressMic": boolean,
  "url": string
}
الحقول
updatedState

value (Value format)

إبلاغ كائن JSON التالي بالتطبيق

suppressMic

boolean

أدخِل خيارًا حتى لا يتم فتح الميكروفون بعد هذه الاستجابة الشاملة.

url

string

عنوان URL للتطبيق

اقتراح

شريحة اقتراح يمكن للمستخدم النقر عليها لنشر ردّ على المحادثة بسرعة.

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

string

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

رابط الخروج

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

تمثيل JSON
{
  "destinationName": string,
  "url": string,
  "openUrlAction": {
    object (OpenUrlAction)
  }
}
الحقول
destinationName

string

اسم التطبيق أو الموقع الإلكتروني الذي ترتبط به هذه الشريحة. سيتم عرض الشريحة بعنوان "فتح ". 20 حرفًا بحد أقصى. حقل مطلوب

url
(deprecated)

string

تمّ الإيقاف. يمكنك استخدام OpenUrlAction بدلاً من ذلك.

openUrlAction

object (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

string

اسم intent المضمّن، مثل actions.intent.TEXT، أو الأهداف المحدّدة في حزمة الإجراءات. وإذا لم يكن الغرض المقصود مُدمجًا، يتم استخدامه فقط لانحياز الكلام ويكون الإدخال الذي يقدّمه "مساعد Google" هو هدف actions.intent.TEXT.

inputValueData

object

بيانات الإعداد الإضافية المطلوبة حسب النية بالشراء المضمّنة. القيم المحتملة للأهداف المضمّنة: actions.intent.OPTION -> google.actions.v2.OptionValueSpec، actions.intent.CONFIRMATION -> google.actions.v2.ConfirmationValueSpec، actions.intent.TRANSACTION_REQUIREMENTS_CHECK -> google.actions.v2.TransactionRequirementsCheckSpec، actions.intent.DELIVERY_ADDRESS -> google.actions.v2.DeliveryAddressValueSpec، actions.intent.TRANSACTION_DECISION -> google.actions.v2.TransactionDecisionValueSpec، actions.intent.PLACE -> google.actions.v2.PlaceValueSpec، actions.intent.Link -> google.actions.v2.LinkValueSpec

تمثّل هذه السمة عنصرًا يحتوي على حقول من النوع العشوائي. يحتوي حقل إضافي "@type" على معرّف موارد منتظم (URI) يحدد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }.

parameterName

string

اختياريًا، هي معلمة intent المطلوبة. صالحة فقط للأغراض المطلوبة. يُستخدَم لانحياز الكلام.

الرد النهائي

الاستجابة النهائية عندما لا يكون من المتوقّع أن يُدخل المستخدم أي بيانات.

تمثيل JSON
{

  // Union field response can be only one of the following:
  "speechResponse": {
    object (SpeechResponse)
  },
  "richResponse": {
    object (RichResponse)
  }
  // End of list of possible types for union field response.
}
الحقول
حقل الاتحاد response. أنواع الردود المحتملة لا يمكن أن يكون response سوى واحد مما يلي:
speechResponse
(deprecated)

object (SpeechResponse)

استجابة منطوقة عندما لا يُطلب من المستخدم تقديم إدخال.

richResponse

object (RichResponse)

يتم تقديم ردّ منسّق عندما لا يُطلب من المستخدم تقديم إدخال.

رسالة مخصّصة

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

تمثيل JSON
{
  "target": {
    object (Target)
  },

  // Union field content can be only one of the following:
  "orderUpdate": {
    object (OrderUpdate)
  },
  "userNotification": {
    object (UserNotification)
  }
  // End of list of possible types for union field content.
}
الحقول
target

object (Target)

الهدف المحدّد لطلب الدفع.

حقل الاتحاد content. الأنواع المختلفة للحمولة لا يمكن أن يكون content سوى واحد مما يلي:
orderUpdate

object (OrderUpdate)

تعديل على الطلب لتعديل الطلبات التي تم إجراؤها من خلال واجهات برمجة تطبيقات المعاملات

userNotification

object (UserNotification)

وإذا تم تحديد هذا الخيار، يتم عرض إشعار للمستخدم بعنوان ونص محدّدَين.

إشعار المستخدم

إشعار المستخدم لعرضه مع طلب.

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

string

تمثّل هذه السمة عنوان الإشعار.

text

string

محتوى الإشعار.

الهدف

الهدف المحدّد لطلب الدفع.

تمثيل JSON
{
  "userId": string,
  "intent": string,
  "argument": {
    object (Argument)
  },
  "locale": string
}
الحقول
userId

string

المستخدِم المطلوب استهدافه

intent

string

الغرض من الاستهداف:

argument

object (Argument)

الوسيطة لاستهدافها لغرض. بالنسبة إلى الإصدار 1، يمكن استخدام وسيطة واحدة فقط.

locale

string

اللغة المراد استهدافها ويتوافق مع رمز اللغة IETF BCP-47. يمكن استخدام هذا التطبيق في عدة لغات لاستهداف مستخدم على تطبيق مترجَم محدّد. وفي حال عدم تحديد هذا الخيار، سيتم ضبط الإعداد التلقائي على en-US.