Package google.maps.booking.v1alpha

شاخص

AdsAccountLinkingService

سرویس مدیریت پیوند حساب بین Google Ads و Partner Center.

اطلاعیه رزرو

اعلان های قرار ملاقات ها را از شرکای برنامه ریزی خارجی دریافت می کند. شریک بسته به اینکه شریک RPCهای مبتنی بر رزرو مانند CreateBooking و CheckAvailability را اجرا کند یا RPCهای پایه مانند CreateOrder و CheckOrderFulfillability، باید با UpdateBooking یا UpdateOrder تماس بگیرد.

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

rpc UpdateBooking( UpdateBookingRequest ) returns ( Booking )

یک Booking موجود را به روز می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
UpdateOrder

rpc UpdateOrder( UpdateOrderRequest ) returns ( Order )

یک Order موجود را به روز می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking

خوراک

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

GetStatus

rpc GetStatus( GetStatusRequest ) returns ( FeedStatus )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
وضعیت لیست

rpc ListStatus( ListStatusRequest ) returns ( ListStatusResponse )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking

Invalidation Service

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

InvalidateResource

rpc InvalidateResource( InvalidateResourceRequest ) returns ( Empty )

یک منبع موجود را باطل می کند.

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

انواع منابع پشتیبانی شده: - وانت

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking

وضعیت موجودی

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

GetMerchantStatus

rpc GetMerchantStatus( GetMerchantStatusRequest ) returns ( MerchantStatus )

MerchantStatus یک Merchant را دریافت کنید.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
ListMerchantStatuses

rpc ListMerchantStatuses( ListMerchantStatusesRequest ) returns ( ListMerchantStatusesResponse )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking

InventoryUpdate

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

BatchDeleteGenericRecords

rpc BatchDeleteGenericRecords( BatchDeleteGenericRecordsRequest ) returns ( Empty )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
BatchPushGenericRecord

rpc BatchPushGenericRecord( BatchPushGenericRecordRequest ) returns ( Empty )

سوابق نوع خوراک مشخص شده را درج و/یا به روز می کند. فقط اعتبار سنجی اولیه را انجام می دهد (مانند درخواست نادرست) که پس از آن بلافاصله پاسخ مناسب به شریک بازگردانده می شود. Google اعتبار سنجی منطق کسب و کار را در درخواست به صورت ناهمزمان انجام می دهد. این فراخوان دسته ای اتمی بودن را تضمین نمی کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
BatchReplaceServiceAvailability

rpc BatchReplaceServiceAvailability( BatchReplaceServiceAvailabilityRequest ) returns ( BatchReplaceServiceAvailabilityResponse )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
ایجاد تاجر

rpc CreateMerchant( CreateMerchantRequest ) returns ( Merchant )

یک Merchant جدید ایجاد می کند که توسط جمع کننده مشخص شده مدیریت می شود و آن را برمی گرداند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
CreateService

rpc CreateService( CreateServiceRequest ) returns ( Service )

یک Service جدید از یک تاجر ایجاد می کند که توسط جمع کننده مشخص شده مدیریت می شود و آن را برمی گرداند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
Delete Merchant

rpc DeleteMerchant( DeleteMerchantRequest ) returns ( Empty )

یک Merchant موجود که توسط جمع‌آوری‌کننده مشخص شده مدیریت می‌شود را حذف می‌کند. تمام خدمات و در دسترس بودن تاجر نیز غیرفعال خواهد شد. اگر بعداً بازرگان را دوباره اضافه کنید، همان مجموعه سرویس‌ها و اسلات‌های در دسترس ظاهر می‌شوند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
DeleteService

rpc DeleteService( DeleteServiceRequest ) returns ( Empty )

یک Service موجود از یک تاجر که توسط جمع‌آوری‌کننده مشخص شده مدیریت می‌شود را حذف می‌کند. تمام موارد در دسترس بودن این سرویس نیز حذف خواهد شد.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
ReplaceServiceAvailability

rpc ReplaceServiceAvailability( ReplaceServiceAvailabilityRequest ) returns ( ServiceAvailability )

Availability یک Service موجود از یک تاجر که توسط جمع‌آوری مشخص شده مدیریت می‌شود را جایگزین می‌کند و آن را برمی‌گرداند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
UpdateMerchant

rpc UpdateMerchant( UpdateMerchantRequest ) returns ( Merchant )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking
UpdateService

rpc UpdateService( UpdateServiceRequest ) returns ( Service )

Service موجود یک تاجر را که توسط جمع‌آوری‌کننده مشخص شده مدیریت می‌شود، به‌روزرسانی می‌کند و آن را برمی‌گرداند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/mapsbooking

ActionLinkType

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

Enums

رویداد Metadata

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

فیلدها
surface

Surface

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

سطح

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

Enums
SURFACE_UNSPECIFIED سطح نامشخص است.
SURFACE_YOUTUBE پیوند اقدام، رزرو بلیط رویداد در YouTube است.
SURFACE_ADS پیوند اکشن روی تبلیغی برای رویداد کلیک می کند.

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 است.

ایالت

پیوند حساب وضعیت Ads.

Enums
STATE_UNSPECIFIED حالت نامعلوم
LINKED حساب بین مرکز شریک و پورتال تبلیغات مرتبط است.
PENDING حساب منتظر تأیید در مرکز شریک یا پورتال تبلیغات است.
DELETED لینک اکانت حذف شد
REJECTED درخواست پیوند حساب توسط مرکز شریک یا پورتال تبلیغات رد می شود.

نصیحت

توصیه هایی که هنگام رزرو از طریق Reserve with Google به کاربر نمایش داده می شود.

فیلدها
text

Text

پیام سفارشی برای نمایش به کاربر هنگام رزرو از طریق رزرو با Google.

در دسترس بودن

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

فیلدها
start_ time

Timestamp

زمان شروع زمان ملاقات

duration

Duration

مدت زمان قرار ملاقات

spots_ total

int64

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

  • کلاس یوگا 10 نقطه با 3 رزرو: availability {spots_total: 10, spots_open: 7 ...}
  • جلسه ماساژ صندلی که قبلاً به طور کامل رزرو شده است: availability {spots_total: 1, spots_open: 0 ...}

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

  • Recurence به معنی spots_total=1 و spots_open=1 است.
  • ScheduleException به spots_total=1 و spots_open=0 اشاره دارد.
spots_ open

int64

تعداد نقاط باز

availability_ tag

string

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

resources

Resources

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

به عنوان مثال همان کلاس یوگا با دو 2 مربی:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }
payment_ option_ id[]

string

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

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

recurrence

Recurrence

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

schedule_ exception[]

ScheduleException

زمان هایی که نمی توان این سرویس را برنامه ریزی کرد. برای محدود کردن تعداد پیام‌های schedule_exception، پیوستن به استثناهای مجاور را در نظر بگیرید.

deposit

Deposit

واریز اختیاری برای این در دسترس بودن. در صورت مشخص بودن واریز خدمات لغو می شود.

no_ show_ fee

NoShowFee

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

prepayment

Prepayment

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

require_ credit_ card

RequireCreditCard

نشان می دهد که آیا کاربر باید کارت اعتباری برای رزرو این اسلات در دسترس ارائه دهد یا خیر. اگر مقدار تنظیم نشده باشد، اگر در آنجا تنظیم شده باشد، از سطح سرویس به ارث می رسد. (اختیاری)

ticket_ type_ id[]

string

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

  • سرویس با چهار نوع بلیط: TicketType {ticket_type_id: "adult_1" short_description: "Adult Days week"} TicketType {ticket_type_id: "adult_2" short_description: "Adult آخر هفته"} TicketType {ticket_type_id: "Youthday"_descripth TicketType {ticket_type_id: "youth_2" short_description: "آخر هفته جوانان"}

برای نشان دادن موجودی در روزهای هفته: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...} . برای نشان دادن موجودی در طول تعطیلات: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...} .

  • سرویس با سه نوع بلیط: TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "Youth" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Seni"

برای نشان دادن اینکه هر سه نوع بلیت برای این بازه زمانی در دسترس هستند، از availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} یا "availability {...}" استفاده کنید (تنظیم نشود ticket_type_id در این شکاف).

(اختیاری)

duration_ requirement

DurationRequirement

الزام برای نشان دادن مدت زمان و/یا زمان پایان اسلات. اگر شکاف در دسترس نباشد، این فیلد نادیده گرفته می شود. در قسمت عمودی Things-To-Do استفاده نمی شود. (اختیاری)

scheduling_ rule_ overrides

SchedulingRuleOverrides

قوانین زمانبندی در دسترس بودن اگر فیلدها پر شوند، قوانین زمانبندی مربوطه را در SchedulingRules سطح سرویس لغو می کنند.

confirmation_ mode

ConfirmationMode

حالت تأییدی که هنگام رزرو این در دسترس بودن استفاده خواهد شد. تلاش برای ایجاد رزرو برای در دسترس بودن با حالت تأیید CONFIRMATION_MODE_SYNCHRONOUS باید فوراً تأیید یا رد شود. تلاش برای ایجاد رزرو برای در دسترس بودن با حالت تأیید CONFIRMATION_MODE_ASYNCHRONOUS باید فوراً رد شود یا با وضعیت در انتظار ایجاد شود.

linkout_ required_ reason

LinkoutRequiredReason

اختیاری. دلیل نیاز به پیوند برای این اسلات. اگر تنظیم شود، منبع Merchant برای این اسلات باید یک LinkoutTemplate معتبر داشته باشد. (اختیاری)

ConfirmationMode

حالت‌های تأیید مورد استفاده هنگام رزرو در دسترس بودن.

Enums
CONFIRMATION_MODE_UNSPECIFIED حالت تایید مشخص نشده است. تایید همزمان فرض می شود.
CONFIRMATION_MODE_SYNCHRONOUS رزرو برای این در دسترس بودن به طور همزمان تأیید می شود.
CONFIRMATION_MODE_ASYNCHRONOUS رزرو برای این در دسترس بودن به صورت ناهمزمان تایید می شود.

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

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

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

LinkoutRequiredReason

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

Enums
LINKOUT_REQUIRED_REASON_UNSPECIFIED مقدار پیش‌فرض: استفاده نشود، معادل مجهول است.
PAYMENT_REQUIRED اسلات برای رزرو نیاز به پرداخت در پلتفرم شریک دارد.

عود

پیام‌های تکراری اختیاری هستند، اما امکان نمایش فشرده‌تر اسلات‌های در دسترس را که به طور مداوم تکرار می‌شوند را فراهم می‌کنند. آنها معمولاً برنامه کاری یک روز را نشان می دهند. سپس از پیام‌های ScheduleException برای نمایش بازه‌های زمانی رزرو شده/غیرقابل دسترس در روز کاری استفاده می‌شود.

الزامات:

  1. گسترش اسلات‌های دسترسی یا تکرارها نباید شکاف‌های یکسانی ایجاد کند. اگر شناسه ها، start_time، مدت زمان و منابع مطابقت داشته باشند، اسلات ها یکسان در نظر گرفته می شوند.
  2. قالب استاندارد در دسترس بودن و تکرار را در شکاف های یک سرویس ترکیب نکنید. تکرار به سود بازرگانان/خدماتی است که قرار ملاقات ارائه می دهند. قالب استاندارد برای بازرگانان/خدمات با کلاس های برنامه ریزی شده منظم طراحی شده است.
  3. عودها نباید بیش از 24 ساعت طول بکشد.
فیلدها
repeat_ until

Timestamp

حداکثر مُهر زمانی UTC تا زمانی که در دسترس بودن تکرار می‌شود.

repeat_ every

Duration

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

مثال: در دسترس بودن با مدت زمان 20 دقیقه، تکرار هر 30 دقیقه، زمان شروع 9:00 صبح و تکرار تا 11:00 صبح، در 9-9:20 صبح، 9:30-9:50 صبح، 10 -10:20 صبح، 10:30 تا 10:50 صبح، 11 الی 11:20 صبح (الزامی)

ScheduleException

پیام‌های ScheduleException بازه‌های زمانی رزرو شده/غیرقابل دسترس را در روز کاری نشان می‌دهند، که استثناهایی برای تکرار شرح داده شده در بالا هستند. با رزرو بازه های زمانی، فهرست استثناها باید به روز شود تا بازه های زمانی جدید در دسترس را منعکس کند. خود عود نباید اصلاح شود.

فیلدها
time_ range

TimeRange

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

مثال: اگر تکرار مدت زمان 20 دقیقه، تکرار_هر 30 دقیقه، شروع_زمان 9:00 صبح، و تکرار_تا ساعت 11:00 صبح را مشخص کند، آنگاه ScheduleException با محدوده_زمان 9:45 صبح تا 11:00 صبح غیرقابل دسترس می شود. اسلات ساعت 9:30 تا 9:50 صبح، 10-10:20 صبح و 10:30-10:50 صبح.

توجه داشته باشید که به دلیل باز بودن بازه زمانی بسته، شکافی که از ساعت 11 صبح شروع می‌شود تحت تأثیر قرار نمی‌گیرد.

