AppResponse

AppResponse پاسخی است که توسط تکمیل به دستیار Google ارسال می شود. برای مثالهایی از نحوه استفاده از این مورد در Actions on 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

یک نشانه غیر شفاف که در هر نوبت مکالمه به Action بازگردانده می شود.

userStorage

string

یک نشانه مات که توسط Action کنترل می‌شود و در سراسر مکالمات برای یک کاربر خاص باقی می‌ماند. اگر خالی یا نامشخص باشد، توکن موجود بدون تغییر خواهد بود. حداکثر اندازه رشته 10 هزار بایت است. اگر چندین گفتگو به طور همزمان برای یک کاربر اتفاق می افتد، به روز رسانی این نشانه می تواند به طور غیرمنتظره ای روی یکدیگر بازنویسی کند.

resetUserStorage

boolean

اینکه آیا ذخیره کاربر باقی مانده پاک شود. اگر روی true تنظیم شود، در تعامل بعدی با کاربر، قسمت userStorage خالی خواهد بود.

expectUserResponse

boolean

نشان می دهد که آیا Action منتظر پاسخ کاربر است یا خیر. این درست زمانی که مکالمه در حال انجام است، نادرست است زمانی که مکالمه انجام می شود.

expectedInputs[]

object ( ExpectedInput )

فهرست ورودی‌هایی که Action انتظار دارد، هر ورودی می‌تواند یک کنش رایج در Google intent باشد (با «اقدامات» شروع شود)، یا یک فهرست ورودی از مقاصد احتمالی باشد. در حال حاضر فقط یک ورودی پشتیبانی می شود.

finalResponse

object ( FinalResponse )

پاسخ نهایی زمانی که Action انتظار ورودی کاربر را ندارد.

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

فهرست عباراتی که Action می‌خواهد Google از آن برای سوگیری گفتار استفاده کند. حداکثر 1000 عبارت مجاز است.

InputPrompt

درخواست ورودی برای دستیار برای راهنمایی کاربر برای ارائه ورودی برای سؤال برنامه استفاده می شود.

نمایندگی 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، به عنوان مثال " بعد از صدا نام حیوان را بگویید. ". متقابل با textToSpeech منحصر به فرد.

RichResponse

پاسخی غنی که می تواند شامل صدا، متن، کارت، پیشنهادات و داده های ساختاریافته باشد.

نمایندگی JSON
{
  "items": [
    {
      object (Item)
    }
  ],
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "linkOutSuggestion": {
    object (LinkOutSuggestion)
  }
}
فیلدها
items[]

object ( Item )

فهرستی از عناصر رابط کاربری که پاسخ را می‌سازند موارد باید شرایط StructuredResponse BasicCard داشته باشند HtmlResponse 1. اولین مورد MediaResponse SimpleResponse باشد SimpleResponse ) 4. اگر از یک intent 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 )

کارت مرور چرخ فلک، به جای آن از collectionBrowse استفاده کنید..

tableCard

object ( TableCard )

کارت جدول.

htmlResponse

object ( HtmlResponse )

پاسخ Html برای رندر روی Canvas استفاده می شود.

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> . متقابل با textToSpeech منحصر به فرد.

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 )

تصویر قهرمان برای کارت. ارتفاع روی 192dp ثابت شده است. اختیاری.

buttons[]

object ( Button )

دکمه ها در حال حاضر حداکثر 1 دکمه پشتیبانی می شود. اختیاری.

imageDisplayOptions

enum ( ImageDisplayOptions )

گزینه نوع نمایش تصویر اختیاری.

دکمه

یک شیء دکمه ای که معمولاً در پایین کارت ظاهر می شود.

نمایندگی JSON
{
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  }
}
فیلدها
title

string

عنوان دکمه مورد نیاز.

openUrlAction

object ( OpenUrlAction )

زمانی که کاربر روی دکمه ضربه می زند، اقدامی انجام شود. مورد نیاز.

Structured Response

پاسخ تعریف شده برای برنامه برای پاسخگویی با داده های ساختاریافته.

نمایندگی 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 میدان اتحادیه ظرف پاسخ محموله از عوامل 3P. data فقط می توانند یکی از موارد زیر باشند:
orderUpdate

object ( OrderUpdate )

برنامه پس از دریافت سفارش، به روز رسانی سفارش (به عنوان مثال Receipt ) را ارائه می دهد.

