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 فارغًا أثناء التفاعل التالي مع المستخدم.
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)

الطلبات الأولية التي تطلب من المستخدم إدخال البيانات ولا تتم إتاحة سوى طلب مبدئي واحد.
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

نص اختياري للعرض في فقاعة المحادثة. وفي حال عدم إعطائها، سيتم استخدام عرض نص textToSpeech أو لغة الاستعلامات البنيوية (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 وحدة بكسل مستقلة الكثافة (dp). اختياريّ.
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 بدلاً منه. معلومات توصيل الطلب عندما تكون الولاية مكتملة.

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

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

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 أو إذا كان الحقل "urlTypeHint" تم تعيينها على AMP_CONTENT، ومحتوى AMP. مطلوب.

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 وintent. بالنسبة إلى عناوين URL المقصودة، يُرجى الرجوع إلى: https://developer.chrome.com/multidevice/android/intents

ExpectedIntent

الغرض المتوقع من التطبيق الذي يطلب من المساعد تقديمه.

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