Method: fulfill

{
  "name": string
}

string

اختیاری. نام کنترل کننده.

{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}

string

مورد نیاز. نام آخرین هدف منطبق.

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

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

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

string

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

{
  "original": string,
  "resolved": value
}

string

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

value ( Value format)

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

{
  "name": string,
  "slotFillingStatus": enum (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  },
  "next": {
    object (NextScene)
  }
}

string

مورد نیاز. نام صحنه فعلی

enum ( SlotFillingStatus )

مورد نیاز. وضعیت فعلی پر کردن اسلات. این فیلد فقط خواندنی است.

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

شکاف های مرتبط با صحنه فعلی. پاسخ های کنترل کننده نمی توانند اسلات هایی را که در درخواست ارسال نشده اند برگردانند.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( NextScene )

اختیاری. اطلاعات مربوط به صحنه در مرحله بعدی اجرا می شود.

{
  "mode": enum (SlotMode),
  "status": enum (SlotStatus),
  "value": value,
  "updated": boolean,
  "prompt": {
    object (Prompt)
  }
}

enum ( SlotMode )

حالت اسلات (الزامی یا اختیاری). می تواند توسط توسعه دهنده تنظیم شود.

enum ( SlotStatus )

وضعیت اسلات.

value ( Value format)

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

boolean

نشان می دهد که آیا مقدار اسلات در آخرین پیچ جمع آوری شده است یا خیر. این فیلد فقط خواندنی است.

object ( Prompt )

اختیاری. این درخواست در صورت نیاز برای پر کردن یک اسلات مورد نیاز برای کاربر ارسال می شود. این اعلان اعلان موجود تعریف شده در کنسول را لغو می کند. این فیلد در درخواست webhook گنجانده نشده است.

{
  "override": boolean,
  "firstSimple": {
    object (Simple)
  },
  "content": {
    object (Content)
  },
  "lastSimple": {
    object (Simple)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (Link)
  },
  "canvas": {
    object (Canvas)
  },
  "orderUpdate": {
    object (OrderUpdate)
  }
}

boolean

اختیاری. حالت نحوه ادغام این پیام‌ها با پیام‌های تعریف‌شده قبلی. "true" تمام پیام های تعریف شده قبلی (اولین و آخرین ساده، محتوا، پیوند پیشنهادات و بوم) را پاک می کند و پیام های تعریف شده در این اعلان را اضافه می کند. "false" پیام های تعریف شده در این اعلان را به پیام های تعریف شده در پاسخ های قبلی اضافه می کند. رها کردن این فیلد روی "نادرست" همچنین افزودن به برخی از فیلدهای داخل فرمان های ساده، اعلان پیشنهادات و اعلان Canvas (بخشی از اعلان محتوا) را امکان پذیر می کند. اگر در اعلان تعریف شده باشد، پیام‌های محتوا و پیوند همیشه بازنویسی می‌شوند. مقدار پیش فرض "نادرست" است.

object ( Simple )

اختیاری. اولین پاسخ صوتی و متنی.

object ( Content )

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

object ( Simple )

اختیاری. آخرین پاسخ صوتی و متنی.

object ( Suggestion )

اختیاری. پیشنهاداتی برای نمایش به کاربر که همیشه در انتهای پاسخ ظاهر می شوند. اگر فیلد «نسخ» در فرمان حاوی «نادرست» باشد، عناوین تعریف‌شده در این قسمت به عناوین تعریف‌شده در هر فرمان پیشنهادی تعریف‌شده قبلی اضافه می‌شوند و مقادیر تکراری حذف می‌شوند.

object ( Link )

اختیاری. یک تراشه پیشنهادی اضافی که می‌تواند به برنامه یا سایت مرتبط پیوند دهد. تراشه با عنوان "باز (نام)" ارائه می شود. حداکثر 20 کاراکتر

object ( Canvas )

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

object ( OrderUpdate )

اقدام اختیاری پس از دریافت سفارش در جریان تراکنش، با OrderUpdate پاسخ می دهد. پس از دریافت این، Google این به‌روزرسانی را در سفارش ثبت می‌کند و در صورت موفقیت‌آمیز، یک کارت رسید را به همراه TTS ارسال شده روی دستگاه‌های نمایشگر نمایش می‌دهد.

{
  "speech": string,
  "text": string
}

string

اختیاری. بیانگر گفتاری است که باید به کاربر گفته شود. می تواند SSML یا متن به گفتار باشد. اگر قسمت "override" در دستور حاوی "true" باشد، گفتار تعریف شده در این قسمت جایگزین گفتار Simple prompt قبلی می شود. به https://developers.google.com/assistant/conversational/ssml مراجعه کنید.

string

متن اختیاری برای نمایش در حباب چت. در صورت عدم ارائه، یک نمایش نمایشی از قسمت گفتار بالا استفاده خواهد شد. محدود به 640 کاراکتر. اگر فیلد «override» در اعلان حاوی «true» باشد، متن تعریف شده در این قسمت جایگزین متن دستور Simple قبلی می شود.

{

  // Union field content can be only one of the following:
  "card": {
    object (Card)
  },
  "image": {
    object (Image)
  },
  "table": {
    object (Table)
  },
  "media": {
    object (Media)
  },
  "collection": {
    object (Collection)
  },
  "list": {
    object (List)
  },
  "collectionBrowse": {
    object (CollectionBrowse)
  }
  // End of list of possible types for union field content.
}

object ( Card )

یک کارت پایه

object ( Image )

یک تصویر

object ( Table )

کارت جدول.

object ( Media )

پاسخ نشان‌دهنده مجموعه‌ای از رسانه‌ها برای پخش.

object ( Collection )

کارتی که مجموعه ای از گزینه ها را برای انتخاب ارائه می دهد.

object ( List )

کارتی که فهرستی از گزینه ها را برای انتخاب ارائه می دهد.

object ( CollectionBrowse )

کارتی که مجموعه ای از صفحات وب را برای باز کردن ارائه می دهد.

{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (Image)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (Link)
  }
}

string

عنوان کلی کارت اختیاری.

string

اختیاری.

string

متن متن کارت از مجموعه محدودی از نحو نشانه گذاری برای قالب بندی پشتیبانی می کند. الزامی است، مگر اینکه تصویر موجود باشد.

