AppResponse

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

string

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

userStorage

string

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

resetUserStorage

boolean

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

expectUserResponse

boolean

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

expectedInputs[]

object (ExpectedInput)

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

finalResponse

object (FinalResponse)

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

customPushMessage

object (CustomPushMessage)

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

isInSandbox

boolean

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

ExpectedInput

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

object (InputPrompt)

الإشعار المخصّص المستخدَم لطلب البيانات من المستخدم

possibleIntents[]

object (ExpectedIntent)

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

speechBiasingHints[]

string

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

InputPrompt

إشعار الإدخال المستخدَم لمساعد Google لإرشاد المستخدم لتقديم مدخل لسؤال التطبيق.

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

object (SpeechResponse)

الطلبات الأولية التي تطلب من المستخدم إدخال البيانات. يُسمح باستخدام رسالة first_prompt واحدة فقط.

richInitialPrompt

object (RichResponse)

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

noInputPrompts[]

object (SimpleResponse)

طلب مستخدَم لسؤال المستخدم عندما لا يكون هناك إدخال من المستخدم.

SpeechResponse

ردّ يحتوي على كلام فقط. تم إيقافها.

تمثيل 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، مثل " قول اسم الحيوان بعد الصوت. ". وتتّسم ميزة "تحويل النص إلى كلام" معًا.

RichResponse

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

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

object (Item)

قائمة بعناصر واجهة المستخدم التي تنشئ الرد يجب أن تستوفي العناصر المتطلبات التالية: 1. يجب أن يكون العنصر الأول SimpleResponse 2. SimpleResponse 3 على الأكثر. عنصر رد منسق واحد على الأكثر (مثل BasicCard أو StructuredResponse أو MediaResponse أو HtmlResponse) 4- لا يمكنك استخدام عنصر رد منسق إذا كنت تستخدم actions.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)

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

tableCard

object (TableCard)

بطاقة جدول.

htmlResponse

object (HtmlResponse)

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

SimpleResponse

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

تمثيل 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

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

BasicCard

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

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

string

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

subtitle

string

اختياريّ.

formattedText

string

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

image

object (Image)

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

buttons[]

object (Button)

الأزرار يتوفّر زر واحد بحدّ أقصى حاليًا. اختياريّ.

imageDisplayOptions

enum (ImageDisplayOptions)

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

زرّ

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

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

string

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

openUrlAction

object (OpenUrlAction)

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

StructuredResponse

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

تمثيل 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)

يقدم التطبيق تحديثًا للطلب بتنسيق واجهة برمجة التطبيقات الإصدار 3 بعد استلام الطلب.

OrderUpdate

مهملة: يمكنك استخدام V3 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)

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

إيصال

مهملة: يمكنك استخدام V3 Proto بدلاً من ذلك. إيصال الاستلام عندما تكون الحالة "مؤكّدة" أو أي ولاية أخرى (مثل IN_TRANSIT أو FULFILLED) تشمل الحالة "مؤكّدة"

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

string

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

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

userVisibleOrderId

string

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

RejectionInfo

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

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

enum (ReasonType)

نوع الرفض

reason

string

سبب الخطأ

CancellationInfo

مهملة: يمكنك استخدام V3 Proto بدلاً من ذلك. معلومات الإلغاء عندما تكون الحالة "مُلغى"

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

string

سبب الإلغاء.

InTransitInfo

مهملة: يمكنك استخدام V3 Proto بدلاً من ذلك. المعلومات التي يتم نقلها عندما تكون الولاية IN_TRANSIT.

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

string (Timestamp format)

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

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

FulfillmentInfo

مهملة: يمكنك استخدام V3 Proto بدلاً من ذلك. معلومات التنفيذ عندما تكون الولاية FULFILLED.

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

string (Timestamp format)

متى سيتم توصيل الطلب.

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

ReturnInfo

مهملة: يمكنك استخدام V3 Proto بدلاً من ذلك. يتم عرض معلومات الإرجاع عندما تكون الحالة "مرفوضة".

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

string

سبب الإرجاع

UserNotification

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

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

string

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

text

string

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

MediaResponse

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

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

enum (MediaType)

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

mediaObjects[]

object (MediaObject)

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

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)

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

CarouselBrowse

يقدم هذا العرض مجموعة من مستندات 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 أو محتوى AMP في حال ضبط "urlTypeHint" على AMP_CONTENT. مطلوبة.

TableCard

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

تمثيل 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)

الأزرار يتوفّر زر واحد بحدّ أقصى حاليًا. اختياريّ.

ColumnProperties

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

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

string

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

horizontalAlignment

enum (HorizontalAlignment)

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

الصف

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

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

object (Cell)

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

dividerAfter

boolean

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

الخلية

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

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

string

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

HtmlResponse

استجابة تعرض 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 حرفًا بحد أقصى

LinkOutSuggestion

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

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

string

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

url
(deprecated)

string

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

openUrlAction

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

string

اسم الغرض المضمَّن، مثل 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

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

FinalResponse

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

تمثيل 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)

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

CustomPushMessage

رسالة فورية مخصَّصة تحتوي على البيانات المنظَّمة لفرض واجهة برمجة تطبيقات 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)

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

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)

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

locale

string

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