SchedulingRuleOverrides

قوانین زمان بندی سطح در دسترس بودن

فیلدها
last_ bookable_ sec

int64

آخرین بار (در ثانیه) که این اسلات می تواند رزرو شود. این مهر زمانی باید قبل از start_sec از اسلات باشد تا رعایت شود (اگر کاربران می‌توانند بعد از زمان شروع رزرو کنند، از SchedulingRules.min_booking_before_end_time در سطح سرویس استفاده کنید). در صورت وجود، هر چیزی که در min_booking_buffer از SchedulingRules سرویس مربوطه مشخص شده است لغو می شود.

first_ bookable_ sec

int64

اولین بار (در چند ثانیه) که این اسلات می تواند رزرو شود. این مهر زمانی باید قبل از start_sec شکاف یا last_bookable_sec در صورت مشخص شدن باشد.

last_ online_ cancellable_ sec

int64

در صورت تنظیم، آخرین بار (در چند ثانیه از زمان یونیکس) که می‌توان این زمان قرار ملاقات خاص را از طریق رزرو با Google لغو کرد. این فیلد همه قوانین لغو در سطح خدمات را لغو می کند. (اختیاری)

BatchDeleteGenericRecordsRequest

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

فیلدها
parent

string

نام منبع، که دارای قالب - partners/{partner_id}/feeds/{feed_name} است.

records[]

GenericDeleteRecord

رکوردهایی که باید حذف شوند. حداکثر 1000 رکورد در یک تماس API مجاز است.

درخواست BatchPushGenericRecord

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

فیلدها
parent

string

نام منبع، که دارای قالب - partners/{partner_id}/feeds/{feed_name} است.

records[]

GenericRecord

رکوردهایی که باید درج و/یا به روز شوند. حداکثر 1000 رکورد در یک تماس API مجاز است.

BatchReplaceServiceAvailability Request

درخواست دسته ای برای جایگزینی اسلات های دسترسی چند Service .

فیلدها
parent

string

قالب partners/{partner_id} .

extended_ service_ availability[]

ExtendedServiceAvailability

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

BatchReplaceServiceAvailabilityResponse

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

فیلدها
extended_ service_ availability[]

ExtendedServiceAvailability

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

رزرو

رزرو برای اسلات موجودی

فیلدها
name

string

نام منبع رزرو: partners/{partner ID}/bookings/{booking ID}

merchant_ id

string

شناسه تاجر برای اسلات

service_ id

string

شناسه خدمات بازرگان

start_ time

Timestamp

زمان شروع محل قرار

duration

Duration

مدت زمان قرار ملاقات

client_ information

ClientInformation

اطلاعات شخصی مشتری که قرار ملاقات می گذارد

status

BookingStatus

وضعیت رزرو

payment_ information

PaymentInformation

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

party_ size

int64

اندازه مهمانی رزرو

رزرو شکست

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

فیلدها
cause

Cause

دلیل عدم موفقیت رزرو (الزامی)

rejected_ card_ type

CreditCardType

(فقط در صورتی لازم است که علت PAYMENT_ERROR_CARD_TYPE_REJECTED باشد)

description

string

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

payment_ failure

PaymentFailureInformation

اطلاعات مربوط به عدم پرداخت

علت

برشمردن علل شکست

Enums
CAUSE_UNSPECIFIED مقدار پیش فرض: استفاده نکنید. به یک "خطای ناشناخته" تبدیل می شود
SLOT_UNAVAILABLE اسلات در دسترس بودن ارجاع شده دیگر در دسترس نیست.
SLOT_ALREADY_BOOKED_BY_USER کاربر قبلاً قرار ملاقاتی را برای اسلات در دسترس بودن ارجاع داده شده رزرو کرده است.
LEASE_EXPIRED اجاره نامه (در صورت ارائه) منقضی شده است و دیگر نمی توان از آن برای تکمیل رزرو درخواستی استفاده کرد.
OUTSIDE_CANCELLATION_WINDOW لغو درخواستی به دلیل محدودیت‌های زمانی در خط‌مشی لغو تاجر در زمان فعلی قابل انجام نیست.
PAYMENT_ERROR_CARD_TYPE_REJECTED هنگام پردازش پرداخت خطایی روی داد زیرا نوع کارت اعتباری ارائه شده توسط تاجر پذیرفته نشد. نوع کارت اعتباری باید به صورت rejected_card_type ارائه شود.
PAYMENT_ERROR_CARD_DECLINED هنگام پردازش پرداخت خطایی روی داد زیرا کارت اعتباری ارائه شده رد شد.
PAYMENT_OPTION_NOT_VALID خطایی در بسته/عضویت مورد استفاده برای پرداخت هزینه رزرو رخ داد. ممکن است هیچ استفاده معتبری وجود نداشته باشد، ممکن است منقضی شده باشد، و غیره.
PAYMENT_ERROR هنگام پردازش پرداخت برای این رزرو خطایی روی داد. از این مقدار برای نشان دادن یک خطای کلی مربوط به پرداخت استفاده کنید، تنها در صورتی که خطا با خطای پرداخت خاص در بالا مطابقت نداشته باشد.
USER_CANNOT_USE_PAYMENT_OPTION کاربر نمی تواند از گزینه پرداخت داده شده استفاده کند (مثلاً کاربر سعی می کند برای بار دوم از قیمت بار اول استفاده کند).
BOOKING_ALREADY_CANCELLED رزروی که کاربر سعی کرده آن را لغو کند قبلاً لغو شده است.
BOOKING_NOT_CANCELLABLE رزروی که کاربر سعی کرده آن را لغو کند قابل لغو نیست.
OVERLAPPING_RESERVATION کاربر یک رزرو موجود بسیار نزدیک به این زمان دارد.
USER_OVER_BOOKING_LIMIT به دلیل اینکه کاربر بیش از حد مجاز رزرو برای هر کاربر جمع‌آوری‌کننده بود، رزرو انجام نشد.
PAYMENT_REQUIRES_3DS1

زمانی را تنظیم کنید که پرداخت رد شود زیرا شما درخواست می‌کنید که تراکنش دوباره امتحان شود، اما این بار پس از انجام چالش/پاسخ 3DS1. توجه داشته باشید که وضعیت شکست تراکنش فعلی ناموفق خواهد ماند. تلاش مجدد کاملاً مجزا خواهد بود.

وقتی این دلیل شکست است، pay_failure.3DS1_parameters باید تنظیم شود. اگر اینطور نیست، با علت فعلی به گونه‌ای برخورد می‌شود که گویی PAYMENT_ERROR است.

اطلاعات خطای پرداخت

اطلاعات مربوط به عدم پرداخت

فیلدها
threeds1_ parameters

ThreeDS1Parameters

پارامترهایی که توسط یک تجمیع کننده RwG برای شروع پروتکل احراز هویت 3DS1 با کاربر استفاده می شود. نادیده گرفته می شود مگر اینکه BookingFailure.cause روی PAYMENT_REQUIRES_3DS1 تنظیم شود.

ThreeDS1Parameters

پارامترهایی که درخواست می کنند RwG یک چالش 3DS1 را انجام دهد.

پارامترها توسط توضیحات EMVCo از پروتکل 3DS1 تنظیم می شوند.

فیلدها
acs_ url

string

نشانی اینترنتی که از آن فرم بارگیری می شود تا برای احراز هویت به کاربر ارائه شود.

pa_ req

string

یک درخواست احراز هویت Payment. در صورت ارائه به فرم ACSUrl ارسال می شود.

transaction_ id

string

شناسه ای که توسط ارائه دهنده ACS استفاده می شود. در صورت ارائه به فرم ACSUrl ارسال می شود.

md_ merchant_ data

string

داده های تجاری در صورت ارائه به فرم ACSUrl ارسال می شود.

وضعیت رزرو

وضعیت یک رزرو

Enums
BOOKING_STATUS_UNSPECIFIED مشخص نشده است.
CONFIRMED رزرو تایید شده است
PENDING_MERCHANT_CONFIRMATION رزرو قبل از اینکه بتواند به وضعیت تأیید شده تبدیل شود در انتظار تأیید تاجر است (در حال حاضر پشتیبانی نمی‌شود)
PENDING_CLIENT_CONFIRMATION رزرو قبل از اینکه بتواند به وضعیت تأیید شده تبدیل شود در انتظار تأیید توسط مشتری است (در حال حاضر پشتیبانی نمی شود)
CANCELED رزرو از طرف کاربر لغو شده است.
NO_SHOW مشتری برای قرار ملاقات حاضر نشد
NO_SHOW_PENALIZED مشتری برخلاف خط مشی لغو، برای قرار ملاقات حاضر نشد.
FAILED به دلیل خطا در پردازش، رزرو انجام نشد.
DECLINED_BY_MERCHANT رزرو به صورت ناهمزمان توسط تاجر رد شد.

Call Merchant

این نوع هیچ فیلدی ندارد.

پیام خالی برای استفاده در UnsupportedPartySizeOption، با تنظیم این گزینه گزینه ای را به کاربران نشان می دهد تا برای رزرو با کسب و کار تماس بگیرند.

سیاست لغو

سیاست لغو برای یک سرویس.

فیلدها
refund_ condition[]

RefundCondition

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

شرایط بازپرداخت

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

فیلدها
min_ duration_ before_ start_ time

Duration

مدت زمان قبل از زمان شروع، تا زمانی که مشتری بتواند بخشی از هزینه خدمات مشخص شده در refund_percent را بازپرداخت کند. هنگامی که روی 0 (پیش‌فرض) تنظیم می‌شود، سرویس را می‌توان در هر زمان لغو کرد.

refund_ percent

uint32

درصد قابل بازپرداخت، تا زمانی که رزرو سرویس حداقل min_duration_before_start_time قبل از زمان شروع سرویس لغو شود، در محدوده [0، 100]. وقتی روی 0 (پیش‌فرض) تنظیم می‌شود، سرویس قابل استرداد نیست. وقتی روی 100 تنظیم شود، این سرویس به طور کامل قابل استرداد است.

اطلاعات مشتری

اطلاعات شخصی در مورد شخصی که رزرو می کند

فیلدها
given_ name

string

نام مشتری

family_ name

string

نام خانوادگی مشتری

address

PostalAddress

آدرس مشتری

telephone

string

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

email

string

آدرس ایمیل مشتری

CreateAdsAccountLinkRequest

درخواست پیام برای AdsAccountLinkingService.CreateAdsAccountLink.

فیلدها
parent

string

مورد نیاز. منبع اصلی که در آن پیوند این حساب Ads ایجاد خواهد شد. این همان شناسه حساب Partner Center است. قالب: شرکا/{شریک}

ایجاد MerchantRequest

درخواست ایجاد Merchant .

فیلدها
parent

string

نام منبع والد برای شریک صاحب این تاجر، در قالب partners/{partner_id} .

merchant_ id

string

شناسه فروشنده برای استفاده برای این تاجر.

merchant

Merchant

تاجر برای ایجاد.

CreateServiceRequest

درخواست ایجاد یک Service جدید.

فیلدها
parent

string

نام منبع والد برای تاجری که این سرویس را دارد، در قالب partners/{partner_id}/merchants/{merchant_id} .

service_ id

string

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

service

Service

سرویس برای ایجاد.

محدودیت های کارت اعتباری

محدودیت‌هایی برای انواع کارت اعتباری که این تاجر می‌پذیرد.

فیلدها
credit_ card_ type[]

CreditCardType

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

نوع کارت اعتباری

یک نوع کارت اعتباری

Enums
CREDIT_CARD_TYPE_UNSPECIFIED استفاده نشده
VISA کارت اعتباری ویزا
MASTERCARD کارت اعتباری مسترکارت
AMERICAN_EXPRESS کارت اعتباری امریکن اکسپرس
DISCOVER کارت اعتباری Discover
JCB کارت اعتباری JCB

DeleteAdsAccountLinkRequest

درخواست پیام برای AdsAccountLinkingService.DeleteAdsAccountLink.

فیلدها
name

string

مورد نیاز. نام AdsAccountLink برای حذف. قالب: شرکا/{partner}/adsAccountLinks/{ads_account_link}

حذف MerchantRequest

درخواست حذف Merchant .

فیلدها
name

string

نام منبع تاجر برای حذف. در قالب شرکا/{partner_id}/merchants/{merchant_id}

DeleteServiceRequest

درخواست حذف یک Service

فیلدها
name

string

نام منبع سرویس برای حذف. در قالب partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

سپرده گذاری

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

فیلدها
deposit

Price

مبلغ سپرده.

min_ advance_ cancellation_ sec

int64

حداقل لغو پیش پرداخت برای واریز.

deposit_ type

PriceType

نحوه تعیین سپرده را از در دسترس بودن تعریف می کند.

DirectMerchantPayment

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

فیلدها
payment_ methods[]

Text

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

محدوده مدت

لفاف برای محدوده ای از مدت زمان که می تواند محدود یا بدون محدودیت باشد. حداقل یکی از min_duration و max_duration duration مورد نیاز است.