object ( Image )

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

enum ( ImageFill )

پس زمینه تصویر چگونه پر می شود. اختیاری.

object ( Link )

دکمه با لینک خروجی. اختیاری.

{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}

string

آدرس منبع تصویر تصاویر می توانند JPG، PNG و GIF (متحرک و غیر متحرک) باشند. برای مثال، https://www.agentx.com/logo.png . مورد نیاز.

string

شرح متنی از تصویر که برای دسترسی استفاده می شود، به عنوان مثال صفحه خوان. مورد نیاز.

integer

ارتفاع تصویر بر حسب پیکسل اختیاری.

integer

عرض تصویر بر حسب پیکسل اختیاری.

{
  "name": string,
  "open": {
    object (OpenUrl)
  }
}

string

نام لینک. حداکثر 20 کاراکتر

object ( OpenUrl )

وقتی کاربر لینک را باز می کند چه اتفاقی می افتد

{
  "url": string,
  "hint": enum (UrlHint)
}

string

فیلد url که می تواند یکی از این موارد باشد: - آدرس های http/https برای باز کردن یک برنامه مرتبط با برنامه یا یک صفحه وب

enum ( UrlHint )

یک اشاره برای نوع URL را نشان می دهد.

{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (Link)
  }
}

string

عنوان کلی جدول اختیاری است اما اگر زیرنویس تنظیم شده باشد باید تنظیم شود.

string

زیرنویس جدول اختیاری.

object ( Image )

تصویر مرتبط با جدول اختیاری.

object ( TableColumn )

سرصفحه ها و تراز ستون ها.

object ( TableRow )

داده های ردیف جدول 3 ردیف اول تضمین شده است که نشان داده می شوند اما سایر ردیف ها ممکن است بر روی سطوح خاصی بریده شوند. لطفاً با شبیه ساز تست کنید تا ببینید کدام ردیف برای یک سطح مشخص نشان داده می شود. در سطوحی که از قابلیت WEB_BROWSER پشتیبانی می کنند، می توانید کاربر را به صفحه وب با داده های بیشتر هدایت کنید.

object ( Link )

دکمه.

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

string

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

enum ( HorizontalAlignment )

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

{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}

object ( TableCell )

سلول های این ردیف نمایش 3 سلول اول تضمین شده است، اما سایر سلول ها ممکن است بر روی سطوح خاصی بریده شوند. لطفاً با شبیه ساز تست کنید تا ببینید کدام سلول برای یک سطح مشخص نشان داده می شود.

boolean

نشان می دهد که آیا بعد از هر ردیف باید یک تقسیم کننده وجود داشته باشد.

{
  "text": string
}

string

محتوای متن سلول

{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ],
  "repeatMode": enum (RepeatMode),
  "firstMediaObjectIndex": integer
}

enum ( MediaType )

string ( Duration format)

شروع افست اولین شی رسانه ای.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' خاتمه می یابد. مثال: "3.5s" .

enum ( OptionalMediaControls )

انواع کنترل رسانه اختیاری که این جلسه پاسخ رسانه می تواند پشتیبانی کند. در صورت تنظیم، زمانی که یک رویداد رسانه ای خاص اتفاق می افتد، درخواست به 3p ارسال می شود. اگر تنظیم نشده باشد، 3p همچنان باید دو نوع کنترل پیش‌فرض، FINISHED و FAILED را کنترل کند.

object ( MediaObject )

فهرست اشیاء رسانه ای

enum ( RepeatMode )

حالت تکرار برای لیست اشیاء رسانه.

integer

شاخص مبتنی بر 0 اولین Media Object در mediaObjects برای پخش. اگر نامشخص، صفر یا خارج از محدوده باشد، پخش از اولین شی رسانه در mediaObjects شروع می شود.

{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}

string

نام این شی رسانه ای.

string

شرح این شی رسانه ای.

string

نشانی اینترنتی که به محتوای رسانه اشاره دارد. فایل‌های MP3 باید روی سرور وب میزبانی شوند و از طریق یک URL HTTPS در دسترس عموم قرار گیرند. پخش زنده فقط برای فرمت MP3 پشتیبانی می شود.

object ( MediaImage )

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

{

  // Union field image can be only one of the following:
  "large": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}

object ( Image )

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

object ( Image )

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

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}

string

عنوان مجموعه. اختیاری.

string

زیرنویس مجموعه. اختیاری.

object ( CollectionItem )

لیستی از موارد می تواند دقیقه 2 و حداکثر 10 باشد.

enum ( ImageFill )

نحوه پر شدن پس زمینه تصویر آیتم های مجموعه اختیاری.

{
  "key": string
}

string

مورد نیاز. کلید NLU که با نام کلید ورودی در نوع مرتبط مطابقت دارد.

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}

string

عنوان لیست اختیاری.

string

زیرنویس لیست اختیاری.

object ( ListItem )

لیستی از موارد می تواند دقیقه 2 و حداکثر 30 باشد.

{
  "key": string
}

string

مورد نیاز. کلید NLU که با نام کلید ورودی در نوع مرتبط مطابقت دارد.

{
  "items": [
    {
      object (Item)
    }
  ],
  "imageFill": enum (ImageFill)
}

object ( Item )

لیستی از موارد می تواند دقیقه 2 و حداکثر 10 باشد.

enum ( ImageFill )

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

{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (Image)
  },
  "openUriAction": {
    object (OpenUrl)
  }
}

string

مورد نیاز. عنوان آیتم مجموعه.

string

شرح آیتم مجموعه

string

متن پاورقی برای آیتم مجموعه، در زیر توضیحات نمایش داده شده است. تک خط متن، کوتاه شده با بیضی.

object ( Image )

تصویر برای آیتم مجموعه.

object ( OpenUrl )

مورد نیاز. URI برای باز کردن در صورت انتخاب مورد.

{
  "title": string
}

string

مورد نیاز. متن نشان داده شده در تراشه پیشنهاد. وقتی روی آن ضربه بزنید، این متن به طور کلمه به مکالمه ارسال می شود، گویی که کاربر آن را تایپ کرده است. هر عنوان باید در میان مجموعه تراشه های پیشنهادی منحصر به فرد باشد. حداکثر 25 کاراکتر

