- نمایش JSON
- اکشنپلتفرم
- نوع پیوند اکشن
- سفارش آنلاینفراداده
- گزینه تکمیل سفارش
- نوع انجام سفارش
- روز موجود
- تاریخ
- جزئیات هزینه
- بدون کارمزد
- حداقل هزینه
- هزینه ثابت
- سفارش غذافراداده
- جزئیات هزینه
- نوع هزینه
- مبلغ کارمزد
- پول
- مانی رنج
- مقدار کمی
- محدودهمقدار
- محدوده مدت زمان
- جزئیات سفارش پیشرفته
- فراداده رویداد
- سطح
یک URL مربوط به یک عمل به همراه زبان مربوطه، فهرست کشورهای دارای محدودیت دسترسی و پلتفرم اختیاری که نشان میدهد این عمل باید روی کدام پلتفرم انجام شود.
| نمایش JSON |
|---|
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( |
| فیلدها | |
|---|---|
url | نشانی اینترنتی (URL) نقطه ورود برای این لینک عملیاتی. |
language | برچسب زبان BCP-47 که زبانی را که محتوای این URI به آن زبان در دسترس است، مشخص میکند. |
restrictedCountry[] | کد کشور ISO 3166-1 alpha-2. برای مشاهده نامحدود، خالی بگذارید. |
platform | پلتفرمی که این عمل باید روی آن انجام شود. اگر این فیلد تنظیم نشده باشد، ACTION_PLATFORM_WEB_APPLICATION به عنوان جایگزین استفاده خواهد شد. |
actionLinkType | نوع اقدام از پیش تعیین شده |
orderOnlineMetadata | متادیتا برای لینک سفارش آنلاین. از اکشن با ActionLinkType از نوع ACTION_LINK_TYPE_SHOP_ONLINE پشتیبانی میکند. |
foodOrderingMetadata | فراداده برای لینکهای سفارش غذا. از نوع اکشن پشتیبانی میکند: * |
eventMetadata | اطلاعات تکمیلی در مورد لینک اکشن که مختص بخش رویدادها است. |
اکشنپلتفرم
پلتفرمی که عمل روی آن انجام میشود. برنامه وب، جایگزین عمومی است. توصیه میشود حداقل یک ActionLink با ACTION_PLATFORM_WEB_APPLICATION داشته باشید. لینکهایی که پلتفرم آنها اندروید و iOS است، فقط روی سیستم مربوطه استفاده میشوند.
| انومها | |
|---|---|
ACTION_PLATFORM_UNSPECIFIED | پلتفرم مشخص نشده است. |
ACTION_PLATFORM_WEB_APPLICATION | پلتفرم عمل به طور کلی وب است. |
ACTION_PLATFORM_MOBILE_WEB | پلتفرم اکشن، وب روی دستگاههای تلفن همراه است. |
ACTION_PLATFORM_ANDROID | پلتفرم اکشن، سیستم عامل اندروید است. |
ACTION_PLATFORM_IOS | پلتفرم اکشن، iOS است. |
نوع پیوند اکشن
نوع اقدام از پیش تعیینشده مرتبط با یک لینک اقدام.
| انومها | |
|---|---|
ACTION_LINK_TYPE_UNSPECIFIED | نوع لینک اکشن مشخص نشده است. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT | نوع لینک اقدام، رزرو نوبت است. |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT | نوع لینک اقدام، رزرو نوبت آنلاین است. |
ACTION_LINK_TYPE_ORDER_FOOD | نوع لینک اقدام، سفارش غذا برای تحویل یا بیرونبر یا هر دو است. |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY | نوع لینک اقدام، سفارش غذا برای تحویل است. |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT | نوع لینک اقدام، سفارش غذا برای بیرونبر است. |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION | نوع لینک اقدام، رزرو غذا است. |
ACTION_LINK_TYPE_SHOP_ONLINE | نوع لینک اقدام، سفارش برای خرید است، میتواند تحویل یا تحویل حضوری یا هر دو باشد. |
سفارش آنلاینفراداده
فراداده برای لینک اقدام سفارش آنلاین.
| نمایش JSON |
|---|
{
"fulfillmentOption": [
{
object ( |
| فیلدها | |
|---|---|
fulfillmentOption[] | گزینههای موجود برای انجام سفارش از طریق لینک اقدام آنلاین. |
گزینه تکمیل سفارش
گزینه تکمیل سفارش برای لینک اقدام آنلاین.
| نمایش JSON |
|---|
{ "fulfillmentType": enum ( |
| فیلدها | |
|---|---|
fulfillmentType | الزامی. نوع انجام سفارش. |
availableDay[] | الزامی. فهرستی از روزهایی که برای این روش ارسال، سفارش در دسترس است (ترجیحاً حداقل ۲ روز). |
feeDetails | الزامی. جزئیات هزینه برای روش انجام سفارش. |
minimumOrder | الزامی. حداقل سفارش برای روش انجام سفارش مرتبط با لینک اقدام. |
نوع انجام سفارش
نوع تحقق مرتبط با یک لینک اقدام.
| انومها | |
|---|---|
FULFILLMENT_TYPE_UNSPECIFIED | نوع تحقق نامشخص است. |
FULFILLMENT_TYPE_DELIVERY | نوع انجام سفارش، تحویل است. |
FULFILLMENT_TYPE_PICKUP | نوع انجام سفارش، دریافت سفارش (pick up) است. |
روز موجود
در دسترس بودن در سطح روز.
| نمایش JSON |
|---|
{
"fulfillmentDate": {
object ( |
| فیلدها | |
|---|---|
fulfillmentDate | الزامی. تاریخ موجود برای روش انجام سفارش. فرض میشود که در منطقه زمانی فروشنده باشد. |
lastOrderingTime | الزامی. مهر زمانی یونیکس. آخرین زمانی که کاربر میتوانست اقلام را سفارش دهد و تا برای مثال، اگر تاریخ تکمیل سفارش (fillmentDate) برابر با 2020-08-10 باشد: - مقدار lastOrderingTime برابر با 2020-08-10 18:00 به این معنی است که برای دریافت سفارش خود در تاریخ 2020-08-10، مشتری باید آن سفارش را تا ساعت 6 بعد از ظهر همان روز انجام دهد. - مقدار lastOrderingTime برابر با 2020-08-08 20:00 به این معنی است که برای دریافت سفارش خود در تاریخ 2020-08-10، مشتری باید آن سفارش را تا ساعت 8 شب دو روز قبل انجام دهد. از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: |
تاریخ
نشان دهنده یک تاریخ تقویمی کامل یا جزئی، مانند تاریخ تولد است. زمان روز و منطقه زمانی یا در جای دیگری مشخص شدهاند یا اهمیت چندانی ندارند. تاریخ نسبت به تقویم میلادی است. این میتواند یکی از موارد زیر را نشان دهد:
- یک تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر.
- یک ماه و یک روز، با یک سال صفر (مثلاً یک سالگرد).
- یک سال به تنهایی، با یک ماه صفر و یک روز صفر.
- یک سال و یک ماه، با یک روز صفر (برای مثال، تاریخ انقضای کارت اعتباری).
انواع مرتبط:
-
google.type.TimeOfDay -
google.type.DateTime -
google.protobuf.Timestamp
| نمایش JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| فیلدها | |
|---|---|
year | سال تاریخ. باید از ۱ تا ۹۹۹۹ باشد، یا برای مشخص کردن تاریخ بدون سال، ۰ باشد. |
month | ماه سال. باید از ۱ تا ۱۲ باشد، یا برای مشخص کردن سال بدون ماه و روز، ۰ باشد. |
day | روز ماه. باید از ۱ تا ۳۱ باشد و برای سال و ماه معتبر باشد، یا ۰ برای مشخص کردن یک سال به تنهایی یا یک سال و ماه که روز در آن مهم نیست. |
جزئیات هزینه
جزئیات هزینه برای روش انجام سفارش مرتبط با لینک اقدام.
| نمایش JSON |
|---|
{ // Union field |
| فیلدها | |
|---|---|
فیلد مشترک fee_details . مدل هزینه برای روش انجام سفارش. fee_details فقط میتواند یکی از موارد زیر باشد: | |
noFee | بدون هزینه برای روش انجام سفارش. |
baseFee | هزینه پایه مرتبط با روش انجام سفارش. |
fixedFee | هزینه ثابت مرتبط با روش انجام سفارش. |
بدون کارمزد
این نوع هیچ فیلدی ندارد.
برای روش انجام سفارش مرتبط با لینک اقدام، هیچ هزینهای لازم نیست.
حداقل هزینه
حداقل هزینه مورد نیاز برای روش انجام سفارش مرتبط با لینک اقدام.
| نمایش JSON |
|---|
{
"baseFeeAmount": {
object ( |
| فیلدها | |
|---|---|
baseFeeAmount | الزامی. مبلغ پایه کارمزد برای روش انجام سفارش. |
هزینه ثابت
هزینه ثابت مورد نیاز برای روش انجام سفارش مرتبط با لینک اقدام.
| نمایش JSON |
|---|
{
"amount": {
object ( |
| فیلدها | |
|---|---|
amount | الزامی. مبلغ کارمزد ثابت برای روش انجام سفارش. |
سفارش غذافراداده
فراداده برای لینکهای اقدام سفارش غذا.
| نمایش JSON |
|---|
{ "feeDetails": [ { object ( |
| فیلدها | |
|---|---|
feeDetails[] | جزئیات هزینههای اعمالشده بر کاربر علاوه بر جمع کل کالا. این مورد برای انواع مختلف هزینهها مانند هزینه خدمات، هزینه ارسال و غیره تکرار میشود. |
advanceOrderDetails | جزئیات مربوط به پشتیبانی پیشرفته سفارش که با نام سفارش از قبل نیز شناخته میشود و در آن کاربر میتواند سفارشی را برای انجام در زمانی دیرتر از زمان حال ثبت کند. |
فیلد Union fulfillment_duration_options . مدت زمان انجام سفارش از زمان تأیید سفارش. برای سفارشهای تحویل، مدت زمان تا تحویل غذا. برای سفارشهای تحویل، مدت زمان تا آماده شدن غذا برای تحویل. fulfillment_duration_options فقط میتواند یکی از موارد زیر باشد: | |
fulfillmentLeadTimeDuration | مدت زمان ثابت. مثلاً: ۳۰ دقیقه. مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' |
fulfillmentLeadTimeDurationRange | طیف وسیعی از مدت زمان. مثالها: * ۳۰ دقیقه تا ۴۵ دقیقه * بیشتر از ۳۰ دقیقه * کمتر از ۵۰ دقیقه |
جزئیات هزینه
جزئیات شهریه.
| نمایش JSON |
|---|
{ "type": enum ( |
| فیلدها | |
|---|---|
type | نوع هزینه (الزامی) |
feeAmount | مبلغ هزینه یا به واحد پول، درصدی از ارزش سبد خرید یا ترکیبی از هر دو. (الزامی) |
نوع هزینه
نوع کارمزد.
| انومها | |
|---|---|
FEE_TYPE_UNSPECIFIED | نوع هزینه مشخص نیست |
DELIVERY | برای هزینه های تحویل. |
SERVICE | برای هزینه خدمات. |
مبلغ کارمزد
نمونههایی FeeAmount : * کارمزد ثابت: 0 دلار آمریکا (بدون کارمزد)، 1.5 دلار آمریکا * محدوده کارمزد ثابت: 1.0 دلار آمریکا (حداقل)، 3.0 دلار آمریکا (حداکثر)، 5.0-6.0 دلار آمریکا * درصد اندازه سبد خرید: 15.5٪، 10٪-20٪، 10٪ (حداقل)، 15٪ (حداکثر) * ترکیب محدوده و درصد: 25.5٪ و 2.5 دلار آمریکا (حداقل)، 25.5٪ و 4.5 دلار آمریکا (حداکثر)، 10٪ و 1.5-2.5 دلار آمریکا، 10.5٪-20٪ و 2.5-3.5 دلار آمریکا
| نمایش JSON |
|---|
{ "cartPercentage": { object ( |
| فیلدها | |
|---|---|
cartPercentage | هزینه بر اساس درصد از ارزش سبد خرید. از یک محدوده (محدود و نامحدود) یا درصد ثابت پشتیبانی میکند. مقدار باید بین 0 تا 100 باشد. مثالها: * ثابت 5.5٪ * حداقل 5.5٪ * حداکثر 5.5٪ * 4.5٪ تا 5.5٪ |
فیلد union amount_options . گزینههایی برای تعیین مبلغ پولی. amount_options فقط میتواند یکی از موارد زیر باشد: | |
amount | مبلغ ثابت. مثلاً ۳.۵ دلار آمریکا. |
amountRange | محدوده مبلغ. مثالها: * ۳.۵ تا ۵.۵ دلار آمریکا * حداقل ۳.۵ دلار آمریکا * حداکثر ۵.۵ دلار آمریکا |
amountUnknown | مبلغ نامعلوم. |
پول
نشان دهنده مقدار پول به همراه نوع ارز آن است.
| نمایش JSON |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| فیلدها | |
|---|---|
currencyCode | کد ارزی سه حرفی که در استاندارد ISO 4217 تعریف شده است. |
units | کل واحدهای مبلغ. برای مثال اگر |
nanos | تعداد نانو (10^-9) واحد از مبلغ. مقدار باید بین -999,999,999 و +999,999,999 باشد. اگر |
مانی رنج
یک پوشش برای طیف وسیعی از مبالغ پولی که میتواند محدود یا نامحدود باشد. حداقل یکی از minAmount و maxAmount مورد نیاز است.
| نمایش JSON |
|---|
{ "minAmount": { object ( |
| فیلدها | |
|---|---|
minAmount | حداقل مقدار. |
maxAmount | حداکثر مقدار. |
مقدار کمی
پوششی برای یک مقدار عددی که میتواند یک محدوده یا یک مقدار ثابت باشد. مثالهای QuantitativeValue : * مقدار مفرد: value: 10.5 * محدوده محدود: valueRange {minValue: 5.5, maxValue 10.5} * حد پایین: valueRange {minValue: 5.5} * حد بالا: valueRange {maxValue: 10.5}
| نمایش JSON |
|---|
{ // Union field |
| فیلدها | |
|---|---|
فیلد union value_options . (الزامی) value_options فقط میتواند یکی از موارد زیر باشد: | |
value | یک مقدار مفرد. به عنوان مثال: ۵.۶ |
valueRange | طیفی از مقادیر که میتوانند باز یا محدود نیز باشند. مثالها: * حداقل ۵.۵ * حداکثر ۵.۵ * ۵.۵ تا ۶.۵ |
محدودهمقدار
محدودهای از مقادیر به طوری که minValue < maxValue . حداقل به یکی از minValue و maxValue نیاز دارد.
| نمایش JSON |
|---|
{ "minValue": number, "maxValue": number } |
| فیلدها | |
|---|---|
minValue | حداقل مقدار. |
maxValue | حداکثر مقدار. |
محدوده مدت زمان
یک پوشش برای بازه زمانی که میتواند محدود یا نامحدود باشد. حداقل یکی از مدت زمانهای minDuration و maxDuration مورد نیاز است.
| نمایش JSON |
|---|
{ "minDuration": string, "maxDuration": string } |
| فیلدها | |
|---|---|
minDuration | حداقل مدت زمان. مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' |
maxDuration | حداکثر مدت زمان. مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' |
جزئیات سفارش پیشرفته
برای پشتیبانی قبل از سفارش.
| نمایش JSON |
|---|
{ "isSupported": boolean } |
| فیلدها | |
|---|---|
isSupported | اگر سفارشهای پیشرفته، که با نام سفارش پیشاپیش نیز شناخته میشوند، پشتیبانی شوند، صحیح است. (الزامی) |
فراداده رویداد
اطلاعات تکمیلی در مورد لینک اکشن که مختص بخش رویدادها است.
| نمایش JSON |
|---|
{
"surface": enum ( |
| فیلدها | |
|---|---|
surface | سطح رویداد از پیش تعیینشده مرتبط با یک لینک اقدام. این فقط برای رویدادهای عمودی استفاده میشود. |
سطح
سطح رویداد از پیش تعیینشده مرتبط با یک لینک اقدام. این فقط برای رویدادهای عمودی استفاده میشود.
| انومها | |
|---|---|
SURFACE_UNSPECIFIED | سطح نامشخص است. |
SURFACE_SEARCH | لینک اقدام، رزرو بلیط رویداد در جستجو است. |
SURFACE_YOUTUBE | لینک اقدام، رزرو بلیط رویداد در یوتیوب است. |
SURFACE_ADS | لینک اقدام، کلیک روی تبلیغی برای رویداد است. |