فیلدها
min_ duration

Duration

حداقل مدت.

max_ duration

Duration

حداکثر مدت.

اپراتور اقتصادی

اطلاعات اپراتور اقتصادی برای تجمیع کننده.

فیلدها
text

Text

مورد نیاز. نام، آدرس، شماره تلفن و آدرس ایمیل فعال اقتصادی که تولیدکننده، نماینده مجاز، واردکننده، توزیع کننده، ارائه دهنده خدمات انجام و یا هر شخص حقیقی یا حقوقی دیگری مشمول تعهدات مربوط به ساخت محصولات است و در دسترس قرار می دهد. یا قرار دادن آنها در خدمت. نمایش رشته آزاد از operator_ Economic. این اطلاعات ممکن است با استفاده از " " و "\n" قالب بندی شوند.

ExtendedServiceAvailability

فهرستی از در دسترس بودن و چه کسی/چه زمانی باید برای آنها اعمال شود.

فیلدها
merchant_ id

string

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

service_ id

string

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

start_ time_ restrict

Timestamp

در صورت ارائه، موجودیت های در دسترس بودن ارائه شده را به عنوان یک عکس فوری کامل از [start_time_restrict، end_time_restrict در نظر می گیریم. به این معنا که اگر شرط زیر درست باشد، تمام موجودی‌های موجود حذف خواهند شد:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

اگر پیام مدت زمان تنظیم شده باشد، این شرط بیشتر محدود می شود:

  availability.duration == duration_restrict

اگر یک پیغام resources_restrict تنظیم شده باشد، این شرط بیشتر محدود می شود:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

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

تنظیم start_time_restrict در حالی که end_time_restrict تنظیم نشده است به معنای شروع تمام زمان در start_time_restrict تفسیر می‌شود.

end_ time_ restrict

Timestamp

تنظیم end_time_restrict در حالی که start_time_restrict تنظیم نشده است به معنای تمام زمان تا پایان_time_restrict تفسیر می‌شود.

duration_ restrict

Duration

تنظیم مدت زمان، دامنه به‌روزرسانی را فقط به در دسترس بودن با مدت زمان منطبق محدود می‌کند.

resources_ restrict

Resources

تنظیم resources_restrict دامنه به‌روزرسانی را فقط به این مجموعه از منابع محدود می‌کند. تمام فیلدهای شناسه منابع باید دقیقاً مطابقت داشته باشند.

availability[]

Availability

لیست جدید در دسترس بودن

FeedStatistics

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

فیلدها
new_ items

int64

موارد تازه اضافه شده توسط این فید. بسته به نوع فید، آیتم‌ها می‌توانند تاجر، خدمات یا جایگاه‌های دسترسی باشند.

existing_ items

int64

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

deleted_ items

int64

موارد دیگر در این فید وجود ندارند و در نتیجه حذف شدند.

وضعیت فید

وضعیت فید آپلود شده توسط پلتفرم جمع‌آور.

فیلدها
name

string

نام منبع فید که دارای قالب است

  • partners/{partner_id}/feeds/merchants/{file_name}
  • partners/{partner_id}/feeds/services/{file_name}
  • partners/{partner_id}/feeds/availability/{file_name}
state

State

وضعیت پردازش این خوراک.

error_ details

string

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

statistics

FeedStatistics

آمار مخصوص این فید.

ایالت

Enum برای نشان دادن وضعیت پردازش یک خوراک.

Enums
STATE_UNSPECIFIED مقدار پیش فرض استفاده نشده
IN_PROGRESS فید هنوز در حال پردازش است.
SUCCESS فید با موفقیت پردازش شد.
FAILURE هنگام پردازش فید با خطایی مواجه شدیم.

Food OrderingMetadata

ابرداده برای پیوندهای اقدام به سفارش غذا.

فیلدها
fee_ details[]

FeeDetails

جزئیات هزینه های پرداخت شده به کاربر در بالای مورد. تکرار شده برای انواع مختلف هزینه مانند هزینه خدمات ، هزینه تحویل و غیره

advance_ order_ details

AdvanceOrderDetails

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

Union Field fulfillment_duration_options . مدت زمان تحقق سفارش از تأیید سفارش. برای سفارشات تحویل ، مدت زمان تا زمان تحویل غذا. برای سفارشات وانت ، مدت زمان تا زمان آماده شدن غذا برای وانت. fulfillment_duration_options فقط می تواند یکی از موارد زیر باشد:
fulfillment_ lead_ time_ duration

Duration

مدت زمان ثابت به عنوان مثال: 30 دقیقه.

fulfillment_ lead_ time_ duration_ range

DurationRange

طیف وسیعی از مدت زمان. مثال: * 30 دقیقه تا 45 دقیقه * بیشتر از 30 دقیقه * کمتر از 50 دقیقه

AdvilorderDetails

برای پشتیبانی پیش رو.

فیلدها
is_ supported

bool

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

خوراک

جزئیات هزینه

فیلدها
type

FeeType

نوع هزینه (الزامی)

fee_ amount

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 ٪ و 1.5-2.5 USD ، 10.5 ٪ -20 ٪ و 2.5-3.5 USD

فیلدها
cart_ percentage

QuantitativeValue

هزینه از نظر درصد از ارزش سبد خرید. از دامنه (محدود و بدون مرز) یا درصد ثابت پشتیبانی می کند. مقدار باید بین 0 تا 100 باشد. مثال: * 5.5 ٪ ثابت * حداقل 5.5 ٪ * حداکثر 5.5 ٪ * 4.5 ٪ تا 5.5 ٪

UNION FIELD amount_options . گزینه هایی برای مشخص کردن مبلغ پولی. amount_options فقط می توانند یکی از موارد زیر باشند:
amount

Money

مقدار ثابت به عنوان مثال 3.5 دلار.

amount_ range

MoneyRange

دامنه مقدار مثالها: * 3.5 دلار تا 5.5 دلار * حداقل 3.5 دلار * حداکثر 5.5 دلار

amount_ unknown

bool

مقدار ناشناخته

نوع پاها

نوع هزینه

Enums
FEE_TYPE_UNSPECIFIED نوع هزینه نامشخص.
DELIVERY برای هزینه های تحویل
SERVICE برای هزینه خدمات

انجام

گزینه تحقق برای یک لینک اقدام آنلاین سفارش.

فیلدها
fulfillment_ type

FulfillmentType

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

available_ day[]

AvailableDay

مورد نیاز. لیستی از روزهایی که در آن در دسترس بودن برای این روش تحقق وجود دارد (ترجیحاً حداقل 2).

fee_ details

FeeDetails

مورد نیاز. جزئیات هزینه برای روش تحقق.

minimum_ order

Price

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

در دسترس

در دسترس بودن سطح روز.

فیلدها
fulfillment_ date

Date

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

last_ ordering_ time

Timestamp

مورد نیاز. Timestamp UNIX. آخرین باری که یک کاربر می تواند سفارش دهد ، و موارد را با استفاده از fulfillment_date دریافت کند. به عبارت دیگر ، پس از last_ordering_time ، fourfillment_date دیگر به صورت موجود نشان داده نمی شود.

به عنوان مثال ، اگر Flufillment_date 2020-08-10 باشد:-مقدار Last_ordering_time از 2020-08-10 18:00 به این معنی است که ، برای دریافت سفارش خود در 2020-08-10 ، مشتری باید آن سفارش را تا ساعت 6 عصر انجام دهد همان روز -یک مقدار Last_ordering_time از 2020-08-08 20:00 به این معنی است که برای دریافت سفارش خود در 2020-08-10 ، مشتری باید دو روز قبل از 8 شب آن سفارش را انجام دهد.

خوراک

جزئیات هزینه برای روش تحقق مرتبط با لینک عمل.

فیلدها
Union Field fee_details . مدل هزینه برای روش تحقق. fee_details فقط می تواند یکی از موارد زیر باشد:
no_ fee

NoFee

هزینه ای برای روش تحقق ندارد.

base_ fee

MinimumFee

هزینه پایه مرتبط با روش تحقق.

fixed_ fee

FixedFee

هزینه ثابت مرتبط با روش تحقق.

ثابت

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

فیلدها
amount

Price

مورد نیاز. مبلغ هزینه ثابت برای روش تحقق.

رفیق

نوع تحقق مرتبط با یک لینک عمل.

Enums
FULFILLMENT_TYPE_UNSPECIFIED نوع تحقق نامشخص است.
FULFILLMENT_TYPE_DELIVERY نوع تحقق تحویل است.
FULFILLMENT_TYPE_PICKUP نوع تحقق وانت است.

حداقل

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

فیلدها
base_ fee_ amount

Price

مورد نیاز. مبلغ هزینه پایه برای روش تحقق.

نافری

این نوع هیچ فیلدی ندارد.

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

صفحه اصلی

ضبط شده از نوع خوراک ذکر شده در درخواست URL حذف می شود.

فیلدها
delete_ time

Timestamp

مورد نیاز. از این زمان سنج برای تعیین ترتیب استفاده از حذف برای موجودی استفاده می شود.

Union Field record_type . شرکای مختلف Feed (Ndjson ، Proto و غیره) را می تواند یک رکورد کامل شبیه به نحوه ارائه یک رکورد در API Feed یا Batchpush ارائه دهد. شرکا همچنین این گزینه را دارند که فقط زمینه های اساسی یک رکورد مورد نیاز برای شناسایی منحصر به فرد آن را در بر گیرند. record_type فقط می تواند یکی از موارد زیر باشد:
data_ record

bytes

برای فیدهای مبتنی بر غیر پروتو.

proto_ record

Any

برای فیدهای مبتنی بر پروتئین.

عکسبرداری عمومی

سابقه نوع خوراک ذکر شده در درخواست URL.

فیلدها
generation_ timestamp

Timestamp

مورد نیاز. از این Timestamp برای اطمینان از سفارش صحیح به روزرسانی موجودی استفاده می شود.

Union Field record_type . انواع مختلفی از خوراک (Ndjson ، Proto و غیره) record_type ضبط کنید.
data_ record

bytes

برای فیدهای مبتنی بر غیر پروتو.

proto_ record

Any

برای فیدهای مبتنی بر پروتئین.

زمین

داده های جغرافیایی یک مکان ، از جمله عرض جغرافیایی ، طول جغرافیایی و آدرس.

فیلدها
latitude

double

عرض جغرافیایی در درجه. (اختیاری)

longitude

double

طول جغرافیایی (اختیاری)

addresses حوزه اتحادیه. آدرس برای یک مکان ، می تواند ساختار یافته یا بدون ساختار باشد. addresses فقط می توانند یکی از موارد زیر باشند:
address

PostalAddress

آدرس پستی محل ، ترجیح داده شده است.

unstructured_ address

string

یک آدرس بدون ساختار نیز می تواند به عنوان یک بازپرداخت ارائه شود. به عنوان مثال "1600 Amphitheater Parkway Mountain View ، CA 94043"

getAdsAccountLinkRequest

درخواست پیام برای adsaccountlinkingservice.getAdsAccountLink.

فیلدها
name

string

مورد نیاز. نام پیوند حساب ADS برای بازیابی. فرمت: partners/{partner}/adsAccountLinks/{ads_account_link}

GetMerchantStatusRequest

درخواست دریافت یک MerchantStatus

فیلدها
name

string

مورد نیاز. نام منبع ، در قالب شرکا/{شریک_ید}/بازرگانان/{merchant_id}/وضعیت.

getStatusRequest

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

فیلدها
name

string

نام منبع خوراک ، که دارای قالب است

  • partners/{partner_id}/feeds/merchants/{file_name}
  • partners/{partner_id}/feeds/services/{file_name}
  • partners/{partner_id}/feeds/availability/{file_name}

HomeServicedata

اطلاعات اضافی لازم برای ارائه خدمات به صورت عمودی ارائه می شود.

فیلدها
category_ type

string

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

job_ type

string

نوع شغلی تحت مقوله ای که سرویس خانه داده شده به آن تعلق دارد. به عنوان مثال unclog_drain ، install_faucet انواع کار در گروه لوله کشی هستند.

نوع ادغام

عمق ادغام پشتیبانی می شود.

Enums
INTEGRATION_TYPE_UNSPECIFIED پیش فرض به end_to_end.
INTEGRATION_TYPE_END_TO_END ادغام کامل که به پایان می رسد پایان رزرو از طریق Google.
INTEGRATION_TYPE_INVENTORY_ONLY سرور رزرو نیازی به پشتیبانی از این سرویس ندارد. فقط بازرگانان ، خدمات و (اختیاری) داده های در دسترس بودن باید ارسال شوند.

InvalidaterEsourcerequest

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

فیلدها
resource_ id

string

نام منبعی که قابل اعتبار است.

به عنوان مثال ، برای یک منبع وانت ، نام باید از فرمت partners/{partner_id}/pickups/{pickup_id} برخوردار باشد. پیاده سازی ها باید نسخه های ذخیره شده از منبع شناسایی شده را حذف کنند.

خط

یک مورد واحد به ترتیب-رزرو یک سرویس واحد در یک شکاف واحد.

فیلدها
service_ id

string

شناسه خدمات بازرگان.

start_ sec

int64

زمان شروع شکاف قرار ملاقات را در ثانیه از زمان UTC از زمان UNIX EPOCH شروع کنید.

duration_ sec

int64

مدت زمان شکاف قرار ملاقات در ثانیه.

tickets[]

OrderedTickets

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

price

Price

قیمت کل (به استثنای مالیات) این مورد خط.

status

BookingStatus

وضعیت مورد خط.

orderedtickets

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

فیلدها
ticket_ id

string

شناسه از نوع بلیط.

count

int32

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

ListMerchantStatusEsRequest

درخواست برای دریافت لیستی از MerchantStatus

فیلدها
parent

string

مورد نیاز. والدین ، ​​که صاحب این مجموعه از وضعیت بازرگان است. قالب: partners/{partner_id}/merchants

page_ size

int32

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

page_ token

string

اختیاری. در صورت وجود ، مقدار NextPageToken از یک لیست قبلی ListMerchantStatusResponse بازگشت.

booking_ inventory_ status_ restrict

BookingInventoryStatus

اختیاری. محدودیت اختیاری برای فیلتر کردن نتایج با رزرو وضعیت موجودی.

waitlist_ inventory_ status_ restrict

WaitlistInventoryStatus

اختیاری. محدودیت اختیاری برای فیلتر کردن نتایج با وضعیت موجودی لیست انتظار.

geo_ match_ restrict

GeoMatchingStatus

اختیاری. محدودیت اختیاری برای فیلتر کردن نتایج با وضعیت تطبیق GEO.

رزرو

وضعیت موجودی رزرو پایان به پایان.

Enums
BOOKING_INVENTORY_STATUS_UNSPECIFIED مشخص نشده است.
NO_VALID_FUTURE_INVENTORY بازرگان در 30 روز آینده موجودی رزرو ندارد.
HAS_VALID_FUTURE_INVENTORY بازرگان در 30 روز آینده موجودی رزرو دارد.

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

وضعیت تطبیق GEO بازرگان.

Enums
GEO_MATCHING_STATUS_UNSPECIFIED مشخص نشده است.
GEO_UNMATCHED بازرگان با GEO مطابقت ندارد.
GEO_MATCHED بازرگان با GEO مطابقت دارد.

WaitlistinventoryStatus

وضعیت موجودی لیست انتظار پایان به پایان.

Enums
WAITLIST_INVENTORY_STATUS_UNSPECIFIED مشخص نشده است.
NO_VALID_WAITLIST_SERVICE بازرگان از لیست انتظار خدمات پشتیبانی نمی کند.
HAS_VALID_WAITLIST_SERVICE بازرگان دارای سرویس پشتیبانی از لیست انتظار است.

listmerchantstatusesresponse

پاسخ به لیست MerchantStatus .

فیلدها
merchant_ statuses[]

MerchantStatus

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

next_ page_ token

string

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

لیست

درخواست بازیابی Status برای چندین فید بارگذاری شده توسط پلت فرم جمع کننده.

فیلدها
name

string

نام منبع خوراک ، که دارای قالب است

  • partners/{partner_id}/feeds/merchants
  • partners/{partner_id}/feeds/services
  • partners/{partner_id}/feeds/availability
page_ size

int32

حداکثر تعداد موارد برای بازگشت.

page_ token

string

مقدار NEXT_PAGE_TOKEN در صورت وجود از درخواست لیست قبلی بازگردد.

state_ restrict

State

اختیاری محدود به نتایج فیلتر توسط حالت خوراک.

time_ range_ restrict

TimeRange

اختیاری محدود به نتایج فیلتر با محدودیت بالا و پایین. اگر Start_Time غیرقانونی باشد ، به طور پیش فرض تا ابتدای زمان یونیکس خواهد بود. اگر end_time غیرقانونی باشد ، اکنون به طور پیش فرض خواهد بود.

پاسخ لیست

درخواست بازیابی Status برای چندین فید بارگذاری شده توسط پلت فرم جمع کننده.

فیلدها
status[]

FeedStatus

لیست زمانی معکوس وضعیتهای فیدهای بارگذاری شده. حداکثر تعداد موارد برگشتی بر اساس قسمت page_size در درخواست است.

next_ page_ token

string

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

نوشابه

نمونه ای از یک رشته در یک محلی.

فیلدها
locale

string

کد زبان IETF BCP 47 ، مانند "en" ، "MAS" ، "Zh-Hant" ، "DE-CH-1901". به http://www.w3.org/international/articles/language-tags/ مراجعه کنید.

value

string

پیام در محل فوق (UTF-8).

مکان

اطلاعات جغرافیایی در مورد یک مکان.

فیلدها
place_ id

string

شناسه مکان برای مکانی در پایگاه داده Google Places و در Google Maps. برای اطلاعات بیشتر در مورد شناسه های مکان ، به https://developers.google.com/places/web-service/place-id مراجعه کنید. اگر این امر فراهم شود ، Google مکان را با این مکان مطابقت می دهد.

name

string

از نام ، تلفن ، URL و GEO این مکان برای پشتیبانی از تطبیق مکان با مکانهایی که قبلاً در Google Maps حضور دارند استفاده می شود.

این قسمت اختیاری است ، اما ممکن است در برخی زمینه ها مورد نیاز باشد. به عنوان مثال ، یک سرویس. محل بدون نام با یک نهاد تجاری مطابقت نخواهد داشت ، حتی اگر در همان آدرس قرار داشته باشند. (اختیاری)

telephone

string

شماره تلفن عمومی محل از جمله کدهای کشور و منطقه آن ، به عنوان مثال +14567891234. (اختیاری)

url

string

URL وب سایت عمومی مکان. (اختیاری)

geo

GeoCoordinates

اطلاعات جغرافیایی محل ، از جمله عرض جغرافیایی ، طول جغرافیایی و آدرس. (اختیاری)

location_ type

LocationType

در صورت ارائه این مکان برای یک سرویس ، نوع مکان ، باید تأمین شود.

location_ id

string

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

نوع مکان

نوع این مکان

Enums
LOCATION_TYPE_UNSPECIFIED نوع مکان نامشخص.
VISITED_LOCATION مکانی که این سرویس از آن بازدید می کند.
START_LOCATION مکانی که این سرویس شروع می شود ، همچنین به عنوان SCEET_LOCATION خدمت می کند.
END_LOCATION مکانی که این سرویس به پایان می رسد.

بازرگان

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

فیلدها
name

string

نام منبع بازرگان ، که دارای فرمت partners/{partner_id}/merchants/{merchant_id} است.

merchant_ name

string

از Merchant_Name ، Teleplle ، URL و GEO برای پشتیبانی از موجودی شریک زندگی با بازرگانانی که قبلاً در Google Maps حضور دارند استفاده می شود. این اطلاعات نمایش داده نمی شود.

نام بازرگان.

telephone

string

شماره تلفن عمومی بازرگان از جمله کدهای کشور و منطقه آن ، به عنوان مثال +14567891234.

url

string

URL وب سایت عمومی بازرگان.

geo

GeoCoordinates

اطلاعات جغرافیایی بازرگان ، از جمله عرض جغرافیایی ، طول و آدرس.

category

string

دسته تجارت در پلتفرم Aggregator.

num_bookings_30d
(deprecated)

int64

این فیلد منسوخ شده است.

tax_rate_basis_points
(deprecated)

uint32

نرخ مالیات بازرگان در نقاط پایه (یک صدم یک درصد). به عنوان مثال ، اگر نرخ مالیات 7.5 ٪ باشد ، این قسمت باید روی 750 تنظیم شود.

اگر این قسمت UNET باقی مانده یا روی 0 تنظیم شود ، کل قیمت که برای هر سرویس ارائه شده توسط این بازرگان به کاربر شارژ می شود ، قیمت دقیقی است که توسط Service.Price مشخص شده است. فرض بر این است که قیمت خدمات از مالیات های قابل اجرا معاف است یا در حال حاضر شامل مالیات های قابل اجرا است. مالیات به عنوان یک مورد خط جداگانه به کاربر نشان داده نمی شود.

اگر این قسمت به هر ارزش غیرزرو تنظیم شود ، کل قیمت که برای هر خدمتی که توسط این بازرگان ارائه شده است به کاربر پرداخت می شود ، قیمت خدمات به علاوه مالیات ارزیابی شده با استفاده از نرخ مالیات ارائه شده در اینجا را شامل می شود. کسری از کوچکترین واحد ارزی (به عنوان مثال ، کسری از یک درصد) با استفاده از نزدیکترین حتی گرد گرد می شوند. مالیات به عنوان یک مورد خط جداگانه به کاربر نشان داده می شود.

این قسمت مستهلک می شود ، لطفاً به جای آن از مالیات_رایت استفاده کنید.

tax_ rate

TaxRate

نرخ مالیات بازرگان. در صورت وجود این زمینه ، قسمت مستهلک شده مالیات_ rate_basis_points را نادیده می گیرد. یک پیام خالی (یعنی مالیات_ {}) نرخ مالیات اعمال شده را به صفر بازنشانی می کند.

payment_ restrictions

PaymentRestrictions

محدودیت در روش های پرداختی که این بازرگان می پذیرد. اگر این قسمت تنظیم نشده باشد ، هیچ محدودیتی وجود ندارد.

payment_ option[]

PaymentOption

گزینه های پرداخت موجود برای این بازرگان. خدمات تحت این بازرگان قادر خواهند بود گزینه های پرداختی را که اجازه می دهند به صورت جداگانه محدود کنند.

payment_processor_config
(deprecated)

PaymentProcessorConfig

پیکربندی برای یک پردازنده پرداخت توکن ، اگر بازرگان از آن پشتیبانی می کند.

tokenization_ config

TokenizationConfig

پیکربندی برای یک پردازنده پرداخت توکن ، اگر بازرگان از آن پشتیبانی می کند.

terms

Terms

شرایط و ضوابط بازرگان خاص هنگام رزرو سرویس از طریق Reserve با Google به کاربر نمایش داده می شود. علاوه بر این شرایط و ضوابط شریک جمع همیشه به کاربر نمایش داده می شود و نباید در اینجا ارائه شود.

brand_ id

string

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

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

اگر فقط یک برند شریک مصرف کننده وجود داشته باشد ، نیازی به تنظیم این زمینه ندارد و می توان آن را نادیده گرفت.

اگر شریک زندگی ...

آیا مارک های مختلف مصرف کننده وجود ندارد؟ -> این زمینه را نادیده بگیرید

آیا مارک های مختلفی که پیکربندی شده اند؟

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

توجه دقیق: اکثر شرکا نیازی به تنظیم این زمینه ندارند. اگر شریک زندگی بخواهد از این قسمت استفاده کند ، ابتدا باید برای پیکربندی مارک های جداگانه ، از جمله مارک پیش فرض ، ابتدا با ما تماس بگیرند.

matching_ hints

MerchantMatchingHints

نکات برای کمک به Google با یک بازرگان با مکانی در Google Maps مطابقت دارد. توجه: اکثر شرکا نیازی به تنظیم این قسمت ندارند ، زیرا Google با استفاده از اطلاعات ارائه شده در بالا ، بازرگانان را با مکان های Google Maps مطابقت می دهد. (اختیاری)

service_ attribute[]

ServiceAttribute

تعاریف مربوط به هرگونه ویژگی خدماتی که برای توصیف خدمات برای این بازرگان استفاده می شود. (اختیاری)

waitlist_ advisement

Advisement

اختیاری. مشاوره عمومی از یک بازرگان خاص برای کاربر که از طریق Reserve with Google به لیست انتظار می رود. زمینه های متن فردی در مشاوره باید به طول 100 بایت محدود شود.

economic_ operator

EconomicOperator

اختیاری. اطلاعات اپراتور اقتصادی مرتبط با این بازرگان خاص که برای انطباق نظارتی مورد نیاز است. (اختیاری)

بازرگانی

نکات مورد استفاده برای کمک به Google با یک بازرگان با مکانی در Google Maps.

فیلدها
place_ id

string

شناسه مکان برای مکانی در پایگاه داده Google Places و در Google Maps. برای اطلاعات بیشتر در مورد شناسه های مکان ، به https://developers.google.com/places/web-service/place-id مراجعه کنید.

بازرگان

وضعیت یک بازرگان در ذخیره با Google Platform.

فیلدها
name

string

نام منبع وضعیت بازرگان ، که دارای فرمت partners/{partner_id}/merchants/{merchant_id}/status

merchant_ name

string

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

input_ geo_ info

GeoCoordinates

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

processing_ status

ProcessingStatus

وضعیت پردازش بازرگان.

booking_ status

BookingStatus

وضعیت مربوط به ادغام رزرو پایان به انتها.

waitlist_ status

WaitlistStatus

وضعیت مربوط به ادغام لیست انتظار.

geo_ match

PlaceInfo

مکان GEO با این بازرگان. اگر بازرگان با GEO مطابقت نداشته باشد خالی است.

local_ services_ match

LocalServicesMatchInfo

خدمات محلی با این بازرگان مطابقت دارد. اگر این یک بازرگان خدمات محلی نباشد یا با هیچ یک از ارائه دهندگان مطابقت نداشته باشد ، خالی باشد.

direct_ urls[]

DirectUrl

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

رزرو

وضعیت مربوط به ادغام رزرو پایان به انتها.

فیلدها
has_ valid_ future_ inventory

bool

درست است اگر بازرگان در 30 روز آینده موجودی داشته باشد. تضمین نمی کند که بازرگان در واقع ارائه شود.

کارگردانی

URL که بازرگان را سطح می کند.

فیلدها
type

UrlType

نوع این URL.

url

string

URL که ممکن است این بازرگان را سطح کند.

نوع مجریه

نوع آدرس اینترنتی.

Enums
URL_TYPE_UNSPECIFIED مشخص نشده است.
BOOKING URL رزرو پایان به پایان.
WAITLIST URL لیست انتظار پایان به پایان.
LOCAL_SERVICES URL خدمات محلی Google.

محلی

اطلاعات مربوط به خدمات محلی Google (فقط برای بازرگان خدمات محلی تعیین شده است).

فیلدها
matched_ providers[]

MatchedProvider

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

پیشرو

ارائه دهنده خدمات محلی.

فیلدها
customer_ id

int64

شناسه مشتری خارجی Google Services.

categories[]

string

دسته بندی خدمات محلی (عمودی). به عنوان مثال "لوله کشی" و "فرش_ پاک".

محل زندگی

اطلاعات یک مکان همسان

فیلدها
name

string

نام مکان

formatted_ address

string

آدرس فرمت شده به زبان محلی.

place_ id

string

شناسه Google Place این مکان. می توان برای ساخت URL نقشه های Google Maps یا واکشی جزئیات بیشتر در مکان استفاده کرد. برای استفاده به عنوان مثال به https://developers.google.com/places/web-service/place-id مراجعه کنید.

پردازش

وضعیت پردازش بازرگان.

Enums
PROCESSING_STATUS_UNSPECIFIED وضعیت نامشخص
IN_PROGRESS بازرگان توسط ماددن پذیرفته شده است ، اما هنوز در حال پردازش است. بازرگانان در این وضعیت وضعیت دیگری ندارند.
COMPLETED سایر وضعیت های بازرگان محاسبه شده است.

لیست انتظار

وضعیت مربوط به ادغام لیست انتظار.

فیلدها
has_ valid_ waitlist_ service

bool

درست است اگر بازرگان دارای سرویس لیست انتظار باشد. تضمین نمی کند که بازرگان در واقع ارائه شود.

پول

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

فیلدها
min_ amount

Money

حداقل مقدار

max_ amount

Money

حداکثر مقدار

نوشافی

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

فیلدها
fee

Price

مبلغی که کاربر در صورت عدم حضور در رزرو آنها ممکن است شارژ شود.

fee_ type

PriceType

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

سفارش دهید

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

فیلدها
name

string

نام منبع سفارش: partners/{partner ID}/orders/{order ID}

client_ information

ClientInformation

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

payment_ information

PaymentInformation

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

merchant_ id

string

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

item[]

LineItem

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

ordeonlinemetadata

ابرداده برای یک لینک اقدام آنلاین سفارش.

فیلدها
fulfillment_ option[]

FulfillmentOption

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

اطلاعات پرداخت

جزئیات پرداختی که مربوط به رزرو است

فیلدها
prepayment_ status

PrepaymentStatus

وضعیت پیش پرداخت رزرو. اگر پیش پرداخت_ستاتوس پیش پرداخت_پرولیده شده یا پیش پرداخت شده باشد ، پس پرداخت_ transaction_id حاوی شناسه معامله منحصر به فرد مرتبط است.

payment_ transaction_ id

string

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

پرداخت

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

فیلدها
payment_ option_ id

string

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

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

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

name

string

نام گزینه پرداخت. این می تواند کاربر قابل مشاهده باشد.

description

string

شرح گزینه پرداخت. این می تواند کاربر قابل مشاهده باشد.

price

Price

قیمت گزینه پرداخت.

tax_ rate

TaxRate

نرخ مالیات برای این گزینه پرداخت. در صورت وجود این زمینه ، زمینه مالیات_ر موجود در بازرگان یا خدمات را تحت الشعاع قرار می دهد. یک پیام خالی (یعنی مالیات_ {}) نرخ مالیات اعمال شده را به صفر بازنشانی می کند.

payment_ option_ type

PaymentOptionType

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

session_ count

int64

این گزینه پرداخت می تواند برای چند جلسه استفاده شود. فقط برای چند جلسه / بسته ها معتبر است ، جایی که مقدار باید> 1 باشد.

purchase_ interval

TimeRange

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

valid_ interval

TimeRange

گزینه پرداخت می تواند در این بازه استفاده شود (به عنوان مثال قیمت ویژه ژانویه 2017). در صورت وجود ، این امر بر اعتبار_دور و فعال سازی_تایپ غلبه می کند.

valid_ duration

Duration

مدت اعتبار گزینه پرداخت (به عنوان مثال عضویت 30 روزه).

activation_ type

ActivationType

تعیین می کند که چگونه تاریخ شروع اعتبار برای این گزینه پرداخت تعیین می شود.

user_ restriction

UserPurchaseRestriction

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

نوع فعال سازی

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

Enums
ACTIVATION_TYPE_UNSPECIFIED استفاده نشده
ACTIVATION_ON_PURCHASE اعتبار در زمان خرید شروع می شود.
ACTIVATION_ON_FIRST_USE اعتبار هنگامی شروع می شود که برای اولین بار از گزینه پرداخت استفاده می شود.

نوع پرداخت

نوع گزینه پرداخت

Enums
PAYMENT_OPTION_TYPE_UNSPECIFIED استفاده نشده
PAYMENT_OPTION_SINGLE_USE گزینه پرداخت فقط یک بار قابل استفاده است.
PAYMENT_OPTION_MULTI_USE اگر تعداد جلسه آن> 0 باشد ، می توان از گزینه پرداخت استفاده کرد.
PAYMENT_OPTION_UNLIMITED گزینه پرداخت می تواند در محدوده زمانی معتبر خود استفاده شود - تعداد جلسه غیرقابل استفاده است.

پرداخت پردازشگر

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

فیلدها
processor

Processor

شریک پردازنده پرداخت این پیکربندی را مشخص می کند.

public_ key

string

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

برای راه راه ، به: https://stripe.com/docs/dashboard#api-keys برای Braintree مراجعه کنید ، به https://articles.braintreepayments.com/control-panel/important-gateway-credentials مراجعه کنید.

version

string

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

پردازنده

یک شریک پردازنده پرداخت خاص را تعریف می کند.

Enums
PROCESSOR_UNSPECIFIED استفاده نشده
PROCESSOR_STRIPE پیکربندی برای پرداخت با نوار.
PROCESSOR_BRAINTREE پیکربندی برای پرداخت با Braintree.

بازپرداختهای پرداخت

محدودیت در روش های پرداختی که این بازرگان می پذیرد.

فیلدها
credit_ card_ restrictions

CreditCardRestrictions

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

پیشرو

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

فیلدها
delivery_ fee

Price

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

processing_ fee

Price

هزینه ای برای پردازش روش پرداخت کاربر.

باجایی

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

فیلدها
service_ charge

Price

هزینه اضافی برای یک سرویس ارزیابی شده است.

facility_ fee

Price

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

taxes

Price

مالیات بلیط.

پست

آدرس مشتری یا یک تجارت.

فیلدها
address_ country

string

این کشور ، با استفاده از کد کشور ISO 3166-1 Alpha-2 ، به عنوان مثال "ما" (مورد نیاز) مشخص شده است

address_ locality

string

محل ، به عنوان مثال "نمای کوه". (الزامی)

address_ region

string

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

postal_ code

string

کد پستی ، به عنوان مثال "94043". (الزامی)

street_ address

string

آدرس خیابان ، به عنوان مثال "1600 آمفی تئاتر PKWY". (الزامی)

پیش پرداخت

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

فیلدها
price_ info

PriceInfo

کانتینر برای جزئیات قیمت.

پیش پرداخت

وضعیت پیش پرداخت یک رزرو.

Enums
PREPAYMENT_STATUS_UNSPECIFIED مشخص نشده است ، پیش فرض برای پیش پرداخت_نوت_پرول.
PREPAYMENT_PROVIDED هزینه رزرو از قبل پرداخت شده است.
PREPAYMENT_NOT_PROVIDED هزینه رزرو از قبل پرداخت نشده است.
PREPAYMENT_REFUNDED این هزینه قبلاً پیش پرداخت_ ارائه شده بود اما اکنون بازپرداخت شده است.

قیمت

قیمت یک سرویس یا هزینه.

فیلدها
price_ micros

int64

قیمت در واحدهای خرد ارز. کسری از واحد کوچکترین واحد ارز با استفاده از نزدیکترین حتی گرد گرد می شوند. (به عنوان مثال برای 2.5 سنت دلار به 2 سنت ، 3.5 سنت دور به 4 سنت ، 0.5 سنت گرد به 0 سنت ، 2.51 سنت گرد تا 3 سنت).

currency_ code

string

ارز قیمتی که در ISO 4217 تعریف شده است.

pricing_ option_ tag

string

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

قیمت

کانتینر برای جزئیات قیمت.

فیلدها
price_ type

PriceType

نحوه اعمال قیمت یا محدوده قیمت را تعریف می کند (برای هر نفر یا ثابت)

Union Field price_options . گزینه های قیمت برای تعیین قیمت دقیق یا دامنه است. price_options فقط می تواند یکی از موارد زیر باشد:
price

Price

قیمت یک سرویس یا هزینه.

price_ range

PriceRange

حد بالایی و/یا پایین یک سرویس یا هزینه.

تفسیر قیمت

توصیف می کند که چگونه یک قیمت باید تفسیر و به کاربر نمایش داده شود.

Enums
PRICE_INTERPRETATION_UNSPECIFIED تفسیر قیمت نامشخص ، پیش فرض به دقیق_مونت.
EXACT_AMOUNT

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

مثال: 20 دلار برای کلاس یوگا ؛ 15 دلار برای مدل موهای کودک

STARTS_AT

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

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

مثالها: 30 دلار برای نظافت سگ ، اما گزینه های اضافی مصرف کننده ممکن است قیمت را افزایش دهد

NOT_DISPLAYED

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

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

مثال: مشاوره برای یک سرویس خانگی

محدوده قیمت

بسته بندی برای طیف وسیعی از مبلغ پولی که به صورت نامحدود رفتار می شوند مگر اینکه هر دو مقدار تنظیم شوند. حداقل یکی از min_amount و max_amount لازم است.

فیلدها
min_ price

Price

حداقل مقدار

max_ price

Price

حداکثر مقدار همیشه باید> min_price باشد.

نوع قیمت

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

Enums
FIXED_RATE_DEFAULT

قیمت برای مبلغ ثابت است. اگر این قسمت تنظیم نشده باشد ، این مقدار پیش فرض است.

مثالها: سپرده 50 دلار برای رزرو جدول ؛ 20 دلار بدون هزینه نمایش برای کلاس یوگا

PER_PERSON

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

مثالها: 10 دلار برای هر بلیط به یک موزه

مقدار کمی

بسته بندی برای یک مقدار عددی که می تواند یک محدوده یا یک مقدار ثابت باشد. مثالهای QuantitativeValue : * مقدار مفرد: value: 10.5 * محدوده محدود: value_range {min_value: 5.5, max_value 10.5} * محدوده پایین: value_range {min_value: 5.5} * حد بالایی: value_range {max_value: 10.5}

فیلدها
Union Field value_options . (مورد نیاز) value_options فقط می تواند یکی از موارد زیر باشد:
value

double

یک مقدار مفرد به عنوان مثال: 5.6

value_ range

RangeValue

طیف وسیعی از مقادیر که می توانند باز یا محدود شوند. مثال: * حداقل 5.5 * حداکثر 5.5 * 5.5 تا 6.5

دامنه مقادیر

دامنه مقادیر به گونه ای که min_value < max_value . حداقل به یکی از min_value و max_value نیاز دارد.

فیلدها
min_ value

double

حداقل مقدار

max_ value

double

حداکثر مقدار

رتبه بندی

رتبه بندی را برای یک موجود تعریف می کند.

فیلدها
value

double

مقدار متوسط ​​رتبه بندی (در صورت نیاز به شماره_of_ratings> 0). مقدار باید در محدوده [1 ، 5] باشد و اگر و فقط اگر شماره_ف_راتینگ صفر باشد ، می تواند حذف شود.

number_ of_ ratings

uint64

تعداد رتبه بندی های مورد استفاده در محاسبه مقدار (مورد نیاز).

وابسته

عکسهای مربوط به این سرویس. Google این رسانه ها را خزنده می کند تا اطمینان حاصل شود که آنها به درستی برای کاربران نهایی نمایش داده می شوند. (اختیاری)

فیلدها
url

string

URL این منبع رسانه ای. Google رسانه های میزبانی شده در این URL را خزنده می کند.

type

MediaType

نوع این منبع رسانه ای.

localized_ caption

Text

عنوان رسانه ای که از i18n پشتیبانی می کند ، فقط متن ساده پشتیبانی می شود. هر مؤلفه HTML سلب می شود. (اختیاری)

attribution

Attribution

اطلاعات مربوط به منبع رسانه. توجه داشته باشید که در صورت نیاز به انتساب برای نمایش با رسانه ها برای اعتبار به عکاس یا آژانس ، این زمینه باید تنظیم شود. (اختیاری)

caption
(deprecated)

string

مستهلک ، ترجیح می دهید از boalized_caption استفاده کنید.

انتساب

اطلاعات مربوط به این رسانه.

فیلدها
localized_ text

Text

متن برای اعتبار به عکاس یا آژانس پشتیبانی I18N. این متن به همراه رسانه منبع نمایش داده می شود. توجه داشته باشید که فقط متن ساده برای این زمینه پشتیبانی می شود ، هر مؤلفه HTML سلب می شود (انتساب مبتنی بر لینک پشتیبانی نمی شود).

text
(deprecated)

string

کاهش یافته ، ترجیح می دهید از boalized_text استفاده کنید.

MediaType

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

Enums
TYPE_UNSPECIFIED استفاده نشده
PHOTO نشان می دهد رسانه های ارائه شده توسط URL یک عکس است.

chepraceserviceailabilityrequest

درخواست برای جایگزینی در دسترس بودن Service .

فیلدها
service_ availability

ServiceAvailability

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

costecreditcard

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

Enums
REQUIRE_CREDIT_CARD_UNSPECIFIED نیاز کارت اعتباری به صراحت مشخص نشده است و رفتار با آنچه برای مشروط مشخص شده است یکسان است.
REQUIRE_CREDIT_CARD_CONDITIONAL در صورت برآورده شدن هر یک از شرایط زیر ، Google به کارت اعتباری برای رزرو نیاز دارد: * در دسترس بودن قیمت دارد و پیش پرداخت_تایپ مورد نیاز است * NO_SHOW_FEE تنظیم شده است * قسمت سپرده تنظیم شده است.
REQUIRE_CREDIT_CARD_ALWAYS کارت اعتباری همیشه برای رزرو این در دسترس بودن بدون در نظر گرفتن سایر مقادیر میدانی مورد نیاز است.

منابع

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

فیلدها
staff_ id

string

شناسه اختیاری برای یک کارمند ارائه دهنده خدمات. این زمینه عضو کارکنان را در همه بازرگانان ، خدمات و سوابق در دسترس بودن مشخص می کند. همچنین باید با گذشت زمان پایدار باشد تا همبستگی با رزرو گذشته فراهم شود. در صورت حضور Staff_Name ، این قسمت باید حضور داشته باشد.

staff_ name

string

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

room_ id

string

یک شناسه اختیاری برای اتاقی که در آن واقع شده است. این قسمت اتاق را در همه بازرگانان ، خدمات و سوابق در دسترس بودن مشخص می کند. همچنین باید با گذشت زمان پایدار باشد تا همبستگی با رزرو گذشته فراهم شود. در صورت وجود اتاق_ نام ، این قسمت باید حضور داشته باشد.

room_ name

string

یک نام اختیاری برای اتاقی که در آن واقع شده است. این قسمت برای کاربرانی که رزرو می کنند نمایش داده می شود و باید بر خلاف یک شناسه مات ، قابل خواندن باشد. (اختیاری اما لازم است اگر اتاق_د وجود داشته باشد) در ناهار خوری یک اتاق فقط باید برای مناطق نشیمن مانند نوار یا پاسیو استفاده شود و نباید برای منوهای قیمت ثابت ، فعالیتهای ویژه یا هر مقدار غیر اتاق دیگر استفاده شود (مانند رزرو یا شام). به شدت توصیه می شود که فضای صندلی پیش فرض اتاقی در ارتباط با آن نداشته باشد.

party_ size

int32

فقط برای ناهار خوری قابل اجرا است: اندازه مهمانی که در این شکاف می تواند در آن جای بگیرد. یک رستوران می تواند در همان زمان با چندین شکاف همراه باشد ، هر کدام یک مهمانی متفاوت را مشخص می کنند ، اگر به عنوان مثال 2 ، 3 یا 4 نفر با رزرو نشسته باشند.

room_ description

Text

اختیاری. توضیحات اتاق محلی. در صورت تنظیم ، یک مقدار پیش فرض باید ارائه شود. ترجیح داده می شود زبان های متداول را برای محل بازرگان نیز فراهم کنیم. (اختیاری)

برنامه زمانبندی

قوانین برنامه ریزی برای یک سرویس.

فیلدها
min_ advance_ online_ canceling

int64

حداقل اخطار قبلی در ثانیه های لازم برای لغو قرار ملاقات رزرو شده به صورت آنلاین. (اختیاری)

late_cancellation_fee
(deprecated)

Price

هزینه لغو در حداقل دوره اخطار قبلی.

noshow_fee
(deprecated)

Price

هزینه بدون نمایش بدون لغو.

admission_ policy

AdmissionPolicy

خط مشی پذیرش که در مورد این سرویس اعمال می شود. در صورت عدم استفاده ، به طور پیش فرض به TIME_STRICT. (اختیاری)

cancellation_ policy

CancellationPolicy

برنامه ریزی قوانین لغو قوانین. (برای کارها لازم است)

Union Field min_booking_buffer . مدت زمان (در ثانیه) از زمانی که آخرین رزرو می تواند با شروع یا پایان کار در دسترس باشد.

اگر "min_advance_booking" تنظیم شود ، آخرین زمان قابل رزرو به صورت (<زمان شروع کار> - "min_advance_booking" محاسبه می شود). اگر "min_booking_buffer_before_end_time" تنظیم شده باشد ، آخرین زمان قابل رزرو به صورت (<زمان پایان شکاف> - "min_booking_buffer_before_end_time" محاسبه می شود). توجه داشته باشید که در صورت تنظیم ، مقدار "min_booking_buffer_before_end_time" باید مثبت باشد. اگر هر دو مورد باز نیستند ، شکاف قابل رزرو است تا زمان شروع شکاف. اگر هر دو قسمت تنظیم شوند ، فقط یک مقدار انتخاب می شود در حالی که مقدار دیگر نادیده گرفته می شود-ما نمی توانیم با اطمینان پیش بینی کنیم که کدام مقدار انتخاب شده است.

مثال ها:

  • مدل مو که حداقل 1 ساعت قبل از زمان شروع باید رزرو شود. 'SHANLING_RULES {min_advance_booking: 3600 ...} `

  • موزه ای که آخرین بلیط را می توان 30 دقیقه قبل از بسته شدن خریداری کرد: "برنامه ریزی_رول {min_booking_buffer_before_end_time: 1800 ...} '

  • بلیط فیلم که باید قبل از زمان شروع خریداری شود. 'scheduling_rules {...}' (این قسمت را خالی بگذارید) (اختیاری) min_booking_buffer تنها یکی از موارد زیر است:

min_ advance_ booking

int64

مدت زمان (در ثانیه) از زمانی که آخرین رزرو با شروع شکاف در دسترس بودن می تواند انجام شود.

min_ booking_ buffer_ before_ end_ time

int64

The duration (in seconds) from when the last booking can be made to when the availability slot ends. If this field is set, the "admission_policy" field must be set to TIME_FLEXIBLE to indicate that users can use the purchased tickets after slots start.

AdmissionPolicy

The admission policy of this service.

Enums
ADMISSION_POLICY_UNSPECIFIED استفاده نشده
TIME_STRICT Customers are required to be present at the start time of the availability slot, and the service is expected to finish at the end time of the slot. Examples of TIME_STRICT use cases: * A tour that starts at 9am that requires all attendees to arrive at the start time, and returns at around 12pm. * A haircut reservation at 3pm on Saturday that will take approximately 30 minutes. * A fitness class from 6pm to 8pm.
TIME_FLEXIBLE

Customers can arrive at any time between the start and end time of the availability slot to use this booking.

Examples of TIME_FLEXIBLE use cases: * A museum ticket that can be used during any time on the purchase date. * An afternoon admission to an amusement park that can be used from 12pm to 9pm.

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Customers need to arrive at the merchant at the start time of the availability slot but can leave any time they want.

For example, in the museum admission scenario, a timed entry ticket for 10am requires the user to be at the museum at 10am. The start time of availability slots for this service represents the designated entry time. The end time, however, is used solely as a key to identify the availability slot for booking.

خدمات

Info about a service that is provided by the merchant, eg haircut.

فیلدها
name

string

The service resource name, which has the format of partners/{partner_id}/merchants/{merchant_id}/services/{service_id} .

service_ name

string

The name of the service, eg "Men's haircut". Deprecated, use localized_service_name instead.

localized_ service_ name

Text

The name of the service, eg "Men's haircut". Possibly in several locales.

description

string

The user-visible description of the service. Deprecated, use localized_description instead.

localized_ description

Text

The user-visible description of the service.

This field supports both plain-text and HTML-like formatting. Unlike plain text sections, customized layouts can be created here using headings, paragraphs, lists and some phrase tags. Please read the following instructions and notes carefully to ensure you create the best user-experience.

Supported HTML-like formatting tags:

Heading tags: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Heading tags can be used to display titles and sub-titles. For example, <h1>Itinerary</h1> will display the inline text as the most important heading of the section. Note that any inner HTML tags, styles or attributes will be ignored. For example, <h1 style=".."> will be treated the same as <h1>. Only pure text wil be preserved.

Paragraph tag: <p>
The paragraph tag can be used to highlight a detailed introduction or contents. Any inner tags, styles or attributes will be ignored, with a few exceptions: <br>, <strong> and <em>. Please see the phrase tag section below for more details.

List tags: <ul>, <ol>, <li>
The <ul> tag can be used with the <li> tag to display unordered lists, and the <ol> tag can be used with <li> to display ordered lists. This is a good way to display checklists, schedules, or any other lists that fit your use-cases.
Example: To show a list of features of a cruise trip:
<ol>
<li>Wonderful ocean view and chances to play with wildlife.</li>
<li>Carefully designed travel arrangements and services.</li>
<li>Guaranteed lowest price.</li>
</ol>
Note that only <li> children under <ul> or <ol> tags will be converted. All other children will be dropped. Also, any inner tags, attributes and styles will be ignored; we only preserve pure text contents.

Division tag: <div>
All supported inner tags of the <div> tag will be parsed with the rules stated above, imply <div> tag itself does not mean any grouping or indenting here. Also, any inner attributes and styles will be ignored.

Phrase tags: <br>, <strong>, <em>:
Only the three tags mentioned above are supported. <br> can be used to break lines in paragraphs, and <strong>/<em> can be used to highlight important text. Any other phrase tags will be ignored.

Unsupported tags:

  • <html>, <header>, and <body> tags are not allowed.
  • Any other tags not mentioned above are not supported (for example <table>, <td> ...).
    Any URLs, anchors, and links will be stripped, and will never be displayed to end-users. If you want to use photos to create a rich user experience, please use the "related_media" field below to send your photo URLs.

نکات مهم:

  • Try not to use other tags except for the supported ones mentioned above, because the contents within unsupported tags will be stripped, and may lead to an undesirable user experience.
  • Try avoid deep nested structures like more than 3 different heading levels or nested lists. Keeping the structure flat, simple, and straightforward, helps to create a better user experience.
  • If the currently supported layouts are not sufficient for your use cases, please reach out to the Reserve with Google team.
  • The recommended maximum size is 32,000 characters.
price

Price

قیمت خدمات.

price_ interpretation

PriceInterpretation

Describes how the price is interpreted and displayed to the user. Can be used by any vertical except Dining and Things To Do to configure display of the service price.

rules

SchedulingRules

Rules to book/cancel an appointment.

prepayment_ type

PrepaymentType

Whether a prepayment is required, optional or not supported.

prepayment_ terms

PrepaymentTerms

Terms around when the prepayment is completed.

form[]
(deprecated)

ServiceIntakeForm

منسوخ شده است. Please use intake_form and per_ticket_intake_form.

intake_ form

ServiceIntakeForm

A form requesting additional information from the user when they book this service. (اختیاری)

per_ ticket_ intake_ form

ServiceIntakeForm

A form requesting additional information from the user when they book this service. This form must be filled out once for each ticket the user is booking. (اختیاری)

tax_ rate

TaxRate

The service's tax rate. If present this field overrides any tax_rate set at the merchant level. An empty message (ie tax_rate { }) will reset the applied tax rate to zero.

payment_ option_ id[]

string

A list of ids referencing the payment options which can be used to pay for this service. The actual payment options are defined at the Merchant level, and can also be shared among multiple Merchants.

deposit

Deposit

Defines how a deposit may be charged to the user. Overrides the service deposit if one was specified. Setting this to an empty Deposit message removes any service-level deposit. (اختیاری)

no_ show_ fee

NoShowFee

Defines a no show fee that may be charged to the user. Overrides the service no show fee if one was specified. Setting this to an empty NoShowFee message removes any service-level no show fee. (اختیاری)

require_ credit_ card

RequireCreditCard

Indicates whether the user must provide a credit card in order to book this service. This field can be overridden at the availability level. (اختیاری)

type

ServiceType

The predefined type of this service. (اختیاری)

ticket_ type[]

TicketType

Types of tickets that can be booked/purchased for this service, if tickets are supported. (اختیاری)

related_ media[]

RelatedMedia

Photos related to this service. Google will crawl and store the media to ensure that they are displayed to end-users in the most efficient way. (اختیاری)

service_ attribute_ value_ id[]

ServiceAttributeValueId

Service attribute values that apply to this service (optional). Each Service may have zero or more values for each service attribute defined in the corresponding Merchant. (اختیاری)

waitlist_ rules

WaitlistRules

Rules to joining the waitlist.

ticketing_ vertical_ specific_ data

TicketingVerticalSpecificData

Additional information unique to the event ticketing vertical. (اختیاری)

integration_ type

IntegrationType

Depth of integration we support for this service. (optional) Irrelevant for partners with the starter integration. End to end will always be disabled for these partners.

per_ order_ fee

PerOrderFee

Order level fees for purchasing this service. (اختیاری)

tours_ and_ activities_ content

ToursAndActivitiesContent

Content fields specific to Tours and Activities.

location[]

Location

Locations related to this service. IMPORTANT NOTES: If there are multiple visited locations related to this service, or the START_LOCATION is different from the VISITED_LOCATION, the START_LOCATION must be specified. Example: - A guided biking tour visiting three venues, the start venue needs to be specified. - A bus tour meeting at a hotel lobby and then head to the visited venue. The meeting location needs to be specified.

rating

Rating

User rating for this service as an aggregate metric over all reviews.

home_ service_ data

HomeServiceData

Additional information unique to home service vertical. (اختیاری)

virtual_ session

VirtualSession

اختیاری. Information about virtual session. It is required for enabling virtual services.

direct_ merchant_ payment

DirectMerchantPayment

اختیاری. Additional information which needs to be added if the service requires the user to pay directly to the merchant. IMPORTANT NOTE: RwG would not be involved in this transaction. It is required if virtual_session is defined and the service is not free or prepayment_type is NOT set to REQUIRED.

uri_ template

UriTemplate

اختیاری. An optional template specifying how Google should generate URLs to external site.

PrepaymentTerms

Specific information around when prepayment is completed.

فیلدها
charge_ timing

ChargeTiming

When the charge will occur relative to the purchase time.

charge_ time_ before_ start_ time_ sec

int64

Time in seconds before the service start time that the user is charged for payment. This field should only be set when ChargeTiming is CHARGE_LATER.

ChargeTiming

Enum to specify when the charge will occur relative to the purchase time.

Enums
CHARGE_TIMING_UNSPECIFIED استفاده نشده
CHARGE_NOW Customer will be charged immediately.
CHARGE_LATER Customer will be charged later.

PrepaymentType

Enum to indicate the prepayment type.

Enums
PREPAYMENT_TYPE_UNSPECIFIED By default we will assume that the prepayment is NOT_SUPPORTED.
REQUIRED The user has to pay this service at the booking time.
OPTIONAL The user can choose to pre-pay this service at the booking time or later, but it is not required in order to book.
NOT_SUPPORTED The prepayment is not supported for this service.

نوع سرویس

Predefined service types.

Enums
SERVICE_TYPE_UNSPECIFIED استفاده نشده
SERVICE_TYPE_DINING_RESERVATION Dining reservation.
SERVICE_TYPE_FOOD_ORDERING Food ordering, could be either food delivery or takeout or both.
SERVICE_TYPE_FOOD_DELIVERY Food delivery.
SERVICE_TYPE_FOOD_TAKEOUT Food takeout.
SERVICE_TYPE_EVENT_TICKET Event ticket.
SERVICE_TYPE_TRIP_TOUR Trip tour.
SERVICE_TYPE_APPOINTMENT Service that provides appointments or classes. Recommended for (1) health and fitness, (2) spa and beauty, and (3) financial consults and evaluations services. Please see the supported service types: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
SERVICE_TYPE_ONLINE_APPOINTMENT Service that provides online appointment for a class or session which will be fully virtual. Must be set if enabling virtual service bookings.
SERVICE_TYPE_SHOPPING Service that allows users to shop from the given merchant. It could either be delivery or pickup.

ServiceAttribute

Service attributes are partner-defined categories that describe the Services for a Merchant. For example, a bank may define an "Account Type" service attribute with possible values of "Personal" and "Business", while a hair salon may define a "Service Type" service attribute with possible values of "Haircut", "Color", and "Style".

فیلدها
attribute_ id

string

An identifier that uniquely identifies this service attribute among others for the same merchant, eg "account-type".

attribute_ name

string

A user-visible name for this attribute, eg "Account Type".

value[]

Value

All possible values for this service attribute.

ارزش

Represents a possible value for a particular service attribute.

فیلدها
value_ id

string

An identifier that uniquely identifies this value among others for this service attribute, eg "personal".

value_ name

string

A user-visible name for the value, eg "Personal".

ServiceAttributeValueId

Identifies a particular value of a service attribute to be applied to a Service.

فیلدها
attribute_ id

string

ID of an attribute as defined in Merchant.service_attribute, eg "service-type".

value_ id

string

ID of the value for this attribute, eg "haircut". Must match a value_id in the service attribute definition.

ServiceAvailability

A list of availability and who/when they should be applied to.

فیلدها
name

string

The resource name of the service to apply this to. In the format of partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

start_ time_ restrict

Timestamp

If provided, we will consider the Availability entities provided to be a complete snapshot from [start_time_restrict, end_time_restrict). That is, all existing availability will be deleted if the following condition holds true:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

If a duration message is set, the condition is further restricted:

  availability.duration == duration_restrict

If a resources_restrict message is set, the condition is further restricted:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

These fields are typically used to provide a complete update of availability in a given time range.

Setting start_time_restrict while leaving end_time_restrict unset is interpreted to mean all time beginning at start_time_restrict.

end_ time_ restrict

Timestamp

Setting end_time_restrict while leaving start_time_restrict unset is interpreted to mean all time up to the end_time_restrict.

duration_ restrict

Duration

Setting duration further restricts the scope of the update to just the availability with matching duration.

resources_ restrict

Resources

Setting resources_restrict further restricts the scope of the update to just this set of resources. All id fields of the resources must match exactly.

availability[]

Availability

The new list of availability.

ServiceIntakeForm

Defines an intake form that customizes the service provided by a merchant.

فیلدها
field[]

ServiceIntakeFormField

Fields that will be displayed to the user.

first_time_customers
(deprecated)

bool

If true, this form will be shown to first time customers. منسوخ شده است. This functionality is not supported for intake forms.

returning_customers
(deprecated)

bool

If true, this form will be shown to repeat customers. منسوخ شده است. This functionality is not supported for intake forms.

ServiceIntakeFormField

Defines a field that is included in a ServiceIntakeForm.

فیلدها
id

string

A string from an aggregator partner which uniquely identifies a form field. This id should be the same as the id in the corresponding form field answer and must be unique across both the service level and per ticket intake forms. (الزامی)

type

FieldType

The type of this field.

label

string

The text shown to the user for this field. Deprecated, please use localized_label instead.

localized_ label

Text

The text shown to the user for this field. The field can be supplied in multiple locales. (الزامی)

value[]

string

Set if and only if the field type is LOCATION_SEARCH. Please use the "location_id" in the "location" field to specify the location value.

choice_ text[]

Text

Set if and only if the field type is MULTIPLE_CHOICE, CHECKBOXES, or DROPDOWN. Used to enumerate possible choices.

is_ required

bool

Indicates whether an answer to this field is required by a user.

allow_ custom_ answer

bool

Indicates whether a custom value is allowed in additional to predefined answers. This is only applicable when the field type is LOCATION_SEARCH. (اختیاری)

additional_ option[]

Text

Additional options provided in addition to the provided values. Only applicable when the field type is LOCATION_SEARCH. Eg in addition to the provided location list, another available option can be "I will contact supplier later". (اختیاری)

ticket_ type_ restrict[]

string

If this question should only be shown when the user books certain ticket types, this field should be set as the set of applicable ticket type ids. Leave the field empty if the question is always applicable.

hint

Text

The hint text for input, which shows up as a text placeholder. This is only applicable when the field type is SHORT_ANSWER or PARAGRAPH. (اختیاری)

نوع فیلد

Enum to indicate the type of field.

Enums
FIELD_TYPE_UNSPECIFIED Fields of unspecified or unknown type will be ignored.
SHORT_ANSWER A one-line input field for text.
PARAGRAPH A multi-line input field for text.
MULTIPLE_CHOICE A set of radio buttons that requires one choice from many options.
CHECKBOXES One or more enumerated items with checkboxes.
DROPDOWN A selection from a dropdown.
BOOLEAN A yes/no button.

نرخ مالیات

A tax rate applied when charging the user for a service, and which can be set on either a per merchant, or per service basis.

فیلدها
micro_ percent

int32

A tax rate in millionths of one percent, effectively giving 6 decimals of precision. For example, if the tax rate is 7.253%, this field should be set to 7253000.

If this field is left unset or set to 0, the total price charged to a user for any service provided by this merchant is the exact price specified by Service.price. The service price is assumed to be exempt from or already inclusive of applicable taxes. Taxes will not be shown to the user as a separate line item.

If this field is set to any nonzero value, the total price charged to a user for any service provided by this merchant will include the service price plus the tax assessed using the tax rate provided here. Fractions of the smallest currency unit (for example, fractions of one cent) will be rounded using nearest even rounding. Taxes will be shown to the user as a separate line item.

شرایط

A set of rules and guidelines that are displayed to the user in order to make a booking through Reserve with Google.

فیلدها
url

string

Optionally, the URL to the Terms and Conditions.

text

string

The text to be displayed to the user. Use localized_text below for new integrations.

localized_ text

Text

The localized text to be displayed to the user.

متن

A possibly-localized text payload. Some Text fields may contain marked-up content.

فیلدها
value

string

Text value in an unknown locale. Required if and only if localized_value is empty. The locale for this value may depend on the partner or service provider -- it should not be assumed to be any specific language.

localized_ value[]

LocalizedString

Per-locale text values. اختیاری.

TicketType

TicketType is used to differentiate among tickets with different prices and/or availabilities due to different user types, different service attributes, or different options/add-ons.

A ticket is the minimal bookable unit to a service, eg a spot on a rafting trip, an admission to a museum, a full day double kayak rental.

فیلدها
ticket_ type_ id

string

The ticket id is used to differentiate among different ticket types of the same service, and is only expected to be unique within a service.

short_ description

string

A short description to this TicketType.

This can be user visible, eg, “adult”, "child", “veteran”, “Row J”, etc. Required, each ticket type should have a description to be user visible. Deprecated, use localized_short_description instead.

localized_ short_ description

Text

A short description to this TicketType with i18n support.

This can be user visible, eg, “adult”, "child", “veteran”, “Row J”, etc. Required, each ticket type should have a description to be user visible. Separate values could be supplied for each locale.

price

Price

The price of a single ticket of this type, exclusive of any taxes. The tax rate of Service is applied to its tickets.

per_ ticket_ fee

PerTicketFee

Additional fees for purchasing this ticket. (اختیاری)

price_ display_ type

PriceDisplayType

اختیاری. Predetermined price display type of a single ticket of this type.

option_ description

string

Description of any additional option which this ticket type represents, if any. Deprecated, use localized_option_description instead.

localized_ option_ description

Text

Description of any additional option which this ticket type represents, if any. Separate values could be supplied for each locale.

Additional options are useful when the ticket type represents multiple dimensions.

Example 1: an admission ticket with different types 'adult', 'child' and language as an additional option, the expected TicketType list would be: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } }

Example 2: an multi-hour kayak rental with optional dry bag add-on, the short_description could be "3 hours" and the option_description could be either "with dry bag" or "without dry bag": - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } }

Optional, but if any ticket type within the service has this field set, we expect all other ticket types to have this field set as well (a default option_description could be used). Eg [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] is not a valid list.

Only two HTML formatting tags are supported: and
. They are intended to be used for specifying options with both a title and detailed description, for example: " Premium Seating
This option offers seating at the private boxes including fully cushioned seats, private TVs, in-seat food and beverage service. These seats provide picturesque views of the field."

inventory_ type

InventoryType

اختیاری. Predetermined inventory type of a single ticket of this type.

InventoryType

Predetermined inventory type of a single ticket of this type.

Enums
INVENTORY_TYPE_UNSPECIFIED The inventory type is unspecified.
INVENTORY_TYPE_PRIMARY Primary inventory.
INVENTORY_TYPE_VERIFIED_RESALE Verified resale inventory.
INVENTORY_TYPE_RESALE Resale inventory.
INVENTORY_TYPE_AGGREGATOR Aggregator inventory.

PriceDisplayType

Indicates the price format displayed on the landing page.

This field is ignored for non-link-out inventory.

This field allows Google surfaces to show the same price format as used byService the landing page. Consistent price formats improve conversion rate and reduce confusion.