{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "continuousMatchConfig": {
    object (ContinuousMatchConfig)
  }
}

string

URL برنامه وب بوم تعاملی برای بارگیری. اگر تنظیم نشود، آدرس اینترنتی بوم فعال فعلی مجدداً استفاده خواهد شد.

value ( Value format)

اختیاری. داده های JSON به عنوان یک رویداد به صفحه وب تجربه همهجانبه منتقل می شود. اگر فیلد «نسخ» در فرمان حاوی «نادرست» باشد، مقادیر داده‌های تعریف‌شده در این فرمان Canvas پس از مقادیر داده‌های تعریف‌شده در درخواست‌های قبلی Canvas اضافه می‌شوند.

boolean

اختیاری. مقدار پیش فرض: نادرست.

object ( ContinuousMatchConfig )

پیکربندی مورد استفاده برای شروع حالت تطابق مداوم.

{
  "expectedPhrases": [
    {
      object (ExpectedPhrase)
    }
  ],
  "durationSeconds": integer
}

object ( ExpectedPhrase )

تمام عبارات مورد انتظار ممکن در این جلسه حالت تطابق مداوم.

integer

مدت زمان برای روشن نگه داشتن حالت تطابق مداوم. اگر مشخص شود، پس از اتمام زمان، میکروفون بسته خواهد شد. حداکثر مقدار مجاز 180 است.

{
  "phrase": string,
  "alternativePhrases": [
    string
  ]
}

string

عبارت مطابقت در جلسه حالت تطابق مداوم.

string

برخی از عبارات ممکن است توسط مدل گفتار به اشتباه تشخیص داده شوند، حتی با سوگیری گفتاری. این به توسعه دهندگان اجازه می دهد تا محرک های جایگزین را برای همفون ها مشخص کنند.

{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}

enum ( Type )

منسوخ شده: به جای آن از OrderUpdate.update_mask استفاده کنید. اگر نوع = SNAPSHOT، OrderUpdate.order باید کل سفارش باشد. اگر نوع = ORDER_STATUS، این تغییر وضعیت سطح سفارش است. فقط order.last_update_time و این وضعیت عمودی انتخاب می شوند. توجه: type.ORDER_STATUS فقط از به‌روزرسانی‌های وضعیت PurcahaseOrderExtension پشتیبانی می‌کند و برنامه‌ای برای گسترش این پشتیبانی وجود ندارد. در عوض، توصیه می‌کنیم از updateMask استفاده کنید، زیرا عمومی‌تر، قابل توسعه‌تر است و می‌تواند برای همه عمودی‌ها استفاده شود.

object ( Order )

string ( FieldMask format)

توجه: توجه/توصیه های زیر برای فیلدهای ویژه زیر وجود دارد: 1. order.last_update_time همیشه به عنوان بخشی از درخواست به روز رسانی به روز می شود. 2. order.create_time، order.google_order_id و order.merchant_order_id در صورت ارائه به عنوان بخشی از updateMask نادیده گرفته خواهند شد.

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

object ( UserNotification )

در صورت مشخص شدن، یک اعلان با عنوان و متن مشخص شده به کاربر نمایش می دهد. تعیین یک اعلان یک پیشنهاد برای اطلاع رسانی است و تضمین نمی شود که منجر به اعلان شود.

string

دلیل تغییر/به روز رسانی

{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}

string

Google شناسه سفارش را اختصاص داد.

string

مورد نیاز: شناسه سفارش داخلی به تاجر اختصاص داده شده است. این شناسه باید منحصر به فرد باشد و برای عملیات به روز رسانی بعدی سفارش لازم است. این شناسه ممکن است روی googleOrderId ارائه شده یا هر مقدار منحصر به فرد دیگری تنظیم شود. توجه داشته باشید که شناسه ارائه شده به کاربران userVisibleOrderId است که ممکن است مقداری متفاوت و کاربرپسندتر باشد. حداکثر طول مجاز 128 کاراکتر است.

string

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

string

منسوخ شده: به جای آن از وضعیت OrderExtensions استفاده کنید. برچسب قابل مشاهده توسط کاربر برای وضعیت این سفارش.

object ( UserInfo )

اطلاعات در مورد خریدار

object ( Image )

تصویر مرتبط با سفارش

string ( Timestamp format)

مورد نیاز: تاریخ و زمان ایجاد سفارش.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

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

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

object ( Merchant )

تاجری که تسویه حساب را تسهیل کرد. این می‌تواند با ارائه‌دهنده سطح مورد خطی متفاوت باشد. مثال: سفارش Expedia با مورد خط از ANA.

object ( Contents )

مورد نیاز: محتویات را سفارش دهید که گروهی از موارد خطی است.

object ( PriceAttribute )

قیمت، تخفیف، مالیات و غیره.

object ( Action )

پیگیری اقدامات در سطح سفارش

object ( PaymentData )

داده های مربوط به پرداخت برای سفارش

string

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

string

یادداشت های پیوست شده به سفارش

object ( Promotion )

همه تبلیغاتی که با این سفارش مرتبط هستند.

object ( Disclosure )

افشاهای مرتبط با این سفارش.

object

منسوخ شده: به جای آن از عمودی استفاده کنید. این ویژگی ها برای همه موارد خط اعمال می شود، مگر اینکه در برخی از موارد خطی لغو شوند. این عمودی باید با نوع عمودی سطح مورد خط مطابقت داشته باشد. مقادیر ممکن: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

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

object ( PurchaseOrderExtension )

سفارش خرید

object ( TicketOrderExtension )

سفارش بلیط

{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}

string

ایمیل کاربر، به عنوان مثال: janedoe@gmail.com .

string

نام کاربر.

string

نام خانوادگی کاربر.

string

نام نمایشی کاربر، ممکن است با نام یا نام خانوادگی متفاوت باشد.

object ( PhoneNumber )

شماره تلفن های کاربر

{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}

string

شماره تلفن در قالب E.164، همانطور که در توصیه اتحادیه بین المللی مخابرات (ITU) E.164 تعریف شده است. پیوند ویکی: https://en.wikipedia.org/wiki/E.164

string

