- منبع: خدمات
- تفسیر قیمت
- قوانین زمانبندی
- سیاست پذیرش
- سیاست لغو
- شرایط بازپرداخت
- نوع پیش پرداخت
- شرایط پیش پرداخت
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- نوع فیلد
- نوع سرویس
- TicketType
- هزینه بلیط
- رسانه های مرتبط
- MediaType
- انتساب
- ServiceAttributeValueId
- قوانین فهرست انتظار
- UnsupportedPartySizeOption
- Call Merchant
- TicketingVerticalSpecificData
- دسته رویداد
- موجودیت
- EntityType
- EntityRole
- PublicIdentificationData
- حالت حضور و غیاب
- OrganizerType
- EventState
- IntegrationType
- PerOrderFee
- محتوای تورها و فعالیت ها
- مکان
- نوع مکان
- رتبه بندی
- HomeServiceData
- جلسه مجازی
- VirtualPlatformInfo
- پلت فرم
- DirectMerchantPayment
- روش ها
منبع: خدمات
اطلاعات مربوط به خدماتی که توسط تاجر ارائه می شود، به عنوان مثال، کوتاه کردن مو.
نمایندگی JSON |
---|
{ "name": string, "serviceName": string, "localizedServiceName": { object ( |
فیلدها | |
---|---|
name | نام منبع سرویس، که دارای قالب |
serviceName | نام سرویس، به عنوان مثال "مدل موی مردانه". منسوخ شده است، به جای آن از localizedServiceName استفاده کنید. |
localizedServiceName | نام سرویس، به عنوان مثال "مدل موی مردانه". احتمالاً در چندین منطقه. |
description | شرح خدمات قابل مشاهده توسط کاربر. منسوخ شده است، به جای آن از localizedDescription استفاده کنید. |
localizedDescription | شرح خدمات قابل مشاهده توسط کاربر. این فیلد از قالب بندی متن ساده و HTML مانند پشتیبانی می کند. برخلاف بخشهای متن ساده، طرحبندیهای سفارشیشده را میتوان با استفاده از سرفصلها، پاراگرافها، فهرستها و برخی برچسبهای عبارت در اینجا ایجاد کرد. لطفاً دستورالعمل ها و یادداشت های زیر را به دقت بخوانید تا مطمئن شوید که بهترین تجربه کاربری را ایجاد می کنید. برچسبهای قالببندی HTML پشتیبانی شده: تگ های عنوان: <h1>، <h2>، <h3>، <h4>، <h5>، <h6> برچسب پاراگراف: <p> برچسب های لیست: <ul>، <ol>، <li> تگ تقسیم: <div> برچسبهای عبارت: <br>، <strong>، <em>: برچسب های پشتیبانی نشده:
نکات مهم:
|
price | قیمت خدمات. |
priceInterpretation | نحوه تفسیر و نمایش قیمت به کاربر را شرح می دهد. می تواند توسط هر عمودی به جز Dining و Things To Do برای پیکربندی نمایش قیمت خدمات استفاده شود. |
rules | قوانین رزرو/لغو قرار ملاقات |
prepaymentType | اینکه آیا پیش پرداخت لازم است، اختیاری است یا پشتیبانی نمی شود. |
prepaymentTerms | شرایط زمانی که پیش پرداخت تکمیل می شود. |
form[] | منسوخ شده است. لطفا از intakeForm و perTicketIntakeForm استفاده کنید. |
intakeForm | فرمی که هنگام رزرو این سرویس از کاربر اطلاعات بیشتری درخواست می کند. (اختیاری) |
perTicketIntakeForm | فرمی که هنگام رزرو این سرویس از کاربر اطلاعات بیشتری درخواست می کند. این فرم باید برای هر بلیطی که کاربر رزرو می کند یک بار پر شود. (اختیاری) |
taxRate | نرخ مالیات این سرویس در صورت وجود، این فیلد بر هر نرخ مالیاتی تنظیم شده در سطح تاجر لغو می شود. یک پیام خالی (یعنی taxRate { }) نرخ مالیات اعمال شده را به صفر بازنشانی می کند. |
paymentOptionId[] | فهرستی از شناسهها که به گزینههای پرداختی که میتوان برای پرداخت این سرویس استفاده کرد اشاره دارد. گزینههای پرداخت واقعی در سطح Merchant تعریف میشوند، و همچنین میتوانند بین چندین تاجر به اشتراک گذاشته شوند. |
deposit | نحوه پرداخت وجه از کاربر را مشخص می کند. در صورت مشخص بودن واریز خدمات لغو می شود. تنظیم این پیام بر روی یک پیام سپرده خالی، هرگونه واریز در سطح خدمات را حذف می کند. (اختیاری) |
noShowFee | هزینه عدم نمایش را تعریف می کند که ممکن است از کاربر دریافت شود. در صورتی که مشخص شده بود، سرویس بدون هزینه نمایش را لغو می کند. تنظیم این پیام بر روی یک پیام NoShowFee خالی، هزینه بدون نمایش در سطح سرویس را حذف می کند. (اختیاری) |
requireCreditCard | نشان می دهد که آیا کاربر برای رزرو این سرویس باید کارت اعتباری ارائه دهد یا خیر. این فیلد را می توان در سطح در دسترس بودن لغو کرد. (اختیاری) |
actionLink[] | لینک اقدام مربوط به این سرویس. اگر پیوند اقدام وجود دارد، نوع (به زیر مراجعه کنید) باید در سرویس تنظیم شود. |
type | نوع از پیش تعریف شده این سرویس. (اختیاری) |
ticketType[] | انواع بلیط های قابل رزرو/خرید برای این سرویس، در صورت پشتیبانی از بلیط. (اختیاری) |
relatedMedia[] | عکس های مربوط به این سرویس Google رسانهها را میخزد و ذخیره میکند تا مطمئن شود که به کارآمدترین روش برای کاربران نهایی نمایش داده میشوند. (اختیاری) |
serviceAttributeValueId[] | مقادیر ویژگی سرویس که برای این سرویس اعمال می شود (اختیاری). هر سرویس ممکن است مقادیر صفر یا بیشتر برای هر ویژگی سرویس تعریف شده در Merchant مربوطه داشته باشد. (اختیاری) |
waitlistRules | قوانین پیوستن به لیست انتظار |
ticketingVerticalSpecificData | اطلاعات اضافی منحصر به فرد برای رویداد عمودی بلیط. (اختیاری) |
integrationType | عمق ادغام ما برای این سرویس پشتیبانی می کنیم. (اختیاری) برای شرکای دارای ادغام شروع کننده نامربوط است. پایان به انتها همیشه برای این شرکا غیرفعال خواهد بود. |
perOrderFee | برای خرید این سرویس هزینه های سطح سفارش دهید. (اختیاری) |
toursAndActivitiesContent | فیلدهای محتوای خاص تورها و فعالیت ها. |
location[] | مکان های مرتبط با این سرویس نکات مهم: اگر چندین مکان بازدید شده مرتبط با این سرویس وجود دارد، یا START_LOCATION با VISITED_LOCATION متفاوت است، START_LOCATION باید مشخص شود. مثال: - یک تور دوچرخه سواری با راهنما که از سه مکان بازدید می کند، محل شروع باید مشخص شود. - یک جلسه تور اتوبوس در لابی هتل و سپس رفتن به محل بازدید. مکان جلسه باید مشخص شود. |
rating | رتبهبندی کاربر برای این سرویس بهعنوان یک معیار مجموع در همه مرورها. |
homeServiceData | اطلاعات اضافی منحصر به فرد برای خدمات خانگی عمودی. (اختیاری) |
virtualSession | اختیاری. اطلاعات در مورد جلسه مجازی برای فعال کردن خدمات مجازی مورد نیاز است. |
directMerchantPayment | اختیاری. اطلاعات اضافی که در صورت نیاز کاربر به پرداخت مستقیم به تاجر، باید اضافه شود. نکته مهم: RwG در این تراکنش دخیل نیست. اگر virtualSession تعریف شده باشد و سرویس رایگان نباشد یا PrepaymentType روی REQUIRED تنظیم نشده باشد، لازم است. |
تفسیر قیمت
توضیح می دهد که چگونه یک قیمت باید تفسیر و به کاربر نمایش داده شود.
Enums | |
---|---|
PRICE_INTERPRETATION_UNSPECIFIED | تفسیر قیمت مشخص نشده است، پیشفرض EXACT_AMOUNT است. |
EXACT_AMOUNT | زمانی که قیمت باید به عنوان یک ارزش خاص تفسیر شود. مثال: 20 دلار برای کلاس یوگا. 15 دلار برای کوتاه کردن موی کودک |
STARTS_AT | زمانی که قیمت یک سرویس متغیر است اما حداقل قیمت شناخته شده و به مصرف کنندگان نمایش داده می شود. مصرف کنندگان ممکن است انتخاب هایی داشته باشند که قیمت را افزایش دهد. توجه داشته باشید که هر سرویسی که از این تفسیر قیمت استفاده میکند باید از PrepaymentType NOT_SUPPORTED استفاده کند. مثال ها: 30 دلار برای نظافت سگ، اما انتخاب های اضافی مصرف کننده ممکن است قیمت را افزایش دهد |
NOT_DISPLAYED | زمانی که قیمت یک سرویس متغیر است و هیچ اطلاعات قیمتی از قبل به مصرف کنندگان نمایش داده نمی شود. توجه داشته باشید که هر سرویسی که از این PriceInterpretation استفاده میکند باید از PrepaymentType NOT_SUPPORTED استفاده کند و قیمت باید خالی باشد. مثال: مشاوره برای خدمات خانگی |
قوانین زمانبندی
قوانین زمانبندی برای یک سرویس
نمایندگی JSON |
---|
{ "minAdvanceOnlineCanceling": string, "lateCancellationFee": { object ( |
فیلدها | |
---|---|
minAdvanceOnlineCanceling | حداقل اخطار قبلی در چند ثانیه مورد نیاز برای لغو قرار آنلاین رزرو شده. (اختیاری) |
lateCancellationFee | هزینه انصراف در حداقل دوره اطلاع قبلی. |
noshowFee | هزینه عدم نمایش بدون لغو. |
admissionPolicy | خط مشی پذیرش که برای این سرویس اعمال می شود. اگر تنظیم نشود، پیشفرض TIME_STRICT است. (اختیاری) |
cancellationPolicy | خط مشی لغو قوانین برنامه ریزی (برای کارهایی که باید انجام دهید لازم است) |
فیلد اتحادیه اگر "min_advance_booking" تنظیم شده باشد، آخرین زمان قابل رزرو به صورت (<slot start time> - "min_advance_booking") محاسبه می شود. اگر "min_booking_buffer_before_end_time" تنظیم شده باشد، آخرین زمان قابل رزرو به صورت (<زمان پایان اسلات> - "min_booking_buffer_before_end_time" محاسبه می شود. توجه داشته باشید که مقدار "min_booking_buffer_before_end_time" در صورت تنظیم باید مثبت باشد. اگر هر دو تنظیم نشده باشند، اسلات تا زمان شروع اسلات قابل رزرو است. اگر هر دو فیلد تنظیم شده باشند، فقط یک مقدار انتخاب می شود در حالی که مقدار دیگر نادیده گرفته می شود - ما نمی توانیم به طور قابل اعتماد پیش بینی کنیم که کدام مقدار انتخاب شده است. مثال ها:
| |
minAdvanceBooking | مدت زمان (بر حسب ثانیه) از زمانی که می توان آخرین رزرو را انجام داد تا زمانی که اسلات در دسترس بودن شروع می شود. |
minBookingBufferBeforeEndTime | مدت زمان (بر حسب ثانیه) از زمانی که می توان آخرین رزرو را انجام داد تا زمانی که شکاف دسترسی به پایان می رسد. اگر این فیلد تنظیم شده باشد، قسمت "admissionPolicy" باید روی TIME_FLEXIBLE تنظیم شود تا نشان دهد که کاربران می توانند پس از شروع اسلات از بلیط های خریداری شده استفاده کنند. |
سیاست پذیرش
سیاست پذیرش این سرویس.
Enums | |
---|---|
ADMISSION_POLICY_UNSPECIFIED | استفاده نشده |
TIME_STRICT | مشتریان باید در زمان شروع شکاف در دسترس بودن حضور داشته باشند و انتظار میرود خدمات در زمان پایان شکاف به پایان برسد. نمونههایی از موارد استفاده TIME_STRICT: * توری که از ساعت 9 صبح شروع میشود و همه شرکتکنندگان را ملزم میکند در زمان شروع حضور داشته باشند و حدود ساعت 12 بعد از ظهر برمیگردند. * رزرو کوتاهی مو در ساعت 15 روز شنبه که تقریباً 30 دقیقه طول خواهد کشید. * کلاس تناسب اندام از ساعت 18 تا 20. |
TIME_FLEXIBLE | مشتریان می توانند در هر زمانی بین زمان شروع و پایان زمان در دسترس بودن برای استفاده از این رزرو حضور پیدا کنند. نمونه هایی از موارد استفاده TIME_FLEXIBLE: * بلیط موزه که در هر زمانی در تاریخ خرید می توان از آن استفاده کرد. * پذیرش بعد از ظهر به یک شهربازی که از ساعت 12 شب تا 9 شب قابل استفاده است. |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION | مشتریان باید در زمان شروع اسلات در دسترس بودن به تاجر برسند، اما میتوانند هر زمانی که بخواهند آنجا را ترک کنند. به عنوان مثال، در سناریوی پذیرش موزه، بلیط ورود به موقع برای ساعت 10 صبح، کاربر را ملزم می کند ساعت 10 صبح در موزه باشد. زمان شروع اسلات های موجود برای این سرویس نشان دهنده زمان ورود تعیین شده است. با این حال، زمان پایان صرفاً به عنوان کلیدی برای شناسایی جایگاه در دسترس بودن برای رزرو استفاده میشود. |
سیاست لغو
سیاست لغو برای یک سرویس.
نمایندگی JSON |
---|
{
"refundCondition": [
{
object ( |
فیلدها | |
---|---|
refundCondition[] | شرایط بازپرداخت صفر یا بیشتر مربوط به سیاست. |
شرایط بازپرداخت
یک شرط بازپرداخت واحد را تعریف می کند. شرایط بازپرداخت چندگانه را می توان با هم برای توصیف "مراحل بازپرداخت" به عنوان دوره های مختلف قبل از زمان شروع سرویس استفاده کرد.
نمایندگی JSON |
---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
فیلدها | |
---|---|
minDurationBeforeStartTime | مدت زمان قبل از زمان شروع، تا زمانی که مشتری بتواند بخشی از هزینه خدمات مشخص شده در مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' |
refundPercent | درصد قابل بازپرداخت، تا زمانی که رزرو سرویس حداقل |
نوع پیش پرداخت
Enum برای نشان دادن نوع پیش پرداخت.
Enums | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED | بهطور پیشفرض فرض میکنیم که پیشپرداخت NOT_SUPPORTED است. |
REQUIRED | کاربر باید در زمان رزرو این سرویس را پرداخت کند. |
OPTIONAL | کاربر می تواند انتخاب کند که این سرویس را در زمان رزرو یا بعد از آن پیش پرداخت کند، اما برای رزرو الزامی نیست. |
NOT_SUPPORTED | پیش پرداخت برای این سرویس پشتیبانی نمی شود. |
شرایط پیش پرداخت
اطلاعات خاص در مورد زمان تکمیل پیش پرداخت.
نمایندگی JSON |
---|
{
"chargeTiming": enum ( |
فیلدها | |
---|---|
chargeTiming | زمانی که شارژ نسبت به زمان خرید اتفاق می افتد. |
chargeTimeBeforeStartTimeSec | زمان بر حسب ثانیه قبل از زمان شروع سرویس که هزینه پرداخت از کاربر دریافت می شود. این فیلد فقط زمانی باید تنظیم شود که ChargeTiming CHARGE_LATER باشد. |
ChargeTiming
Enum برای تعیین زمان شارژ نسبت به زمان خرید.
Enums | |
---|---|
CHARGE_TIMING_UNSPECIFIED | استفاده نشده |
CHARGE_NOW | مشتری بلافاصله شارژ می شود. |
CHARGE_LATER | بعداً هزینه مشتری دریافت می شود. |
ServiceIntakeForm
فرم دریافتی را تعریف می کند که خدمات ارائه شده توسط یک تاجر را سفارشی می کند.
نمایندگی JSON |
---|
{
"field": [
{
object ( |
فیلدها | |
---|---|
field[] | فیلدهایی که به کاربر نمایش داده می شود. |
firstTimeCustomers | اگر درست باشد، این فرم برای اولین بار به مشتریان نشان داده می شود. منسوخ شده است. این عملکرد برای فرم های دریافت پشتیبانی نمی شود. |
returningCustomers | اگر درست باشد، این فرم به مشتریان مکرر نشان داده می شود. منسوخ شده است. این عملکرد برای فرم های دریافت پشتیبانی نمی شود. |
ServiceIntakeFormField
فیلدی را تعریف می کند که در ServiceIntakeForm گنجانده شده است.
نمایندگی JSON |
---|
{ "id": string, "type": enum ( |
فیلدها | |
---|---|
id | رشتهای از شریک جمعآوری که به طور منحصربهفرد یک فیلد فرم را شناسایی میکند. این شناسه باید همان شناسه در پاسخ فیلد فرم مربوطه باشد و باید هم در سطح خدمات و هم در فرم های دریافت بلیط منحصر به فرد باشد. (الزامی) |
type | نوع این رشته |
label | متنی که برای این فیلد به کاربر نشان داده می شود. منسوخ شده است، لطفاً به جای آن از |
localizedLabel | متنی که برای این فیلد به کاربر نشان داده می شود. فیلد را می توان در چندین منطقه ارائه کرد. (الزامی) |
value[] | اگر و فقط اگر نوع فیلد LOCATION_SEARCH باشد، تنظیم کنید. لطفاً از "locationId" در قسمت "location" برای تعیین مقدار مکان استفاده کنید. |
choiceText[] | اگر و فقط اگر نوع فیلد MULTIPLE_CHOICE، CHECKBOXES یا DROPDOWN باشد، تنظیم کنید. برای برشمردن گزینه های ممکن استفاده می شود. |
isRequired | نشان می دهد که آیا پاسخ به این فیلد توسط کاربر مورد نیاز است یا خیر. |
allowCustomAnswer | نشان می دهد که آیا یک مقدار سفارشی علاوه بر پاسخ های از پیش تعریف شده مجاز است یا خیر. این فقط زمانی قابل اعمال است که نوع فیلد LOCATION_SEARCH باشد. (اختیاری) |
additionalOption[] | گزینه های اضافی علاوه بر مقادیر ارائه شده ارائه شده است. فقط زمانی قابل اعمال است که نوع فیلد LOCATION_SEARCH باشد. به عنوان مثال، علاوه بر لیست مکان ارائه شده، یکی دیگر از گزینه های موجود می تواند "بعداً با تامین کننده تماس خواهم گرفت". (اختیاری) |
ticketTypeRestrict[] | اگر این سوال فقط زمانی نشان داده شود که کاربر انواع بلیط خاصی را رزرو می کند، این قسمت باید به عنوان مجموعه شناسه نوع بلیط قابل اجرا تنظیم شود. اگر سوال همیشه قابل اجرا است، فیلد را خالی بگذارید. |
hint | متن راهنمایی برای ورودی، که به عنوان یک مکان نگهدار متن نشان داده می شود. این فقط زمانی قابل اعمال است که نوع فیلد SHORT_ANSWER یا PARAGRAPH باشد. (اختیاری) |
نوع فیلد
Enum برای نشان دادن نوع فیلد.
Enums | |
---|---|
FIELD_TYPE_UNSPECIFIED | فیلدهایی از نوع نامشخص یا ناشناخته نادیده گرفته خواهند شد. |
SHORT_ANSWER | یک فیلد ورودی یک خطی برای متن. |
PARAGRAPH | یک فیلد ورودی چند خطی برای متن. |
MULTIPLE_CHOICE | مجموعه ای از دکمه های رادیویی که نیاز به یک انتخاب از بین گزینه های متعدد دارد. |
CHECKBOXES | یک یا چند مورد شمارش شده با کادرهای تأیید. |
DROPDOWN | انتخابی از یک کشویی |
BOOLEAN | یک دکمه بله/خیر |
LOCATION_SEARCH | یک کادر جستجو که از یافتن مکان منطبق با ورودی کاربر از لیست مکان ارائه شده پشتیبانی می کند. |
نوع سرویس
انواع خدمات از پیش تعریف شده
Enums | |
---|---|
SERVICE_TYPE_UNSPECIFIED | استفاده نشده |
SERVICE_TYPE_DINING_RESERVATION | رزرو غذا. |
SERVICE_TYPE_FOOD_ORDERING | سفارش غذا، میتواند تحویل غذا باشد یا تحویل غذا یا هر دو. |
SERVICE_TYPE_FOOD_DELIVERY | تحویل غذا. |
SERVICE_TYPE_FOOD_TAKEOUT | بیرون آوردن غذا |
SERVICE_TYPE_EVENT_TICKET | بلیط رویداد. |
SERVICE_TYPE_TRIP_TOUR | تور سفر. |
SERVICE_TYPE_APPOINTMENT | خدماتی که قرار ملاقات ها یا کلاس ها را ارائه می دهد. برای (1) سلامت و تناسب اندام، (2) آبگرم و زیبایی، و (3) خدمات مشاوره مالی و ارزیابی توصیه می شود. لطفاً انواع خدمات پشتیبانی شده را ببینید: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview |
SERVICE_TYPE_ONLINE_APPOINTMENT | سرویسی که به صورت آنلاین برای یک کلاس یا جلسه که کاملا مجازی خواهد بود قرار ملاقات می دهد. در صورت فعال کردن رزرو سرویس مجازی، باید تنظیم شود. |
SERVICE_TYPE_SHOPPING | سرویسی که به کاربران امکان خرید از تاجر داده شده را می دهد. این می تواند تحویل یا تحویل باشد. |
TicketType
TicketType برای تمایز بین بلیط هایی با قیمت ها و/یا در دسترس بودن متفاوت به دلیل انواع مختلف کاربر، ویژگی های خدمات مختلف، یا گزینه ها/افزونه های مختلف استفاده می شود.
بلیط حداقل واحد قابل رزرو برای یک سرویس است، به عنوان مثال، یک مکان در سفر رفتینگ، ورود به موزه، یک روز تمام روز اجاره کایاک دو نفره.
نمایندگی JSON |
---|
{ "ticketTypeId": string, "shortDescription": string, "localizedShortDescription": { object ( |
فیلدها | |
---|---|
ticketTypeId | شناسه بلیط برای تمایز بین انواع بلیط های مختلف یک سرویس استفاده می شود و تنها انتظار می رود که در یک سرویس منحصر به فرد باشد. |
shortDescription | توضیح کوتاهی برای این TicketType. این می تواند توسط کاربر قابل مشاهده باشد، به عنوان مثال، "بزرگسال"، "کودک"، "کهنه سرباز"، "ردیف J"، و غیره. لازم است، هر نوع بلیط باید دارای توضیحاتی باشد تا کاربر قابل مشاهده باشد. منسوخ شده است، به جای آن از localizedShortDescription استفاده کنید. |
localizedShortDescription | توضیح کوتاهی درباره این TicketType با پشتیبانی از i18n. این می تواند توسط کاربر قابل مشاهده باشد، به عنوان مثال، "بزرگسال"، "کودک"، "کهنه سرباز"، "ردیف J"، و غیره. لازم است، هر نوع بلیط باید دارای توضیحاتی باشد تا کاربر قابل مشاهده باشد. مقادیر جداگانه ای را می توان برای هر منطقه ارائه کرد. |
price | قیمت بلیط تک از این نوع، بدون هر گونه مالیات. نرخ مالیات خدمات بر بلیط های آن اعمال می شود. |
perTicketFee | هزینه های اضافی برای خرید این بلیط. (اختیاری) |
optionDescription | شرح هر گزینه اضافی که این نوع بلیط نشان دهنده آن است، در صورت وجود. منسوخ شده است، به جای آن از localizedOptionDescription استفاده کنید. |
localizedOptionDescription | شرح هر گزینه اضافی که این نوع بلیط نشان دهنده آن است، در صورت وجود. مقادیر جداگانه ای را می توان برای هر منطقه ارائه کرد. گزینه های اضافی زمانی مفید هستند که نوع بلیط نشان دهنده چند بعد باشد. مثال 1: بلیط ورودی با انواع مختلف "بزرگسال"، "کودک" و زبان به عنوان گزینه اضافی، لیست TicketType مورد انتظار این خواهد بود: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: " انگلیسی" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localized "Optionenglishion" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } } مثال 2: اجاره کایاک چند ساعته با افزودنی کیسه خشک اختیاری، shortDescription می تواند "3 ساعت" باشد و optionDescription می تواند "با کیسه خشک" یا "بدون کیسه خشک" باشد: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 ساعت" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 ساعت" } localizedOptionDescription { value: "اسپانیایی" } } - { ticketTypeId: "3ket" localizedShortDescription { value: "3 ساعت" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 ساعت" } localizedOptionDescription { value: "spanish" } } اختیاری است، اما اگر هر نوع بلیط در سرویس دارای این فیلد تنظیم شده باشد، انتظار داریم همه انواع بلیط های دیگر نیز این فیلد را تنظیم کنند (یک گزینه پیش فرض Description می تواند استفاده شود). به عنوان مثال [{ticket_type_1, adult, English}, {ticket_type_1, adult, ''}] لیست معتبری نیست. فقط دو تگ قالب بندی HTML پشتیبانی می شود: و |
هزینه بلیط
هزینه هایی که باید برای هر بلیطی که کاربر خریداری می کند پرداخت شود.
نمایندگی JSON |
---|
{ "serviceCharge": { object ( |
فیلدها | |
---|---|
serviceCharge | هزینه اضافی برای یک سرویس ارزیابی می شود. |
facilityFee | هزینه ای که به محل/تسهیالت می رود. |
taxes | به ازای مالیات بلیط |
رسانه های مرتبط
عکس های مربوط به این سرویس Google این رسانهها را میخزد تا مطمئن شود که آنها به درستی برای کاربران نهایی نمایش داده میشوند. (اختیاری)
نمایندگی JSON |
---|
{ "url": string, "type": enum ( |
فیلدها | |
---|---|
url | آدرس این منبع رسانه ای. Google رسانه میزبانی شده در این URL را میخزد. |
type | نوع این منبع رسانه ای |
localizedCaption | عنوان رسانه ای که i18n را پشتیبانی می کند، فقط متن ساده پشتیبانی می شود. هر مؤلفه HTML حذف خواهد شد. (اختیاری) |
attribution | اطلاعات انتساب در مورد منبع رسانه. توجه داشته باشید که اگر برای اعطای اعتبار به عکاس یا آژانس لازم است انتساب با رسانه نمایش داده شود، این قسمت باید تنظیم شود. (اختیاری) |
caption | منسوخ شده است، ترجیح می دهید از LocalizedCaption استفاده کنید. |
MediaType
Enum برای نشان دادن نوع این منبع رسانه. فقط عکس ها پشتیبانی می شوند. لطفاً در صورت نیاز به پشتیبانی از سایر رسانههای فراتر از عکس، با تیم رزرو با Google تماس بگیرید.
Enums | |
---|---|
TYPE_UNSPECIFIED | استفاده نشده |
PHOTO | نشان می دهد رسانه ارائه شده توسط URL یک عکس است. |
انتساب
اطلاعات انتساب برای این رسانه.
نمایندگی JSON |
---|
{
"localizedText": {
object ( |
فیلدها | |
---|---|
localizedText | متنی که به عکاس یا آژانس پشتیبانی کننده i18n اعتبار می دهد. این متن همراه با رسانه منبع نمایش داده می شود. توجه داشته باشید که فقط متن ساده برای این فیلد پشتیبانی میشود، هر مؤلفه HTML حذف میشود (ارزیابی مبتنی بر پیوند پشتیبانی نمیشود). |
text | منسوخ شده است، ترجیح می دهید از متن محلی استفاده کنید. |
ServiceAttributeValueId
مقدار خاصی از ویژگی سرویس را برای اعمال به یک سرویس مشخص می کند.
نمایندگی JSON |
---|
{ "attributeId": string, "valueId": string } |
فیلدها | |
---|---|
attributeId | شناسه یک ویژگی همانطور که در Merchant.service_attribute تعریف شده است، به عنوان مثال "نوع سرویس". |
valueId | شناسه مقدار این ویژگی، به عنوان مثال "مشکل مو". باید با یک valueId در تعریف ویژگی سرویس مطابقت داشته باشد. |
قوانین فهرست انتظار
قوانین مربوط به پیوستن به لیست انتظار.
نمایندگی JSON |
---|
{
"minPartySize": integer,
"maxPartySize": integer,
"supportsAdditionalRequest": boolean,
"aboveMaxPartySizeOptions": [
{
object ( |
فیلدها | |
---|---|
minPartySize | مورد نیاز. باید یک عدد صحیح مثبت برای خدمات ارائه دهنده عملکرد لیست انتظار باشد. اگر سرویس یا تاجر عملکرد لیست انتظار را ارائه نمیکند، این نباید پر شود. |
maxPartySize | مورد نیاز. باید یک عدد صحیح مثبت برای خدمات ارائه دهنده عملکرد لیست انتظار باشد. اگر سرویس یا تاجر عملکرد لیست انتظار را ارائه نمیکند، این نباید پر شود. |
supportsAdditionalRequest | اگر درست باشد، کاربر میتواند هنگام پیوستن به فهرست انتظار برای این سرویس، یک درخواست متن اضافی به صورت رایگان ارسال کند. |
aboveMaxPartySizeOptions[] | گزینه هایی را برای مهمانی های بزرگتر از مجموعه maxPartySize تنظیم کنید. اگر نباید گزینه های جایگزین برای پیوستن به لیست انتظار به مهمانان بزرگتر داده شود، خالی بگذارید. |
UnsupportedPartySizeOption
گزینه هایی برای مهمانی هایی که خارج از محدوده هستند.
نمایندگی JSON |
---|
{
"callMerchant": {
object ( |
فیلدها | |
---|---|
callMerchant | اندازه مهمانی هایی که خارج از محدوده هستند می توانند با کسب و کار تماس بگیرند. یک پیام از پیش تعریف شده برای کاربر نمایش داده می شود. نمونه متنی که باید نمایش داده شود: "برای مهمانی های بزرگتر از {waitlistRules.max_party_size} لطفاً با شماره {phone} با رستوران تماس بگیرید." CallMerchant باید تنظیم شود، اما خالی خواهد بود. |
Call Merchant
پیام خالی برای استفاده در UnsupportedPartySizeOption، با تنظیم این گزینه گزینه ای را به کاربران نشان می دهد تا برای رزرو با کسب و کار تماس بگیرند.
TicketingVerticalSpecificData
اطلاعات اضافی منحصر به فرد برای رویداد عمودی بلیط.
نمایندگی JSON |
---|
{ "eventCategory": enum ( |
فیلدها | |
---|---|
eventCategory | دسته بندی رویداد. تنظیم فقط زمانی که رویداد در یکی از دسته های از پیش تعریف شده قرار می گیرد. (اختیاری) |
eventUrl | نشانی وب رویداد در وب سایت شریک. (اختیاری) |
entity[] | فهرستی از نهادهای مرتبط با رویداد. (اختیاری) |
eventAttendanceMode | مورد نیاز. نوع حضور در رویداد |
eventVirtualLocationUrl[] | اختیاری. نشانی اینترنتی جایی که می توان رویداد را تماشا کرد. |
eventOrganizer | اختیاری. سازمان دهنده ای که رویداد را برگزار می کند. |
eventOrganizerUrl | اختیاری. URL سازمان دهنده که رویداد را میزبانی می کند. |
eventOrganizerType | اختیاری. نوع برگزار کننده. |
eventSourceUrl[] | مورد نیاز. URL صفحاتی که اطلاعات یا توضیحات رویداد را می توان یافت. |
eventState | اختیاری. وضعیت رویداد. |
دسته رویداد
زیرمجموعه ای از دسته های رویداد که ما تجربه محصول را برای آن سفارشی می کنیم. توجه: در نظر گرفته نشده است که یک هستی شناسی جهانی از رویدادها باشد.
Enums | |
---|---|
EVENT_CATEGORY_UNSPECIFIED | مشخص نشده است. استفاده نکنید. |
EVENT_CATEGORY_CONCERT | کنسرت ها |
EVENT_CATEGORY_SPORTS | رویدادهای ورزشی |
EVENT_CATEGORY_THEATRE | رویدادهای تئاتر |
EVENT_CATEGORY_EXHIBITS | نمایشگاه ها |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES | کارگاه ها و کلاس ها |
موجودیت
نماینده یک نهاد مرتبط با رویداد است.
نمایندگی JSON |
---|
{ "id": string, "name": string, "url": string, "entityType": enum ( |
فیلدها | |
---|---|
id | شناسه منحصر به فرد موجودیت در پایگاه داده شریک. (اختیاری) |
name | نام نهاد. (الزامی) |
url | آدرس صفحه وب که به طور واضح موجودیت را توصیف می کند. در صورت وجود، این صفحه وب در وب سایت شریک برای نهاد است. برای سایر URL های عمومی موجودیت، از relevantUrl در publicIdentificationData استفاده کنید. (اختیاری) |
entityType | نوع موجودیت. (اختیاری) |
entityRole | نقش نهاد در رویداد. (اختیاری) |
publicIdentificationData | مراجع عمومی نهاد. (اختیاری) |
EntityType
نوع موجودیت. توجه: در نظر گرفته نشده است که یک هستی شناسی جهانی باشد.
Enums | |
---|---|
ENTITY_TYPE_UNSPECIFIED | مشخص نشده است. استفاده نکنید. |
ENTITY_TYPE_PERFORMER | نهاد معرف هنرمند یا گروهی است که در یک کنسرت یا نمایش اجرا می کند. فقط زمانی قابل اعمال است که دسته رویداد کنسرت یا تئاتر باشد. |
ENTITY_TYPE_PLAYER | این نهاد نماینده تیم ورزشی یا بازیکن در رویداد است. فقط زمانی قابل اجراست که دسته رویداد ورزشی باشد. |
ENTITY_TYPE_CONCERT_TOUR | نهاد نشان دهنده توری است که این رویداد به آن تعلق دارد. فقط زمانی قابل اعمال است که دسته رویداد CONCERT باشد. |
ENTITY_TYPE_SPORTS_SERIES | نهاد یک تورنمنت ورزشی است که این رویداد به آن تعلق دارد. فقط زمانی قابل اجراست که دسته رویداد ورزشی باشد. |
ENTITY_TYPE_PLAY | موجودیت نشان دهنده نوع نمایش (مثلاً موزیکال، کمدی، باله و غیره) است که در رویداد اجرا می شود. فقط زمانی قابل اجراست که دسته رویداد تئاتر باشد. |
EntityRole
نقش نهاد در رویداد.
Enums | |
---|---|
ENTITY_ROLE_UNSPECIFIED | مشخص نشده است. |
ENTITY_ROLE_HEADLINER | این نهاد نشان دهنده یک تیتر یا مجری پیشرو در رویداد است. |
ENTITY_ROLE_SUPPORTER | این نهاد یک مجری حامی در رویداد را نمایندگی می کند. |
ENTITY_ROLE_HOME_TEAM | این نهاد نماینده تیم میزبان در رویداد (ورزشی) است. |
ENTITY_ROLE_AWAY_TEAM | این نهاد نماینده تیم میهمان در رویداد (ورزشی) است. |
PublicIdentificationData
شناسه ها، صفحات وب یا هر منبع عمومی دیگری که به یک موجودیت ارجاع می دهد.
نمایندگی JSON |
---|
{ "relevantUrl": [ string ], "musicbrainzId": string } |
فیلدها | |
---|---|
relevantUrl[] | URL عمومی هر صفحه وب که فقط به موضوع اختصاص داده شده است. این می تواند شامل وب سایت های رسمی، دیسک ها، پلت فرم های رسانه های اجتماعی، صفحات ویکی پدیا یا imdb باشد، به عنوان مثال https://www.discogs.com/artist/1124645-Taylor-Swift ، https://www.wikidata.org/wiki/Q19320959 ، https://twitter.com/acmilan . (اختیاری) |
musicbrainzId | شناسه 36 کاراکتری musicbrainz هنرمند یا سایر نهادهای موسیقی، در صورت وجود. به https://musicbrainz.org/doc/MusicBrainz_Identifier مراجعه کنید. (اختیاری) |
حالت حضور و غیاب
نوع حضور در رویداد
Enums | |
---|---|
ATTENDANCE_MODE_UNSPECIFIED | مشخص نشده است. |
ONLINE | برای رویدادهای مجازی |
PHYSICAL | برای رویدادهای فیزیکی |
PHYSICAL_ONLINE_MIXED | برای رویدادهایی که هم فیزیکی و هم مجازی هستند. |
OrganizerType
نوع برگزار کننده.
Enums | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED | مشخص نشده است. |
PERSON | برای سازمان دهنده که یک شخص است. |
ORGANIZATION | برای سازمان دهنده که یک سازمان است. |
EventState
وضعیت رویداد.
Enums | |
---|---|
EVENT_STATE_UNSPECIFIED | مشخص نشده است. |
SCHEDULED | این رویداد برنامه ریزی شده است. |
RESCHEDULED | این رویداد دوباره برنامه ریزی شده است. |
CANCELLED | این رویداد لغو می شود. |
POSTPONED | این رویداد به تعویق افتاد. |
IntegrationType
عمق ادغام پشتیبانی می شود.
Enums | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED | پیشفرض END_TO_END است. |
INTEGRATION_TYPE_END_TO_END | یکپارچهسازی کامل که امکان رزرو نهایی از طریق Google را فراهم میکند. |
INTEGRATION_TYPE_INVENTORY_ONLY | سرور رزرو نیازی به پشتیبانی از این سرویس ندارد. فقط بازرگانان، خدمات، و دادههای در دسترس بودن (اختیاری) باید ارسال شوند. |
PerOrderFee
هزینه هایی که بدون در نظر گرفتن تعداد بلیط باید یک بار در هر سفارش پرداخت شود.
نمایندگی JSON |
---|
{ "deliveryFee": { object ( |
فیلدها | |
---|---|
deliveryFee | هزینه ای که می تواند بر اساس روش تحویل متفاوت باشد. |
processingFee | هزینه ای برای پردازش روش پرداخت کاربر. |
محتوای تورها و فعالیت ها
فیلدهای محتوای خاص تورها و فعالیت ها. هر عنصر در فیلد تکراری باید مستقل باشد تا امکان رندر جداگانه (مثلاً به عنوان نقطه گلوله) فراهم شود.
پر کردن محتوای تورها و فعالیتها به شدت برای تورها و فعالیتها توصیه میشود، اما اکیداً الزامی نیست. همه فیلدها از متن ساده و HTML مانند برای قالب بندی اولیه پشتیبانی می کنند. برچسبهای قالببندی HTML پشتیبانی شده:
برچسب های عبارت:
, , , : فقط سه تگ ذکر شده در بالا پشتیبانی می شوند.
می تواند برای شکستن خطوط در پاراگراف ها استفاده شود و // می تواند برای برجسته کردن یک متن مهم استفاده شود. هر برچسب عبارت دیگری نادیده گرفته می شود.
سایر برچسب ها و سبک های سفارشی مجاز نیستند و حذف خواهند شد. URL ها، لنگرها و پیوندها حذف می شوند و هرگز به کاربران نهایی نمایش داده نمی شوند.
نکات مهم: * داده های ارائه شده در highlights
، exclusion
و سایر فیلدهای خاص تر در توضیحات سرویس را تکرار نکنید. * از استفاده از برچسب های دیگر به جز موارد پشتیبانی شده ذکر شده در بالا خودداری کنید، زیرا محتویات داخل برچسب های پشتیبانی نشده پاک می شوند و ممکن است منجر به تجربه کاربری نامطلوب شوند.
نمایندگی JSON |
---|
{ "highlights": [ { object ( |
فیلدها | |
---|---|
highlights[] | لیست قابل مشاهده برای کاربر از نکات برجسته. |
inclusions[] | فهرست مشمولان قابل مشاهده برای کاربر. |
exclusions[] | فهرست استثنائات قابل مشاهده برای کاربر. |
mustKnow[] | فهرست یادداشتهای مهم قابل مشاهده برای کاربر، برای جزئیاتی مانند محدودیتهای سنی یا سایر شرایطی که این سرویس را نامناسب میکند، استفاده کنید. |
مکان
اطلاعات جغرافیایی در مورد یک مکان
نمایندگی JSON |
---|
{ "placeId": string, "name": string, "telephone": string, "url": string, "geo": { object ( |
فیلدها | |
---|---|
placeId | شناسه مکان برای مکانی در پایگاه داده Google Places و در Google Maps. برای اطلاعات بیشتر درباره شناسههای مکان، به https://developers.google.com/places/web-service/place-id مراجعه کنید. در صورت ارائه، Google مکان را با این مکان مطابقت می دهد. |
name | نام مکان، تلفن، آدرس اینترنتی و جغرافیایی برای پشتیبانی از تطبیق مکان با مکانهایی که قبلاً در Google Maps وجود دارد استفاده میشود. این فیلد اختیاری است، اما ممکن است در برخی زمینه ها مورد نیاز باشد. به عنوان مثال، یک Service.location بدون نام با یک نهاد تجاری تطبیق داده نخواهد شد، حتی اگر آنها در همان آدرس واقع شده باشند. (اختیاری) |
telephone | شماره تلفن عمومی محل شامل کدهای کشور و منطقه آن، به عنوان مثال +14567891234. (اختیاری) |
url | آدرس وب سایت عمومی مکان. (اختیاری) |
geo | اطلاعات جغرافیایی مکان، از جمله عرض جغرافیایی، طول جغرافیایی، و آدرس. (اختیاری) |
locationType | اگر این مکان برای یک سرویس ارائه شده باشد، باید نوع مکان ارائه شود. |
locationId | مرجع منحصر به فرد مکان در سرویس. از این شناسه می توان برای اشاره به این مکان در سایر فیلدهای خدمات استفاده کرد. به عنوان مثال در فرم دریافت سفارشی، مجموعهای از شناسههای مکان را میتوان برای تعیین گزینههای دریافت مکان استفاده کرد. اگر تنظیم شود، این شناسه باید در همان سرویس یکتا باشد. (اختیاری) |
نوع مکان
نوع این مکان.
Enums | |
---|---|
LOCATION_TYPE_UNSPECIFIED | نوع مکان مشخص نشده است. |
VISITED_LOCATION | مکانی که این سرویس از آن بازدید می کند. |
START_LOCATION | مکانی که این سرویس از آنجا شروع می شود، به عنوان MEETING_LOCATION نیز عمل می کند. |
END_LOCATION | مکانی که این سرویس به پایان می رسد. |
رتبه بندی
رتبه بندی یک موجودیت را تعریف می کند.
نمایندگی JSON |
---|
{ "value": number, "numberOfRatings": string } |
فیلدها | |
---|---|
value | میانگین ارزش رتبهبندی (الزامی زمانی که numberOfRatings > 0 باشد). مقدار باید در محدوده [1، 5] باشد و اگر و فقط اگر numberOfRatings صفر باشد می توان آن را حذف کرد. |
numberOfRatings | تعداد رتبه های استفاده شده در محاسبه مقدار (الزامی). |
HomeServiceData
اطلاعات اضافی مورد نیاز برای ارائه خدمات خانگی عمودی.
نمایندگی JSON |
---|
{ "categoryType": string, "jobType": string } |
فیلدها | |
---|---|
categoryType | دسته سطح بالایی که این سرویس خانه به آن تعلق دارد. به عنوان مثال لوله کش، برق و غیره |
jobType | نوع شغل تحت دسته ای که سرویس خانه داده شده به آن تعلق دارد. به عنوان مثال unclog_drain، install_faucet انواع مشاغل در دسته لوله کش هستند. |
جلسه مجازی
اطلاعات در مورد جلسه مجازی/آنلاین. به عنوان مثال کلاس یوگا آنلاین، کلاس آشپزی مجازی و غیره.
نمایندگی JSON |
---|
{ "sessionInstructions": { object ( |
فیلدها | |
---|---|
sessionInstructions | دستورالعمل نحوه راه اندازی این کلاس مجازی. اگر شریک نشانی وب ویدیو را با رزرو وارد نکرده باشد، این متن باید شامل زمانی باشد که URL ویدیو با کاربر به اشتراک گذاشته میشود. به عنوان مثال "URL بزرگنمایی 30 دقیقه قبل از کلاس پست می شود." (توصیه می شود) |
sessionRequirements | الزامات جلسه مجازی داده شده به عنوان مثال تشک یوگا، ظروف پخت و پز و غیره (توصیه می شود) |
virtualPlatformInfo | اطلاعاتی در مورد بستر مجازی مورد استفاده در این جلسه. (برای فعال کردن خدمات مجازی لازم است) |
isSessionPrerecorded | مورد نیاز. اگر جلسه مجازی زنده نیست و از قبل ضبط شده است، این را درست تنظیم کنید. |
VirtualPlatformInfo
اطلاعاتی در مورد پلتفرمی که برای این جلسه مجازی استفاده خواهد شد.
نمایندگی JSON |
---|
{ "platform": enum ( |
فیلدها | |
---|---|
platform | پلتفرم مورد استفاده برای جلسه مجازی |
otherPlatformName | نام پلتفرم اگر پلتفرم روی OTHER تنظیم شده باشد. (اگر پلتفرم روی OTHER تنظیم شده باشد، الزامی است) |
پلت فرم
Enum برای نشان دادن اینکه کدام پلتفرم مجازی توسط تاجر استفاده می شود.
Enums | |
---|---|
PLATFORM_UNSPECIFIED | استفاده نشده |
FLEXIBLE | تاجر انعطاف پذیر است که در کدام پلتفرم ویدیویی استفاده می کند. |
GOOGLE_HANGOUTS | محصول Google Hangouts. |
GOOGLE_MEET | محصول Google Meet. |
ZOOM | ارتباطات ویدئویی زوم. |
SKYPE | اسکایپ. |
YOUTUBE | پخش زنده در یوتیوب. |
OTHER | اگر پلتفرم ویدیویی استفاده شده با موارد ذکر شده در اینجا متفاوت باشد، باید تنظیم شود. |
DirectMerchantPayment
اطلاعاتی درباره نحوه پرداخت مستقیم کاربر به تاجر به جای پیش پرداخت از طریق RwG.
نمایندگی JSON |
---|
{
"paymentMethods": [
{
object ( |
فیلدها | |
---|---|
paymentMethods[] | به کاربران توصیه می شود فقط از طریق روش های پرداخت ذکر شده در زیر پرداخت کنند. |
روش ها | |
---|---|
| یک Service جدید از یک تاجر ایجاد می کند که توسط جمع کننده مشخص شده مدیریت می شود و آن را برمی گرداند. |
| یک Service موجود از یک تاجر که توسط جمعآوریکننده مشخص شده مدیریت میشود را حذف میکند. |
| Service موجود یک تاجر را که توسط جمعآوریکننده مشخص شده مدیریت میشود، بهروزرسانی میکند و آن را برمیگرداند. |