Enums
PRICE_DISPLAY_TYPE_UNSPECIFIED The price display type is unspecified. Google will determine which format to show.
PRICE_DISPLAY_TYPE_BASE The price shown on the landing page is the base price.
PRICE_DISPLAY_TYPE_ALL_IN The price shown on the landing page includes all fees and taxes.

TicketingVerticalSpecificData

Additional information unique to the event ticketing vertical.

فیلدها
event_ category

EventCategory

The category of the event. Set only when event falls into one of the predefined categories. (اختیاری)

event_ url

string

The URL of the event on the partner's website. (اختیاری)

entity[]

Entity

A list of entities related to the event. (اختیاری)

event_ attendance_ mode

AttendanceMode

مورد نیاز. The type of the event attendance.

event_ virtual_ location_ url[]

string

اختیاری. URL where the event can be watched.

event_ organizer

Text

اختیاری. Organizer who hosts the event.

event_ organizer_ url

string

اختیاری. URL of the organizer who hosts the event.

event_ organizer_ type

OrganizerType

اختیاری. The type of the organizer.

event_ source_ url[]

string

مورد نیاز. URL of the pages where the event information or descriptions can be found.

event_ state

EventState

اختیاری. State of the event.

brand_ name

Text

اختیاری. The localized brand name.