برنامه افزودنی در توصیه های ITU استاندارد نشده است، به جز اینکه به عنوان مجموعه ای از اعداد با طول حداکثر 40 رقم تعریف شده است. در اینجا به‌عنوان رشته‌ای تعریف می‌شود که برای استفاده احتمالی از صفر اصلی در برنامه افزودنی استفاده می‌شود (سازمان‌ها آزادی کامل برای انجام این کار دارند، زیرا هیچ استانداردی تعریف نشده است). به غیر از ارقام، برخی از کاراکترهای شماره گیری دیگر مانند "," (که نشان دهنده انتظار است) ممکن است در اینجا ذخیره شوند. به عنوان مثال، در xxx-xxx-xxxx ext. 123، "123" پسوند است.

string

کد انتخاب شرکت مخابراتی که هنگام تماس با این شماره تلفن داخلی ترجیح داده می شود. این همچنین شامل کدهایی است که در برخی کشورها هنگام تماس از تلفن ثابت به تلفن همراه یا بالعکس باید شماره گیری شوند. به عنوان مثال، در کلمبیا، هنگام تماس از تلفن همراه به تلفن ثابت داخلی، یک "3" باید قبل از خود شماره تلفن شماره گیری شود. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

توجه داشته باشید که این کد "ترجیح" است، به این معنی که کدهای دیگر نیز ممکن است کار کنند.

{
  "url": string,
  "accessibilityText": string,
  "height": integer,
  "width": integer
}

string

آدرس منبع تصویر تصاویر می توانند JPG، PNG و GIF (متحرک و غیر متحرک) باشند. برای مثال، https://www.agentx.com/logo.png . مورد نیاز.

string

شرح متنی از تصویر که برای دسترسی استفاده می شود، به عنوان مثال صفحه خوان. مورد نیاز.

integer

ارتفاع تصویر بر حسب پیکسل اختیاری.

integer

عرض تصویر بر حسب پیکسل اختیاری.

{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}

string

شناسه اختیاری به تاجر در صورت وجود اختصاص داده می‌شود.

string

نام تاجر مانند "نان پانرا".

object ( Image )

تصویر مرتبط با تاجر.

object ( PhoneNumber )

شماره تلفن های تاجر

object ( Location )

آدرس تاجر.

{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}

object ( LatLng )

مختصات جغرافیایی به مجوز [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] نیاز دارد.

string

نشانی نمایش، به عنوان مثال، "1600 Amphitheatre Pkwy, Mountain View, CA 94043". به مجوز [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] نیاز دارد.

string

کد پستی به مجوز [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] یا [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] نیاز دارد.

string

شهر. به مجوز [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] یا [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] نیاز دارد.

object ( PostalAddress )

آدرس پستی به مجوز [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] یا [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] نیاز دارد.

string

نام مکان.

string

شماره تلفن محل، به عنوان مثال شماره تماس محل کسب و کار یا شماره تلفن محل تحویل.

string

نکاتی در مورد مکان

string

placeId با Places API برای واکشی جزئیات یک مکان استفاده می شود. به https://developers.google.com/places/web-service/place-id مراجعه کنید

{
  "latitude": number,
  "longitude": number
}

number

عرض جغرافیایی بر حسب درجه باید در محدوده [-90.0، +90.0] باشد.

number

طول جغرافیایی بر حسب درجه باید در محدوده [-180.0، +180.0] باشد.

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

بازبینی طرحواره PostalAddress . این باید روی 0 تنظیم شود که آخرین ویرایش است.

همه ویرایش‌های جدید باید با نسخه‌های قبلی سازگار باشند.

string

مورد نیاز. کد منطقه CLDR کشور/منطقه آدرس. این هرگز استنباط نمی شود و اطمینان از صحیح بودن مقدار به عهده کاربر است. برای جزئیات بیشتر به http://cldr.unicode.org/ و http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html مراجعه کنید. مثال: "CH" برای سوئیس.

string

اختیاری. کد زبان BCP-47 محتویات این آدرس (در صورت شناخته شدن). این اغلب زبان رابط کاربری فرم ورودی است یا انتظار می‌رود با یکی از زبان‌های مورد استفاده در کشور/منطقه آدرس یا معادل‌های نویسه‌گردانی شده آنها مطابقت داشته باشد. این می‌تواند بر قالب‌بندی در برخی کشورها تأثیر بگذارد، اما برای صحت داده‌ها حیاتی نیست و هرگز بر روی اعتبارسنجی یا سایر عملیات مرتبط با قالب‌بندی تأثیر نمی‌گذارد.

اگر این مقدار مشخص نیست، باید حذف شود (به جای تعیین یک پیش فرض احتمالاً نادرست).

مثال: "zh-Hant"، "ja"، "ja-Latn"، "en".

string

اختیاری. کد پستی آدرس همه کشورها از وجود کدهای پستی استفاده نمی‌کنند یا نیاز به وجود کد پستی ندارند، اما در جایی که از آنها استفاده می‌شود، ممکن است اعتبار سنجی اضافی را با سایر قسمت‌های آدرس (مثلاً اعتبارسنجی ایالت/زیپ در ایالات متحده آمریکا) ایجاد کنند.

string

اختیاری. کد مرتب‌سازی اضافی، خاص کشور. این در اکثر مناطق استفاده نمی شود. در جایی که از آن استفاده می‌شود، مقدار یا رشته‌ای مانند «CEDEX» است، که به صورت اختیاری با یک عدد دنبال می‌شود (مثلاً «CEDEX 7»)، یا فقط یک عدد به تنهایی، نشان‌دهنده «کد بخش» (جامائیکا)، «نشانگر ناحیه تحویل» است. (مالاوی) یا «نشانگر اداره پست» (مثلاً ساحل عاج).

string

اختیاری. بالاترین بخش اداری که برای آدرس های پستی یک کشور یا منطقه استفاده می شود. به عنوان مثال، این می تواند یک ایالت، یک استان، یک استان یا یک استان باشد. به طور خاص، برای اسپانیا این استان است و نه جامعه خودمختار (مثلاً "بارسلونا" و نه "کاتالونیا"). بسیاری از کشورها از یک منطقه اداری در آدرس های پستی استفاده نمی کنند. به عنوان مثال در سوئیس این باید خالی از سکنه بماند.

