- نمایندگی JSON
- ActionPlatform
- ActionLinkType
- OrderOnline Metadata
- FulfillmentOption
- نوع تحقق
- روز در دسترس
- تاریخ
- FeeDetails
- NoFee
- حداقل هزینه
- فیکس فیکس
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- پول
- Money Range
- مقدار کمی
- RangeValue
- محدوده مدت
- AdvanceOrderDetails
- Metadata رویداد
- سطح
یک URL اقدام با زبان مرتبط، فهرست کشورهای محدود شده و پلت فرم اختیاری که نشان میدهد این اقدام در کدام پلتفرم باید انجام شود.
نمایندگی JSON |
---|
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( |
فیلدها | |
---|---|
url | نشانی وب نقطه ورودی برای این پیوند اقدام. |
language | برچسب زبان BCP-47 که زبانی را که محتوای این URI در آن موجود است مشخص می کند. |
restricted Country[] | کد کشور ISO 3166-1 آلفا-2. برای دید نامحدود خالی بگذارید. |
platform | پلتفرمی که این عمل باید روی آن انجام شود. اگر این فیلد تنظیم نشده باشد، ACTION_PLATFORM_WEB_APPLICATION به عنوان بازگشتی استفاده خواهد شد. |
action Link Type | نوع عمل از پیش تعیین شده |
order Online Metadata | فوق داده برای پیوند سفارش آنلاین. از عملکرد با ActionLinkType از ACTION_LINK_TYPE_SHOP_ONLINE پشتیبانی می کند. |
food Ordering Metadata | پیوندهای فوق داده برای سفارش غذا. از نوع عملکرد پشتیبانی میکند: * |
event Metadata | اطلاعات اضافی درباره پیوند اقدام که منحصر به رویدادهای عمودی است. |
ActionPlatform
پلتفرمی که عمل روی آن انجام می شود. برنامه وب یک بازگشت عمومی است. توصیه می شود حداقل یک ActionLink با ACTION_PLATFORM_WEB_APPLICATION داشته باشید. پیوندهایی با اندروید و iOS به عنوان پلتفرم فقط در سیستم مربوطه استفاده می شود.
Enums | |
---|---|
ACTION_PLATFORM_UNSPECIFIED | پلت فرم نامشخص است. |
ACTION_PLATFORM_WEB_APPLICATION | پلتفرم اکشن به طور کلی وب است. |
ACTION_PLATFORM_MOBILE_WEB | پلت فرم اکشن وب روی دستگاه های تلفن همراه است. |
ACTION_PLATFORM_ANDROID | پلتفرم اکشن سیستم عامل اندروید است. |
ACTION_PLATFORM_IOS | پلتفرم اکشن iOS است. |
ActionLinkType
نوع عمل از پیش تعیین شده مرتبط با پیوند اقدام.
Enums | |
---|---|
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 | نوع پیوند اقدام سفارش برای خرید است، می تواند تحویل یا تحویل یا هر دو باشد. |
OrderOnline Metadata
ابرداده برای پیوند اقدام آنلاین سفارش.
نمایندگی JSON |
---|
{
"fulfillmentOption": [
{
object ( |
فیلدها | |
---|---|
fulfillment Option[] | گزینه های انجام موجود برای پیوند اقدام آنلاین سفارش. |
FulfillmentOption
گزینه انجام برای پیوند اقدام آنلاین سفارش.
نمایندگی JSON |
---|
{ "fulfillmentType": enum ( |
فیلدها | |
---|---|
fulfillment Type | مورد نیاز. نوع تحقق |
available Day[] | مورد نیاز. فهرستی از روزهایی که برای این روش تکمیلی در دسترس است (ترجیحاً حداقل 2). |
fee Details | مورد نیاز. جزئیات هزینه برای روش تکمیل. |
minimum Order | مورد نیاز. حداقل سفارش برای روش انجام مرتبط با پیوند اقدام. |
نوع تحقق
نوع انجام مرتبط با پیوند اقدام.
Enums | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED | نوع تحقق نامشخص است. |
FULFILLMENT_TYPE_DELIVERY | نوع انجام تحویل است. |
FULFILLMENT_TYPE_PICKUP | نوع تکمیل پیکاپ است. |
روز در دسترس
در دسترس بودن سطح روز
نمایندگی JSON |
---|
{
"fulfillmentDate": {
object ( |
فیلدها | |
---|---|
fulfillment Date | مورد نیاز. تاریخ در دسترس برای یک روش تحقق. فرض بر این است که در منطقه زمانی تاجر است. |
last Ordering Time | مورد نیاز. مهر زمانی یونیکس آخرین باری که کاربر میتوانست سفارش دهد و اقلام را تا به عنوان مثال، اگر تاریخ تکمیل 10-08-2020 باشد: - مقدار lastOrderingTime 2020-08-10 ساعت 18:00 به این معنی است که برای دریافت سفارش خود در 10-08-2020، مشتری باید آن سفارش را تا ساعت 6 بعد از ظهر انجام دهد. همان روز - مقدار lastOrderingTime 2020-08-08 ساعت 20:00 به این معنی است که برای دریافت سفارش خود در تاریخ 10-08-2020، مشتری باید آن سفارش را تا ساعت 8 بعد از ظهر دو روز قبل انجام دهد. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
تاریخ
نمایانگر یک تاریخ تقویم کامل یا جزئی، مانند روز تولد است. زمان روز و منطقه زمانی یا در جای دیگری مشخص شده است یا ناچیز است. تاریخ مربوط به تقویم میلادی است. این می تواند نشان دهنده یکی از موارد زیر باشد:
- تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر.
- یک ماه و روز، با یک سال صفر (مثلاً یک سالگرد).
- یک سال به تنهایی، با یک ماه صفر و یک روز صفر.
- یک سال و یک ماه، با روز صفر (مثلاً تاریخ انقضای کارت اعتباری).
انواع مرتبط:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
نمایندگی JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
فیلدها | |
---|---|
year | سال تاریخ. برای تعیین تاریخ بدون سال باید از 1 تا 9999 یا 0 باشد. |
month | ماه از یک سال. باید از 1 تا 12 یا 0 باشد تا یک سال بدون ماه و روز مشخص شود. |
day | روز یک ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا 0 برای مشخص کردن یک سال به تنهایی یا یک سال و ماهی که در آن روز مهم نیست، معتبر باشد. |
FeeDetails
جزئیات کارمزد روش تکمیل مرتبط با پیوند اقدام.
نمایندگی JSON |
---|
{ // Union field |
فیلدها | |
---|---|
فیلد اتحادیه فیلد fee_details . مدل کارمزد برای روش تحقق. fee_details فقط می تواند یکی از موارد زیر باشد: | |
no Fee | بدون هزینه برای روش انجام. |
base Fee | هزینه پایه مرتبط با روش تکمیل. |
fixed Fee | هزینه ثابت مرتبط با روش انجام. |
NoFee
این نوع هیچ فیلدی ندارد.
هیچ هزینه ای برای روش انجام مرتبط با پیوند اقدام لازم نیست.
حداقل هزینه
حداقل هزینه مورد نیاز برای روش انجام مرتبط با پیوند اقدام.
نمایندگی JSON |
---|
{
"baseFeeAmount": {
object ( |
فیلدها | |
---|---|
base Fee Amount | مورد نیاز. مبلغ کارمزد پایه برای روش انجام. |
فیکس فیکس
هزینه ثابت مورد نیاز برای روش انجام مرتبط با پیوند اقدام.
نمایندگی JSON |
---|
{
"amount": {
object ( |
فیلدها | |
---|---|
amount | مورد نیاز. مبلغ حق الزحمه ثابت روش انجام. |
Food OrderingMetadata
متادیتا برای پیوندهای اقدام سفارش غذا.
نمایندگی JSON |
---|
{ "feeDetails": [ { object ( |
فیلدها | |
---|---|
fee Details[] | جزئیات هزینه هایی که از کاربر در بالای کل کالا دریافت می شود. برای انواع مختلف هزینه ها مانند هزینه خدمات، هزینه تحویل و غیره تکرار می شود. |
advance Order Details | جزئیات مربوط به پشتیبانی پیشرفته سفارش که به عنوان سفارش پیشرو نیز شناخته میشود، که در آن کاربر میتواند سفارشی را برای انجام در زمانی دیرتر از اکنون ثبت کند. |
fulfillment_duration_options فیلد اتحادیه. مدت زمان انجام سفارش از زمان تایید سفارش. برای سفارشات تحویل، مدت زمان تا تحویل غذا. برای سفارشات پیکاپ، مدت زمان تا آماده شدن غذا برای تحویل گرفتن. fulfillment_duration_options فقط می تواند یکی از موارد زیر باشد: | |
fulfillment Lead Time Duration | مدت زمان ثابت به عنوان مثال: 30 دقیقه مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' |
fulfillment Lead Time Duration Range | محدوده ای از مدت زمان. مثال ها: * 30 دقیقه تا 45 دقیقه * بیشتر از 30 دقیقه * کمتر از 50 دقیقه |
FeeDetails
جزئیات هزینه
نمایندگی JSON |
---|
{ "type": enum ( |
فیلدها | |
---|---|
type | نوع کارمزد (الزامی) |
fee Amount | مبلغ کارمزد به واحد ارز، درصدی از ارزش سبد خرید یا ترکیبی از هر دو. (الزامی) |
FeeType
نوع کارمزد
Enums | |
---|---|
FEE_TYPE_UNSPECIFIED | نوع کارمزد مشخص نشده است. |
DELIVERY | برای هزینه های تحویل. |
SERVICE | برای هزینه خدمات. |
FeeAmount
نمونههای FeeAmount
: * کارمزد ثابت: 0 USD (بدون کارمزد)، 1.5 USD * محدوده کارمزد ثابت: 1.0 USD (حداقل)، 3.0 USD (حداکثر)، 5.0-6.0 USD * درصد اندازه سبد خرید: 15.5٪، 10٪ 20٪، 10٪ (حداقل)، 15٪ (حداکثر) * ترکیب دامنه و درصد: 25.5٪ و 2.5 دلار (حداقل)، 25.5٪ و 4.5 دلار (حداکثر)، 10٪ و USD 1.5-2.5، 10.5٪ - USD 20٪ و دلار 2.5-3.5
نمایندگی JSON |
---|
{ "cartPercentage": { object ( |
فیلدها | |
---|---|
cart Percentage | کارمزد بر حسب درصدی از ارزش سبد خرید. از یک محدوده (محدود و نامحدود) یا یک درصد ثابت پشتیبانی می کند. مقدار باید بین 0 تا 100 باشد. مثالها: * ثابت 5.5٪ * حداقل 5.5٪ * حداکثر 5.5٪ * 4.5٪ تا 5.5٪ |
amount_options فیلد اتحادیه. گزینه هایی برای تعیین مقدار پولی amount_options فقط می تواند یکی از موارد زیر باشد: | |
amount | مبلغ ثابت به عنوان مثال USD 3.5. |
amount Range | محدوده مقدار. مثال: * 3.5 تا 5.5 دلار * حداقل 3.5 دلار * حداکثر 5.5 دلار |
amount Unknown | مقدار نامعلوم |
پول
مقداری پول را با نوع ارز آن نشان می دهد.
نمایندگی JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
فیلدها | |
---|---|
currency Code | کد ارز سه حرفی تعریف شده در ISO 4217. |
units | کل واحدهای مقدار. به عنوان مثال، اگر |
nanos | تعداد نانو (10^-9) واحد مقدار. مقدار باید بین -999,999,999 و +999,999,999 باشد. اگر |
Money Range
لفاف برای محدوده ای از مقدار پولی که می تواند محدود یا نامحدود باشد. حداقل یکی از minAmount و maxAmount مورد نیاز است.
نمایندگی JSON |
---|
{ "minAmount": { object ( |
فیلدها | |
---|---|
min Amount | حداقل مقدار. |
max Amount | حداکثر مقدار. |
مقدار کمی
بسته بندی برای یک مقدار عددی که می تواند یک محدوده یا یک مقدار ثابت باشد. نمونههای QuantitativeValue
: * مقدار واحد: value: 10.5
* محدوده محدود: valueRange {minValue: 5.5, maxValue 10.5}
* کران پایین: valueRange {minValue: 5.5}
* کران بالا: valueRange {maxValue: 10.5}
نمایندگی JSON |
---|
{ // Union field |
فیلدها | |
---|---|
فیلد اتحادیه value_options . (ضروری) value_options فقط می تواند یکی از موارد زیر باشد: | |
value | یک مقدار منفرد. به عنوان مثال: 5.6 |
value Range | محدوده ای از مقادیر که می تواند با پایان باز یا محدود نیز باشد. مثال: * حداقل 5.5 * حداکثر 5.5 * 5.5 تا 6.5 |
RangeValue
محدوده مقادیر به گونه ای که minValue
< maxValue
. به حداقل یکی از minValue
و maxValue
نیاز دارد.
نمایندگی JSON |
---|
{ "minValue": number, "maxValue": number } |
فیلدها | |
---|---|
min Value | حداقل ارزش. |
max Value | حداکثر مقدار. |
محدوده مدت
لفاف برای محدوده ای از مدت زمان که می تواند محدود یا بدون محدودیت باشد. حداقل یکی از minDuration و maxDuration duration مورد نیاز است.
نمایندگی JSON |
---|
{ "minDuration": string, "maxDuration": string } |
فیلدها | |
---|---|
min Duration | حداقل مدت. مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' |
max Duration | حداکثر مدت. مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' |
AdvanceOrderDetails
برای سفارش از قبل پشتیبانی
نمایندگی JSON |
---|
{ "isSupported": boolean } |
فیلدها | |
---|---|
is Supported | درست است اگر سفارشهای پیشفرض، که به عنوان سفارش پیشرو نیز شناخته میشود، پشتیبانی شود. (الزامی) |
Metadata رویداد
اطلاعات اضافی درباره پیوند اقدام که منحصر به رویدادهای عمودی است.
نمایندگی JSON |
---|
{
"surface": enum ( |
فیلدها | |
---|---|
surface | سطح رویداد از پیش تعیین شده مرتبط با پیوند اقدام. این فقط برای رویدادهای عمودی استفاده می شود. |
سطح
سطح رویداد از پیش تعیین شده مرتبط با پیوند اقدام. این فقط برای رویدادهای عمودی استفاده می شود.
Enums | |
---|---|
SURFACE_UNSPECIFIED | سطح نامشخص است. |
SURFACE_SEARCH | پیوند اقدام، رزرو بلیط رویداد در جستجو است. |
SURFACE_YOUTUBE | پیوند اقدام، رزرو بلیط رویداد در YouTube است. |
SURFACE_ADS | پیوند اکشن روی تبلیغی برای رویداد کلیک می کند. |