event_ creator

EventCreator

اختیاری. Information about the creator of the event.

AttendanceMode

The type of the event attendance.

Enums
ATTENDANCE_MODE_UNSPECIFIED مشخص نشده است.
ONLINE For virtual events.
PHYSICAL For physical events.
PHYSICAL_ONLINE_MIXED For events that are both physical and virtual.

موجودیت

Represents an entity related to the event.

فیلدها
id

string

Unique identifier of the entity in the partner's database. (اختیاری)

name

string

نام نهاد. (الزامی)

url

string

Url of the webpage that unambiguously describes the entity. This is the webpage on the partner's website for the entity if any; for other public URLs of the entity, use relevant_url in public_identification_data. (اختیاری)

entity_ type

EntityType

نوع موجودیت. (اختیاری)

entity_ role

EntityRole

The role of the entity in the event. (اختیاری)

public_ identification_ data

PublicIdentificationData

Public references of the entity. (اختیاری)

EntityRole

The role of the entity in the event.

Enums
ENTITY_ROLE_UNSPECIFIED مشخص نشده است.
ENTITY_ROLE_HEADLINER The entity represents a headliner or leading performer at the event.
ENTITY_ROLE_SUPPORTER The entity represents a supporting performer at the event.
ENTITY_ROLE_HOME_TEAM The entity represents the home team at the (sports) event.
ENTITY_ROLE_AWAY_TEAM The entity represents the away team at the (sports) event.