string

اختیاری. عموماً به بخش شهر/شهرک آدرس اشاره دارد. مثال: شهر ایالات متحده، کمون فناوری اطلاعات، شهر پست بریتانیا. در مناطقی از جهان که محلی ها به خوبی تعریف نشده اند یا به خوبی در این ساختار قرار نمی گیرند، محلی را خالی بگذارید و از خطوط آدرس استفاده کنید.

string

اختیاری. موقعیت فرعی آدرس به عنوان مثال، این می تواند محله، محله، منطقه باشد.

string

خطوط آدرس بدون ساختار که سطوح پایین یک آدرس را توصیف می کند.

از آنجایی که مقادیر در addressLines اطلاعات نوع ندارند و گاهی اوقات ممکن است حاوی چندین مقدار در یک فیلد واحد باشند (به عنوان مثال "Austin, TX")، واضح بودن ترتیب خطوط مهم است. ترتیب خطوط آدرس باید "سفارش پاکت" برای کشور/منطقه آدرس باشد. در جاهایی که ممکن است متفاوت باشد (مثلاً ژاپن)، address_language برای صریح‌تر کردن آن استفاده می‌شود (مثلاً "ja" برای سفارش بزرگ به کوچک و "ja-Latn" یا "en" برای کوچک به بزرگ). به این ترتیب، مشخص ترین خط یک آدرس را می توان بر اساس زبان انتخاب کرد.

حداقل نمایش ساختاری مجاز یک آدرس شامل یک RegionCode با تمام اطلاعات باقیمانده در خطوط آدرس است. قالب بندی چنین آدرسی تقریباً بدون کدگذاری جغرافیایی امکان پذیر است، اما هیچ استدلال معنایی در مورد هیچ یک از اجزای آدرس نمی توان تا حداقل تا حدی حل شود.

ایجاد آدرسی که فقط شامل یک regionCode و addressLines باشد و سپس geocoding روشی توصیه شده برای مدیریت آدرس‌های کاملاً بدون ساختار است (برخلاف حدس زدن اینکه کدام قسمت‌های آدرس باید محل‌ها یا مناطق اداری باشند).

string

اختیاری. گیرنده در آدرس این فیلد تحت شرایط خاصی ممکن است حاوی اطلاعات چند خطی باشد. به عنوان مثال، ممکن است حاوی اطلاعات "مراقبت از" باشد.

string

اختیاری. نام سازمان در آدرس.

{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}

object ( LineItem )

لیست اقلام خط سفارش حداقل 1 خط مورد نیاز است و حداکثر 50 مورد مجاز است. همه موارد خط باید به یک عمود تعلق داشته باشند.

{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}

string

مورد نیاز: تاجر برای مورد خط شناسه اختصاص داده است. برای شناسایی مورد خط موجود در اعمال به‌روزرسانی‌های جزئی استفاده می‌شود. حداکثر طول مجاز 64 کاراکتر است.

string

نام کالای خط همانطور که در رسید نشان داده شده است. حداکثر طول مجاز 100 کاراکتر است.

string

منسوخ شده است. به جای آن از وضعیت سطح عمودی استفاده کنید. به عنوان مثال، برای خرید، از PurchaseOrderExtension.status استفاده کنید. برچسب قابل مشاهده توسط کاربر برای وضعیت این مورد خط.

object ( Merchant )

ارائه‌دهنده مورد خط خاص، اگر با سفارش کلی متفاوت باشد. مثال: Expedia Order با ارائه دهنده اقلام خطی ANA.

object ( PriceAttribute )

قیمت و تنظیمات سطح مورد خطی.

object ( Action )

پیگیری اقدامات در مورد خط.

object ( UserInfo )

مشتریان سطح اقلام خطی، این ممکن است با خریدار سطح سفارش متفاوت باشد. مثال: کاربر X با نام کاربر Y رزرو رستوران انجام داده است.

object ( Image )

تصویر کوچک مرتبط با این مورد، در صورت وجود.

string

شرح مورد خط.

string

یادداشت‌های اضافی قابل اعمال برای این مورد خاص، برای مثال خط‌مشی لغو.

object ( Disclosure )

افشاهای مرتبط با این مورد.

object

منسوخ شده: به جای آن از عمودی استفاده کنید. مورد نیاز: محتوای معنایی آیتم خط بر اساس نوع/عمودی آن. هر عمودی باید شامل جزئیات تحقق خودش باشد. باید یکی از مقادیر زیر باشد: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

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

object ( PurchaseItemExtension )

سفارشات خرید مانند کالا، غذا و غیره

object ( ReservationItemExtension )

سفارشات رزرو مانند رستوران، مدل مو و غیره

{
  "type": enum (Type),
  "name": string,
  "id": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": integer
  // End of list of possible types for union field spec.
}

enum ( Type )

مورد نیاز: نوع ویژگی پول.

string

مورد نیاز: رشته ای از ویژگی قیمت را کاربر نمایش می دهد. این توسط تاجر ارسال و بومی سازی شده است.

string

اختیاری: شناسه قلم خطی که این قیمت با آن مطابقت دارد.

enum ( State )

مورد نیاز: وضعیت قیمت: برآورد در مقابل واقعی.

boolean

این که آیا قیمت شامل مالیات می شود.

object ( Money )

مقدار پولی

integer

مشخصات درصد ، تا 1/1000 درصد درصد. به عنوان مثال: 8.750 ٪ به عنوان 8750 نشان داده شده است ، درصد منفی نشان دهنده تخفیف درصد است. کاهش این زمینه در صورت نیاز به usecase جامد ، می توانید اضافه کنید.

{
  "currencyCode": string,
  "amountInMicros": string
}

string

کد ارز 3 حرف تعریف شده در ISO 4217.

string ( int64 format)

مقدار در میکرو. به عنوان مثال ، این قسمت باید به عنوان 1990000 با قیمت 1.99 دلار تنظیم شود.

{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}

enum ( Type )

مورد نیاز: نوع عمل.

string

عنوان یا برچسب عمل ، به کاربر نمایش داده می شود. حداکثر طول مجاز 100 بار است.

object ( OpenUrlAction )

