شاخص
-
BookingNotification
(رابط) -
Feed
(رابط) -
InvalidationService
(رابط) -
InventoryStatus
(رابط) -
InventoryUpdate
(رابط) -
ActionLink
(پیام) -
ActionLink.ActionLinkType
(enum) -
ActionPlatform
(enum) -
Advisement
(پیام) -
Availability
(پیام) -
Availability.ConfirmationMode
(enum) -
Availability.DurationRequirement
(تعدادی) -
Availability.Recurrence
(پیام) -
Availability.ScheduleException
(پیام) -
Availability.SchedulingRuleOverrides
(پیام) -
BatchDeleteGenericRecordsRequest
(پیام) -
BatchPushGenericRecordRequest
(پیام) -
BatchReplaceServiceAvailabilityRequest
(پیام) -
BatchReplaceServiceAvailabilityResponse
(پیام) -
Booking
(پیام) -
BookingFailure
(پیام) -
BookingFailure.Cause
(تعدادی) -
BookingFailure.PaymentFailureInformation
اطلاعات (پیام) -
BookingFailure.PaymentFailureInformation.ThreeDS1Parameters
(پیام) -
BookingStatus
(تعدادی) -
CallMerchant
(پیام) -
CancellationPolicy
(پیام) -
CancellationPolicy.RefundCondition
(پیام) -
ClientInformation
(پیام) -
CreateMerchantRequest
(پیام) -
CreateServiceRequest
(پیام) -
CreditCardRestrictions
(پیام) -
CreditCardRestrictions.CreditCardType
(enum) -
DeleteMerchantRequest
(پیام) -
DeleteServiceRequest
(پیام) -
Deposit
(پیام) -
DirectMerchantPayment
(پیام) -
DurationRange
(پیام) -
ExtendedServiceAvailability
(پیام) -
FeedStatistics
(پیام) -
FeedStatus
(پیام) -
FeedStatus.State
(enum) -
FoodOrderingMetadata
(پیام) -
FoodOrderingMetadata.AdvanceOrderDetails
(پیام) -
FoodOrderingMetadata.FeeDetails
(پیام) -
FoodOrderingMetadata.FeeDetails.FeeAmount
(پیام) -
FoodOrderingMetadata.FeeDetails.FeeType
(تعدادی) -
FulfillmentOption
(پیام) -
FulfillmentOption.AvailableDay
(پیام) -
FulfillmentOption.FeeDetails
(پیام) -
FulfillmentOption.FixedFee
(پیام) -
FulfillmentOption.FulfillmentType
(enum) -
FulfillmentOption.MinimumFee
(پیام) -
FulfillmentOption.NoFee
(پیام) -
GenericDeleteRecord
(پیام) -
GenericRecord
(پیام) -
GeoCoordinates
(پیام) -
GetMerchantStatusRequest
(پیام) -
GetStatusRequest
(پیام) -
HomeServiceData
(پیام) -
IntegrationType
(enum) -
InvalidateResourceRequest
(پیام) -
LineItem
(پیام) -
LineItem.OrderedTickets
(پیام) -
ListMerchantStatusesRequest
(پیام) -
ListMerchantStatusesRequest.BookingInventoryStatus
(enum) -
ListMerchantStatusesRequest.GeoMatchingStatus
(enum) -
ListMerchantStatusesRequest.WaitlistInventoryStatus
(enum) -
ListMerchantStatusesResponse
(پیام) -
ListStatusRequest
(پیام) -
ListStatusResponse
(پیام) -
LocalizedString
(پیام) -
Location
(پیام) -
LocationType
(enum) -
Merchant
(پیام) -
MerchantMatchingHints
(پیام) -
MerchantStatus
(پیام) -
MerchantStatus.BookingStatus
(پیام) -
MerchantStatus.DirectUrl
(پیام) -
MerchantStatus.DirectUrl.UrlType
(enum) -
MerchantStatus.LocalServicesMatchInfo
(پیام) -
MerchantStatus.LocalServicesMatchInfo.MatchedProvider
(پیام) -
MerchantStatus.PlaceInfo
(پیام) -
MerchantStatus.ProcessingStatus
(enum) -
MerchantStatus.WaitlistStatus
(پیام) -
MoneyRange
(پیام) -
NoShowFee
(پیام) -
Order
(پیام) -
OrderOnlineMetadata
(پیام) -
PaymentInformation
(پیام) -
PaymentOption
(پیام) -
PaymentOption.ActivationType
(enum) -
PaymentOption.PaymentOptionType
(enum) -
PaymentProcessorConfig
(پیام) -
PaymentProcessorConfig.Processor
(enum) -
PaymentRestrictions
(پیام) -
PerOrderFee
(پیام) -
PerTicketFee
(پیام) -
PostalAddress
(پیام) -
PrepaymentStatus
(تعدادی) -
Price
(پیام) -
PriceInterpretation
(تعبیر) -
PriceType
(تعدادی) -
QuantitativeValue
(پیام) -
QuantitativeValue.RangeValue
(پیام) -
Rating
(پیام) -
RelatedMedia
(پیام) -
RelatedMedia.Attribution
(پیام) -
RelatedMedia.MediaType
(enum) -
ReplaceServiceAvailabilityRequest
(پیام) -
RequireCreditCard
(تعدادی) -
Resources
(پیام) -
SchedulingRules
(پیام) -
SchedulingRules.AdmissionPolicy
(تعدادی) -
Service
(پیام) -
Service.PrepaymentTerms
(پیام) -
Service.PrepaymentTerms.ChargeTiming
(تعدادی) -
Service.PrepaymentType
(تعدادی) -
Service.ServiceType
(enum) -
ServiceAttribute
(پیام) -
ServiceAttribute.Value
(پیام) -
ServiceAttributeValueId
(پیام) -
ServiceAvailability
(پیام) -
ServiceIntakeForm
(پیام) -
ServiceIntakeFormField
(پیام) -
ServiceIntakeFormField.FieldType
(enum) -
TaxRate
(پیام) -
Terms
(پیام) -
Text
(پیام) -
TicketType
(پیام) -
TicketingVerticalSpecificData
(پیام) -
TicketingVerticalSpecificData.AttendanceMode
(enum) -
TicketingVerticalSpecificData.Entity
(پیام) -
TicketingVerticalSpecificData.Entity.EntityRole
(enum) -
TicketingVerticalSpecificData.Entity.EntityType
(enum) -
TicketingVerticalSpecificData.EventCategory
(enum) -
TicketingVerticalSpecificData.EventState
(enum) -
TicketingVerticalSpecificData.OrganizerType
(enum) -
TicketingVerticalSpecificData.PublicIdentificationData
(پیام) -
TimeRange
(پیام) -
TokenizationConfig
(پیام) -
TokenizationConfig.BillingInformationFormat
(enum) -
ToursAndActivitiesContent
(پیام) -
UnsupportedPartySizeOption
(پیام) -
UpdateBookingRequest
(پیام) -
UpdateMerchantRequest
(پیام) -
UpdateOrderRequest
(پیام) -
UpdateServiceRequest
(پیام) -
UserPurchaseRestriction
(پیام) -
VirtualSession
(پیام) -
VirtualSession.VirtualPlatformInfo
(پیام) -
VirtualSession.VirtualPlatformInfo.Platform
(enum) -
WaitlistRules
(پیام)
اطلاعیه رزرو
اعلان های قرار ملاقات ها را از شرکای برنامه ریزی خارجی دریافت می کند. شریک بسته به اینکه شریک RPCهای مبتنی بر رزرو مانند CreateBooking و CheckAvailability را اجرا کند یا RPCهای پایه مانند CreateOrder و CheckOrderFulfillability، باید با UpdateBooking یا UpdateOrder تماس بگیرد.
به روز رسانی رزرو |
---|
یک
|
UpdateOrder |
---|
یک
|
خوراک
وضعیت پردازش فیدهای آپلود شده توسط شرکای جمعآوری خارجی را بازیابی کنید.
GetStatus |
---|
|
وضعیت لیست |
---|
|
Invalidation Service
درخواست های عدم اعتبار منبع را از شرکای خارجی دریافت می کند.
InvalidateResource |
---|
یک منبع موجود را باطل می کند. اگر منبع درخواستی مشترک سرویس Google نباشد، درخواستی نادیده گرفته می شود. انواع منابع پشتیبانی شده: - وانت
|
وضعیت موجودی
موجودی و وضعیت تطبیق تاجران آپلود شده را بازیابی کنید.
GetMerchantStatus |
---|
|
ListMerchantStatuses |
---|
فهرست همه
|
InventoryUpdate
به روز رسانی موجودی را از جمع کننده های خارجی دریافت می کند.
BatchDeleteGenericRecords |
---|
رکوردهای نوع خوراک مشخص شده را حذف می کند. فقط اعتبار سنجی اولیه را انجام می دهد (مانند درخواست نادرست) که پس از آن بلافاصله پاسخ مناسب به شریک بازگردانده می شود. Google اعتبار سنجی منطق کسب و کار را در درخواست به صورت ناهمزمان انجام می دهد. این فراخوان دسته ای اتمی بودن را تضمین نمی کند.
|
BatchPushGenericRecord |
---|
سوابق نوع خوراک مشخص شده را درج و/یا به روز می کند. فقط اعتبار سنجی اولیه را انجام می دهد (مانند درخواست نادرست) که پس از آن بلافاصله پاسخ مناسب به شریک بازگردانده می شود. Google اعتبار سنجی منطق کسب و کار را در درخواست به صورت ناهمزمان انجام می دهد. این فراخوان دسته ای اتمی بودن را تضمین نمی کند.
|
BatchReplaceServiceAvailability |
---|
|
ایجاد تاجر |
---|
یک
|
CreateService |
---|
یک
|
Delete Merchant |
---|
یک
|
DeleteService |
---|
یک
|
ReplaceServiceAvailability |
---|
|
UpdateMerchant |
---|
یک
|
UpdateService |
---|
|
اکشن لینک
یک URL اقدام با زبان مرتبط، فهرست کشورهای محدود شده و پلت فرم اختیاری که نشان میدهد این اقدام در کدام پلتفرم باید انجام شود.
فیلدها | |
---|---|
url | نشانی وب نقطه ورودی برای این پیوند اقدام. |
language | برچسب زبان BCP-47 که زبانی را که محتوای این URI در آن موجود است مشخص می کند. |
restricted_country[] | کد کشور ISO 3166-1 آلفا-2. برای دید نامحدود خالی بگذارید. |
platform | پلتفرمی که این عمل باید روی آن انجام شود. اگر این فیلد تنظیم نشده باشد، ACTION_PLATFORM_WEB_APPLICATION به عنوان بازگشتی استفاده خواهد شد. |
action_link_type | نوع عمل از پیش تعیین شده |
order_online_metadata | ابرداده برای پیوند سفارش آنلاین. از عملکرد با ActionLinkType از ACTION_LINK_TYPE_SHOP_ONLINE پشتیبانی می کند. |
food_ordering_metadata | پیوندهای فوق داده برای سفارش غذا. از نوع عملکرد پشتیبانی میکند: * |
ActionLinkType
نوع عمل از پیش تعیین شده مرتبط با پیوند اقدام.
Enums | |
---|---|
ACTION_LINK_TYPE_UNSPECIFIED | نوع پیوند اقدام نامشخص است. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT | نوع پیوند اقدام، رزرو قرار است. |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT | نوع پیوند اقدام، رزرو قرار آنلاین است. |
ACTION_LINK_TYPE_ORDER_FOOD | نوع پیوند اقدام سفارش غذا برای تحویل یا بیرون رفتن یا هر دو است. |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY | نوع پیوند اقدام، سفارش غذا برای تحویل است. |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT | نوع پیوند اقدام، سفارش غذا برای بیرونبر است. |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION | نوع پیوند اقدام، رزرو ناهارخوری است. |
ACTION_LINK_TYPE_SHOP_ONLINE | نوع پیوند اقدام سفارش برای خرید است، می تواند تحویل یا تحویل یا هر دو باشد. |
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 است. |
نصیحت
توصیه هایی که هنگام رزرو از طریق Reserve with Google به کاربر نمایش داده می شود.
فیلدها | |
---|---|
text | پیام سفارشی برای نمایش به کاربر هنگام رزرو از طریق رزرو با Google. |
در دسترس بودن
یک اسلات در دسترس بودن خدمات تاجر که زمان و تعداد نقاط را نشان می دهد.
فیلدها | |
---|---|
start_time | زمان شروع زمان ملاقات |
duration | مدت زمان قرار ملاقات |
spots_total | تعداد کل نقاط و نقاط باز این در دسترس بودن. مثال ها:
توجه: در صورت ارسال درخواست با استفاده از فرمت فشرده سازی در دسترس بودن تعریف شده در زیر، این دو فیلد استنباط می شود.
|
spots_open | تعداد نقاط باز |
availability_tag | یک رشته مات اختیاری برای شناسایی این شکاف دسترسی. در صورت تنظیم، در درخواستهایی که قرار ملاقاتها را رزرو/بهروزرسانی/لغو میکنند، گنجانده میشود. |
resources | منابع اختیاری مورد استفاده برای ابهامزدایی از این شکاف در دسترس بودن از دیگران، زمانی که اعضای مختلف کارکنان یا اتاقها بخشی از سرویس هستند. به عنوان مثال همان کلاس یوگا با دو 2 مربی:
|
payment_option_id[] | فهرستی از شناسهها که به گزینههای پرداختی که میتوان برای پرداخت این اسلات استفاده کرد اشاره میکند. گزینههای پرداخت واقعی در سطح Merchant تعریف میشوند، و همچنین میتوانند بین چندین تاجر به اشتراک گذاشته شوند. این فیلد هر pay_option_ids مشخص شده در پیام سرویس را لغو می کند. به طور مشابه pay_option_ids مشخص شده در اینجا لازم نیست در پیام سرویس وجود داشته باشد، اگرچه باید در سطح Merchant تعریف شود. |
recurrence | اطلاعات تکرار برای در دسترس بودن، نشان دهنده بیش از یک زمان شروع است. یک تکرار باید شامل قرار ملاقات برای یک روز کاری باشد. |
schedule_exception[] | زمان هایی که نمی توان این سرویس را برنامه ریزی کرد. برای محدود کردن تعداد پیامهای schedule_exception، پیوستن به استثناهای مجاور را در نظر بگیرید. |
deposit | واریز اختیاری برای این در دسترس بودن. در صورت مشخص بودن واریز خدمات لغو می شود. |
no_show_fee | اختیاری بدون هزینه نمایش برای این در دسترس بودن. در صورتی که مشخص شده بود، سرویس بدون هزینه نمایش را لغو می کند. |
require_credit_card | نشان می دهد که آیا کاربر باید کارت اعتباری برای رزرو این اسلات در دسترس ارائه دهد یا خیر. اگر مقدار تنظیم نشده باشد، اگر در آنجا تنظیم شده باشد، از سطح سرویس به ارث می رسد. (اختیاری) |
ticket_type_id[] | فهرستی از انواع بلیط های پشتیبانی شده برای این شکاف در دسترس را نشان می دهد. اگر تنظیم نشود، همه انواع بلیط در سرویس والدین برای این اسلات در دسترس هستند. توجه داشته باشید که مقادیر این فیلد باید در سرویس والد تعریف شود. مثال ها:
برای نشان دادن موجودی در روزهای هفته:
برای نشان دادن اینکه هر سه نوع بلیت برای این بازه زمانی در دسترس هستند، از (اختیاری) |
duration_requirement | الزام برای نشان دادن مدت زمان و/یا زمان پایان اسلات. اگر شکاف در دسترس نباشد، این فیلد نادیده گرفته می شود. در قسمت عمودی Things-To-Do استفاده نمی شود. (اختیاری) |
scheduling_rule_overrides | قوانین زمانبندی در دسترس بودن اگر فیلدها پر شوند، قوانین زمانبندی مربوطه را در SchedulingRules سطح سرویس لغو می کنند. |
confirmation_mode | حالت تأییدی که هنگام رزرو این در دسترس بودن استفاده خواهد شد. تلاش برای ایجاد رزرو برای در دسترس بودن با حالت تأیید CONFIRMATION_MODE_SYNCHRONOUS باید فوراً تأیید یا رد شود. تلاش برای ایجاد رزرو برای در دسترس بودن با حالت تأیید CONFIRMATION_MODE_ASYNCHRONOUS باید فوراً رد شود یا با وضعیت در انتظار ایجاد شود. |
ConfirmationMode
حالتهای تأیید مورد استفاده هنگام رزرو در دسترس بودن.
Enums | |
---|---|
CONFIRMATION_MODE_UNSPECIFIED | حالت تایید مشخص نشده است. تایید همزمان فرض می شود. |
CONFIRMATION_MODE_SYNCHRONOUS | رزرو برای این در دسترس بودن به طور همزمان تأیید می شود. |
CONFIRMATION_MODE_ASYNCHRONOUS | رزرو برای این در دسترس بودن به صورت ناهمزمان تایید می شود. |
مدت زمان مورد نیاز
این فهرست نشان میدهد که چه الزاماتی برای تأیید یا مشاهده مدت زمان/زمان پایان اسلات درخواستی توسط کاربر وجود دارد.
Enums | |
---|---|
DURATION_REQUIREMENT_UNSPECIFIED | نحوه رسیدگی به زمان پایان مشخص نشده است. این پیش فرض است. |
DO_NOT_SHOW_DURATION | زمان پایان به کاربر نشان داده نمی شود. |
MUST_SHOW_DURATION | قبل از تعیین قرار، زمان پایان باید به کاربر نشان داده شود. |
عود
پیامهای تکراری اختیاری هستند، اما امکان نمایش فشردهتر اسلاتهای در دسترس را که به طور مداوم تکرار میشوند را فراهم میکنند. آنها معمولاً برنامه کاری یک روز را نشان می دهند. سپس از پیامهای ScheduleException برای نمایش بازههای زمانی رزرو شده/غیرقابل دسترس در روز کاری استفاده میشود.
الزامات:
- گسترش اسلاتهای دسترسی یا تکرارها نباید شکافهای یکسانی ایجاد کند. اگر شناسه ها، start_time، مدت زمان و منابع مطابقت داشته باشند، اسلات ها یکسان در نظر گرفته می شوند.
- قالب استاندارد در دسترس بودن و تکرار را در شکاف های یک سرویس ترکیب نکنید. تکرار به سود بازرگانان/خدماتی است که قرار ملاقات ارائه می دهند. قالب استاندارد برای بازرگانان/خدمات با کلاس های برنامه ریزی شده منظم طراحی شده است.
- عودها نباید بیش از 24 ساعت طول بکشد.
فیلدها | |
---|---|
repeat_until | حداکثر مُهر زمانی UTC تا زمانی که در دسترس بودن تکرار میشود. |
repeat_every | زمان بین اسلات های دسترسی متوالی را مشخص می کند. مثال: در دسترس بودن با مدت زمان 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 | محدوده زمانی استثنا. هر شکاف توصیف شده توسط تکرار که با این محدوده زمانی بسته-باز همپوشانی داشته باشد، غیرقابل دسترس تلقی خواهد شد. مثال: اگر تکرار مدت زمان 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 | آخرین بار (در ثانیه) که این اسلات می تواند رزرو شود. این مهر زمانی باید قبل از start_sec از اسلات باشد تا رعایت شود (اگر کاربران میتوانند بعد از زمان شروع رزرو کنند، از SchedulingRules.min_booking_before_end_time در سطح سرویس استفاده کنید). در صورت وجود، هر چیزی که در min_booking_buffer از SchedulingRules سرویس مربوطه مشخص شده است لغو می شود. |
first_bookable_sec | اولین بار (در چند ثانیه) که این اسلات می تواند رزرو شود. این مهر زمانی باید قبل از start_sec شکاف یا last_bookable_sec در صورت مشخص شدن باشد. |
last_online_cancellable_sec | در صورت تنظیم، آخرین بار (در چند ثانیه از زمان یونیکس) که میتوان این زمان قرار ملاقات خاص را از طریق رزرو با Google لغو کرد. این فیلد همه قوانین لغو در سطح خدمات را لغو می کند. (اختیاری) |
BatchDeleteGenericRecordsRequest
درخواست دسته ای برای حذف رکوردهای نوع خوراک مشخص شده.
فیلدها | |
---|---|
parent | نام منبع، که دارای قالب - |
records[] | رکوردهایی که باید حذف شوند. حداکثر 1000 رکورد در یک تماس API مجاز است. |
درخواست BatchPushGenericRecord
درخواست دسته ای برای درج و/یا به روز رسانی سوابق نوع فید مشخص شده در آدرس اینترنتی درخواست.
فیلدها | |
---|---|
parent | نام منبع، که دارای قالب - |
records[] | رکوردهایی که باید درج و/یا به روز شوند. حداکثر 1000 رکورد در یک تماس API مجاز است. |
BatchReplaceServiceAvailability Request
درخواست دسته ای برای جایگزینی اسلات های دسترسی چند Service
.
فیلدها | |
---|---|
parent | قالب |
extended_service_availability[] | در دسترس بودن سرویس گسترده که برای جایگزینی اسلات های موجود استفاده می شود. |
BatchReplaceServiceAvailabilityResponse
پاسخ دسته ای برای جایگزینی اسلات های دسترسی چند Service
. فقط اسلات هایی که با موفقیت به روز شده اند در این پیام گنجانده می شوند
فیلدها | |
---|---|
extended_service_availability[] | پیامهای در دسترس بودن سرویس توسعهیافته با موفقیت بهروزرسانی شدند که برای جایگزینی شکافهای در دسترس بودن موجود استفاده شدند. |
رزرو
رزرو برای اسلات موجودی
فیلدها | |
---|---|
name | نام منبع رزرو: |
merchant_id | شناسه تاجر برای اسلات |
service_id | شناسه خدمات بازرگان |
start_time | زمان شروع زمان ملاقات |
duration | مدت زمان قرار ملاقات |
client_information | اطلاعات شخصی مشتری که قرار ملاقات می گذارد |
status | وضعیت رزرو |
payment_information | اطلاعات مربوط به تراکنش های پرداخت مربوط به رزرو. |
party_size | اندازه مهمانی رزرو |
رزرو شکست
دادههای وضعیتی که نشان میدهد چرا پردازش رزرو بهصورت ناهمزمان انجام نشد. BookingFailure اساساً برای گرفتن خطاهای منطقی تجاری در نظر گرفته شده است.
فیلدها | |
---|---|
cause | دلیل عدم موفقیت رزرو (الزامی) |
rejected_card_type | (فقط در صورتی لازم است که علت PAYMENT_ERROR_CARD_TYPE_REJECTED باشد) |
description | این فیلد اختیاری برای شریک استفاده می شود تا اطلاعات اضافی را فقط برای اشکال زدایی درج کند. (اختیاری) |
payment_failure | اطلاعات مربوط به عدم پرداخت |
علت
برشمردن علل شکست
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 | پارامترهایی که توسط یک تجمیع کننده RwG برای شروع پروتکل احراز هویت 3DS1 با کاربر استفاده می شود. نادیده گرفته می شود مگر اینکه BookingFailure.cause روی PAYMENT_REQUIRES_3DS1 تنظیم شود. |
ThreeDS1Parameters
پارامترهایی که درخواست می کنند RwG یک چالش 3DS1 را انجام دهد.
پارامترها توسط توضیحات EMVCo از پروتکل 3DS1 تنظیم می شوند.
فیلدها | |
---|---|
acs_url | نشانی اینترنتی که از آن فرم بارگیری می شود تا برای احراز هویت به کاربر ارائه شود. |
pa_req | یک درخواست احراز هویت Payment. در صورت ارائه به فرم ACSUrl ارسال می شود. |
transaction_id | شناسه ای که توسط ارائه دهنده ACS استفاده می شود. در صورت ارائه به فرم ACSUrl ارسال می شود. |
md_merchant_data | داده های تجاری در صورت ارائه به فرم 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[] | شرایط بازپرداخت صفر یا بیشتر مربوط به سیاست. |
شرایط بازپرداخت
یک شرط بازپرداخت واحد را تعریف می کند. شرایط بازپرداخت چندگانه را می توان با هم برای توصیف "مراحل بازپرداخت" به عنوان دوره های مختلف قبل از زمان شروع سرویس استفاده کرد.
فیلدها | |
---|---|
min_duration_before_start_time | مدت زمان قبل از زمان شروع، تا زمانی که مشتری بتواند بخشی از هزینه خدمات مشخص شده در |
refund_percent | درصد قابل بازپرداخت، تا زمانی که رزرو سرویس حداقل |
اطلاعات مشتری
اطلاعات شخصی در مورد شخصی که رزرو می کند
فیلدها | |
---|---|
given_name | نام مشتری |
family_name | نام خانوادگی مشتری |
address | آدرس مشتری |
telephone | شماره تلفن مشتری |
email | آدرس ایمیل مشتری |
ایجاد MerchantRequest
درخواست ایجاد Merchant
.
فیلدها | |
---|---|
parent | نام منبع والد برای شریک صاحب این تاجر، در قالب |
merchant_id | شناسه فروشنده برای استفاده برای این تاجر. |
merchant | تاجر برای ایجاد. |
CreateServiceRequest
درخواست ایجاد یک Service
جدید.
فیلدها | |
---|---|
parent | نام منبع والد برای تاجری که این سرویس را دارد، در قالب |
service_id | شناسه سرویس مورد استفاده برای این سرویس. |
service | سرویس برای ایجاد. |
محدودیت های کارت اعتباری
محدودیتهایی برای انواع کارت اعتباری که این تاجر میپذیرد.
فیلدها | |
---|---|
credit_card_type[] | لیستی از کارت های اعتباری پشتیبانی شده در صورت خالی بودن کارت اعتباری پشتیبانی نمی شود. |
نوع کارت اعتباری
یک نوع کارت اعتباری
Enums | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED | استفاده نشده |
VISA | کارت اعتباری ویزا |
MASTERCARD | کارت اعتباری مسترکارت |
AMERICAN_EXPRESS | کارت اعتباری امریکن اکسپرس |
DISCOVER | کارت اعتباری Discover |
JCB | کارت اعتباری JCB |
حذف MerchantRequest
درخواست حذف Merchant
.
فیلدها | |
---|---|
name | نام منبع تاجر برای حذف. در قالب شرکا/{partner_id}/merchants/{merchant_id} |
DeleteServiceRequest
درخواست حذف یک Service
فیلدها | |
---|---|
name | نام منبع سرویس برای حذف. در قالب |
سپرده گذاری
سپرده ای که ممکن است از کاربر شارژ شود یا کارت اعتباری خود را نگه دارد.
فیلدها | |
---|---|
deposit | مبلغ سپرده. |
min_advance_cancellation_sec | حداقل لغو پیش پرداخت برای واریز. |
deposit_type | نحوه تعیین سپرده را از در دسترس بودن تعریف می کند. |
DirectMerchantPayment
اطلاعاتی درباره نحوه پرداخت مستقیم کاربر به تاجر به جای پیش پرداخت از طریق RwG.
فیلدها | |
---|---|
payment_methods[] | به کاربران توصیه می شود فقط از طریق روش های پرداخت ذکر شده در زیر پرداخت کنند. |
محدوده مدت
لفاف برای محدوده ای از مدت زمان که می تواند محدود یا بدون محدودیت باشد. حداقل یکی از min_duration و max_duration duration مورد نیاز است.
فیلدها | |
---|---|
min_duration | حداقل مدت. |
max_duration | حداکثر مدت. |
ExtendedServiceAvailability
فهرستی از در دسترس بودن و چه کسی/چه زمانی باید برای آنها اعمال شود.
فیلدها | |
---|---|
merchant_id | این یک فیلد اجباری است که برای تعیین اینکه پیامهای در دسترس بودن زیر متعلق به کدام تاجر است، لازم است. |
service_id | این یک فیلد اجباری است که برای مشخص کردن این که پیامهای در دسترس بودن زیر به کدام سرویس تعلق دارند، لازم است. |
start_time_restrict | در صورت ارائه، موجودیت های در دسترس بودن ارائه شده را به عنوان یک عکس فوری کامل از [start_time_restrict، end_time_restrict در نظر می گیریم. به این معنا که اگر شرط زیر درست باشد، تمام موجودیهای موجود حذف خواهند شد:
اگر پیام مدت زمان تنظیم شده باشد، این شرط بیشتر محدود می شود:
اگر یک پیغام resources_restrict تنظیم شده باشد، این شرط بیشتر محدود می شود:
این فیلدها معمولاً برای ارائه بهروزرسانی کامل در دسترس بودن در یک بازه زمانی معین استفاده میشوند. تنظیم start_time_restrict در حالی که end_time_restrict تنظیم نشده است به معنای شروع تمام زمان در start_time_restrict تفسیر میشود. |
end_time_restrict | تنظیم end_time_restrict در حالی که start_time_restrict تنظیم نشده است به معنای تمام زمان تا پایان_time_restrict تفسیر میشود. |
duration_restrict | تنظیم مدت زمان، دامنه بهروزرسانی را فقط به در دسترس بودن با مدت زمان منطبق محدود میکند. |
resources_restrict | تنظیم resources_restrict دامنه بهروزرسانی را فقط به این مجموعه از منابع محدود میکند. تمام فیلدهای شناسه منابع باید دقیقاً مطابقت داشته باشند. |
availability[] | لیست جدید در دسترس بودن |
FeedStatistics
آماری که هنگام پردازش فید آپلود شده به دست آمده است.
فیلدها | |
---|---|
new_items | موارد تازه اضافه شده توسط این فید. بسته به نوع فید، آیتمها میتوانند تاجر، خدمات یا جایگاههای دسترسی باشند. |
existing_items | موارد موجود، در صورت نیاز از اطلاعات جدیدتر فید بهروزرسانی میشوند. |
deleted_items | موارد دیگر در این فید وجود ندارند و در نتیجه حذف شدند. |
وضعیت فید
وضعیت فید آپلود شده توسط پلتفرم جمعآور.
فیلدها | |
---|---|
name | نام منبع فید که دارای قالب است
|
state | وضعیت پردازش این خوراک. |
error_details | اگر نتوانستیم این فید را پردازش کنیم، رشته قابل خواندن توسط انسان جزئیات بیشتری را ارائه می دهد. |
statistics | آمار مخصوص این فید. |
ایالت
Enum برای نشان دادن وضعیت پردازش یک خوراک.
Enums | |
---|---|
STATE_UNSPECIFIED | مقدار پیش فرض استفاده نشده |
IN_PROGRESS | فید هنوز در حال پردازش است. |
SUCCESS | فید با موفقیت پردازش شد. |
FAILURE | هنگام پردازش فید با خطایی مواجه شدیم. |
FoodOrderingMetadata
پیوندهای اقدام متادیتا برای سفارش غذا.
فیلدها | |
---|---|
fee_details[] | جزئیات هزینه هایی که از کاربر در بالای کل کالا دریافت می شود. برای انواع مختلف هزینه ها مانند هزینه خدمات، هزینه تحویل و غیره تکرار می شود. |
advance_order_details | جزئیات مربوط به پشتیبانی پیشرفته سفارش که به عنوان سفارش پیشرو نیز شناخته میشود، که در آن کاربر میتواند سفارشی را برای انجام در زمانی دیرتر از اکنون ثبت کند. |
fulfillment_duration_options فیلد اتحادیه. مدت زمان انجام سفارش از زمان تایید سفارش. برای سفارشات تحویل، مدت زمان تا تحویل غذا. برای سفارشات پیکاپ، مدت زمان تا آماده شدن غذا برای تحویل گرفتن. fulfillment_duration_options فقط می تواند یکی از موارد زیر باشد: | |
fulfillment_lead_time_duration | مدت زمان ثابت به عنوان مثال: 30 دقیقه |
fulfillment_lead_time_duration_range | محدوده ای از مدت زمان. مثال ها: * 30 دقیقه تا 45 دقیقه * بیشتر از 30 دقیقه * کمتر از 50 دقیقه |
AdvanceOrderDetails
برای سفارش از قبل پشتیبانی
فیلدها | |
---|---|
is_supported | درست است اگر سفارشهای پیشفرض، که به عنوان سفارش پیشرو نیز شناخته میشود، پشتیبانی شود. (الزامی) |
FeeDetails
جزئیات هزینه
فیلدها | |
---|---|
type | نوع کارمزد (الزامی) |
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٪ و USD 1.5-2.5، 10.5٪ - USD 20٪ و دلار 2.5-3.5
فیلدها | |
---|---|
cart_percentage | کارمزد بر حسب درصدی از ارزش سبد خرید. از یک محدوده (محدود و نامحدود) یا یک درصد ثابت پشتیبانی می کند. مقدار باید بین 0 تا 100 باشد. مثالها: * ثابت 5.5٪ * حداقل 5.5٪ * حداکثر 5.5٪ * 4.5٪ تا 5.5٪ |
amount_options فیلد اتحادیه. گزینه هایی برای تعیین مقدار پولی amount_options فقط می تواند یکی از موارد زیر باشد: | |
amount | مبلغ ثابت به عنوان مثال USD 3.5. |
amount_range | محدوده مقدار. مثال: * 3.5 تا 5.5 دلار * حداقل 3.5 دلار * حداکثر 5.5 دلار |
amount_unknown | مقدار نامعلوم |
FeeType
نوع کارمزد
Enums | |
---|---|
FEE_TYPE_UNSPECIFIED | نوع کارمزد مشخص نشده است. |
DELIVERY | برای هزینه های تحویل. |
SERVICE | برای هزینه خدمات. |
FulfillmentOption
گزینه انجام برای پیوند اقدام آنلاین سفارش.
فیلدها | |
---|---|
fulfillment_type | مورد نیاز. نوع تحقق |
available_day[] | مورد نیاز. فهرستی از روزهایی که برای این روش تکمیلی در دسترس است (ترجیحاً حداقل 2). |
fee_details | مورد نیاز. جزئیات هزینه برای روش تکمیل. |
minimum_order | مورد نیاز. حداقل سفارش برای روش انجام مرتبط با پیوند اقدام. |
روز در دسترس
در دسترس بودن سطح روز
فیلدها | |
---|---|
fulfillment_date | مورد نیاز. تاریخ در دسترس برای یک روش تحقق. فرض بر این است که در منطقه زمانی تاجر است. |
last_ordering_time | مورد نیاز. مهر زمانی یونیکس آخرین باری که کاربر میتوانست سفارش دهد و اقلام را تا به عنوان مثال، اگر تاریخ تکمیلی 10-08-2020 باشد: - مقدار last_ordering_time 2020-08-10 ساعت 18:00 به این معنی است که برای دریافت سفارش خود در 10-08-2020، مشتری باید آن سفارش را تا ساعت 6 بعد از ظهر انجام دهد. همان روز - مقدار last_ordering_time 2020-08-08 ساعت 20:00 به این معنی است که برای دریافت سفارش خود در تاریخ 10-08-2020، مشتری باید آن سفارش را تا ساعت 8 بعد از ظهر دو روز قبل انجام دهد. |
FeeDetails
جزئیات کارمزد روش تکمیل مرتبط با پیوند اقدام.
فیلدها | |
---|---|
فیلد اتحادیه fee_details . مدل کارمزد برای روش تحقق. fee_details فقط می تواند یکی از موارد زیر باشد: | |
no_fee | بدون هزینه برای روش انجام. |
base_fee | هزینه پایه مرتبط با روش تکمیل. |
fixed_fee | هزینه ثابت مرتبط با روش انجام. |
فیکس فیکس
هزینه ثابت مورد نیاز برای روش انجام مرتبط با پیوند اقدام.
فیلدها | |
---|---|
amount | مورد نیاز. مبلغ حق الزحمه ثابت روش انجام. |
نوع تحقق
نوع انجام مرتبط با پیوند اقدام.
Enums | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED | نوع تحقق نامشخص است. |
FULFILLMENT_TYPE_DELIVERY | نوع تحقق تحویل است. |
FULFILLMENT_TYPE_PICKUP | نوع تحقق وانت است. |
حداقل
حداقل هزینه مورد نیاز برای روش تحقق مرتبط با لینک عمل.
فیلدها | |
---|---|
base_fee_amount | مورد نیاز. مبلغ هزینه پایه برای روش تحقق. |
نافری
هزینه ای برای روش تحقق مرتبط با لینک عمل لازم نیست.
صفحه اصلی
ضبط شده از نوع خوراک ذکر شده در درخواست URL حذف می شود.
فیلدها | |
---|---|
delete_time | مورد نیاز. از این زمان سنج برای تعیین ترتیب استفاده از حذف برای موجودی استفاده می شود. |
Union Field record_type . شرکای مختلف Feed (Ndjson ، Proto و غیره) را می تواند یک رکورد کامل شبیه به نحوه ارائه یک رکورد در API Feed یا Batchpush ارائه دهد. شرکا همچنین این گزینه را دارند که فقط زمینه های اساسی یک رکورد مورد نیاز برای شناسایی منحصر به فرد آن را در بر گیرند. record_type فقط می تواند یکی از موارد زیر باشد: | |
data_record | برای فیدهای مبتنی بر غیر پروتو. |
proto_record | برای فیدهای مبتنی بر پروتئین. |
عکسبرداری عمومی
سابقه نوع خوراک ذکر شده در درخواست URL.
فیلدها | |
---|---|
generation_timestamp | مورد نیاز. از این Timestamp برای اطمینان از سفارش صحیح به روزرسانی موجودی استفاده می شود. |
Union Field record_type . انواع مختلفی از خوراک (Ndjson ، Proto و غیره) record_type کنید. | |
data_record | برای فیدهای مبتنی بر غیر پروتو. |
proto_record | برای فیدهای مبتنی بر پروتئین. |
زمین
داده های جغرافیایی یک مکان ، از جمله عرض جغرافیایی ، طول جغرافیایی و آدرس.
فیلدها | |
---|---|
latitude | عرض جغرافیایی در درجه. (اختیاری) |
longitude | طول جغرافیایی (اختیاری) |
addresses حوزه اتحادیه. آدرس برای یک مکان ، می تواند ساختار یافته یا بدون ساختار باشد. addresses فقط می توانند یکی از موارد زیر باشند: | |
address | آدرس پستی محل ، ترجیح داده شده است. |
unstructured_address | یک آدرس بدون ساختار نیز می تواند به عنوان یک بازپرداخت ارائه شود. به عنوان مثال "1600 Amphitheater Parkway Mountain View ، CA 94043" |
GetMerchantStatusRequest
درخواست دریافت یک MerchantStatus
فیلدها | |
---|---|
name | مورد نیاز. نام منبع ، در قالب شرکا/{شریک_ید}/بازرگانان/{merchant_id}/وضعیت. |
getStatusRequest
درخواست بازیابی Status
برای یک فید خاص بارگذاری شده توسط پلت فرم جمع کننده.
فیلدها | |
---|---|
name | نام منبع خوراک ، که دارای قالب است
|
HomeServicedata
اطلاعات اضافی لازم برای ارائه خدمات به صورت عمودی ارائه می شود.
فیلدها | |
---|---|
category_type | گروه سطح بالایی که این سرویس خانگی به آن تعلق دارد. به عنوان مثال لوله کش ، برق و غیره |
job_type | نوع شغلی تحت مقوله ای که سرویس خانه داده شده به آن تعلق دارد. به عنوان مثال unclog_drain ، install_faucet انواع کار در گروه لوله کشی هستند. |
نوع ادغام
عمق ادغام پشتیبانی می شود.
Enums | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED | پیش فرض به end_to_end. |
INTEGRATION_TYPE_END_TO_END | ادغام کامل که به پایان می رسد پایان رزرو از طریق Google. |
INTEGRATION_TYPE_INVENTORY_ONLY | سرور رزرو نیازی به پشتیبانی از این سرویس ندارد. فقط بازرگانان ، خدمات و (اختیاری) داده های در دسترس بودن باید ارسال شوند. |
InvalidaterEsourcerequest
درخواست برای باطل کردن یک منبع.
فیلدها | |
---|---|
resource_id | نام منبعی که قابل اعتبار است. به عنوان مثال ، برای یک منبع وانت ، نام باید از فرمت |
خط
یک مورد واحد به ترتیب-رزرو یک سرویس واحد در یک شکاف واحد.
فیلدها | |
---|---|
service_id | شناسه خدمات بازرگان. |
start_sec | زمان شروع شکاف قرار ملاقات را در ثانیه از زمان UTC از زمان UNIX EPOCH شروع کنید. |
duration_sec | مدت زمان شکاف قرار ملاقات در ثانیه. |
tickets[] | تعداد بلیط سفارش داده شده توسط نوع بلیط. |
price | قیمت کل (به استثنای مالیات) این مورد خط. |
status | وضعیت مورد خط. |
orderedtickets
تعداد بلیط های سفارش داده شده بر اساس نوع بلیط.
فیلدها | |
---|---|
ticket_id | شناسه از نوع بلیط. |
count | تعداد بلیط های سفارش داده شده برای این نوع. |
ListMerchantStatusEsRequest
درخواست برای دریافت لیستی از MerchantStatus
فیلدها | |
---|---|
parent | مورد نیاز. والدین ، که صاحب این مجموعه از وضعیت بازرگان است. قالب: |
page_size | مورد نیاز. حداکثر تعداد موارد برای بازگشت. توجه داشته باشید که سرور ممکن است اندازه صفحه را کاهش دهد. |
page_token | اختیاری. در صورت وجود ، مقدار NextPageToken از یک لیست قبلی ListMerchantStatusResponse بازگشت. |
booking_inventory_status_restrict | اختیاری. محدودیت اختیاری برای فیلتر کردن نتایج با رزرو وضعیت موجودی. |
waitlist_inventory_status_restrict | اختیاری. محدودیت اختیاری برای فیلتر کردن نتایج با وضعیت موجودی لیست انتظار. |
geo_match_restrict | اختیاری. محدودیت اختیاری برای فیلتر کردن نتایج با وضعیت تطبیق 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[] | لیست وضعیت های بازرگان که شرایط فیلتر را برآورده می کند. |
next_page_token | نشانه برای بازیابی صفحه بعدی نتایج. اگر خالی باشد نتیجه بیشتری در لیست وجود ندارد. |
لیست
درخواست بازیابی Status
برای چندین فید بارگذاری شده توسط پلت فرم جمع کننده.
فیلدها | |
---|---|
name | نام منبع خوراک ، که دارای قالب است
|
page_size | حداکثر تعداد موارد برای بازگشت. |
page_token | مقدار NEXT_PAGE_TOKEN در صورت وجود از درخواست لیست قبلی بازگردد. |
state_restrict | اختیاری محدود به نتایج فیلتر توسط حالت خوراک. |
time_range_restrict | اختیاری محدود به نتایج فیلتر با محدودیت بالا و پایین. اگر Start_Time غیرقانونی باشد ، به طور پیش فرض تا ابتدای زمان یونیکس خواهد بود. اگر end_time غیرقانونی باشد ، اکنون به طور پیش فرض خواهد بود. |
پاسخ لیست
درخواست بازیابی Status
برای چندین فید بارگذاری شده توسط پلت فرم جمع کننده.
فیلدها | |
---|---|
status[] | لیست زمانی معکوس وضعیتهای فیدهای بارگذاری شده. حداکثر تعداد موارد برگشتی بر اساس قسمت page_size در درخواست است. |
next_page_token | نشانه برای بازیابی صفحه بعدی نتایج. اگر خالی باشد نتیجه بیشتری در لیست وجود ندارد. |
نوشابه
نمونه ای از یک رشته در یک محلی.
فیلدها | |
---|---|
locale | کد زبان IETF BCP 47 ، مانند "en" ، "MAS" ، "Zh-Hant" ، "DE-CH-1901". به http://www.w3.org/international/articles/language-tags/ مراجعه کنید. |
value | پیام در محل فوق (UTF-8). |
مکان
اطلاعات جغرافیایی در مورد یک مکان.
فیلدها | |
---|---|
place_id | شناسه مکان برای مکانی در پایگاه داده Google Places و در Google Maps. برای اطلاعات بیشتر در مورد شناسه های مکان ، به https://developers.google.com/places/web-service/place-id مراجعه کنید. اگر این امر فراهم شود ، Google مکان را با این مکان مطابقت می دهد. |
name | از نام ، تلفن ، URL و GEO این مکان برای پشتیبانی از تطبیق مکان با مکانهایی که قبلاً در Google Maps حضور دارند استفاده می شود. این قسمت اختیاری است ، اما ممکن است در برخی زمینه ها مورد نیاز باشد. به عنوان مثال ، یک سرویس. محل بدون نام با یک نهاد تجاری مطابقت نخواهد داشت ، حتی اگر در همان آدرس قرار داشته باشند. (اختیاری) |
telephone | شماره تلفن عمومی محل از جمله کدهای کشور و منطقه آن ، به عنوان مثال +14567891234. (اختیاری) |
url | URL وب سایت عمومی مکان. (اختیاری) |
geo | اطلاعات جغرافیایی محل ، از جمله عرض جغرافیایی ، طول جغرافیایی و آدرس. (اختیاری) |
location_type | در صورت ارائه این مکان برای یک سرویس ، نوع مکان ، باید تأمین شود. |
location_id | مرجع منحصر به فرد از مکان در سرویس. از این شناسه می توان برای مراجعه به این مکان در سایر زمینه های خدمات استفاده کرد. به عنوان مثال در فرم ورودی سفارشی ، می توان از مجموعه ای از شناسه های مکان برای مشخص کردن گزینه های مکان انتخاب استفاده کرد. در صورت تنظیم ، این شناسه باید در همان سرویس بی نظیر باشد. (اختیاری) |
نوع مکان
نوع این مکان
Enums | |
---|---|
LOCATION_TYPE_UNSPECIFIED | نوع مکان نامشخص. |
VISITED_LOCATION | مکانی که این سرویس از آن بازدید می کند. |
START_LOCATION | مکانی که این سرویس شروع می شود ، همچنین به عنوان SCEET_LOCATION خدمت می کند. |
END_LOCATION | مکانی که این سرویس به پایان می رسد. |
بازرگان
اطلاعات مربوط به یک بازرگان که در پلتفرم جمع است.
فیلدها | |
---|---|
name | نام منبع بازرگان ، که دارای فرمت |
merchant_name | از Merchant_Name ، Teleplle ، URL و GEO برای پشتیبانی از موجودی شریک زندگی با بازرگانانی که قبلاً در Google Maps حضور دارند استفاده می شود. این اطلاعات نمایش داده نمی شود. نام بازرگان. |
telephone | شماره تلفن عمومی بازرگان از جمله کدهای کشور و منطقه آن ، به عنوان مثال +14567891234. |
url | URL وب سایت عمومی بازرگان. |
geo | اطلاعات جغرافیایی بازرگان ، از جمله عرض جغرافیایی ، طول و آدرس. |
category | دسته تجارت در پلتفرم Aggregator. |
num_bookings_30d | این زمینه مستهلک می شود. |
tax_rate_basis_points | نرخ مالیات بازرگان در نقاط پایه (یک صدم یک درصد). به عنوان مثال ، اگر نرخ مالیات 7.5 ٪ باشد ، این قسمت باید روی 750 تنظیم شود. اگر این قسمت UNET باقی مانده یا روی 0 تنظیم شود ، کل قیمت که برای هر سرویس ارائه شده توسط این بازرگان به کاربر شارژ می شود ، قیمت دقیقی است که توسط Service.Price مشخص شده است. فرض بر این است که قیمت خدمات از مالیات های قابل اجرا معاف است یا در حال حاضر شامل مالیات های قابل اجرا است. مالیات به عنوان یک مورد خط جداگانه به کاربر نشان داده نمی شود. اگر این قسمت به هر ارزش غیرزرو تنظیم شود ، کل قیمت که برای هر خدمتی که توسط این بازرگان ارائه شده است به کاربر پرداخت می شود ، قیمت خدمات به علاوه مالیات ارزیابی شده با استفاده از نرخ مالیات ارائه شده در اینجا را شامل می شود. کسری از کوچکترین واحد ارزی (به عنوان مثال ، کسری از یک درصد) با استفاده از نزدیکترین حتی گرد گرد می شوند. مالیات به عنوان یک مورد خط جداگانه به کاربر نشان داده می شود. این قسمت مستهلک می شود ، لطفاً به جای آن از مالیات_رایت استفاده کنید. |
tax_rate | نرخ مالیات بازرگان. در صورت وجود این زمینه ، قسمت مستهلک شده مالیات_ rate_basis_points را نادیده می گیرد. یک پیام خالی (یعنی مالیات_ {}) نرخ مالیات اعمال شده را به صفر بازنشانی می کند. |
payment_restrictions | محدودیت در روش های پرداختی که این بازرگان می پذیرد. اگر این قسمت تنظیم نشده باشد ، هیچ محدودیتی وجود ندارد. |
payment_option[] | گزینه های پرداخت موجود برای این بازرگان. خدمات تحت این بازرگان قادر خواهند بود گزینه های پرداختی را که اجازه می دهند به صورت جداگانه محدود کنند. |
payment_processor_config | پیکربندی برای یک پردازنده پرداخت توکن ، اگر بازرگان از آن پشتیبانی می کند. |
tokenization_config | پیکربندی برای یک پردازنده پرداخت توکن ، اگر بازرگان از آن پشتیبانی می کند. |
terms | شرایط و ضوابط بازرگان خاص هنگام رزرو سرویس از طریق Reserve با Google به کاربر نمایش داده می شود. علاوه بر این شرایط و ضوابط شریک جمع همیشه به کاربر نمایش داده می شود و نباید در اینجا ارائه شود. |
brand_id | یک رشته مات که مارک مصرف کننده را برای استفاده در هنگام نمایش انتساب شریک مشخص می کند. این زمینه به شرکای دارای مارک های مختلف مصرف کننده اجازه می دهد تا بازرگانان را برای همه مارک های موجود در همان خوراک فراهم کنند. یک برند از خصوصیات رو به مصرف کننده مانند نام ، آرم ، شرایط خدمات و خط مشی رازداری تشکیل شده است. اگر فقط یک برند شریک مصرف کننده وجود داشته باشد ، نیازی به تنظیم این زمینه ندارد و می توان آن را نادیده گرفت. اگر شریک زندگی ... آیا مارک های مختلف مصرف کننده وجود ندارد؟ -> این زمینه را نادیده بگیرید آیا مارک های مختلفی که پیکربندی شده اند؟
توجه دقیق: اکثر شرکا نیازی به تنظیم این زمینه ندارند. اگر شریک زندگی بخواهد از این قسمت استفاده کند ، ابتدا باید برای پیکربندی مارک های جداگانه ، از جمله مارک پیش فرض ، ابتدا با ما تماس بگیرند. |
matching_hints | نکات برای کمک به Google با یک بازرگان با مکانی در Google Maps مطابقت دارد. توجه: اکثر شرکا نیازی به تنظیم این قسمت ندارند ، زیرا Google با استفاده از اطلاعات ارائه شده در بالا ، بازرگانان را با مکان های Google Maps مطابقت می دهد. (اختیاری) |
service_attribute[] | تعاریف مربوط به هرگونه ویژگی خدماتی که برای توصیف خدمات برای این بازرگان استفاده می شود. (اختیاری) |
action_link[] | اختیاری. یک URL اقدام با زبان مرتبط ، لیست کشورهایی که محدود به ، نوع و پلت فرم اختیاری هستند که نشان می دهد این پلتفرم باید روی کدام پلتفرم انجام شود |
waitlist_advisement | اختیاری. مشاوره عمومی از یک بازرگان خاص برای کاربر که از طریق Reserve with Google به لیست انتظار می رود. زمینه های متن فردی در مشاوره باید به طول 100 بایت محدود شود. |
بازرگانی
نکات مورد استفاده برای کمک به Google با یک بازرگان با مکانی در Google Maps.
فیلدها | |
---|---|
place_id | شناسه مکان برای مکانی در پایگاه داده Google Places و در Google Maps. برای اطلاعات بیشتر در مورد شناسه های مکان ، به https://developers.google.com/places/web-service/place-id مراجعه کنید. |
بازرگان
وضعیت یک بازرگان در ذخیره با Google Platform.
فیلدها | |
---|---|
name | نام منبع وضعیت بازرگان ، که دارای فرمت |
merchant_name | نام بازرگان ارائه شده توسط شرکا. |
input_geo_info | شرکا اطلاعات جغرافیایی از بازرگان را ارائه دادند. |
processing_status | وضعیت پردازش بازرگان. |
booking_status | وضعیت مربوط به ادغام رزرو پایان به انتها. |
waitlist_status | وضعیت مربوط به ادغام لیست انتظار. |
geo_match | مکان GEO با این بازرگان. اگر بازرگان با GEO مطابقت نداشته باشد خالی است. |
local_services_match | آگهی های خدمات محلی این بازرگان مطابقت دارد. اگر این یک بازرگان خدمات محلی نباشد یا با هیچ یک از ارائه دهندگان مطابقت نداشته باشد ، خالی باشد. |
direct_urls[] | لیستی از URL ها برای نشان دادن محتوای موجودی تجاری فعلی. توجه داشته باشید که این بدان معنا نیست که موجودی در واقع سرو می شود و URL ممکن است با موارد قابل مشاهده متفاوت باشد. |
رزرو
وضعیت مربوط به ادغام رزرو پایان به انتها.
فیلدها | |
---|---|
has_valid_future_inventory | درست است اگر بازرگان در 30 روز آینده موجودی داشته باشد. تضمین نمی کند که بازرگان در واقع ارائه شود. |
کارگردانی
URL که بازرگان را سطح می کند.
فیلدها | |
---|---|
type | نوع این URL. |
url | URL که ممکن است این بازرگان را سطح کند. |
نوع مجریه
نوع آدرس اینترنتی.
Enums | |
---|---|
URL_TYPE_UNSPECIFIED | مشخص نشده است. |
BOOKING | URL رزرو پایان به پایان. |
WAITLIST | URL لیست انتظار پایان به پایان. |
LOCAL_SERVICES | URL خدمات محلی Google. |
محلی
اطلاعات مربوط به خدمات محلی Google (فقط برای بازرگان خدمات محلی تعیین شده است).
فیلدها | |
---|---|
matched_providers[] | ارائه دهندگان خدمات همسان. یک بازرگان می تواند با چندین ارائه دهنده خدمات مطابقت داشته باشد. |
پیشرو
ارائه دهنده خدمات محلی.
فیلدها | |
---|---|
customer_id | شناسه مشتری خارجی Google Services. |
categories[] | دسته بندی خدمات محلی (عمودی). به عنوان مثال "لوله کشی" و "فرش_ پاک". |
محل زندگی
اطلاعات یک مکان همسان
فیلدها | |
---|---|
name | نام مکان |
formatted_address | آدرس فرمت شده به زبان محلی. |
place_id | شناسه 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 | درست است اگر بازرگان دارای سرویس لیست انتظار باشد. تضمین نمی کند که بازرگان در واقع ارائه شود. |
پول
بسته بندی برای طیف وسیعی از مبلغ پولی که می تواند محدود یا بدون مرز باشد. حداقل یکی از min_amount و max_amount لازم است.
فیلدها | |
---|---|
min_amount | حداقل مقدار. |
max_amount | حداکثر مقدار |
نوشافی
هزینه ای که ممکن است کاربر در صورت تهیه یک رزرو هزینه داشته باشد اما نشان نمی دهد.
فیلدها | |
---|---|
fee | مبلغی که کاربر در صورت عدم حضور در رزرو آنها ممکن است شارژ شود. |
fee_type | تعیین می کند که چگونه هزینه از دسترس بودن تعیین می شود. |
سفارش دهید
دستور برای قرار ملاقات های خدمات با یک بازرگان.
فیلدها | |
---|---|
name | نام منبع سفارش: |
client_information | اطلاعات شخصی مشتری که سفارش می دهد. |
payment_information | اطلاعات مربوط به معاملات پرداخت مربوط به سفارش. |
merchant_id | شناسه بازرگان که کلیه خدمات در این دستور متعلق به آن است. |
item[] | موارد خط به این ترتیب. |
ordeonlinemetadata
ابرداده برای یک لینک اقدام آنلاین سفارش.
فیلدها | |
---|---|
fulfillment_option[] | گزینه های تحقق موجود برای یک لینک اقدام آنلاین سفارش. |
اطلاعات پرداخت
جزئیات پرداختی که مربوط به رزرو است
فیلدها | |
---|---|
prepayment_status | وضعیت پیش پرداخت رزرو. اگر پیش پرداخت_ستاتوس پیش پرداخت_پرولیده شده یا پیش پرداخت شده باشد ، پس پرداخت_ transaction_id حاوی شناسه معامله منحصر به فرد مرتبط است. |
payment_transaction_id | شناسه منحصر به فرد برای معامله پرداخت مرتبط با رزرو. در صورت عدم کاربرد خالی. |
پرداخت
یک گزینه پرداخت ، که می تواند برای پرداخت خدمات ارائه شده توسط یک بازرگان استفاده شود. گزینه های پرداخت را می توان در بین بازرگانان متعدد (به عنوان مثال بازرگانان متعلق به همان زنجیره) به اشتراک گذاشت.
فیلدها | |
---|---|
payment_option_id | این شناسه برای شناسایی این گزینه پرداخت استفاده می شود. این شناسه برای کل جمع جهانی جهانی است و با استفاده مجدد از یک ارزش در بین بازرگانان متعدد ، به کاربر امکان می دهد با گزینه پرداخت مربوطه در آن بازرگانان بپردازد. هنگام استفاده مجدد از یک بازرگان چندگانه ، به روزرسانی هر مقدار برای گزینه پرداخت تحت یک بازرگان ، هر گزینه پرداخت دیگری را با همان شناسه ، تحت یک بازرگان متفاوت به روز می کند. به همین ترتیب ، این بهترین روش است که تمام گزینه های پرداخت با همان شناسه ، همیشه به ارزش های یکسان بروزرسانی شود تا از هرگونه امکان رفتار کمبودی جلوگیری شود. |
name | نام گزینه پرداخت. این می تواند کاربر قابل مشاهده باشد. |
description | شرح گزینه پرداخت. این می تواند کاربر قابل مشاهده باشد. |
price | قیمت گزینه پرداخت. |
tax_rate | نرخ مالیات برای این گزینه پرداخت. در صورت وجود این زمینه ، زمینه مالیات_ر موجود در بازرگان یا خدمات را تحت الشعاع قرار می دهد. یک پیام خالی (یعنی مالیات_ {}) نرخ مالیات اعمال شده را به صفر بازنشانی می کند. |
payment_option_type | نوع این گزینه پرداخت. یکبار مصرف برای قطره ، چند کاربردی برای بسته ها و نامحدود برای عضویت. |
session_count | این گزینه پرداخت می تواند برای چند جلسه استفاده شود. فقط برای چند جلسه / بسته ها معتبر است ، جایی که مقدار باید> 1 باشد. |
purchase_interval | گزینه پرداخت را می توان در این بازه خریداری کرد. |
valid_interval | گزینه پرداخت می تواند در این بازه استفاده شود (به عنوان مثال قیمت ویژه ژانویه 2017). در صورت وجود ، این امر بر اعتبار_دور و فعال سازی_تایپ غلبه می کند. |
valid_duration | مدت اعتبار گزینه پرداخت (به عنوان مثال عضویت 30 روزه). |
activation_type | تعیین می کند که چگونه تاریخ شروع اعتبار برای این گزینه پرداخت تعیین می شود. |
user_restriction | کاربران واجد شرایط برای خرید این گزینه پرداخت را محدود می کند. می توان برای محدود کردن گزینه پرداخت تبلیغاتی به زیر مجموعه ای از کاربران استفاده کرد. اگر تنظیم نشده باشد ، همه کاربران واجد شرایط هستند. |
نوع فعال سازی
نحوه تعیین تاریخ شروع اعتبار را مشخص می کند.
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 | شریک پردازنده پرداخت این پیکربندی را مشخص می کند. |
public_key | کلید مورد استفاده برای شناسایی این بازرگان با پردازنده پرداخت. برای راه راه ، به: https://stripe.com/docs/dashboard#api-keys برای Braintree مراجعه کنید ، به https://articles.braintreepayments.com/control-panel/important-gateway-credentials مراجعه کنید. |
version | شماره نسخه API ارسال شده به پردازنده پرداخت به همراه درخواست های پرداخت. |
پردازنده
یک شریک پردازنده پرداخت خاص را تعریف می کند.
Enums | |
---|---|
PROCESSOR_UNSPECIFIED | استفاده نشده |
PROCESSOR_STRIPE | پیکربندی برای پرداخت با نوار. |
PROCESSOR_BRAINTREE | پیکربندی برای پرداخت با Braintree. |
بازپرداختهای پرداخت
محدودیت در روش های پرداختی که این بازرگان می پذیرد.
فیلدها | |
---|---|
credit_card_restrictions | محدودیت در کارتهای اعتباری که این بازرگان می پذیرد. فرض می کنیم اگر این قسمت تنظیم نشده باشد ، همه کارتهای اعتباری پذیرفته می شوند. توجه داشته باشید که لیست کارتهای پشتیبانی شده توسط CreditCardType با گذشت زمان رشد می کند ، به این معنی که ترک این افراد خالی پیکربندی برای تغییرات آینده. |
پیشرو
هزینه هایی که باید یک بار در هر سفارش پرداخت شود ، صرف نظر از تعداد بلیط.
فیلدها | |
---|---|
delivery_fee | هزینه ای که می تواند با روش تحویل متفاوت باشد. |
processing_fee | هزینه ای برای پردازش روش پرداخت کاربر. |
باجایی
هزینه هایی که باید برای هر بلیط که کاربر خریداری می کند پرداخت شود.
فیلدها | |
---|---|
service_charge | هزینه اضافی برای یک سرویس ارزیابی شده است. |
facility_fee | هزینه ای که به محل برگزاری/تسهیلات می رود. |
taxes | مالیات بلیط. |
پست
آدرس مشتری یا یک تجارت.
فیلدها | |
---|---|
address_country | این کشور ، با استفاده از کد کشور ISO 3166-1 Alpha-2 ، به عنوان مثال "ما" (مورد نیاز) مشخص شده است |
address_locality | محل ، به عنوان مثال "نمای کوه". (الزامی) |
address_region | منطقه ، به عنوان مثال "CA". این زمینه فقط در کشورهایی که معمولاً منطقه بخشی از آدرس است لازم است. (اختیاری) |
postal_code | کد پستی ، به عنوان مثال "94043". (الزامی) |
street_address | آدرس خیابان ، به عنوان مثال "1600 آمفی تئاتر PKWY". (الزامی) |
پیش پرداخت
وضعیت پیش پرداخت یک رزرو.
Enums | |
---|---|
PREPAYMENT_STATUS_UNSPECIFIED | مشخص نشده است ، پیش فرض برای پیش پرداخت_نوت_پرول. |
PREPAYMENT_PROVIDED | هزینه رزرو از قبل پرداخت شده است. |
PREPAYMENT_NOT_PROVIDED | هزینه رزرو از قبل پرداخت نشده است. |
PREPAYMENT_REFUNDED | این هزینه قبلاً پیش پرداخت_ ارائه شده بود اما اکنون بازپرداخت شده است. |
قیمت
قیمت یک سرویس یا هزینه.
فیلدها | |
---|---|
price_micros | قیمت در واحدهای خرد ارز. کسری از واحد کوچکترین واحد ارز با استفاده از نزدیکترین حتی گرد گرد می شوند. (به عنوان مثال برای 2.5 سنت دلار به 2 سنت ، 3.5 سنت دور به 4 سنت ، 0.5 سنت گرد به 0 سنت ، 2.51 سنت گرد تا 3 سنت). |
currency_code | ارز قیمتی که در ISO 4217 تعریف شده است. |
pricing_option_tag | یک رشته اختیاری و مات که گزینه قیمت گذاری را که با قیمت طولانی همراه است ، مشخص می کند. |
تفسیر قیمت
توصیف می کند که چگونه یک قیمت باید تفسیر و به کاربر نمایش داده شود.
Enums | |
---|---|
PRICE_INTERPRETATION_UNSPECIFIED | تفسیر قیمت نامشخص ، پیش فرض به دقیق_مونت. |
EXACT_AMOUNT | هنگامی که قیمت باید به عنوان یک ارزش خاص تعبیر شود. مثال: 20 دلار برای کلاس یوگا ؛ 15 دلار برای مدل موهای کودک |
STARTS_AT | هنگامی که قیمت یک سرویس متغیر است اما حداقل قیمت شناخته شده و برای مصرف کنندگان نمایش داده می شود. مصرف کنندگان ممکن است انتخابی را انجام دهند که قیمت را افزایش می دهد. توجه داشته باشید که هر خدمتی که از این تفسیر قیمت استفاده می کند ، باید از پیش پرداخت not_supported استفاده کند. مثالها: 30 دلار برای نظافت سگ ، اما گزینه های اضافی مصرف کننده ممکن است قیمت را افزایش دهد |
NOT_DISPLAYED | هنگامی که قیمت یک سرویس متغیر است و هیچ اطلاعات قیمت قبل از زمان برای مصرف کنندگان نمایش داده نمی شود. توجه داشته باشید که هر خدمتی که از این تفسیر قیمت استفاده می کند ، باید از پیش پرداختی not_supported استفاده کند و قیمت باید خالی باشد. مثال: مشاوره برای یک سرویس خانگی |
نوع قیمت
تعیین می کند که چگونه یک قیمت کل از یک در دسترس بودن تعیین می شود.
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 | یک مقدار مفرد به عنوان مثال: 5.6 |
value_range | طیف وسیعی از مقادیر که می توانند باز یا محدود شوند. مثال: * حداقل 5.5 * حداکثر 5.5 * 5.5 تا 6.5 |
دامنه مقادیر
دامنه مقادیر به گونه ای که min_value
< max_value
. حداقل به یکی از min_value
و max_value
نیاز دارد.
فیلدها | |
---|---|
min_value | حداقل مقدار |
max_value | حداکثر مقدار. |
رتبه بندی
رتبه بندی را برای یک موجود تعریف می کند.
فیلدها | |
---|---|
value | مقدار متوسط رتبه بندی (در صورت نیاز به شماره_of_ratings> 0). مقدار باید در محدوده [1 ، 5] باشد و اگر و فقط اگر شماره_ف_راتینگ صفر باشد ، می تواند حذف شود. |
number_of_ratings | تعداد رتبه بندی های مورد استفاده در محاسبه مقدار (مورد نیاز). |
وابسته
عکسهای مربوط به این سرویس. Google این رسانه ها را خزنده می کند تا اطمینان حاصل شود که آنها به درستی برای کاربران نهایی نمایش داده می شوند. (اختیاری)
فیلدها | |
---|---|
url | URL این منبع رسانه ای. Google رسانه های میزبانی شده در این URL را خزنده می کند. |
type | نوع این منبع رسانه ای. |
localized_caption | عنوان رسانه ای که از i18n پشتیبانی می کند ، فقط متن ساده پشتیبانی می شود. هر مؤلفه HTML سلب می شود. (اختیاری) |
attribution | اطلاعات مربوط به منبع رسانه. توجه داشته باشید که در صورت نیاز به انتساب برای نمایش با رسانه ها برای اعتبار به عکاس یا آژانس ، این زمینه باید تنظیم شود. (اختیاری) |
caption | مستهلک ، ترجیح می دهید از boalized_caption استفاده کنید. |
انتساب
اطلاعات مربوط به این رسانه.
فیلدها | |
---|---|
localized_text | متن برای اعتبار به عکاس یا آژانس پشتیبانی I18N. این متن به همراه رسانه منبع نمایش داده می شود. توجه داشته باشید که فقط متن ساده برای این زمینه پشتیبانی می شود ، هر مؤلفه HTML سلب می شود (انتساب مبتنی بر لینک پشتیبانی نمی شود). |
text | کاهش یافته ، ترجیح می دهید از boalized_text استفاده کنید. |
واسطه
Enum برای نشان دادن نوع این منبع رسانه. فقط عکس ها پشتیبانی می شوند. اگر سایر رسانه ها فراتر از عکس ها پشتیبانی می شوند ، لطفاً با تیم Google به رزرو مراجعه کنید.
Enums | |
---|---|
TYPE_UNSPECIFIED | بلااستفاده |
PHOTO | نشان می دهد رسانه های ارائه شده توسط URL یک عکس است. |
chepraceserviceailabilityrequest
درخواست برای جایگزینی در دسترس بودن Service
.
فیلدها | |
---|---|
service_availability | در دسترس بودن سرویس که برای جایگزینی موارد موجود استفاده می شود. |
costecreditcard
تعریف می کند که آیا کارت اعتباری برای رزرو قرار ملاقات مورد نیاز است.
Enums | |
---|---|
REQUIRE_CREDIT_CARD_UNSPECIFIED | نیاز کارت اعتباری به صراحت مشخص نشده است و رفتار با آنچه برای مشروط مشخص شده است یکسان است. |
REQUIRE_CREDIT_CARD_CONDITIONAL | در صورت برآورده شدن هر یک از شرایط زیر ، Google به کارت اعتباری برای رزرو نیاز دارد: * در دسترس بودن قیمت دارد و پیش پرداخت_تایپ مورد نیاز است * NO_SHOW_FEE تنظیم شده است * قسمت سپرده تنظیم شده است. |
REQUIRE_CREDIT_CARD_ALWAYS | کارت اعتباری همیشه برای رزرو این در دسترس بودن بدون در نظر گرفتن سایر مقادیر میدانی مورد نیاز است. |
منابع
در صورتی که کارمندان مختلف یا اتاق ها بخشی از خدمات باشند ، از منبعی برای تفکیک شکافهای در دسترس بودن از یکدیگر استفاده می شود. چندین شکاف برای همان سرویس و بازه زمانی می توانند در هنگام داشتن منابع مختلف ، همزمان باشند.
فیلدها | |
---|---|
staff_id | شناسه اختیاری برای یک کارمند ارائه دهنده خدمات. این زمینه عضو کارکنان را در همه بازرگانان ، خدمات و سوابق در دسترس بودن مشخص می کند. همچنین باید با گذشت زمان پایدار باشد تا همبستگی با رزرو گذشته فراهم شود. در صورت حضور Staff_Name ، این قسمت باید حضور داشته باشد. |
staff_name | نام اختیاری یک کارمند ارائه دهنده خدمات. این قسمت برای کاربرانی که رزرو می کنند نمایش داده می شود و بر خلاف یک شناسه مات ، باید قابل خواندن باشد. در صورت حضور Staff_ID ، این قسمت باید حضور داشته باشد. |
room_id | یک شناسه اختیاری برای اتاقی که در آن واقع شده است. این قسمت اتاق را در همه بازرگانان ، خدمات و سوابق در دسترس بودن مشخص می کند. همچنین باید با گذشت زمان پایدار باشد تا همبستگی با رزرو گذشته فراهم شود. در صورت وجود اتاق_ نام ، این قسمت باید حضور داشته باشد. |
room_name | یک نام اختیاری برای اتاقی که در آن واقع شده است. این قسمت برای کاربرانی که رزرو می کنند نمایش داده می شود و باید بر خلاف یک شناسه مات ، قابل خواندن باشد. (اختیاری اما لازم است اگر اتاق_د وجود داشته باشد) در ناهار خوری یک اتاق فقط باید برای مناطق نشیمن مانند نوار یا پاسیو استفاده شود و نباید برای منوهای قیمت ثابت ، فعالیتهای ویژه یا هر مقدار غیر اتاق دیگر استفاده شود (مانند رزرو یا شام). به شدت توصیه می شود که فضای صندلی پیش فرض اتاقی در ارتباط با آن نداشته باشد. |
party_size | فقط برای ناهار خوری قابل اجرا است: اندازه مهمانی که در این شکاف می تواند در آن جای بگیرد. یک رستوران می تواند در همان زمان با چندین شکاف همراه باشد ، هر کدام یک مهمانی متفاوت را مشخص می کنند ، اگر به عنوان مثال 2 ، 3 یا 4 نفر با رزرو نشسته باشند. |
برنامه زمانبندی
قوانین برنامه ریزی برای یک سرویس.
فیلدها | |
---|---|
min_advance_online_canceling | حداقل اخطار قبلی در ثانیه های لازم برای لغو قرار ملاقات رزرو شده به صورت آنلاین. (اختیاری) |
late_cancellation_fee | هزینه لغو در حداقل دوره اخطار قبلی. |
noshow_fee | هزینه بدون نمایش بدون لغو. |
admission_policy | خط مشی پذیرش که در مورد این سرویس اعمال می شود. در صورت عدم استفاده ، به طور پیش فرض به TIME_STRICT. (اختیاری) |
cancellation_policy | برنامه ریزی قوانین لغو قوانین. (برای کارها لازم است) |
Union Field اگر "min_advance_booking" تنظیم شود ، آخرین زمان قابل رزرو به صورت (<زمان شروع کار> - "min_advance_booking" محاسبه می شود). اگر "min_booking_buffer_before_end_time" تنظیم شده باشد ، آخرین زمان قابل رزرو به صورت (<زمان پایان شکاف> - "min_booking_buffer_before_end_time" محاسبه می شود). توجه داشته باشید که در صورت تنظیم ، مقدار "min_booking_buffer_before_end_time" باید مثبت باشد. اگر هر دو مورد باز نیستند ، شکاف قابل رزرو است تا زمان شروع شکاف. اگر هر دو قسمت تنظیم شوند ، فقط یک مقدار انتخاب می شود در حالی که مقدار دیگر نادیده گرفته می شود-ما نمی توانیم با اطمینان پیش بینی کنیم که کدام مقدار انتخاب شده است. مثال ها:
| |
min_advance_booking | مدت زمان (در ثانیه) از زمانی که آخرین رزرو با شروع شکاف در دسترس بودن می تواند انجام شود. |
min_booking_buffer_before_end_time | مدت زمان (در ثانیه) از زمانی که آخرین رزرو می تواند با پایان یافتن شکاف در دسترس باشد. اگر این قسمت تنظیم شده باشد ، قسمت "Admission_policy" باید روی Time_Flexible تنظیم شود تا مشخص شود کاربران می توانند پس از شروع اسلات از بلیط های خریداری شده استفاده کنند. |
پذیرش
سیاست پذیرش این سرویس.
Enums | |
---|---|
ADMISSION_POLICY_UNSPECIFIED | بلااستفاده |
TIME_STRICT | مشتریان موظفند در زمان شروع شکاف در دسترس بودن حضور داشته باشند و انتظار می رود این سرویس در پایان زمان شکاف به پایان برسد. نمونه هایی از موارد استفاده از Time_Strict: * تور که از ساعت 9 صبح شروع می شود و به همه شرکت کنندگان نیاز دارد تا در زمان شروع وارد شوند و حدود ساعت 12 شب باز می گردد. * رزرو مدل مو در ساعت 3 بعد از ظهر روز شنبه که تقریباً 30 دقیقه طول خواهد کشید. * کلاس تناسب اندام از 6:00 تا 8 عصر. |
TIME_FLEXIBLE | مشتریان می توانند در هر زمان بین زمان شروع و پایان شکاف در دسترس بودن برای استفاده از این رزرو وارد شوند. نمونه هایی از موارد استفاده قابل استفاده TIME_FLEPLIBLE: * بلیط موزه ای که می تواند در هر زمان در تاریخ خرید استفاده شود. * پذیرش بعد از ظهر در یک پارک تفریحی که از ساعت 12 تا 9 عصر قابل استفاده است. |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION | مشتریان باید در زمان شروع شکاف در دسترس بودن به بازرگان برسند اما می توانند هر زمان که بخواهند ترک کنند. به عنوان مثال ، در سناریوی پذیرش موزه ، بلیط ورود به موقع برای 10 صبح نیاز دارد که کاربر ساعت 10 صبح در موزه باشد. زمان شروع شکافهای در دسترس برای این سرویس ، زمان ورود تعیین شده را نشان می دهد. با این حال ، زمان پایان صرفاً به عنوان یک کلید برای شناسایی شکاف در دسترس بودن برای رزرو استفاده می شود. |
خدمات
اطلاعات مربوط به خدماتی که توسط بازرگان ارائه می شود ، به عنوان مثال مدل مو.
فیلدها | |
---|---|
name | نام منبع خدمات ، که دارای فرمت |
service_name | نام این سرویس ، به عنوان مثال "مدل موهای مردانه". به جای آن ، به جای آن ، از boalized_service_name استفاده کنید. |
localized_service_name | نام این سرویس ، به عنوان مثال "مدل موهای مردانه". احتمالاً در چندین محلی. |
description | توضیحات قابل مشاهده کاربر از سرویس. مستهلک ، به جای آن از localized_description استفاده کنید. |
localized_description | توضیحات قابل مشاهده کاربر از سرویس. این قسمت از قالب بندی ساده متن و HTML پشتیبانی می کند. بر خلاف بخش های متن ساده ، طرح بندی های سفارشی را می توان در اینجا با استفاده از عناوین ، پاراگراف ها ، لیست ها و برخی از برچسب های عبارت ایجاد کرد. لطفاً دستورالعمل ها و یادداشت های زیر را با دقت بخوانید تا اطمینان حاصل کنید که بهترین تجربه کاربر را ایجاد می کنید. پشتیبانی از برچسب های قالب بندی مانند HTML: برچسب های عنوان: <H1> ، <H2> ، <H3> ، <H4> ، <H5> ، <H6> برچسب بند: <p> برچسب های لیست: <ul> ، <ol> ، <li> برچسب تقسیم: <div> برچسب ها: <br> ، <strong> ، <em>: برچسب های پشتیبانی نشده:
نکات مهم:
|
price | The price of the service. |
price_interpretation | 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 | Rules to book/cancel an appointment. |
prepayment_type | Whether a prepayment is required, optional or not supported. |
prepayment_terms | Terms around when the prepayment is completed. |
form[] | منسوخ شده است. Please use intake_form and per_ticket_intake_form. |
intake_form | A form requesting additional information from the user when they book this service. (اختیاری) |
per_ticket_intake_form | 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 | 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[] | 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 | 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 | 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 | Indicates whether the user must provide a credit card in order to book this service. This field can be overridden at the availability level. (اختیاری) |
action_link[] | An action link related to this service. If action link exists, type (see below) must be set in the Service. |
type | The predefined type of this service. (اختیاری) |
ticket_type[] | Types of tickets that can be booked/purchased for this service, if tickets are supported. (اختیاری) |
related_media[] | 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[] | 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 | Rules to joining the waitlist. |
ticketing_vertical_specific_data | Additional information unique to the event ticketing vertical. (اختیاری) |
integration_type | 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 | Order level fees for purchasing this service. (اختیاری) |
tours_and_activities_content | Content fields specific to Tours and Activities. |
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 | User rating for this service as an aggregate metric over all reviews. |
home_service_data | Additional information unique to home service vertical. (اختیاری) |
virtual_session | اختیاری. Information about virtual session. It is required for enabling virtual services. |
direct_merchant_payment | اختیاری. 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. |
PrepaymentTerms
Specific information around when prepayment is completed.
فیلدها | |
---|---|
charge_timing | When the charge will occur relative to the purchase time. |
charge_time_before_start_time_sec | 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 | Unused. |
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. |
ServiceType
Predefined service types.
Enums | |
---|---|
SERVICE_TYPE_UNSPECIFIED | Unused. |
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 | An identifier that uniquely identifies this service attribute among others for the same merchant, eg "account-type". |
attribute_name | A user-visible name for this attribute, eg "Account Type". |
value[] | All possible values for this service attribute. |
ارزش
Represents a possible value for a particular service attribute.
فیلدها | |
---|---|
value_id | An identifier that uniquely identifies this value among others for this service attribute, eg "personal". |
value_name | 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 | ID of an attribute as defined in Merchant.service_attribute, eg "service-type". |
value_id | 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 | The resource name of the service to apply this to. In the format of |
start_time_restrict | 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:
If a duration message is set, the condition is further restricted:
If a resources_restrict message is set, the condition is further restricted:
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 | Setting end_time_restrict while leaving start_time_restrict unset is interpreted to mean all time up to the end_time_restrict. |
duration_restrict | Setting duration further restricts the scope of the update to just the availability with matching duration. |
resources_restrict | 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[] | The new list of availability. |
ServiceIntakeForm
Defines an intake form that customizes the service provided by a merchant.
فیلدها | |
---|---|
field[] | Fields that will be displayed to the user. |
first_time_customers | If true, this form will be shown to first time customers. منسوخ شده است. This functionality is not supported for intake forms. |
returning_customers | 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 | 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 | The type of this field. |
label | The text shown to the user for this field. Deprecated, please use |
localized_label | The text shown to the user for this field. The field can be supplied in multiple locales. (الزامی) |
value[] | 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[] | Set if and only if the field type is MULTIPLE_CHOICE, CHECKBOXES, or DROPDOWN. Used to enumerate possible choices. |
is_required | Indicates whether an answer to this field is required by a user. |
allow_custom_answer | 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[] | 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[] | 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 | 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. (اختیاری) |
FieldType
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. |
LOCATION_SEARCH | A search box that supports finding matched location given user input from provided location list. |
TaxRate
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 | 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 | Optionally, the URL to the Terms and Conditions. |
text | The text to be displayed to the user. Use localized_text below for new integrations. |
localized_text | The localized text to be displayed to the user. |
متن
A possibly-localized text payload. Some Text fields may contain marked-up content.
فیلدها | |
---|---|
value | Text value in an unknown locale. Required if and only if |
localized_value[] | 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 | 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 | 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 | 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 | 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 | Additional fees for purchasing this ticket. (اختیاری) |
option_description | Description of any additional option which this ticket type represents, if any. Deprecated, use localized_option_description instead. |
localized_option_description | 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 |
TicketingVerticalSpecificData
Additional information unique to the event ticketing vertical.
فیلدها | |
---|---|
event_category | The category of the event. Set only when event falls into one of the predefined categories. (اختیاری) |
event_url | The URL of the event on the partner's website. (اختیاری) |
entity[] | A list of entities related to the event. (اختیاری) |
event_attendance_mode | مورد نیاز. The type of the event attendance. |
event_virtual_location_url[] | اختیاری. URL where the event can be watched. |
event_organizer | اختیاری. Organizer who hosts the event. |
event_organizer_url | اختیاری. URL of the organizer who hosts the event. |
event_organizer_type | اختیاری. The type of the organizer. |
event_source_url[] | مورد نیاز. URL of the pages where the event information or descriptions can be found. |
event_state | اختیاری. State 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 | Unique identifier of the entity in the partner's database. (اختیاری) |
name | Name of the entity. (الزامی) |
url | 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 | The type of the entity. (اختیاری) |
entity_role | The role of the entity in the event. (اختیاری) |
public_identification_data | 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
The type of the entity. Note: not intended to be a universal ontology.
Enums | |
---|---|
ENTITY_TYPE_UNSPECIFIED | مشخص نشده است. Do not use. |
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. |
EventCategory
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 | مشخص نشده است. Do not use. |
EVENT_CATEGORY_CONCERT | Concerts. |
EVENT_CATEGORY_SPORTS | Sports events. |
EVENT_CATEGORY_THEATRE | Theatre events. |
EVENT_CATEGORY_EXHIBITS | نمایشگاه ها |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES | Workshops and Classes. |
EventState
State of the event.
Enums | |
---|---|
EVENT_STATE_UNSPECIFIED | مشخص نشده است. |
SCHEDULED | The event is scheduled. |
RESCHEDULED | The event is 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 refernece an entity.
فیلدها | |
---|---|
relevant_url[] | 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 | The 36-character musicbrainz identifier of the artist or other music entities, if applicable. See https://musicbrainz.org/doc/MusicBrainz_Identifier . (اختیاری) |
TimeRange
A closed-open time range, ie [start_time, end_time).
فیلدها | |
---|---|
start_time | The lower bound of the time range. |
end_time | The upper bound of the time range. |
TokenizationConfig
A configuration for payment-processor tokenization, set up on a per-Merchant basis.
فیلدها | |
---|---|
tokenization_parameter | 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 | 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[] | The user-visible list of highlights. |
inclusions[] | The user-visible list of inclusions. |
exclusions[] | The user-visible list of exclusions. |
must_know[] | 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.
فیلدها | |
---|---|
call_merchant | 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. |
UpdateBookingRequest
Request to update a google.maps.booking.v1alpha.Booking
فیلدها | |
---|---|
update_mask | Field mask of all booking fields to be updated |
booking | The booking to be updated |
booking_failure | 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 | The new merchant data. |
update_mask | The specific fields to update for the merchant. |
UpdateOrderRequest
Request to update a google.maps.booking.v1alpha.Order
فیلدها | |
---|---|
update_mask | Field mask of all order fields to be updated |
order | The order to be updated |
UpdateServiceRequest
The request to update a Service
.
فیلدها | |
---|---|
service | The new service data. |
update_mask | The specific fields to update for the service. |
UserPurchaseRestriction
Restricts the users eligible to purchase a payment option.
فیلدها | |
---|---|
new_to_merchant | A payment option that can only be purchased by users who have never purchased from the same merchant before. |
new_to_payment_option | 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 | 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 | Requirements for the given virtual session. به عنوان مثال yoga mat, cooking utensils etc. (Recommended) |
virtual_platform_info | Information about the virtual platform used in this session. (Required to enable virtual services) |
is_session_prerecorded | مورد نیاز. 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 used for virtual session. |
other_platform_name | 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 | Unused. |
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 | مورد نیاز. 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 | مورد نیاز. 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 | 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[] | 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. |