EntityType

نوع موجودیت. Note: not intended to be a universal ontology.

Enums
ENTITY_TYPE_UNSPECIFIED مشخص نشده است. استفاده نکنید.
ENTITY_TYPE_PERFORMER The entity represents the artist or group performing at a concert or a show. Only applicable when event category is CONCERT or THEATRE.
ENTITY_TYPE_PLAYER The entity represents the sports team or player at the event. Only applicable when event category is SPORTS.
ENTITY_TYPE_CONCERT_TOUR The entity represents the tour that this event belongs to. Only applicable when event category is CONCERT.
ENTITY_TYPE_SPORTS_SERIES The entity represents a sports tournament that this event belongs to. Only applicable when event category is SPORTS.
ENTITY_TYPE_PLAY The entity represents the type of play (eg, musical, comedy, ballet, etc.) performed at the event. Only applicable when event category is THEATRE.

دسته رویداد

A subset of event categories for which we customize the product experience. Note: not intended to be a universal ontology of events.

Enums
EVENT_CATEGORY_UNSPECIFIED مشخص نشده است. استفاده نکنید.
EVENT_CATEGORY_CONCERT کنسرت ها
EVENT_CATEGORY_SPORTS رویدادهای ورزشی
EVENT_CATEGORY_THEATRE Theatre events.
EVENT_CATEGORY_EXHIBITS نمایشگاه ها
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES Workshops and Classes.