اقدام برای انجام

object ( ActionMetadata )

ابرداده مرتبط با یک عمل.

{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}

string

قسمت URL که می تواند هر یک از: - URL های HTTP/HTTPS برای باز کردن یک برنامه مرتبط با برنامه یا یک صفحه وب

object ( AndroidApp )

اگر انتظار می رود URL توسط یک برنامه Android انجام شود ، اطلاعات مربوط به برنامه Android را انجام دهید.

enum ( UrlTypeHint )

اشاره ای به نوع URL نشان می دهد.

{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}

string

نام بسته نام بسته باید هنگام مشخص کردن تحقق Android مشخص شود.

object ( VersionFilter )

هنگامی که چندین فیلتر مشخص شد ، هر تطابق فیلتر باعث ایجاد برنامه می شود.

{
  "minVersion": integer,
  "maxVersion": integer
}

integer

کد نسخه حداقل یا 0 ، فراگیر.

integer

کد نسخه حداکثر ، فراگیر. دامنه در نظر گرفته شده [minversion: maxversion] است. دامنه تهی حاکی از هر نسخه است. مثالها: برای مشخص کردن استفاده از نسخه واحد: [target_version: target_version]. برای مشخص کردن هر نسخه از Minversion و MaxVersion نامشخص است. برای مشخص کردن تمام نسخه ها تا حداکثر ، Minversion نامشخص را بگذارید. برای مشخص کردن تمام نسخه ها از Minversion ، MaxVersion نامشخص را بگذارید.

{
  "expireTime": string
}

string ( Timestamp format)

زمانی که این عمل منقضی می شود.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}

string

عنوان افشای. مثال: "اطلاعات ایمنی".

object ( DisclosureText )

محتوای افشای اطلاعات. Weblinks مجاز است.

object ( DisclosurePresentationOptions )

گزینه های ارائه برای افشای اطلاعات.

{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}

string

متن برای نمایش ، حاوی صاحبخانه هایی مانند "{0}" و "{1}" برای هر لینک متن که باید درج شود. مثال: "هشدار: این محصول می تواند شما را در معرض مواد شیمیایی قرار دهد که برای ایجاد سرطان به ایالت کالیفرنیا شناخته شده اند. برای اطلاعات بیشتر به 0 {بروید." این متن افشای اطلاعات نباید حاوی هر محتوای تبلیغاتی یا تبلیغاتی باشد.

object ( TextLink )

پیوندهای متنی که باید در الگوی جایگزین شوند. مورد اول برای "{0}" در رشته الگوی جایگزین می شود ، و مورد دوم برای "{1}" و غیره.

{
  "displayText": string,
  "url": string
}

string

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

string

URL که کاربران باید هنگام فعال شدن پیوند به آن هدایت شوند.

{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}

enum ( PresentationRequirement )

الزام ارائه افشای.

boolean

آیا در ابتدا محتوای افشای اطلاعات باید گسترش یابد. به طور پیش فرض ، در ابتدا فرو ریخت.

