AppResponse

{
  "inputPrompt": {
    object (InputPrompt)
  },
  "possibleIntents": [
    {
      object (ExpectedIntent)
    }
  ],
  "speechBiasingHints": [
    string
  ]
}

object (InputPrompt)

هذا الطلب مخصّص يُستخدَم لسؤال المستخدم عن الإدخال.

object (ExpectedIntent)

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

string

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

{
  "initialPrompts": [
    {
      object (SpeechResponse)
    }
  ],
  "richInitialPrompt": {
    object (RichResponse)
  },
  "noInputPrompts": [
    {
      object (SimpleResponse)
    }
  ]
}

object (SpeechResponse)

الطلبات الأولية التي تطلب من المستخدم إدخال البيانات ولا تتم إتاحة سوى طلب مبدئي واحد.

object (RichResponse)

حمولة الطلب

object (SimpleResponse)

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

{

  // Union field type can be only one of the following:
  "textToSpeech": string,
  "ssml": string
  // End of list of possible types for union field type.
}

string

النص العادي لتحويل الكلام إلى نص "إلى أين تريد الذهاب؟"/

string

رد منطوق منظم للمستخدم بتنسيق SSML، على سبيل المثال " قُل اسم الحيوان بعد الصوت. ". يمكن استخدام النص بشكل متبادل مع ميزة "تحويل النص إلى كلام".

{
  "items": [
    {
      object (Item)
    }
  ],
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "linkOutSuggestion": {
    object (LinkOutSuggestion)
  }
}

object (Item)

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

object (Suggestion)

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

object (LinkOutSuggestion)

شريحة اقتراح إضافية يمكن أن تربط بالتطبيق أو الموقع الإلكتروني المرتبط.

{
  "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.
}

string

معرّف اختياري يحمل اسم هذا العنصر

object (SimpleResponse)

الردّ الصوتي والردّ النصي فقط

object (BasicCard)

بطاقة أساسية

object (StructuredResponse)

البيانات الأساسية المنظَّمة التي ستعالجها Google

object (MediaResponse)

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

object (CarouselBrowse)

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

object (TableCard)

بطاقة جدول.

object (HtmlResponse)

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

{
  "textToSpeech": string,
  "ssml": string,
  "displayText": string
}

string

النص العادي لتحويل الكلام إلى نص "إلى أين تريد الذهاب؟" الأحداث المتنافية مع ملفات ssml

string

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

string

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

{
  "title": string,
  "subtitle": string,
  "formattedText": string,
  "image": {
    object (Image)
  },
  "buttons": [
    {
      object (Button)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}

string

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

string

اختياريّ.

string

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

object (Image)

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

object (Button)

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

enum (ImageDisplayOptions)

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

{
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  }
}

string

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

object (OpenUrlAction)

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

{

  // 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.
}

object (OrderUpdate)

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

object (OrderUpdate)

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

{
  "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.
}

string

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

string

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

object (OrderState)

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

object (Action)

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

object (Receipt)

إيصال الطلب.

string (Timestamp format)

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

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

object (Price)

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

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

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

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

object (UserNotification)

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

object

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

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

object (RejectionInfo)

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

object (CancellationInfo)

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

object (InTransitInfo)

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

object (FulfillmentInfo)

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

object (ReturnInfo)

معلومات حول الحالة التي تم إرجاعها

{
  "type": enum (ActionType),
  "button": {
    object (Button)
  }
}

enum (ActionType)

ونوع الإجراء.

object (Button)

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

{
  "confirmedActionOrderId": string,
  "userVisibleOrderId": string
}

string

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

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

string

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

{
  "type": enum (ReasonType),
  "reason": string
}

enum (ReasonType)

نوع الرفض.

string

سبب الخطأ.

{
  "reason": string
}

string

سبب الإلغاء.

{
  "updatedTime": string
}

string (Timestamp format)

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

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

{
  "deliveryTime": string
}

string (Timestamp format)

موعد تنفيذ الطلب.

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

{
  "reason": string
}

string

سبب الإرجاع.

{
  "title": string,
  "text": string
}

string

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

string

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

{
  "mediaType": enum (MediaType),
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ]
}

enum (MediaType)

ونوع الوسائط داخل هذه الاستجابة.

object (MediaObject)

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

{
  "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.
}

string

باسم كائن الوسائط هذا.

string

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

string

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

object (Image)

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

object (Image)

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

{
  "items": [
    {
      object (Item)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}

object (Item)

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

enum (ImageDisplayOptions)

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

{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (Image)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  }
}

string

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

string

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

string

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

object (Image)

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

object (OpenUrlAction)

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

{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columnProperties": [
    {
      object (ColumnProperties)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "buttons": [
    {
      object (Button)
    }
  ]
}

string

تمثّل هذه السمة العنوان العام للجدول. اختياري، ولكن يجب تعيينه في حال تعيين الترجمة.

string

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

object (Image)

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

object (ColumnProperties)

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

object (Row)

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

object (Button)

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

{
  "header": string,
  "horizontalAlignment": enum (HorizontalAlignment)
}

string

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

enum (HorizontalAlignment)

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

{
  "cells": [
    {
      object (Cell)
    }
  ],
  "dividerAfter": boolean
}

object (Cell)

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

boolean

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

{
  "text": string
}

string

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

{
  "updatedState": value,
  "suppressMic": boolean,
  "url": string
}

value (Value format)

يمكنك نقل كائن JSON التالي إلى التطبيق.

boolean

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

string

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

{
  "title": string
}

string

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

{
  "destinationName": string,
  "url": string,
  "openUrlAction": {
    object (OpenUrlAction)
  }
}

string

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

string

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

object (OpenUrlAction)

عنوان URL للتطبيق أو الموقع الإلكتروني المطلوب فتحه عندما ينقر المستخدم على شريحة الاقتراح. يجب إثبات ملكية هذا التطبيق/عنوان URL هذا في الإجراءات على Google Developers Console، وإلا لن يظهر الاقتراح للمستخدم. يتوافق إجراء عنوان URL المفتوح مع عناوين URL التي تبدأ بـ http وhttps وintent. بالنسبة إلى عناوين URL المقصودة، يُرجى الرجوع إلى: https://developer.chrome.com/multidevice/android/intents

{
  "intent": string,
  "inputValueData": {
    "@type": string,
    field1: ...,
    ...
  },
  "parameterName": string
}

string

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

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" }

string

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

{

  // 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.
}

object (SpeechResponse)

الرد الشفهي عندما لا يُطلب من المستخدم تقديم المدخلات

object (RichResponse)

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

{
  "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.
}

object (Target)

الهدف المحدّد لطلب الإرسال

object (OrderUpdate)

تعديل طلب لتعديل الطلبات المقدَّمة من خلال واجهات برمجة التطبيقات للمعاملات

object (UserNotification)

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

{
  "title": string,
  "text": string
}

string

عنوان الإشعار.

string

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

{
  "userId": string,
  "intent": string,
  "argument": {
    object (Argument)
  },
  "locale": string
}

string

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

string

القصد من الاستهداف.

object (Argument)

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

string

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