EventCreator

Information about the creator of the event. Only relevant for platforms that include user-generated content events.

فیلدها
name

string

اختیاری. Name of the event creator. No character restriction.

EventState

State of the event.

Enums
EVENT_STATE_UNSPECIFIED مشخص نشده است.
SCHEDULED The event is scheduled.
RESCHEDULED این رویداد دوباره برنامه ریزی شده است.
CANCELLED The event is cancelled.
POSTPONED The event is postponed.

OrganizerType

The type of the organizer.

Enums
ORGANIZER_TYPE_UNSPECIFIED مشخص نشده است.
PERSON For organizer who is a person.
ORGANIZATION For organizer who is an organization.

PublicIdentificationData

Identifiers, webpages, or any other public sources that reference an entity.

فیلدها
relevant_ url[]

string

Public URL of any webpage that is dedicated to only the topic. This could include official websites, discogs, social media platforms, wikipedia or imdb pages, eg https://www.discogs.com/artist/1124645-Taylor-Swift , https://www.wikidata.org/wiki/Q19320959 , https://twitter.com/acmilan . (اختیاری)

musicbrainz_ id

string

The 36-character musicbrainz identifier of the artist or other music entities, if applicable. See https://musicbrainz.org/doc/MusicBrainz_Identifier . (اختیاری)

محدوده زمانی

A closed-open time range, ie [start_time, end_time).

فیلدها
start_ time

Timestamp

The lower bound of the time range.

end_ time

Timestamp

The upper bound of the time range.

TokenizationConfig

A configuration for payment-processor tokenization, set up on a per-Merchant basis.

فیلدها
tokenization_ parameter

map<string, string>

A tokenization configuration will typically have one tokenization_parameter whose key is "gateway" and whose value is the name of the processor.

The rest of the parameters are dependent on the processor. See Google Pay's documentation for further information.

Braintree example: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Stripe example: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Adyen example: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

billing_ information_ format

BillingInformationFormat

Include in the payment token the user's billing information as entered into Google Pay with their FOP (see above). Leaving the field empty is equivalent to specifying MIN.

BillingInformationFormat

How much of the Billing Address to require of the user and include in the token. The enum values correspond to parameters in the Google Pay API (see https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters) .

Enums
BILLING_INFORMATION_FORMAT_UNSPECIFIED مشخص نشده است. Defaults to MIN.
MIN name, country code, and postal code (Google Pay default setting).
FULL name, street address, locality, region, country code, and postal code.

ToursAndActivitiesContent

Content fields specific to Tours and Activities. Each element in the repeated field should be independent to allow separate rendering (eg as a bullet point).

Populating ToursAndActivitiesContent is strongly recommended for tours and activities, but not strictly required. All fields support both plain-text and HTML-like text for basic formatting. Supported HTML-like formatting tags:

Phrase tags:
, , , : Only the three tags mentioned above are supported.
can be used to break lines in paragraphs, and / / can be used to highlight an important text. Any other phrase tags will be ignored.

All other tags and custom styles are not allowed and will be removed. Any URLs, anchors, and links will be stripped, and will never be displayed to end-users.

Important notes: * Don't duplicate data already supplied in highlights , exclusion and other, more specific, fields in the service description. * Avoid using other tags except for the supported ones mentioned above, because the contents within unsupported tags will be stripped, and may lead to an undesirable user experience.

فیلدها
highlights[]

Text

The user-visible list of highlights.

inclusions[]

Text

The user-visible list of inclusions.

exclusions[]

Text

The user-visible list of exclusions.

must_ know[]

Text

The user-visible list of important notes, use for details such as age restrictions or other conditions that make this service unsuitable.

UnsupportedPartySizeOption

Options for parties that are out of range.

فیلدها
Union field kind . Available options for parties that are out of range. kind can be only one of the following:
call_ merchant

CallMerchant

Party sizes that are out of range can call the business. A predefined message will be displayed to the user. Sample text to be displayed: "For parties larger than {waitlist_rules.max_party_size} please call the restaurant at {phone}." CallMerchant must be set, but will be empty.

UpdateAdsAccountLinkRequest

Request message for AdsAccountLinkingService.UpdateAdsAccountLink.

فیلدها
update_ mask

FieldMask

اختیاری. The list of fields to update.

UpdateBookingRequest

Request to update a google.maps.booking.v1alpha.Booking

فیلدها
update_ mask

FieldMask

Field mask of all booking fields to be updated

booking

Booking

The booking to be updated

booking_ failure

BookingFailure

If processing of an asynchronously confirmed booking request fails and the booking's status is being updated to FAILED, this field should reflect the business logic error (eg, user has an existing reservation too close to this time). This field should only be set when updating the booking status to FAILED and will be ignored otherwise.

UpdateMerchantRequest

The request to update a Merchant .

فیلدها
merchant

Merchant

The new merchant data.

update_ mask

FieldMask

The specific fields to update for the merchant.

UpdateOrderRequest

Request to update a google.maps.booking.v1alpha.Order

فیلدها
update_ mask

FieldMask

Field mask of all order fields to be updated

order

Order

The order to be updated

UpdateServiceRequest

The request to update a Service .

فیلدها
service

Service

The new service data.

update_ mask

FieldMask

The specific fields to update for the service.

UriTemplate

A template specifying how Google should generate URLs to external site.

فیلدها
uri_ template

string

اختیاری. The uri template must follow the RFC6570, see https://datatracker.ietf.org/doc/html/rfc6570 . Supports Level 2 templates. These parameters will be resolved to their values specified in their respective entities.

5 available parameters for Dining Reservation Linkout: 1) (required) {availability_slot_start_seconds} :: populated from start_sec field in availability feed 2) (required) {availability_slot_duration_seconds} :: populated from duration_sec field in availability feed 3) (optional) {resources_party_size} :: populated from party_size field in availability feed 4) (optional) {availability_availability_tag} :: populated from availability_tag field in availability feed 5) (optional) {resources_room_id} :: populated from room_id field in availability feed

Example Usage: http://example.com/book/restaurant?start={availability_slot_start_seconds } &num_guests={resources_party_size} * start_sec = 123456 * party_size = 2 https://example.com/book/restaurant?start=123456&num_guests=2

UserPurchaseRestriction

Restricts the users eligible to purchase a payment option.

فیلدها
new_ to_ merchant

bool

A payment option that can only be purchased by users who have never purchased from the same merchant before.

new_ to_ payment_ option

bool

A payment option that can only be purchased by users who have never purchased the same payment option before.

VirtualSession

Information about virtual/online session. Eg Online yoga class, virtual cooking class etc.

فیلدها
session_ instructions

Text

Instructions on how this virtual class is set up. If the partner does not include the video URL with the booking, then this text must include when the video URL will be shared with the user. به عنوان مثال “Zoom url will be mailed 30 minutes prior to the class”. (توصیه می شود)

session_ requirements

Text

Requirements for the given virtual session. به عنوان مثال yoga mat, cooking utensils etc. (Recommended)

virtual_ platform_ info

VirtualPlatformInfo

Information about the virtual platform used in this session. (Required to enable virtual services)

is_ session_ prerecorded

bool

مورد نیاز. Set this as true if the virtual session is not live and is pre-recorded.

VirtualPlatformInfo

Information about platform which will be used for this virtual session.

فیلدها
platform

Platform

Platform used for virtual session.

other_ platform_ name

Text

The name of the platform if the platform is set to OTHER. (Required if platform is set to OTHER)

پلت فرم

Enum to indicate which virtual platform would be used by the merchant.

Enums
PLATFORM_UNSPECIFIED استفاده نشده
FLEXIBLE The merchant is flexible in which video platform they use.
GOOGLE_HANGOUTS Google Hangouts product.
GOOGLE_MEET Google Meet product.
ZOOM Zoom Video Communications.
SKYPE اسکایپ.
YOUTUBE Livestreaming in YouTube.
OTHER Should be set if the video platform used is different from the ones mentioned here.

WaitlistRules

Rules related to joining the waitlist.

فیلدها
min_ party_ size

int32

مورد نیاز. Must be a positive integer for services providing waitlist functionality. If the service or merchant does not provide waitlist functionality, this must not be populated.

max_ party_ size

int32

مورد نیاز. Must be a positive integer for services providing waitlist functionality. If the service or merchant does not provide waitlist functionality, this must not be populated.

supports_ additional_ request

bool

If true, the user will be able to send a free-form additional text request when joining the waitlist for this service.

above_ max_ party_ size_ options[]

UnsupportedPartySizeOption

Set options for parties larger than the set max_party_size. Leave empty if larger parties should not be given alternative options for joining a waitlist.