{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "productDetails": {
    object (ProductDetails)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum ( PurchaseStatus )

مورد نیاز: وضعیت سطح مورد خط.

string

مورد نیاز: برچسب/رشته قابل مشاهده کاربر برای وضعیت. حداکثر طول مجاز 50 بار است.

enum ( PurchaseType )

مورد نیاز: نوع خرید.

string

محصول یا شناسه ارائه شده با این مورد خط.

integer

مقدار مورد

object ( MerchantUnitMeasure )

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

object ( PurchaseReturnsInfo )

اطلاعات را برای این مورد خط برمی گرداند. در صورت عدم استفاده ، این مورد خط به ارث می رسد سطح سفارش اطلاعات را برمی گرداند.

object ( PurchaseFulfillmentInfo )

اطلاعات تحقق برای این مورد خط. در صورت عدم استفاده ، این مورد خط اطلاعات تحقق سطح سفارش را به ارث می برد.

object ( ItemOption )

افزودنی های اضافی یا زیر.

object ( ProductDetails )

جزئیات مربوط به محصول.

object

هر زمینه اضافی بین بازرگان و گوگل رد و بدل می شود. توجه: استفاده از این پسوند بسیار دلسرد است. بر اساس مورد/شرایط استفاده ، یکی از موارد زیر را در نظر بگیرید: 1- اگر می توان از آن برای سایر موارد استفاده استفاده کرد (به عنوان مثال توانایی/عملکرد عمومی) ، زمینه های موجود در BuyItemextension را تعریف کنید. 2. در صورت خاص بودن یک ویژگی/ویژگی استفاده غیر ژنتیکی ، از urdent_extension استفاده کنید.

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

{
  "measure": number,
  "unit": enum (Unit)
}

number

مقدار: مثال 1.2.

enum ( Unit )

واحد: پوند مثال ، گرم.

{
  "isReturnable": boolean,
  "daysToReturn": integer,
  "policyUrl": string
}

boolean

اگر درست باشد ، بازگشت مجاز است.

integer

بازگشت در طی روزهای زیادی مجاز است.

string

پیوند به خط مشی بازگشت.

{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}

string

شناسه منحصر به فرد برای این گزینه سرویس.

enum ( Type )

مورد نیاز: نوع تحقق.

object ( Time )

یک پنجره اگر یک برد زمان مشخص شده یا ETA در صورت مشخص شدن زمان مشخص شده است. تحویل مورد انتظار یا زمان وانت.

object ( Time )

یک پنجره اگر یک برد زمان مشخص شده یا ETA در صورت مشخص شدن زمان مشخص شده است. زمان انتظار برای تهیه غذا. یک بار ترجیح داده می شود.

object ( Location )

وانت یا محل تحویل.

string ( Timestamp format)

زمانی که در آن این گزینه تکمیل منقضی می شود.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

object ( PriceAttribute )

هزینه این گزینه

object ( UserInfo )

تماس کاربر برای این تحقق.

string

نام روش حمل و نقل انتخاب شده توسط کاربر.

string

ذخیره سازی محل. مثال: Walmart بازرگان است و StoreCode فروشگاه Walmart است که در آن انجام شده است. https://support.google.com/business/answer/3370250؟ref_topic=4596653 .

object ( PickupInfo )

اطلاعات اضافی در مورد نحوه انتخاب سفارش. این قسمت فقط در صورت وانت انجام می شود.

{
  "timeIso8601": string
}

string

نمایانگر یک زمان سفارش سفارش مانند زمان رزرو ، زمان تحویل و غیره است. می تواند مدت زمان (زمان شروع و پایان) باشد ، فقط تاریخ ، زمان تاریخ و غیره. به https://en.wikipedia.org/wiki/iso_8601 برای همه قالب های پشتیبانی شده مراجعه کنید.

{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}

enum ( PickupType )

روش انتخاب ، مانند instore ، curbside و غیره

object ( CurbsideInfo )

جزئیات خاص برای اطلاعات حاشیه. اگر Pickuptype "حاشیه" نباشد ، این زمینه نادیده گرفته می شود.

object ( CheckInInfo )

لیست روشهای مختلف پشتیبانی شده توسط شریک برای پشتیبانی از ورود به سیستم.

{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}

enum ( CurbsideFulfillmentType )

شرکا برای تسهیل سفارشات وانت کنار نیاز به اطلاعات اضافی دارند. بسته به انتخاب نوع تحقق ، جزئیات مربوطه از کاربر جمع آوری می شود.

object ( Vehicle )

جزئیات وسیله نقلیه کاربر قرار دادن سفارش.

{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}

string

وسیله نقلیه (به عنوان مثال "هوندا"). این به کاربر نمایش داده می شود و باید بومی سازی شود. مورد نیاز.

string

مدل وسیله نقلیه (به عنوان مثال "GROM"). این به کاربر نمایش داده می شود و باید بومی سازی شود. مورد نیاز.

string

شماره پلاک خودرو (به عنوان مثال "1ABC234"). مورد نیاز.

string

نام رنگ وسیله نقلیه ، به عنوان مثال. سیاه اختیاری.

object ( Image )

URL به یک عکس از وسیله نقلیه. این عکس در حدود 256x256px نمایش داده می شود. باید JPG یا PNG باشد. اختیاری.

{
  "checkInType": enum (CheckInType)
}

enum ( CheckInType )

روش استفاده شده برای ارسال دستورالعمل های checkin.

{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}

string

برای گزینه هایی که مواردی هستند ، شناسه مورد منحصر به فرد.

string

نام گزینه

object ( PriceAttribute )

قیمت کل قیمت.

string

یادداشت مربوط به گزینه

integer

برای گزینه هایی که موارد ، کمیت هستند.

string

محصول یا شناسه ارائه شده با این گزینه.

object ( ItemOption )

برای تعریف سایر گزینه های فرعی تو در تو.

{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}

string

محصول یا شناسه ارائه شده با این مورد خط.

string

تعداد کالاهای تجاری جهانی محصول. مفید است اگر پیشنهاد در مرکز بازرگان وجود نداشته باشد. اختیاری.

string

کدهای جستجوی قیمت ، که معمولاً کدهای PLU ، شماره PLU ، به علاوه ، تولید کدها یا برچسب های تولیدی نامیده می شوند ، سیستم اعدادی هستند که به طور منحصر به فرد محصولات فله ای را که در فروشگاه های مواد غذایی و سوپر مارکت ها فروخته می شوند ، شناسایی می کنند.

string

دسته محصول تعریف شده توسط بازرگان. به عنوان مثال "خانه> مواد غذایی> لبنیات و تخم مرغ> شیر> شیر کامل"

map (key: string, value: string)

جزئیات مربوط به بازرگان در مورد محصول ، به عنوان مثال {"آلرژن": "بادام زمینی". مفید است اگر پیشنهاد در مرکز بازرگان وجود نداشته باشد. اختیاری.

یک شیء حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": integer,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  }
}

enum ( ReservationStatus )

مورد نیاز: وضعیت رزرو.

string

مورد نیاز: برچسب/رشته قابل مشاهده کاربر برای وضعیت. حداکثر طول مجاز 50 بار است.

enum ( ReservationType )

نوع رزرو اگر هیچ یک از گزینه های نوع کاربردی نباشد ، ممکن است غیرقانونی باشد.

object ( Time )

زمان برنامه ریزی سرویس/رویداد. می تواند یک محدوده زمانی ، تاریخ یا زمان دقیق تاریخ باشد.

object ( Time )

محدوده زمانی که برای کاربر قابل قبول است.

string

کد تأیید برای این رزرو.

integer

تعداد افراد

object ( StaffFacilitator )

کارکنان تسهیل کننده ای که در حال انجام رزرو هستند. مثال مدل مو.

object ( Location )

محل سرویس/رویداد.

{
  "name": string,
  "image": {
    object (Image)
  }
}

string

نام تسهیلگر کارکنان. مثال "جان اسمیت"

object ( Image )

تصاویر مجری

{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}

object ( PaymentResult )

نتیجه پرداختی که توسط یکپارچه برای انجام معامله استفاده می شود. اگر تجربه پرداخت توسط Action-on-Google مدیریت شود ، این قسمت توسط اقدامات موجود در Google جمع می شود.

object ( PaymentInfo )

اطلاعات پرداخت در مورد سفارش که برای تعامل کاربر با کاربر مفید است.

{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}

string

Google داده های روش پرداخت را ارائه داد. اگر پردازنده پرداخت شما به عنوان پردازنده پرداخت پشتیبانی Google در اینجا ذکر شده است: https://developers.google.com/pay/api/ از طریق لینک به پردازنده پرداخت خود بروید تا جزئیات بیشتری را پیدا کنید. در غیر این صورت ، برای جزئیات بار به مستندات زیر مراجعه کنید. https://developers.google.com/pay/api/payment-data-cryptography

string

بازرگان/اقدام روش پرداخت انتخاب شده توسط کاربر را ارائه داد.

{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}

object ( PaymentMethodDisplayInfo )

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

enum ( PaymentMethodProvenance )

اثبات روش پرداخت مورد استفاده برای معامله. کاربر ممکن است روش پرداخت یکسانی را هم در Google و هم برای بازرگان ثبت کرده باشد.

{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}

enum ( PaymentType )

نوع پرداخت

string

نام قابل مشاهده کاربر روش پرداخت. به عنوان مثال ، ویزا **** 1234 بررسی acct **** 5678

string

نام روش پرداخت باید برای دستگاههای دستیار فقط صدا با کاربر صحبت شود. به عنوان مثال ، "ویزا پایان در یک دو سه چهار" یا "حساب چک که در پنج شش هفت هشت هشت" پایان یافته است. توجه: این رشته بهینه شده صوتی است که به جای پرداخت methoddisplayname برای دستگاه های دستیار فقط صدا استفاده می شود. اگر این رشته تنظیم نشده باشد ، در عوض PaymentMethodDisplayName نام برای کاربر صحبت می شود.

{
  "coupon": string
}

string

مورد نیاز: کد کوپن برای این پیشنهاد اعمال می شود.

{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum ( PurchaseStatus )

مورد نیاز: وضعیت کلی برای سفارش.

string

برچسب/رشته قابل مشاهده کاربر برای وضعیت. حداکثر طول مجاز 50 بار است.

enum ( PurchaseType )

مورد نیاز: نوع خرید.

object ( PurchaseReturnsInfo )

اطلاعات را برای سفارش برگردانید.

object ( PurchaseFulfillmentInfo )

اطلاعات تحقق برای سفارش.

enum ( PurchaseLocationType )

محل خرید (داخل فروشگاه / آنلاین)

object ( PurchaseError )

اختیاری: خطاها به دلیل آن این ترتیب رد شد.

object

هر زمینه اضافی بین بازرگان و گوگل رد و بدل می شود. توجه: استفاده از این پسوند بسیار دلسرد است. بر اساس مورد/شرایط استفاده ، یکی از موارد زیر را در نظر بگیرید: 1- اگر می توان از آن برای سایر موارد استفاده استفاده کرد (به عنوان مثال توانایی/عملکرد عمومی) ، زمینه های موجود در خرید را تعریف کنید. 2. در صورت خاص بودن یک ویژگی/ویژگی استفاده غیر ژنتیکی ، از urdent_extension استفاده کنید.

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

{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}

enum ( ErrorType )

مورد نیاز: این نشان دهنده دلیل دانه ای است که یک سفارش توسط بازرگان رد می شود.

string

توضیحات خطای اضافی

string

شناسه موجودی که با خطا مطابقت دارد. مثال این می تواند با LineItemid / itemOptionID مطابقت داشته باشد.

object ( PriceAttribute )

در مورد نوع خطای Price_Changed / Arrect_Price مرتبط است.

integer

اکنون مقدار موجود است. در صورت وجود در دسترس بودن قابل استفاده است.

{
  "ticketEvent": {
    object (TicketEvent)
  }
}

object ( TicketEvent )

این رویداد برای کلیه بلیط های مورد خط اعمال می شود.

{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}

enum ( Type )

مورد نیاز: نوع رویداد بلیط ، به عنوان مثال فیلم ، کنسرت.

string

مورد نیاز: نام این رویداد. به عنوان مثال ، اگر این رویداد یک فیلم است ، این باید نام فیلم باشد.

string

توضیحات این رویداد.

string

URL به اطلاعات رویداد.

object ( Location )

مکانی که در آن رویداد اتفاق می افتد ، یا یک سازمان در آن واقع شده است.

object ( EventCharacter )

شخصیت های مربوط به این رویداد. این می تواند کارگردان یا بازیگران یک رویداد فیلم یا مجریان یک کنسرت و غیره باشد.

object ( Time )

زمان شروع

object ( Time )

زمان پایان

object ( Time )

زمان ورود ، که ممکن است با زمان شروع رویداد متفاوت باشد. به عنوان مثال این رویداد از ساعت 9 صبح آغاز می شود ، اما زمان ورود 8:30 صبح است.

{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}

enum ( Type )

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

string

نام شخصیت

object ( Image )

تصاویر شخصیت

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

string

عنوان برای اعلان کاربر. حداکثر طول مجاز 30 بار است.

string

محتوای اعلان حداکثر طول مجاز 100 بار است.

{
  "name": string
}

string

نام صحنه در مرحله بعدی اجرا می شود.

{
  "id": string,
  "params": {
    string: value,
    ...
  },
  "typeOverrides": [
    {
      object (TypeOverride)
    }
  ],
  "languageCode": string
}

string

مورد نیاز. شناسه منحصر به فرد در مورد جلسه مکالمه فعلی. این فیلد فقط خواندنی است.

map (key: string, value: value ( Value format))

مورد نیاز. لیست کلیه پارامترهای جمع آوری شده از فرم ها و اهداف در طول جلسه. کلید نام پارامتر است. پارامترهای تعریف شده در اینجا با پارامترهایی که قبلاً در جلسه تعریف شده اند ادغام می شوند. پارامترهای با مقدار تهی از جلسه حذف می شوند. به مستندات ذخیره سازی جلسه مراجعه کنید: https://developers.google.com/assistant/conversational/storage-session .

یک شیء حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( TypeOverride )

اختیاری. انواع مختلفی به جلسه. نوع جلسه تعریف می تواند انواع موجود را مکمل یا جایگزین کند. نام های نوع باید منحصر به فرد باشند.

string

زبان جلسه مکالمه فعلی. دنبال IETF BCP-47 کد زبان http://www.rfc-editor.org/rfc/bcp/bcp47.txt . اگر این اکشن از ویژگی های چند زبانی استفاده کند ، می تواند متفاوت از محل کاربر باشد. به عنوان مثال ، هنگامی که handler_response.expected.language_code تنظیم شده است ، زبان مکالمه را برای همه چرخش های زیر تغییر می دهد ، که در این زمینه منعکس می شود.

{
  "name": string,
  "mode": enum (TypeOverrideMode),
  "synonym": {
    object (SynonymType)
  }
}

string

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

enum ( TypeOverrideMode )

مورد نیاز. نحوه ادغام این نوع با مقادیر دیگر.

object ( SynonymType )

{
  "entries": [
    {
      object (Entry)
    }
  ]
}

object ( Entry )

مورد نیاز. لیست ورودی ها برای نوع مترادف.

{
  "name": string,
  "synonyms": [
    string
  ],
  "display": {
    object (EntryDisplay)
  }
}