orderUpdateV3

object ( OrderUpdate )

برنامه پس از دریافت سفارش، به‌روزرسانی سفارش را با فرمت API v3 ارائه می‌کند.

سفارش به روز رسانی

منسوخ شده: به جای آن از 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

دلیل خطا.

اطلاعات لغو

منسوخ شده: به جای آن از 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" .

اطلاعات تکمیلی

منسوخ شده: به جای آن از 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

دلیل بازگشت.

User Notification

اعلان اختیاری کاربر برای نمایش به عنوان بخشی از به‌روزرسانی سفارش.

نمایندگی 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 برگردانده می شود. حاوی اطلاعاتی درباره رسانه مانند نام، توضیحات، آدرس اینترنتی و غیره است.

نمایندگی 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

نشانی اینترنتی که به محتوای رسانه اشاره دارد.

image میدان اتحادیه تصویر برای نمایش با کارت رسانه. image فقط می تواند یکی از موارد زیر باشد:
largeImage

object ( Image )

یک تصویر بزرگ، مانند جلد آلبوم و غیره.

icon

object ( Image )

یک نماد تصویر کوچک در سمت راست عنوان نمایش داده شده است. اندازه آن به 36x36 dp تغییر یافته است.

چرخ فلک مرور

مجموعه ای از اسناد 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 )

دکمه ها در حال حاضر حداکثر 1 دکمه پشتیبانی می شود. اختیاری.

ویژگی های ستون

ویژگی های ستون ها (از جمله سرصفحه ها) را حفظ می کند.

نمایندگی JSON
{
  "header": string,
  "horizontalAlignment": enum (HorizontalAlignment)
}
فیلدها
header

string

متن سرصفحه برای ستون.

horizontalAlignment

enum ( HorizontalAlignment )

تراز افقی ستون wrt محتوا. اگر مشخص نباشد، محتوا با لبه اصلی تراز می شود.

ردیف

یک ردیف را در جدول توصیف می کند.

نمایندگی 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

آدرس برنامه.

پیشنهاد

یک تراشه پیشنهادی که کاربر می تواند برای ارسال سریع پاسخ به مکالمه روی آن ضربه بزند.

نمایندگی 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 تأیید شود، در غیر این صورت پیشنهاد به کاربر نشان داده نمی‌شود. Open URL Action از آدرس های http، https و intent پشتیبانی می کند. برای URL های Intent به آدرس زیر مراجعه کنید: https://developer.chrome.com/multidevice/android/intents

ExpectedIntent

هدف مورد انتظار برنامه از دستیار درخواست ارائه آن است.

نمایندگی JSON
{
  "intent": string,
  "inputValueData": {
    "@type": string,
    field1: ...,
    ...
  },
  "parameterName": string
}
فیلدها
intent

string

نام intent داخلی، به عنوان مثال actions.intent.TEXT ، یا intent های تعریف شده در بسته عمل. اگر هدف مشخص شده یک intent داخلی نباشد، فقط برای بایاس گفتار استفاده می شود و ورودی ارائه شده توسط Google Assistant عبارت actions.intent.TEXT خواهد بود.

inputValueData

object

داده‌های پیکربندی اضافی مورد نیاز یک intent داخلی است. مقادیر ممکن برای intent های داخلی: 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 google.actions.v2.PlaceValueSpec actions.intent.TRANSACTION_DECISION -> actions.intent.PLACE -> google.actions.v2.TransactionDecisionValueSpec ، actions.intent.Link -> google.actions.v2.LinkValueSpec

یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .

parameterName

string

به صورت اختیاری، پارامتری از قصدی که درخواست می شود. فقط برای اهداف درخواستی معتبر است. برای سوگیری گفتار استفاده می شود.

پاسخ نهایی

پاسخ نهایی زمانی که ورودی کاربر انتظار نمی رود.

نمایندگی 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

یک پیام فشار سفارشی که داده‌های ساختاریافته را برای فشار دادن به APIهای Fulfillment در اختیار دارد.

نمایندگی 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 )

سفارش به‌روزرسانی سفارش‌هایی که از طریق APIهای تراکنش انجام می‌شوند.

userNotification

object ( UserNotification )

در صورت مشخص شدن، یک اعلان با عنوان و متن مشخص به کاربر نمایش می دهد.

User Notification

اعلان کاربر برای نمایش با درخواست

نمایندگی 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 خواهد بود.