شاخص
-
AdsAccountLinkingService
(رابط) -
BookingNotification
(رابط) -
Feed
(رابط) -
InvalidationService
(رابط) -
InventoryStatus
(رابط) -
InventoryUpdate
(رابط) -
ActionLink
(پیام) -
ActionLink.ActionLinkType
(enum) -
ActionLink.EventMetadata
(پیام) -
ActionLink.EventMetadata.Surface
(enum) -
ActionPlatform
(enum) -
AdsAccountLink
(پیام) -
AdsAccountLink.State
(enum) -
Advisement
(پیام) -
Availability
(پیام) -
Availability.ConfirmationMode
(enum) -
Availability.DurationRequirement
(تعدادی) -
Availability.LinkoutRequiredReason
(عدد) -
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
(پیام) -
CreateAdsAccountLinkRequest
(پیام) -
CreateMerchantRequest
(پیام) -
CreateServiceRequest
(پیام) -
CreditCardRestrictions
(پیام) -
CreditCardRestrictions.CreditCardType
(enum) -
DeleteAdsAccountLinkRequest
(پیام) -
DeleteMerchantRequest
(پیام) -
DeleteServiceRequest
(پیام) -
Deposit
(پیام) -
DirectMerchantPayment
(پیام) -
DurationRange
(پیام) -
EconomicOperator
(پیام) -
ExtendedServiceAvailability
(پیام) -
FeedStatistics
(پیام) -
FeedStatus
(پیام) -
FeedStatus.State
(enum) -
FoodOrderingMetadata
(پیام) -
FoodOrderingMetadata.AdvanceOrderDetails
(پیام) -
FoodOrderingMetadata.FeeDetails
(پیام) -
FoodOrderingMetadata.FeeDetails.FeeAmount
(پیام) -
FoodOrderingMetadata.FeeDetails.FeeType
(enum) -
FulfillmentOption
(پیام) -
FulfillmentOption.AvailableDay
(پیام) -
FulfillmentOption.FeeDetails
(پیام) -
FulfillmentOption.FixedFee
(پیام) -
FulfillmentOption.FulfillmentType
(enum) -
FulfillmentOption.MinimumFee
(پیام) -
FulfillmentOption.NoFee
(پیام) -
GenericDeleteRecord
(پیام) -
GenericRecord
(پیام) -
GeoCoordinates
(پیام) -
GetAdsAccountLinkRequest
(پیام) -
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
(پیام) -
Prepayment
(پیام) -
PrepaymentStatus
(تعدادی) -
Price
(پیام) -
PriceInfo
(پیام) -
PriceInterpretation
(تعبیر) -
PriceRange
(پیام) -
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
(پیام) -
TicketType.InventoryType
(enum) -
TicketType.PriceDisplayType
(تعدادی) -
TicketingVerticalSpecificData
(پیام) -
TicketingVerticalSpecificData.AttendanceMode
(enum) -
TicketingVerticalSpecificData.Entity
(پیام) -
TicketingVerticalSpecificData.Entity.EntityRole
(enum) -
TicketingVerticalSpecificData.Entity.EntityType
(enum) -
TicketingVerticalSpecificData.EventCategory
(enum) -
TicketingVerticalSpecificData.EventCreator
(پیام) -
TicketingVerticalSpecificData.EventState
(enum) -
TicketingVerticalSpecificData.OrganizerType
(enum) -
TicketingVerticalSpecificData.PublicIdentificationData
(پیام) -
TimeRange
(پیام) -
TokenizationConfig
(پیام) -
TokenizationConfig.BillingInformationFormat
(enum) -
ToursAndActivitiesContent
(پیام) -
UnsupportedPartySizeOption
(پیام) -
UpdateAdsAccountLinkRequest
(پیام) -
UpdateBookingRequest
(پیام) -
UpdateMerchantRequest
(پیام) -
UpdateOrderRequest
(پیام) -
UpdateServiceRequest
(پیام) -
UriTemplate
(پیام) -
UserPurchaseRestriction
(پیام) -
VirtualSession
(پیام) -
VirtualSession.VirtualPlatformInfo
(پیام) -
VirtualSession.VirtualPlatformInfo.Platform
(enum) -
WaitlistRules
(پیام)
AdsAccountLinkingService
سرویس مدیریت پیوند حساب بین Google Ads و Partner Center.
CreateAdsAccountLink |
---|
پیوند حساب Ads ایجاد می کند. با این کار پیوند بین حساب Google Ads و Partner Center ایجاد می شود. پیوند تا زمانی که از پورتال تبلیغات تایید نشود، در وضعیت
|
DeleteAdsAccountLink |
---|
پیوند حساب Ads را حذف می کند. با این کار ارتباط حساب Google Ads و حساب Partner Center لغو می شود.
|
GetAdsAccountLink |
---|
پیوند حساب Ads را دریافت می کند.
|
UpdateAdsAccountLink |
---|
پیوند حساب Ads را با موارد موجودی بهروزرسانی میکند. با این کار پیوند حساب Ads با موارد موجودی ارائه شده به روز می شود.
|
اطلاعیه رزرو
اعلان های قرار ملاقات ها را از شرکای برنامه ریزی خارجی دریافت می کند. شریک بسته به اینکه شریک 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 | پیوندهای فوق داده برای سفارش غذا. از نوع عملکرد پشتیبانی میکند: * |
event_ 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 | نوع پیوند اقدام سفارش برای خرید است، می تواند تحویل یا تحویل یا هر دو باشد. |
رویداد Metadata
اطلاعات اضافی درباره پیوند اقدام که منحصر به رویدادهای عمودی است.
فیلدها | |
---|---|
surface | سطح رویداد از پیش تعیین شده مرتبط با پیوند اقدام. این فقط برای رویدادهای عمودی استفاده می شود. |
سطح
سطح رویداد از پیش تعیین شده مرتبط با پیوند اقدام. این فقط برای رویدادهای عمودی استفاده می شود.
Enums | |
---|---|
SURFACE_UNSPECIFIED | سطح نامشخص است. |
SURFACE_SEARCH | پیوند اقدام، رزرو بلیط رویداد در جستجو است. |
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 است. |
AdsAccount Link
AdsAccountLink پیوندی بین حساب Ads و حساب Partner Center به همراه اقلام موجودی است.
فیلدها | |
---|---|
name | شناسه. نام منبع AdsAccountLink. قالب: |
item_ ids[] | مورد نیاز. فهرست شناسههای اقلام موجودی که باید با حساب Google Ads مرتبط شوند. |
state | فقط خروجی پیوند حساب وضعیت Ads. |
ایالت
پیوند حساب وضعیت Ads.
Enums | |
---|---|
STATE_UNSPECIFIED | حالت نامعلوم |
LINKED | حساب بین مرکز شریک و پورتال تبلیغات مرتبط است. |
PENDING | حساب منتظر تأیید در مرکز شریک یا پورتال تبلیغات است. |
DELETED | لینک اکانت حذف شد |
REJECTED | درخواست پیوند حساب توسط مرکز شریک یا پورتال تبلیغات رد می شود. |
نصیحت
توصیه هایی که هنگام رزرو از طریق 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 | اختیاری بدون هزینه نمایش برای این در دسترس بودن. در صورتی که مشخص شده بود، سرویس بدون هزینه نمایش را لغو می کند. |
prepayment | اختیاری. اطلاعات پیش پرداخت اختیاری برای این در دسترس بودن. |
require_ credit_ card | نشان می دهد که آیا کاربر باید کارت اعتباری برای رزرو این اسلات در دسترس ارائه دهد یا خیر. اگر مقدار تنظیم نشده باشد، اگر در آنجا تنظیم شده باشد، از سطح سرویس به ارث می رسد. (اختیاری) |
ticket_ type_ id[] | فهرستی از انواع بلیط های پشتیبانی شده برای این شکاف در دسترس را نشان می دهد. اگر تنظیم نشود، همه انواع بلیط در سرویس والدین برای این اسلات در دسترس هستند. توجه داشته باشید که مقادیر این فیلد باید در سرویس والد تعریف شود. مثال ها:
برای نشان دادن موجودی در روزهای هفته:
برای نشان دادن اینکه هر سه نوع بلیت برای این بازه زمانی در دسترس هستند، از (اختیاری) |
duration_ requirement | الزام برای نشان دادن مدت زمان و/یا زمان پایان اسلات. اگر شکاف در دسترس نباشد، این فیلد نادیده گرفته می شود. در قسمت عمودی Things-To-Do استفاده نمی شود. (اختیاری) |
scheduling_ rule_ overrides | قوانین زمانبندی در دسترس بودن اگر فیلدها پر شوند، قوانین زمانبندی مربوطه را در SchedulingRules سطح سرویس لغو می کنند. |
confirmation_ mode | حالت تأییدی که هنگام رزرو این در دسترس بودن استفاده خواهد شد. تلاش برای ایجاد رزرو برای در دسترس بودن با حالت تأیید CONFIRMATION_MODE_SYNCHRONOUS باید فوراً تأیید یا رد شود. تلاش برای ایجاد رزرو برای در دسترس بودن با حالت تأیید CONFIRMATION_MODE_ASYNCHRONOUS باید فوراً رد شود یا با وضعیت در انتظار ایجاد شود. |
linkout_ required_ reason | اختیاری. دلیل نیاز به پیوند برای این اسلات. اگر تنظیم شود، منبع 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 برای نمایش بازههای زمانی رزرو شده/غیرقابل دسترس در روز کاری استفاده میشود.
الزامات:
- گسترش اسلاتهای دسترسی یا تکرارها نباید شکافهای یکسانی ایجاد کند. اگر شناسه ها، 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 | آدرس ایمیل مشتری |
CreateAdsAccountLinkRequest
درخواست پیام برای AdsAccountLinkingService.CreateAdsAccountLink.
فیلدها | |
---|---|
parent | مورد نیاز. منبع اصلی که در آن پیوند این حساب Ads ایجاد خواهد شد. این همان شناسه حساب Partner Center است. قالب: شرکا/{شریک} |
ads_ account_ link_ id | مورد نیاز. شناسه مورد استفاده برای پیوند حساب تبلیغات. این همان شناسه مشتری تبلیغات گوگل است. برای جزئیات، https://support.google.com/google-ads/answer/1704344 قالب: xxx-xxx-xxxx را ببینید. |
ads_ account_ link | مورد نیاز. AdsAccountLink برای ایجاد. |
ایجاد 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 |
DeleteAdsAccountLinkRequest
درخواست پیام برای AdsAccountLinkingService.DeleteAdsAccountLink.
فیلدها | |
---|---|
name | مورد نیاز. نام AdsAccountLink برای حذف. قالب: شرکا/{partner}/adsAccountLinks/{ads_account_link} |
حذف 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 | حداکثر مدت. |
اپراتور اقتصادی
اطلاعات اپراتور اقتصادی برای تجمیع کننده.
فیلدها | |
---|---|
text | مورد نیاز. نام، آدرس، شماره تلفن و آدرس ایمیل فعال اقتصادی که تولیدکننده، نماینده مجاز، واردکننده، توزیع کننده، ارائه دهنده خدمات انجام و یا هر شخص حقیقی یا حقوقی دیگری مشمول تعهدات مربوط به ساخت محصولات است و در دسترس قرار می دهد. یا قرار دادن آنها در خدمت. نمایش رشته آزاد از operator_ Economic. این اطلاعات ممکن است با استفاده از " " و "\n" قالب بندی شوند. |
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 | هنگام پردازش فید با خطایی مواجه شدیم. |
Food OrderingMetadata
متادیتا برای پیوندهای اقدام سفارش غذا.
فیلدها | |
---|---|
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 | مورد نیاز. مبلغ کارمزد پایه برای روش انجام. |
NoFee
این نوع هیچ فیلدی ندارد.
هیچ هزینه ای برای روش انجام مرتبط با پیوند اقدام لازم نیست.
GenericDeleteRecord
رکوردی که باید از نوع فید ذکر شده در درخواست url حذف شود.
فیلدها | |
---|---|
delete_ time | مورد نیاز. این مهر زمانی برای تعیین ترتیب اعمال حذف در موجودی استفاده می شود. |
record_type فیلد اتحادیه. کپسوله کردن انواع مختلف فید (ndjson، مبتنی بر پروتو، و غیره) شریک می تواند یک رکورد کامل مشابه نحوه ارائه یک رکورد در یک فید یا BatchPush API ارائه دهد. شرکا همچنین این گزینه را دارند که فقط فیلدهای ضروری یک رکورد را که برای شناسایی منحصربفرد آن لازم است، لحاظ کنند. record_type تنها می تواند یکی از موارد زیر باشد: | |
data_ record | برای فیدهای غیر مبتنی بر پروتو. |
proto_ record | برای فیدهای مبتنی بر پروتو |
GenericRecord
سابقه نوع فید ذکر شده در درخواست url.
فیلدها | |
---|---|
generation_ timestamp | مورد نیاز. این مهر زمانی برای اطمینان از ترتیب صحیح به روز رسانی موجودی استفاده می شود. |
record_type فیلد اتحادیه. کپسوله کردن انواع مختلف فید (ndjson، مبتنی بر پروتو، و غیره) record_type تنها می تواند یکی از موارد زیر باشد: | |
data_ record | برای فیدهای غیر مبتنی بر پروتو. |
proto_ record | برای فیدهای مبتنی بر پروتو |
مختصات جغرافیایی
داده های جغرافیایی یک مکان، از جمله عرض جغرافیایی، طول جغرافیایی و آدرس.
فیلدها | |
---|---|
latitude | عرض جغرافیایی بر حسب درجه (اختیاری) |
longitude | طول جغرافیایی بر حسب درجه (اختیاری) |
addresses فیلد اتحادیه آدرس برای یک مکان، می تواند ساختارمند یا بدون ساختار باشد. addresses فقط می توانند یکی از موارد زیر باشند: | |
address | آدرس پستی محل، ترجیح داده می شود. |
unstructured_ address | یک آدرس بدون ساختار نیز می تواند به عنوان یک بازگشت ارائه شود. به عنوان مثال "1600 amphitheatre parkway view mountain, ca 94043" |
GetAdsAccountLinkRequest
درخواست پیام برای AdsAccountLinkingService.GetAdsAccountLink.
فیلدها | |
---|---|
name | مورد نیاز. نام پیوند حساب Ads برای بازیابی. قالب: |
GetMerchantStatusRequest
درخواست برای دریافت MerchantStatus
فیلدها | |
---|---|
name | مورد نیاز. نام منبع، در قالب شرکا/{partner_id}/merchants/{merchant_id}/status. |
GetStatusRequest
درخواست برای بازیابی Status
برای فید خاصی که توسط پلتفرم جمعآوری بارگذاری شده است.
فیلدها | |
---|---|
name | نام منبع فید که دارای قالب است
|
HomeServiceData
اطلاعات اضافی مورد نیاز برای ارائه خدمات خانگی عمودی.
فیلدها | |
---|---|
category_ type | دسته سطح بالایی که این سرویس خانه به آن تعلق دارد. به عنوان مثال لوله کش، برق و غیره |
job_ type | نوع شغل تحت دسته ای که سرویس خانه داده شده به آن تعلق دارد. به عنوان مثال unclog_drain، install_faucet انواع مشاغل در دسته لوله کش هستند. |
IntegrationType
عمق ادغام پشتیبانی می شود.
Enums | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED | پیشفرض END_TO_END است. |
INTEGRATION_TYPE_END_TO_END | یکپارچهسازی کامل که امکان رزرو نهایی از طریق Google را فراهم میکند. |
INTEGRATION_TYPE_INVENTORY_ONLY | سرور رزرو نیازی به پشتیبانی از این سرویس ندارد. فقط بازرگانان، خدمات، و دادههای در دسترس بودن (اختیاری) باید ارسال شوند. |
InvalidateResourceRequest
درخواست باطل کردن یک منبع
فیلدها | |
---|---|
resource_ id | نام منبعی که باید باطل شود. به عنوان مثال، برای یک منبع Pickup، نام باید قالب |
آیتم خط
یک مورد در یک سفارش - رزرو یک سرویس در یک بازه زمانی واحد.
فیلدها | |
---|---|
service_ id | شناسه خدمات بازرگان. |
start_ sec | زمان شروع شکاف قرار بر حسب ثانیه از زمان UTC از زمان یونیکس. |
duration_ sec | مدت زمان قرار ملاقات بر حسب ثانیه. |
tickets[] | تعداد بلیط های سفارش داده شده بر اساس نوع بلیط. |
price | قیمت کل (بدون احتساب مالیات) این خط. |
status | وضعیت مورد خط. |
بلیط های سفارش داده شده
تعداد بلیط های سفارش داده شده بر اساس نوع بلیط.
فیلدها | |
---|---|
ticket_ id | شناسه یک نوع بلیط |
count | تعداد بلیط های سفارش داده شده برای این نوع |
ListMerchantStatusesRequest
درخواست برای دریافت لیست MerchantStatus
فیلدها | |
---|---|
parent | مورد نیاز. پدر یا مادری که مالک این مجموعه وضعیت تاجر است. قالب: |
page_ size | مورد نیاز. حداکثر تعداد اقلام برای بازگشت. توجه داشته باشید که سرور ممکن است اندازه صفحه را کاهش دهد. |
page_ token | اختیاری. مقدار nextPageToken از یک ListMerchantStatusResponse قبلی، در صورت وجود، برگردانده شده است. |
booking_ inventory_ status_ restrict | اختیاری. محدودیت اختیاری برای فیلتر کردن نتایج با رزرو وضعیت موجودی. |
waitlist_ inventory_ status_ restrict | اختیاری. محدودیت اختیاری برای فیلتر کردن نتایج بر اساس وضعیت موجودی فهرست انتظار. |
geo_ match_ restrict | اختیاری. محدودیت اختیاری برای فیلتر کردن نتایج بر اساس وضعیت تطبیق جغرافیایی. |
BookingInventoryStatus
وضعیت موجودی رزرو سرتاسر.
Enums | |
---|---|
BOOKING_INVENTORY_STATUS_UNSPECIFIED | مشخص نشده است. |
NO_VALID_FUTURE_INVENTORY | تاجر موجودی رزروی در 30 روز آینده ندارد. |
HAS_VALID_FUTURE_INVENTORY | تاجر موجودی رزرو را در 30 روز آینده دارد. |
GeoMatchingStatus
وضعیت تطبیق جغرافیایی تاجر.
Enums | |
---|---|
GEO_MATCHING_STATUS_UNSPECIFIED | مشخص نشده است. |
GEO_UNMATCHED | تاجر مطابق جغرافیایی نیست. |
GEO_MATCHED | تاجر دارای تطبیق جغرافیایی است. |
WaitlistInventoryStatus
وضعیت موجودی فهرست انتظار پایان به انتها.
Enums | |
---|---|
WAITLIST_INVENTORY_STATUS_UNSPECIFIED | مشخص نشده است. |
NO_VALID_WAITLIST_SERVICE | تاجر لیست انتظار پشتیبانی از خدمات را ندارد. |
HAS_VALID_WAITLIST_SERVICE | تاجر لیست انتظار پشتیبانی از خدمات را دارد. |
ListMerchantStatusesResponse
پاسخ به لیست MerchantStatus
.
فیلدها | |
---|---|
merchant_ statuses[] | فهرست وضعیتهای تجاری که شرایط فیلتر را برآورده میکنند. |
next_ page_ token | رمز برای بازیابی صفحه بعدی نتایج. اگر خالی باشد نتیجه دیگری در لیست وجود ندارد. |
ListStatusRequest
درخواست برای بازیابی Status
برای فیدهای متعدد آپلود شده توسط پلتفرم تجمع کننده.
فیلدها | |
---|---|
name | نام منبع فید که دارای قالب است
|
page_ size | حداکثر تعداد اقلام برای بازگشت. |
page_ token | مقدار next_page_token که از یک درخواست لیست قبلی برگردانده شده است، در صورت وجود. |
state_ restrict | محدودیت اختیاری برای فیلتر کردن نتایج بر اساس وضعیت فید. |
time_ range_ restrict | محدودیت اختیاری برای فیلتر کردن نتایج با کران بالا و پایین. اگر start_time تنظیم نشده باشد، به طور پیشفرض روی شروع زمان یونیکس خواهد بود. اگر end_time تنظیم نشده باشد، پیشفرض اکنون خواهد بود. |
ListStatusResponse
درخواست برای بازیابی Status
برای فیدهای متعدد آپلود شده توسط پلتفرم تجمع کننده.
فیلدها | |
---|---|
status[] | معکوس کردن فهرست زمانی وضعیتها برای فیدهای آپلود شده. حداکثر تعداد موارد برگردانده شده بر اساس قسمت page_size در درخواست است. |
next_ page_ token | رمز برای بازیابی صفحه بعدی نتایج. اگر خالی باشد نتیجه دیگری در لیست وجود ندارد. |
LocalizedString
نمونه ای از یک رشته در یک منطقه.
فیلدها | |
---|---|
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 | نام مکان، تلفن، آدرس اینترنتی و جغرافیایی برای پشتیبانی از تطبیق مکان با مکانهایی که قبلاً در Google Maps وجود دارد استفاده میشود. این فیلد اختیاری است، اما ممکن است در برخی زمینه ها مورد نیاز باشد. به عنوان مثال، یک Service.location بدون نام با یک نهاد تجاری تطبیق داده نخواهد شد، حتی اگر آنها در همان آدرس واقع شده باشند. (اختیاری) |
telephone | شماره تلفن عمومی محل شامل کدهای کشور و منطقه آن، به عنوان مثال +14567891234. (اختیاری) |
url | آدرس وب سایت عمومی مکان. (اختیاری) |
geo | اطلاعات جغرافیایی مکان، از جمله عرض جغرافیایی، طول جغرافیایی، و آدرس. (اختیاری) |
location_ type | اگر این مکان برای یک سرویس ارائه شده باشد، باید نوع مکان ارائه شود. |
location_ id | مرجع منحصر به فرد مکان در سرویس. از این شناسه می توان برای اشاره به این مکان در سایر فیلدهای خدمات استفاده کرد. به عنوان مثال در فرم دریافت سفارشی، مجموعهای از شناسههای مکان را میتوان برای تعیین گزینههای دریافت مکان استفاده کرد. اگر تنظیم شود، این شناسه باید در همان سرویس یکتا باشد. (اختیاری) |
نوع مکان
نوع این مکان.
Enums | |
---|---|
LOCATION_TYPE_UNSPECIFIED | نوع مکان مشخص نشده است. |
VISITED_LOCATION | مکانی که این سرویس از آن بازدید می کند. |
START_LOCATION | مکانی که این سرویس از آنجا شروع می شود، به عنوان MEETING_LOCATION نیز عمل می کند. |
END_LOCATION | مکانی که این سرویس پایان می یابد. |
بازرگان
اطلاعاتی درباره تاجری که در پلتفرم جمعآوری کننده است.
فیلدها | |
---|---|
name | نام منبع تاجر، که دارای قالب |
merchant_ name | merchant_name، telephone، url و geo برای پشتیبانی از موجودی شریک منطبق با تاجرانی که قبلاً در Google Maps حضور دارند استفاده میشود. این اطلاعات نمایش داده نخواهد شد. نام تاجر. |
telephone | شماره تلفن عمومی تاجر شامل کدهای کشور و منطقه آن، به عنوان مثال +14567891234. |
url | آدرس وب سایت عمومی تاجر. |
geo | اطلاعات جغرافیایی تاجر، از جمله عرض جغرافیایی، طول جغرافیایی، و آدرس. |
category | دسته بندی کسب و کار در پلت فرم جمع آوری کننده. |
num_bookings_30d | این فیلد منسوخ شده است. |
tax_rate_basis_points | نرخ مالیات تاجر بر حسب واحد پایه (یک صدم درصد). مثلاً اگر نرخ مالیات 7.5 درصد باشد، این فیلد باید 750 باشد. اگر این قسمت تنظیم نشده باقی بماند یا روی 0 تنظیم شود، کل قیمتی که برای هر سرویس ارائه شده توسط این تاجر از کاربر دریافت میشود، دقیقاً قیمتی است که توسط Service.price مشخص شده است. فرض می شود که قیمت خدمات از مالیات های قابل اعمال معاف است یا از قبل شامل آن می شود. مالیات ها به عنوان یک خط جداگانه به کاربر نشان داده نمی شود. اگر این قسمت روی مقدار غیر صفر تنظیم شود، کل قیمتی که برای هر سرویس ارائه شده توسط این تاجر از کاربر دریافت میشود، شامل قیمت خدمات به اضافه مالیات محاسبهشده با استفاده از نرخ مالیات ارائهشده در اینجا میشود. کسری از کوچکترین واحد پول (به عنوان مثال، کسری از یک سنت) با استفاده از نزدیکترین گرد کردن زوج گرد می شود. مالیات ها به عنوان یک خط جداگانه به کاربر نشان داده می شود. این فیلد منسوخ شده است، لطفاً به جای آن از tax_rate استفاده کنید. |
tax_ rate | نرخ مالیات تاجر. اگر این فیلد وجود داشته باشد، قسمت منسوخ tax_rate_basis_points را لغو می کند. یک پیام خالی (یعنی tax_rate { }) نرخ مالیات اعمال شده را به صفر بازنشانی می کند. |
payment_ restrictions | محدودیتهایی برای روشهای پرداختی که این تاجر میپذیرد. اگر این فیلد تنظیم نشده باشد، فرض می کنیم که هیچ محدودیتی وجود ندارد. |
payment_ option[] | گزینه های پرداخت برای این تاجر موجود است. خدمات تحت این تاجر می توانند به صورت جداگانه گزینه های پرداختی را که اجازه می دهند محدود کنند. |
payment_processor_config | پیکربندی برای پردازشگر پرداخت توکن شده، در صورتی که تاجر از آن پشتیبانی کند. |
tokenization_ config | پیکربندی برای پردازشگر پرداخت توکن شده، در صورتی که تاجر از آن پشتیبانی کند. |
terms | شرایط و ضوابط تاجر خاص که هنگام رزرو سرویس از طریق رزرو با Google به کاربر نمایش داده می شود. علاوه بر این موارد، شرایط و ضوابط شریک جمع آوری همیشه به کاربر نمایش داده می شود و نباید در اینجا ارائه شود. |
brand_ id | رشتهای غیر شفاف که نشاندهنده برند مصرفکننده برای استفاده در هنگام نمایش اسناد شریک است. این فیلد به شرکای دارای چندین مارک مصرفکننده اجازه میدهد تا تجار را برای همه مارکها در یک خوراک ارائه کنند. یک نام تجاری شامل ویژگیهایی مانند نام، لوگو، شرایط خدمات و خطمشی رازداری است که با مصرفکننده مواجه است. اگر فقط یک برند شریک مصرف کننده وجود داشته باشد، این زمینه نیازی به تنظیم ندارد و می توان آن را نادیده گرفت. اگر شریک ... آیا برندهای متعددی برای مصرف کننده ندارید؟ --> این فیلد را نادیده بگیرید آیا چندین برند پیکربندی شده است؟
توجه دقیق: اکثر شرکا نیازی به تنظیم این فیلد ندارند. اگر شریکی بخواهد از این فیلد استفاده کند، باید ابتدا با ما تماس بگیرد تا مارکهای جداگانه، از جمله نام تجاری پیشفرض را پیکربندی کنیم. |
matching_ hints | نکاتی برای کمک به Google برای مطابقت دادن یک تاجر با مکانی در Google Maps. توجه: اکثر شرکا نیازی به تنظیم این فیلد ندارند، زیرا Google با استفاده از اطلاعات ارائه شده در بالا، بازرگانان را با مکانهای Google Maps مطابقت میدهد. (اختیاری) |
service_ attribute[] | تعاریف هر ویژگی خدماتی که برای توصیف خدمات این تاجر استفاده می شود. (اختیاری) |
action_ link[] | اختیاری. یک URL اقدام با زبان مرتبط، فهرست کشورهای محدود شده، نوع و پلت فرم اختیاری که نشان میدهد این اقدام در کدام پلتفرم باید انجام شود، |
waitlist_ advisement | اختیاری. توصیههای کلی از یک تاجر خاص برای کاربری که از طریق رزرو با Google به فهرست انتظار ملحق میشود. طول فیلدهای متنی در توصیه باید به 100 بایت محدود شود. |
economic_ operator | اختیاری. اطلاعات اپراتور اقتصادی مرتبط با این تاجر خاص برای انطباق با مقررات مورد نیاز است. (اختیاری) |
MerchantMatchingHints
نکات مورد استفاده برای کمک به Google برای مطابقت دادن یک تاجر با مکانی در Google Maps.
فیلدها | |
---|---|
place_ id | شناسه مکان برای مکانی در پایگاه داده Google Places و در Google Maps. برای اطلاعات بیشتر درباره شناسههای مکان، به https://developers.google.com/places/web-service/place-id مراجعه کنید. |
وضعیت فروشنده
وضعیت یک تاجر در پلتفرم Reserve with Google.
فیلدها | |
---|---|
name | نام منبع وضعیت تاجر، که دارای قالب |
merchant_ name | نام تاجر ارائه شده توسط شرکا. |
input_ geo_ info | شرکا اطلاعات جغرافیایی تاجر را ارائه کردند. |
processing_ status | وضعیت پردازش تاجر |
booking_ status | وضعیت مربوط به ادغام رزرو سرتاسر. |
waitlist_ status | وضعیت مربوط به ادغام لیست انتظار. |
geo_ match | مکان جغرافیایی این تاجر مطابقت دارد. در صورتی که تاجر با Geo مطابقت نداشته باشد، خالی است. |
local_ services_ match | خدمات محلی مطابقت این تاجر. اگر تاجر خدمات محلی نیست یا با هیچ ارائهدهندهای مطابقت ندارد، خالی است. |
direct_ urls[] | فهرستی از URL ها برای نشان دادن محتوای موجودی تجاری فعلی. توجه داشته باشید که این بدان معنا نیست که موجودی واقعاً در حال ارائه است و ممکن است URL با موارد قابل مشاهده عمومی متفاوت باشد. |
وضعیت رزرو
وضعیت مربوط به ادغام رزرو سرتاسر.
فیلدها | |
---|---|
has_ valid_ future_ inventory | اگر تاجر در 30 روز آینده موجودی داشته باشد درست است. تضمین نمی کند که تاجر واقعاً به آن خدمات داده شود. |
DirectUrl
URL که روی تاجر ظاهر می شود.
فیلدها | |
---|---|
type | این URL را تایپ کنید. |
url | نشانی اینترنتی که ممکن است در این تاجر ظاهر شود. |
UrlType
نوع URL ظاهری.
Enums | |
---|---|
URL_TYPE_UNSPECIFIED | مشخص نشده است. |
BOOKING | URL رزرو سرتاسر. |
WAITLIST | URL فهرست انتظار سرتاسر. |
LOCAL_SERVICES | URL خدمات محلی Google. |
LocalServicesMatchInfo
اطلاعات مربوط به خدمات محلی Google مطابقت دارد (فقط برای تاجر خدمات محلی تنظیم شده است).
فیلدها | |
---|---|
matched_ providers[] | ارائه دهندگان خدمات همسان یک تاجر را می توان با چندین ارائه دهنده خدمات مطابقت داد. |
MatchedProvider
ارائه دهنده خدمات محلی
فیلدها | |
---|---|
customer_ id | شناسه مشتری خارجی خدمات محلی Google. |
categories[] | دسته بندی خدمات محلی (عمودی). به عنوان مثال "لوله کش" و "فرش_نظافتی". |
PlaceInfo
اطلاعات یک مکان همسان
فیلدها | |
---|---|
name | نام مکان. |
formatted_ address | آدرس فرمت شده به زبان محلی |
place_ id | شناسه Google Place این مکان. می توان از آن برای ساخت URL نقشه های گوگل یا واکشی جزئیات بیشتر مکان استفاده کرد. برای مثال به https://developers.google.com/places/web-service/place-id مراجعه کنید. |
وضعیت پردازش
وضعیت پردازش تاجر
Enums | |
---|---|
PROCESSING_STATUS_UNSPECIFIED | وضعیت نامشخص |
IN_PROGRESS | تاجر توسط مدن دریافت شده است، اما هنوز در حال پردازش است. بازرگانانی که در این وضعیت هستند، وضعیت دیگری را نخواهند داشت. |
COMPLETED | سایر وضعیت های تاجر محاسبه شده است. |
وضعیت لیست انتظار
وضعیت مربوط به ادغام لیست انتظار.
فیلدها | |
---|---|
has_ valid_ waitlist_ service | اگر تاجر خدمات لیست انتظار داشته باشد درست است. تضمین نمی کند که تاجر واقعاً به آن خدمات داده شود. |
Money Range
لفاف برای محدوده ای از مقدار پولی که می تواند محدود یا نامحدود باشد. حداقل یکی از min_amount و max_amount مورد نیاز است.
فیلدها | |
---|---|
min_ amount | حداقل مقدار. |
max_ amount | حداکثر مقدار. |
NoShowFee
هزینه ای که کاربر در صورتی که رزرو کرده باشد اما حاضر نشود، ممکن است دریافت شود.
فیلدها | |
---|---|
fee | در صورت عدم حضور کاربر برای رزرو، مبلغی ممکن است از کاربر دریافت شود. |
fee_ type | نحوه تعیین هزینه از روی در دسترس بودن را مشخص می کند. |
سفارش دهید
سفارش قرار ملاقات با یک تاجر.
فیلدها | |
---|---|
name | نام منبع سفارش: |
client_ information | اطلاعات شخصی مشتری سفارش دهنده |
payment_ information | اطلاعات مربوط به تراکنش های پرداخت مربوط به سفارش. |
merchant_ id | شناسه بازرگانی که تمام خدمات این سفارش متعلق به آن است. |
item[] | موارد خط به این ترتیب. |
OrderOnline Metadata
ابرداده برای پیوند اقدام آنلاین سفارش.
فیلدها | |
---|---|
fulfillment_ option[] | گزینه های انجام موجود برای پیوند اقدام آنلاین سفارش. |
اطلاعات پرداخت
جزئیات پرداخت مربوط به رزرو
فیلدها | |
---|---|
prepayment_ status | وضعیت پیش پرداخت رزرو. اگر وضعیت prepayment PREPAYMENT_PROVIDED یا PREPAYMENT_REFUNDED باشد، pay_transaction_id حاوی شناسه تراکنش منحصر به فرد مرتبط است. |
payment_ transaction_ id | شناسه منحصر به فرد برای تراکنش پرداخت مرتبط با رزرو. خالی اگر قابل اجرا نیست. |
گزینه پرداخت
یک گزینه پرداخت، که می تواند برای پرداخت هزینه خدمات ارائه شده توسط یک تاجر استفاده شود. گزینه های پرداخت را می توان در بین چندین تاجر به اشتراک گذاشت (مثلاً تاجرانی که متعلق به یک زنجیره هستند).
فیلدها | |
---|---|
payment_ option_ id | این شناسه برای شناسایی این گزینه پرداخت استفاده می شود. این شناسه برای کل تجمیع کننده جهانی است و استفاده مجدد از یک مقدار در چندین تاجر به کاربر امکان می دهد با گزینه پرداخت مربوطه در آن تاجران پرداخت کند. هنگام استفاده مجدد از یک شناسه برای چندین تاجر، بهروزرسانی هر مقدار برای گزینه پرداخت تحت یک تاجر، هر گزینه پرداخت دیگری را با همان شناسه، تحت یک تاجر دیگر نیز بهروزرسانی میکند. به این ترتیب، بهترین روش این است که همه گزینههای پرداخت دارای شناسه مشترک باشند، همیشه به مقادیر یکسان بهروزرسانی شوند تا از هرگونه احتمال رفتار ضعیفتر جلوگیری شود. |
name | نام گزینه پرداخت. این می تواند کاربر قابل مشاهده باشد. |
description | توضیح گزینه پرداخت این می تواند کاربر قابل مشاهده باشد. |
price | قیمت گزینه پرداخت. |
tax_ rate | نرخ مالیات برای این گزینه پرداخت. اگر این فیلد وجود داشته باشد، فیلد tax_rate موجود در Merchant یا Service را لغو میکند. یک پیام خالی (یعنی tax_rate { }) نرخ مالیات اعمال شده را به صفر بازنشانی می کند. |
payment_ option_ type | نوع این گزینه پرداخت. یکبار مصرف برای بارگیری، چند منظوره برای بسته ها و نامحدود برای عضویت. |
session_ count | این گزینه پرداخت برای چند جلسه قابل استفاده است. فقط برای چند جلسه / بسته معتبر است، جایی که مقدار باید > 1 باشد. |
purchase_ interval | گزینه پرداخت را می توان در این فاصله خریداری کرد. |
valid_ interval | گزینه پرداخت را می توان در این بازه زمانی استفاده کرد (به عنوان مثال قیمت ویژه ژانویه 2017). در صورت وجود، این گزینه valid_duration و activation_type را لغو می کند. |
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 | گزینه پرداخت را می توان در محدوده زمانی معتبر آن استفاده کرد - تعداد جلسات غیرقابل اجرا است. |
PaymentProcessorConfig
پیکربندی برای پردازشگر پرداخت، تنظیم بر اساس هر فروشنده.
فیلدها | |
---|---|
processor | شریک پردازشگر پرداخت را که این پیکربندی برای آن اعمال می شود، تعریف می کند. |
public_ key | کلید مورد استفاده برای شناسایی این تاجر با پردازشگر پرداخت. برای Stripe، به: https://stripe.com/docs/dashboard#api-keys برای Braintree، مراجعه کنید: https://articles.braintreepayments.com/control-panel/important-gateway-credentials |
version | شماره نسخه API به همراه درخواستهای پرداخت به پردازشگر پرداخت ارسال میشود. |
پردازنده
یک شریک پردازشگر پرداخت خاص را تعریف می کند.
Enums | |
---|---|
PROCESSOR_UNSPECIFIED | استفاده نشده |
PROCESSOR_STRIPE | پیکربندی برای پرداخت با Stripe. |
PROCESSOR_BRAINTREE | پیکربندی برای پرداخت با Braintree. |
محدودیت های پرداخت
محدودیتهایی برای روشهای پرداختی که این تاجر میپذیرد.
فیلدها | |
---|---|
credit_ card_ restrictions | محدودیتهایی برای کارتهای اعتباری که این تاجر میپذیرد. اگر این فیلد تنظیم نشده باشد، فرض میکنیم که تمام کارتهای اعتباری پذیرفته میشوند. توجه داشته باشید که لیست کارتهای پشتیبانی شده توسط CreditCardType به مرور زمان افزایش مییابد، به این معنی که این موضوعات خالی پیکربندی برای تغییرات آینده باقی میماند. |
PerOrderFee
هزینه هایی که بدون در نظر گرفتن تعداد بلیط باید یک بار در هر سفارش پرداخت شود.
فیلدها | |
---|---|
delivery_ fee | هزینه ای که می تواند بر اساس روش تحویل متفاوت باشد. |
processing_ fee | هزینه ای برای پردازش روش پرداخت کاربر. |
هزینه بلیط
هزینه هایی که باید برای هر بلیطی که کاربر خریداری می کند پرداخت شود.
فیلدها | |
---|---|
service_ charge | هزینه اضافی برای یک سرویس ارزیابی می شود. |
facility_ fee | هزینه ای که به محل/تسهیالت می رود. |
taxes | به ازای مالیات بلیط |
آدرس پستی
آدرس یک مشتری یا یک کسب و کار.
فیلدها | |
---|---|
address_ country | کشوری که با استفاده از کد کشور آلفا-2 ISO 3166-1 مشخص شده است، به عنوان مثال "US" (الزامی) |
address_ locality | محل، به عنوان مثال "نمای کوه". (الزامی) |
address_ region | منطقه، به عنوان مثال "CA". این فیلد فقط در کشورهایی ضروری است که منطقه معمولاً بخشی از آدرس است. (اختیاری) |
postal_ code | کد پستی، به عنوان مثال "94043". (الزامی) |
street_ address | آدرس خیابان، به عنوان مثال "1600 Amphitheatre Pkwy". (الزامی) |
پیش پرداخت
پرداختی که کاربر ممکن است به عنوان بخشی از رزرو خود دریافت کند.
فیلدها | |
---|---|
price_ info | کانتینر برای جزئیات قیمت |
وضعیت پیش پرداخت
وضعیت پیش پرداخت یک رزرو.
Enums | |
---|---|
PREPAYMENT_STATUS_UNSPECIFIED | مشخص نشده، پیشفرض PREPAYMENT_NOT_PROVIDED است. |
PREPAYMENT_PROVIDED | هزینه رزرو از قبل پرداخت شده است. |
PREPAYMENT_NOT_PROVIDED | هزینه رزرو از قبل پرداخت نشده است. |
PREPAYMENT_REFUNDED | این هزینه قبلاً PREPAYMENT_PREVIDED بود اما اکنون بازپرداخت شده است. |
قیمت
قیمت یک سرویس یا هزینه.
فیلدها | |
---|---|
price_ micros | قیمت واحدهای خرد ارز. کسری از کوچکترین واحد پول با استفاده از نزدیکترین گرد کردن زوج گرد می شود. (به عنوان مثال برای دلار 2.5 سنت گرد شده به 2 سنت، 3.5 سنت به 4 سنت، 0.5 سنت گرد شده به 0 سنت، 2.51 سنت به 3 سنت گرد شده است). |
currency_ code | واحد پول قیمتی که در ISO 4217 تعریف شده است. |
pricing_ option_ tag | یک رشته اختیاری و غیر شفاف که گزینه قیمت گذاری مرتبط با قیمت تمدید شده را مشخص می کند. |
اطلاعات قیمت
کانتینر برای جزئیات قیمت
فیلدها | |
---|---|
price_ type | نحوه اعمال قیمت یا محدوده قیمت (به ازای هر نفر یا ثابت) را مشخص می کند. |
price_options فیلد اتحادیه . گزینه های قیمت این است که یا قیمت دقیق یا محدوده را مشخص کنید. price_options فقط می تواند یکی از موارد زیر باشد: | |
price | قیمت یک سرویس یا هزینه. |
price_ range | کران بالا و/یا پایین یک سرویس یا هزینه. |
تفسیر قیمت
توضیح می دهد که چگونه یک قیمت باید تفسیر و به کاربر نمایش داده شود.
Enums | |
---|---|
PRICE_INTERPRETATION_UNSPECIFIED | تفسیر قیمت مشخص نشده است، پیشفرض EXACT_AMOUNT است. |
EXACT_AMOUNT | زمانی که قیمت باید به عنوان یک ارزش خاص تفسیر شود. مثال: 20 دلار برای کلاس یوگا. 15 دلار برای کوتاه کردن موی کودک |
STARTS_AT | زمانی که قیمت یک سرویس متغیر است اما حداقل قیمت شناخته شده و به مصرف کنندگان نمایش داده می شود. مصرف کنندگان ممکن است انتخاب هایی داشته باشند که قیمت را افزایش دهد. توجه داشته باشید که هر سرویسی که از این تفسیر قیمت استفاده میکند باید از PrepaymentType NOT_SUPPORTED استفاده کند. مثال ها: 30 دلار برای نظافت سگ، اما انتخاب های اضافی مصرف کننده ممکن است قیمت را افزایش دهد |
NOT_DISPLAYED | زمانی که قیمت یک سرویس متغیر است و هیچ اطلاعات قیمتی از قبل به مصرف کنندگان نمایش داده نمی شود. توجه داشته باشید که هر سرویسی که از این PriceInterpretation استفاده میکند باید از PrepaymentType NOT_SUPPORTED استفاده کند و قیمت باید خالی باشد. مثال: مشاوره برای خدمات خانگی |
محدوده قیمت
بسته بندی برای محدوده ای از مقدار پولی به عنوان نامحدود تلقی می شود مگر اینکه هر دو مقدار تنظیم شده باشند. حداقل یکی از min_amount و max_amount مورد نیاز است.
فیلدها | |
---|---|
min_ price | حداقل مقدار. |
max_ 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}
فیلدها | |
---|---|
فیلد اتحادیه value_options . (ضروری) value_options فقط می تواند یکی از موارد زیر باشد: | |
value | یک مقدار منفرد. به عنوان مثال: 5.6 |
value_ range | محدوده ای از مقادیر که می تواند با پایان باز یا محدود نیز باشد. مثال: * حداقل 5.5 * حداکثر 5.5 * 5.5 تا 6.5 |
RangeValue
محدوده مقادیر به گونه ای که min_value
< max_value
. به حداقل یکی از min_value
و max_value
نیاز دارد.
فیلدها | |
---|---|
min_ value | حداقل ارزش. |
max_ value | حداکثر مقدار |
رتبه بندی
رتبه بندی یک موجودیت را تعریف می کند.
فیلدها | |
---|---|
value | میانگین ارزش رتبهبندی (الزامی زمانی که number_of_ratings > 0 باشد). مقدار باید در محدوده [1، 5] باشد و اگر و فقط اگر تعداد_رتبهبندیها صفر باشد میتوان آن را حذف کرد. |
number_ of_ ratings | تعداد رتبه های استفاده شده در محاسبه مقدار (الزامی). |
رسانه های مرتبط
عکس های مربوط به این سرویس Google این رسانهها را میخزد تا مطمئن شود که آنها به درستی برای کاربران نهایی نمایش داده میشوند. (اختیاری)
فیلدها | |
---|---|
url | آدرس این منبع رسانه ای. Google رسانه میزبانی شده در این URL را میخزد. |
type | نوع این منبع رسانه ای |
localized_ caption | عنوان رسانه ای که i18n را پشتیبانی می کند، فقط متن ساده پشتیبانی می شود. هر مؤلفه HTML حذف خواهد شد. (اختیاری) |
attribution | اطلاعات انتساب در مورد منبع رسانه. توجه داشته باشید که اگر برای اعطای اعتبار به عکاس یا آژانس لازم است انتساب با رسانه نمایش داده شود، این قسمت باید تنظیم شود. (اختیاری) |
caption | منسوخ شده است، ترجیح می دهید از localized_caption استفاده کنید. |
انتساب
اطلاعات انتساب برای این رسانه.
فیلدها | |
---|---|
localized_ text | متنی که به عکاس یا آژانس پشتیبانی کننده i18n اعتبار می دهد. این متن همراه با رسانه منبع نمایش داده می شود. توجه داشته باشید که فقط متن ساده برای این فیلد پشتیبانی میشود، هر مؤلفه HTML حذف میشود (ارزیابی مبتنی بر پیوند پشتیبانی نمیشود). |
text | منسوخ شده است، ترجیح می دهید از localized_text استفاده کنید. |
MediaType
Enum برای نشان دادن نوع این منبع رسانه. فقط عکس ها پشتیبانی می شوند. لطفاً در صورت نیاز به پشتیبانی از سایر رسانههای فراتر از عکس، با تیم رزرو با Google تماس بگیرید.
Enums | |
---|---|
TYPE_UNSPECIFIED | استفاده نشده |
PHOTO | نشان می دهد رسانه ارائه شده توسط URL یک عکس است. |
ReplaceServiceAvailabilityRequest
درخواست جایگزینی در دسترس بودن یک Service
.
فیلدها | |
---|---|
service_ availability | در دسترس بودن سرویسی که برای جایگزینی سرویس های موجود استفاده می شود. |
RequireCreditCard
تعیین می کند که آیا برای رزرو قرار ملاقات نیاز به کارت اعتباری است یا خیر.
Enums | |
---|---|
REQUIRE_CREDIT_CARD_UNSPECIFIED | الزامات کارت اعتباری به صراحت مشخص نشده است و رفتار با رفتاری که برای CONDITIONAL مشخص شده است یکسان است. |
REQUIRE_CREDIT_CARD_CONDITIONAL | در صورت رعایت هر یک از شرایط زیر، Google برای رزرو به کارت اعتباری نیاز دارد: * در دسترس بودن قیمت دارد و نوع_پیش_پرداخت الزامی است * عدم_هزینه_نمایش تنظیم شده است * قسمت سپرده تنظیم شده است. |
REQUIRE_CREDIT_CARD_ALWAYS | برای رزرو این در دسترس بودن بدون توجه به سایر مقادیر فیلد، همیشه کارت اعتباری لازم است. |
منابع
هنگامی که اعضای مختلف کارکنان یا اتاقها بخشی از سرویس هستند، از یک منبع برای ابهامزدایی شکافهای دسترسی از یکدیگر استفاده میشود. اسلات های متعدد برای یک سرویس و بازه زمانی یکسان می توانند زمانی که منابع متفاوتی داشته باشند، وجود داشته باشند.
فیلدها | |
---|---|
staff_ id | شناسه اختیاری برای یکی از کارکنان ارائه دهنده خدمات. این فیلد، کارمند را در تمامی بازرگانان، خدمات و سوابق در دسترس بودن شناسایی میکند. همچنین باید در طول زمان پایدار باشد تا امکان ارتباط با رزروهای گذشته فراهم شود. اگر staff_name وجود دارد این فیلد باید وجود داشته باشد. |
staff_ name | نام اختیاری یکی از کارکنان ارائه دهنده خدمات. این فیلد به کاربرانی که رزرو میکنند نمایش داده میشود و برخلاف یک شناسه غیرشفاف، باید قابل خواندن توسط انسان باشد. اگر staff_id وجود داشته باشد باید این فیلد وجود داشته باشد. |
room_ id | یک شناسه اختیاری برای اتاقی که سرویس در آن قرار دارد. این قسمت اتاق را در همه تاجران، خدمات و سوابق در دسترس بودن مشخص میکند. همچنین باید در طول زمان پایدار باشد تا امکان ارتباط با رزروهای گذشته فراهم شود. اگر room_name وجود دارد، این فیلد باید وجود داشته باشد. |
room_ name | یک نام اختیاری برای اتاقی که سرویس در آن قرار دارد. این فیلد برای کاربرانی که رزرو میکنند نمایش داده میشود و باید قابل خواندن توسط انسان باشد، برخلاف یک شناسه غیر شفاف. (اختیاری است اما در صورت وجود room_id ضروری است) در ناهار خوری، نام اتاق فقط باید برای قسمت های نشیمن مانند بار یا پاسیو استفاده شود و نباید برای منوهای قیمت ثابت، فعالیت های خاص، یا هر ارزش غیر اتاق دیگری استفاده شود (مانند رزرو یا شام). اکیداً توصیه می شود که قسمت نشیمنگاه پیش فرض اتاقی با آن نداشته باشد. |
party_ size | فقط برای ناهار خوری قابل استفاده است: اندازه مهمانی که در این بازه زمانی قابل استفاده است. یک رستوران میتواند بهطور همزمان با چندین اسلات مرتبط شود، که هر کدام یک مهمانی_اندازه متفاوتی را مشخص میکنند، اگر برای مثال 2، 3 یا 4 نفر میتوانند با رزرو بنشینند. |
room_ description | اختیاری. توضیحات اتاق محلی در صورت تنظیم، یک مقدار پیش فرض باید ارائه شود. ترجیح داده میشود که زبانهای مشترک برای منطقه تجاری نیز ارائه شود. (اختیاری) |
قوانین زمانبندی
قوانین زمانبندی برای یک سرویس
فیلدها | |
---|---|
min_ advance_ online_ canceling | حداقل اخطار قبلی در چند ثانیه مورد نیاز برای لغو قرار آنلاین رزرو شده. (اختیاری) |
late_cancellation_fee | هزینه انصراف در حداقل دوره اطلاع قبلی. |
noshow_fee | هزینه عدم نمایش بدون لغو. |
admission_ policy | خط مشی پذیرش که برای این سرویس اعمال می شود. اگر تنظیم نشود، پیشفرض TIME_STRICT است. (اختیاری) |
cancellation_ policy | خط مشی لغو قوانین برنامه ریزی (برای کارهایی که باید انجام دهید لازم است) |
فیلد اتحادیه اگر "min_advance_booking" تنظیم شده باشد، آخرین زمان قابل رزرو به صورت (<slot start time> - "min_advance_booking") محاسبه می شود. اگر "min_booking_buffer_before_end_time" تنظیم شده باشد، آخرین زمان قابل رزرو به صورت (<زمان پایان اسلات> - "min_booking_buffer_before_end_time" محاسبه می شود. توجه داشته باشید که مقدار "min_booking_buffer_before_end_time" در صورت تنظیم باید مثبت باشد. اگر هر دو تنظیم نشده باشند، اسلات تا زمان شروع اسلات قابل رزرو است. اگر هر دو فیلد تنظیم شده باشند، فقط یک مقدار انتخاب می شود در حالی که مقدار دیگر نادیده گرفته می شود - ما نمی توانیم به طور قابل اعتماد پیش بینی کنیم که کدام مقدار انتخاب شده است. مثال ها:
| |
min_ advance_ booking | مدت زمان (بر حسب ثانیه) از زمانی که می توان آخرین رزرو را انجام داد تا زمانی که اسلات در دسترس بودن شروع می شود. |
min_ booking_ buffer_ before_ end_ time | مدت زمان (بر حسب ثانیه) از زمانی که می توان آخرین رزرو را انجام داد تا زمانی که شکاف دسترسی به پایان می رسد. اگر این فیلد تنظیم شده باشد، قسمت "admission_policy" باید روی TIME_FLEXIBLE تنظیم شود تا نشان دهد که کاربران می توانند پس از شروع اسلات از بلیط های خریداری شده استفاده کنند. |
سیاست پذیرش
سیاست پذیرش این سرویس.
Enums | |
---|---|
ADMISSION_POLICY_UNSPECIFIED | استفاده نشده |
TIME_STRICT | مشتریان باید در زمان شروع شکاف در دسترس بودن حضور داشته باشند و انتظار میرود خدمات در زمان پایان شکاف به پایان برسد. نمونههایی از موارد استفاده TIME_STRICT: * توری که از ساعت 9 صبح شروع میشود و همه شرکتکنندگان را ملزم میکند در زمان شروع حضور داشته باشند و حدود ساعت 12 بعد از ظهر برمیگردند. * رزرو کوتاهی مو در ساعت 15 روز شنبه که تقریباً 30 دقیقه طول خواهد کشید. * کلاس تناسب اندام از ساعت 18 تا 20. |
TIME_FLEXIBLE | مشتریان می توانند در هر زمانی بین زمان شروع و پایان زمان در دسترس بودن برای استفاده از این رزرو حضور پیدا کنند. نمونه هایی از موارد استفاده TIME_FLEXIBLE: * بلیط موزه که در هر زمانی در تاریخ خرید می توان از آن استفاده کرد. * پذیرش بعد از ظهر به یک شهربازی که از ساعت 12 شب تا 9 شب قابل استفاده است. |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION | مشتریان باید در زمان شروع اسلات در دسترس بودن به تاجر برسند، اما میتوانند هر زمانی که بخواهند آنجا را ترک کنند. به عنوان مثال، در سناریوی پذیرش موزه، بلیط ورود به موقع برای ساعت 10 صبح، کاربر را ملزم می کند ساعت 10 صبح در موزه باشد. زمان شروع اسلات های موجود برای این سرویس نشان دهنده زمان ورود تعیین شده است. با این حال، زمان پایان صرفاً به عنوان کلیدی برای شناسایی جایگاه در دسترس بودن برای رزرو استفاده میشود. |
خدمات
اطلاعات مربوط به خدماتی که توسط تاجر ارائه می شود، به عنوان مثال، کوتاه کردن مو.
فیلدها | |
---|---|
name | نام منبع سرویس، که دارای قالب |
service_ name | نام سرویس، به عنوان مثال "مدل موی مردانه". منسوخ شده است، به جای آن از localized_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 | قیمت خدمات. |
price_ interpretation | نحوه تفسیر و نمایش قیمت به کاربر را شرح می دهد. می تواند توسط هر عمودی به جز Dining و Things To Do برای پیکربندی نمایش قیمت خدمات استفاده شود. |
rules | قوانین رزرو/لغو قرار ملاقات |
prepayment_ type | اینکه آیا پیش پرداخت لازم است، اختیاری است یا پشتیبانی نمی شود. |
prepayment_ terms | شرایط زمانی که پیش پرداخت تکمیل می شود. |
form[] | منسوخ شده است. لطفاً از intake_form و per_ticket_intake_form استفاده کنید. |
intake_ form | فرمی که هنگام رزرو این سرویس از کاربر اطلاعات بیشتری درخواست می کند. (اختیاری) |
per_ ticket_ intake_ form | فرمی که هنگام رزرو این سرویس از کاربر اطلاعات بیشتری درخواست می کند. این فرم باید برای هر بلیطی که کاربر رزرو می کند یک بار پر شود. (اختیاری) |
tax_ rate | نرخ مالیات این سرویس در صورت وجود، این فیلد هر مالیات_نرخ تنظیم شده در سطح تاجر را لغو می کند. یک پیام خالی (یعنی tax_rate { }) نرخ مالیات اعمال شده را به صفر بازنشانی می کند. |
payment_ option_ id[] | فهرستی از شناسهها که به گزینههای پرداختی که میتوان برای پرداخت این سرویس استفاده کرد اشاره دارد. گزینههای پرداخت واقعی در سطح Merchant تعریف میشوند، و همچنین میتوانند بین چندین تاجر به اشتراک گذاشته شوند. |
deposit | نحوه پرداخت وجه از کاربر را مشخص می کند. در صورت مشخص بودن واریز خدمات لغو می شود. تنظیم این پیام بر روی یک پیام سپرده خالی، هرگونه واریز در سطح خدمات را حذف می کند. (اختیاری) |
no_ show_ fee | هزینه عدم نمایش را تعریف می کند که ممکن است از کاربر دریافت شود. در صورتی که مشخص شده بود، سرویس بدون هزینه نمایش را لغو می کند. تنظیم این پیام بر روی یک پیام NoShowFee خالی، هزینه بدون نمایش در سطح سرویس را حذف می کند. (اختیاری) |
require_ credit_ card | نشان می دهد که آیا کاربر برای رزرو این سرویس باید کارت اعتباری ارائه دهد یا خیر. این فیلد را می توان در سطح در دسترس بودن لغو کرد. (اختیاری) |
action_ link[] | لینک اقدام مربوط به این سرویس. اگر پیوند اقدام وجود دارد، نوع (به زیر مراجعه کنید) باید در سرویس تنظیم شود. |
type | نوع از پیش تعریف شده این سرویس. (اختیاری) |
ticket_ type[] | انواع بلیط های قابل رزرو/خرید برای این سرویس، در صورت پشتیبانی از بلیط. (اختیاری) |
related_ media[] | عکس های مربوط به این سرویس Google رسانهها را میخزد و ذخیره میکند تا مطمئن شود که به کارآمدترین روش برای کاربران نهایی نمایش داده میشوند. (اختیاری) |
service_ attribute_ value_ id[] | مقادیر ویژگی سرویس که برای این سرویس اعمال می شود (اختیاری). هر سرویس ممکن است مقادیر صفر یا بیشتر برای هر ویژگی سرویس تعریف شده در Merchant مربوطه داشته باشد. (اختیاری) |
waitlist_ rules | قوانین پیوستن به لیست انتظار |
ticketing_ vertical_ specific_ data | اطلاعات اضافی منحصر به فرد برای رویداد عمودی بلیط. (اختیاری) |
integration_ type | عمق ادغام ما برای این سرویس پشتیبانی می کنیم. (اختیاری) برای شرکای دارای ادغام شروع کننده نامربوط است. پایان به انتها همیشه برای این شرکا غیرفعال خواهد بود. |
per_ order_ fee | برای خرید این سرویس هزینه های سطح سفارش دهید. (اختیاری) |
tours_ and_ activities_ content | فیلدهای محتوای خاص تورها و فعالیت ها. |
location[] | مکان های مرتبط با این سرویس نکات مهم: اگر چندین مکان بازدید شده مرتبط با این سرویس وجود دارد، یا START_LOCATION با VISITED_LOCATION متفاوت است، START_LOCATION باید مشخص شود. مثال: - یک تور دوچرخه سواری با راهنما که از سه مکان بازدید می کند، محل شروع باید مشخص شود. - یک جلسه تور اتوبوس در لابی هتل و سپس رفتن به محل بازدید. مکان جلسه باید مشخص شود. |
rating | رتبهبندی کاربر برای این سرویس بهعنوان یک معیار مجموع در همه مرورها. |
home_ service_ data | اطلاعات اضافی منحصر به فرد برای خدمات خانگی عمودی. (اختیاری) |
virtual_ session | اختیاری. اطلاعات در مورد جلسه مجازی برای فعال کردن خدمات مجازی مورد نیاز است. |
direct_ merchant_ payment | اختیاری. اطلاعات اضافی که در صورت نیاز کاربر به پرداخت مستقیم به تاجر، باید اضافه شود. نکته مهم: RwG در این تراکنش دخیل نیست. اگر virtual_session تعریف شده باشد و سرویس رایگان نباشد یا prepayment_type روی REQUIRED تنظیم نشده باشد، لازم است. |
uri_ template | اختیاری. یک الگوی اختیاری که مشخص می کند گوگل چگونه باید URL ها را برای سایت خارجی تولید کند. |
شرایط پیش پرداخت
اطلاعات خاص در مورد زمان تکمیل پیش پرداخت.
فیلدها | |
---|---|
charge_ timing | زمانی که شارژ نسبت به زمان خرید اتفاق می افتد. |
charge_ time_ before_ start_ time_ sec | زمان بر حسب ثانیه قبل از زمان شروع سرویس که هزینه پرداخت از کاربر دریافت می شود. این فیلد فقط زمانی باید تنظیم شود که ChargeTiming CHARGE_LATER باشد. |
ChargeTiming
Enum برای تعیین زمان شارژ نسبت به زمان خرید.
Enums | |
---|---|
CHARGE_TIMING_UNSPECIFIED | استفاده نشده |
CHARGE_NOW | مشتری بلافاصله شارژ می شود. |
CHARGE_LATER | بعداً هزینه مشتری دریافت می شود. |
نوع پیش پرداخت
Enum برای نشان دادن نوع پیش پرداخت.
Enums | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED | بهطور پیشفرض فرض میکنیم که پیشپرداخت NOT_SUPPORTED است. |
REQUIRED | کاربر باید در زمان رزرو این سرویس را پرداخت کند. |
OPTIONAL | کاربر می تواند انتخاب کند که این سرویس را در زمان رزرو یا بعد از آن پیش پرداخت کند، اما برای رزرو الزامی نیست. |
NOT_SUPPORTED | پیش پرداخت برای این سرویس پشتیبانی نمی شود. |
نوع سرویس
انواع خدمات از پیش تعریف شده
Enums | |
---|---|
SERVICE_TYPE_UNSPECIFIED | استفاده نشده |
SERVICE_TYPE_DINING_RESERVATION | رزرو ناهار خوری. |
SERVICE_TYPE_FOOD_ORDERING | سفارش غذا، میتواند تحویل غذا باشد یا تحویل غذا یا هر دو. |
SERVICE_TYPE_FOOD_DELIVERY | تحویل غذا. |
SERVICE_TYPE_FOOD_TAKEOUT | بیرون آوردن غذا |
SERVICE_TYPE_EVENT_TICKET | بلیط رویداد. |
SERVICE_TYPE_TRIP_TOUR | تور سفر. |
SERVICE_TYPE_APPOINTMENT | خدماتی که قرار ملاقات ها یا کلاس ها را ارائه می دهد. برای (1) سلامت و تناسب اندام، (2) آبگرم و زیبایی، و (3) خدمات مشاوره مالی و ارزیابی توصیه می شود. لطفاً انواع خدمات پشتیبانی شده را ببینید: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview |
SERVICE_TYPE_ONLINE_APPOINTMENT | سرویسی که به صورت آنلاین برای یک کلاس یا جلسه که کاملا مجازی خواهد بود قرار ملاقات می دهد. در صورت فعال کردن رزرو سرویس مجازی، باید تنظیم شود. |
SERVICE_TYPE_SHOPPING | سرویسی که به کاربران امکان خرید از تاجر داده شده را می دهد. این می تواند تحویل یا تحویل باشد. |
ServiceAttribute
ویژگیهای سرویس دستههای تعریف شده توسط شریک هستند که خدمات یک تاجر را توصیف میکنند. به عنوان مثال، یک بانک ممکن است ویژگی خدمات "نوع حساب" را با مقادیر ممکن "شخصی" و "تجاری" تعریف کند، در حالی که یک آرایشگاه ممکن است ویژگی خدمات "نوع خدمات" را با مقادیر احتمالی "Haircut"، "Color" تعریف کند. ، و "سبک".
فیلدها | |
---|---|
attribute_ id | شناسهای که بهطور منحصربهفرد این ویژگی خدمات را در میان سایر ویژگیهای یک تاجر شناسایی میکند، مثلاً «نوع حساب». |
attribute_ name | یک نام قابل مشاهده برای کاربر برای این ویژگی، به عنوان مثال "نوع حساب". |
value[] | تمام مقادیر ممکن برای این ویژگی سرویس. |
ارزش
یک مقدار ممکن برای یک ویژگی سرویس خاص را نشان می دهد.
فیلدها | |
---|---|
value_ id | شناسهای که بهطور منحصربهفرد این مقدار را در میان سایر ویژگیهای این سرویس شناسایی میکند، مثلاً «شخصی». |
value_ name | یک نام قابل مشاهده برای مقدار، به عنوان مثال "شخصی". |
ServiceAttributeValueId
مقدار خاصی از ویژگی سرویس را برای اعمال به یک سرویس مشخص می کند.
فیلدها | |
---|---|
attribute_ id | شناسه یک ویژگی همانطور که در Merchant.service_attribute تعریف شده است، به عنوان مثال "نوع سرویس". |
value_ id | شناسه مقدار این ویژگی، به عنوان مثال "مشکل مو". باید با یک value_id در تعریف ویژگی سرویس مطابقت داشته باشد. |
سرویس در دسترس بودن
فهرستی از در دسترس بودن و چه کسی/چه زمانی باید برای آنها اعمال شود.
فیلدها | |
---|---|
name | نام منبع سرویسی که باید این مورد را اعمال کرد. در قالب |
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[] | لیست جدید در دسترس بودن |
ServiceIntakeForm
فرم دریافتی را تعریف می کند که خدمات ارائه شده توسط یک تاجر را سفارشی می کند.
فیلدها | |
---|---|
field[] | فیلدهایی که به کاربر نمایش داده می شود. |
first_time_customers | اگر درست باشد، این فرم برای اولین بار به مشتریان نشان داده می شود. منسوخ شده است. این عملکرد برای فرم های دریافت پشتیبانی نمی شود. |
returning_customers | اگر درست باشد، این فرم به مشتریان مکرر نشان داده می شود. منسوخ شده است. این عملکرد برای فرم های دریافت پشتیبانی نمی شود. |
ServiceIntakeFormField
فیلدی را تعریف می کند که در ServiceIntakeForm گنجانده شده است.
فیلدها | |
---|---|
id | رشتهای از شریک جمعآوری که به طور منحصربهفرد یک فیلد فرم را شناسایی میکند. این شناسه باید همان شناسه در پاسخ فیلد فرم مربوطه باشد و باید هم در سطح خدمات و هم در فرم های دریافت بلیط منحصر به فرد باشد. (الزامی) |
type | نوع این رشته |
label | متنی که برای این فیلد به کاربر نشان داده می شود. منسوخ شده است، لطفاً به جای آن از |
localized_ label | متنی که برای این فیلد به کاربر نشان داده می شود. فیلد را می توان در چندین منطقه ارائه کرد. (الزامی) |
value[] | اگر و فقط اگر نوع فیلد LOCATION_SEARCH باشد، تنظیم کنید. لطفاً از "location_id" در قسمت "location" برای تعیین مقدار مکان استفاده کنید. |
choice_ text[] | اگر و فقط اگر نوع فیلد MULTIPLE_CHOICE، CHECKBOXES یا DROPDOWN باشد، تنظیم کنید. برای برشمردن گزینه های ممکن استفاده می شود. |
is_ required | نشان می دهد که آیا پاسخ به این فیلد توسط کاربر مورد نیاز است یا خیر. |
allow_ custom_ answer | نشان می دهد که آیا یک مقدار سفارشی علاوه بر پاسخ های از پیش تعریف شده مجاز است یا خیر. این فقط زمانی قابل اعمال است که نوع فیلد LOCATION_SEARCH باشد. (اختیاری) |
additional_ option[] | گزینه های اضافی علاوه بر مقادیر ارائه شده ارائه شده است. فقط زمانی قابل اعمال است که نوع فیلد LOCATION_SEARCH باشد. به عنوان مثال، علاوه بر لیست مکان ارائه شده، یکی دیگر از گزینه های موجود می تواند "بعداً با تامین کننده تماس خواهم گرفت". (اختیاری) |
ticket_ type_ restrict[] | اگر این سوال فقط زمانی نشان داده شود که کاربر انواع بلیط خاصی را رزرو می کند، این قسمت باید به عنوان مجموعه شناسه نوع بلیط قابل اجرا تنظیم شود. اگر سوال همیشه قابل اجرا است، فیلد را خالی بگذارید. |
hint | متن راهنمایی برای ورودی، که به عنوان یک مکان نگهدار متن نشان داده می شود. این فقط زمانی قابل اعمال است که نوع فیلد SHORT_ANSWER یا PARAGRAPH باشد. (اختیاری) |
نوع فیلد
Enum برای نشان دادن نوع فیلد.
Enums | |
---|---|
FIELD_TYPE_UNSPECIFIED | فیلدهایی از نوع نامشخص یا ناشناخته نادیده گرفته خواهند شد. |
SHORT_ANSWER | یک فیلد ورودی یک خطی برای متن. |
PARAGRAPH | یک فیلد ورودی چند خطی برای متن. |
MULTIPLE_CHOICE | مجموعه ای از دکمه های رادیویی که نیاز به یک انتخاب از بین گزینه های متعدد دارد. |
CHECKBOXES | یک یا چند مورد شمارش شده با کادرهای تأیید. |
DROPDOWN | انتخابی از یک کشویی |
BOOLEAN | یک دکمه بله/خیر |
LOCATION_SEARCH | یک کادر جستجو که از یافتن مکان منطبق با ورودی کاربر از لیست مکان ارائه شده پشتیبانی می کند. |
نرخ مالیات
نرخ مالیاتی که هنگام دریافت هزینه از کاربر برای یک سرویس اعمال میشود و میتواند بر اساس هر تاجر یا بر اساس خدمات تنظیم شود.
فیلدها | |
---|---|
micro_ percent | نرخ مالیات بر حسب میلیونم یک درصد، که عملاً 6 اعشار دقت را نشان می دهد. به عنوان مثال، اگر نرخ مالیات 7.253 درصد باشد، این فیلد باید 7253000 تنظیم شود. اگر این قسمت تنظیم نشده باقی بماند یا روی 0 تنظیم شود، کل قیمتی که برای هر سرویس ارائه شده توسط این تاجر از کاربر دریافت میشود، دقیقاً قیمتی است که توسط Service.price مشخص شده است. فرض می شود که قیمت خدمات از مالیات های قابل اعمال معاف است یا از قبل شامل آن می شود. مالیات ها به عنوان یک خط جداگانه به کاربر نشان داده نمی شود. اگر این قسمت روی مقدار غیر صفر تنظیم شود، کل قیمتی که برای هر سرویس ارائه شده توسط این تاجر از کاربر دریافت میشود، شامل قیمت خدمات به اضافه مالیات محاسبهشده با استفاده از نرخ مالیات ارائهشده در اینجا میشود. کسری از کوچکترین واحد پول (به عنوان مثال، کسری از یک سنت) با استفاده از نزدیکترین گرد کردن زوج گرد می شود. مالیات ها به عنوان یک خط جداگانه به کاربر نشان داده می شود. |
شرایط
مجموعه ای از قوانین و دستورالعمل هایی که به منظور رزرو از طریق رزرو با Google به کاربر نمایش داده می شود.
فیلدها | |
---|---|
url | به صورت اختیاری، URL به شرایط و ضوابط. |
text | متنی که باید به کاربر نمایش داده شود. برای ادغام های جدید از localized_text زیر استفاده کنید. |
localized_ text | متن بومی سازی شده برای نمایش به کاربر. |
متن
محموله متنی احتمالاً محلی شده. برخی از فیلدهای متنی ممکن است حاوی محتوای علامت گذاری شده باشند.
فیلدها | |
---|---|
value | مقدار متن در یک منطقه ناشناخته. اگر و فقط اگر |
localized_ value[] | مقادیر متن به ازای هر محلی. اختیاری. |
TicketType
TicketType برای تمایز بین بلیط هایی با قیمت ها و/یا در دسترس بودن متفاوت به دلیل انواع مختلف کاربر، ویژگی های خدمات مختلف، یا گزینه ها/افزونه های مختلف استفاده می شود.
بلیط حداقل واحد قابل رزرو برای یک سرویس است، به عنوان مثال، یک مکان در سفر رفتینگ، ورود به موزه، یک روز تمام روز اجاره کایاک دو نفره.
فیلدها | |
---|---|
ticket_ type_ id | شناسه بلیط برای تمایز بین انواع بلیط های مختلف یک سرویس استفاده می شود و تنها انتظار می رود که در یک سرویس منحصر به فرد باشد. |
short_ description | توضیح کوتاهی برای این TicketType. این می تواند توسط کاربر قابل مشاهده باشد، به عنوان مثال، "بزرگسال"، "کودک"، "کهنه سرباز"، "ردیف J"، و غیره. لازم است، هر نوع بلیط باید دارای توضیحاتی باشد تا کاربر قابل مشاهده باشد. منسوخ شده است، به جای آن از localized_short_description استفاده کنید. |
localized_ short_ description | توضیح کوتاهی درباره این TicketType با پشتیبانی از i18n. این می تواند توسط کاربر قابل مشاهده باشد، به عنوان مثال، "بزرگسال"، "کودک"، "کهنه سرباز"، "ردیف J"، و غیره. لازم است، هر نوع بلیط باید دارای توضیحاتی باشد تا کاربر قابل مشاهده باشد. مقادیر جداگانه ای را می توان برای هر منطقه ارائه کرد. |
price | قیمت بلیط تک از این نوع، بدون هر گونه مالیات. نرخ مالیات خدمات بر بلیط های آن اعمال می شود. |
per_ ticket_ fee | هزینه های اضافی برای خرید این بلیط. (اختیاری) |
price_ display_ type | اختیاری. نوع نمایش قیمت از پیش تعیین شده یک بلیط از این نوع. |
option_ description | شرح هر گزینه اضافی که این نوع بلیط نشان دهنده آن است، در صورت وجود. منسوخ شده است، به جای آن از localized_option_description استفاده کنید. |
localized_ option_ description | شرح هر گزینه اضافی که این نوع بلیط نشان دهنده آن است، در صورت وجود. مقادیر جداگانه ای را می توان برای هر منطقه ارائه کرد. گزینه های اضافی زمانی مفید هستند که نوع بلیط نشان دهنده چند بعد باشد. مثال 1: بلیط ورودی با انواع مختلف "بزرگسال"، "کودک" و زبان به عنوان گزینه اضافی، لیست TicketType مورد انتظار این خواهد بود: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: " انگلیسی" } } - { 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: "description localized" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } } مثال 2: اجاره کایاک چند ساعته با افزودنی کیسه خشک اختیاری، short_description می تواند "3 ساعت" باشد و option_description می تواند "با کیسه خشک" یا "بدون کیسه خشک" باشد: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 ساعت" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 ساعت" } localized_option_description { value: "spanish" } type_type} localized_short_description { value: "3 ساعت" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 ساعت" } localized_option_description { value: "spanish" } } اختیاری است، اما اگر هر نوع بلیطی در سرویس دارای این فیلد تنظیم شده باشد، انتظار داریم همه انواع بلیط های دیگر نیز این فیلد را تنظیم کنند (از یک option_description پیش فرض می توان استفاده کرد). به عنوان مثال [{ticket_type_1, adult, English}, {ticket_type_1, adult, ''}] لیست معتبری نیست. فقط دو تگ قالب بندی HTML پشتیبانی می شود: و |
inventory_ type | اختیاری. نوع موجودی از پیش تعیین شده یک بلیط واحد از این نوع. |
InventoryType
نوع موجودی از پیش تعیین شده یک بلیط واحد از این نوع.
Enums | |
---|---|
INVENTORY_TYPE_UNSPECIFIED | نوع موجودی مشخص نشده است. |
INVENTORY_TYPE_PRIMARY | موجودی اولیه |
INVENTORY_TYPE_VERIFIED_RESALE | موجودی فروش مجدد تایید شده |
INVENTORY_TYPE_RESALE | موجودی فروش مجدد |
INVENTORY_TYPE_AGGREGATOR | موجودی تجمیع کننده. |
PriceDisplayType
فرمت قیمت نمایش داده شده در صفحه فرود را نشان می دهد.
این فیلد برای موجودی بدون پیوند نادیده گرفته می شود.
این فیلد به سطوح Google اجازه میدهد تا همان قالب قیمتی را که توسطService صفحه فرود استفاده میشود، نشان دهند. فرمت های قیمت ثابت نرخ تبدیل را بهبود می بخشد و سردرگمی را کاهش می دهد.
Enums | |
---|---|
PRICE_DISPLAY_TYPE_UNSPECIFIED | نوع نمایش قیمت مشخص نشده است. Google تعیین خواهد کرد که کدام قالب را نشان دهد. |
PRICE_DISPLAY_TYPE_BASE | قیمت نشان داده شده در صفحه فرود، قیمت پایه است. |
PRICE_DISPLAY_TYPE_ALL_IN | قیمت نشان داده شده در صفحه فرود شامل کلیه هزینه ها و مالیات است. |
TicketingVerticalSpecificData
اطلاعات اضافی منحصر به فرد برای رویداد عمودی بلیط.
فیلدها | |
---|---|
event_ category | دسته بندی رویداد. تنظیم فقط زمانی که رویداد در یکی از دسته های از پیش تعریف شده قرار می گیرد. (اختیاری) |
event_ url | نشانی وب رویداد در وب سایت شریک. (اختیاری) |
entity[] | فهرستی از نهادهای مرتبط با رویداد. (اختیاری) |
event_ attendance_ mode | مورد نیاز. نوع حضور در رویداد |
event_ virtual_ location_ url[] | اختیاری. نشانی اینترنتی جایی که می توان رویداد را تماشا کرد. |
event_ organizer | اختیاری. سازمان دهنده ای که رویداد را برگزار می کند. |
event_ organizer_ url | اختیاری. URL سازمان دهنده که رویداد را میزبانی می کند. |
event_ organizer_ type | اختیاری. نوع برگزار کننده. |
event_ source_ url[] | مورد نیاز. URL صفحاتی که اطلاعات یا توضیحات رویداد را می توان یافت. |
event_ state | اختیاری. وضعیت رویداد. |
brand_ name | اختیاری. نام تجاری بومی سازی شده |
event_ creator | اختیاری. اطلاعات در مورد خالق رویداد. |
حالت حضور و غیاب
نوع حضور در رویداد
Enums | |
---|---|
ATTENDANCE_MODE_UNSPECIFIED | مشخص نشده است. |
ONLINE | برای رویدادهای مجازی |
PHYSICAL | برای رویدادهای فیزیکی |
PHYSICAL_ONLINE_MIXED | برای رویدادهایی که هم فیزیکی و هم مجازی هستند. |
موجودیت
نماینده یک نهاد مرتبط با رویداد است.
فیلدها | |
---|---|
id | شناسه منحصر به فرد موجودیت در پایگاه داده شریک. (اختیاری) |
name | نام نهاد. (الزامی) |
url | آدرس صفحه وب که به طور واضح موجودیت را توصیف می کند. در صورت وجود، این صفحه وب در وب سایت شریک برای نهاد است. برای سایر URL های عمومی موجودیت، از relevant_url در public_identification_data استفاده کنید. (اختیاری) |
entity_ type | نوع موجودیت. (اختیاری) |
entity_ role | نقش نهاد در رویداد. (اختیاری) |
public_ identification_ data | مراجع عمومی نهاد. (اختیاری) |
EntityRole
نقش نهاد در رویداد.
Enums | |
---|---|
ENTITY_ROLE_UNSPECIFIED | مشخص نشده است. |
ENTITY_ROLE_HEADLINER | این نهاد نشان دهنده یک تیتر یا مجری پیشرو در رویداد است. |
ENTITY_ROLE_SUPPORTER | این نهاد یک مجری حامی در رویداد را نمایندگی می کند. |
ENTITY_ROLE_HOME_TEAM | این نهاد نماینده تیم میزبان در رویداد (ورزشی) است. |
ENTITY_ROLE_AWAY_TEAM | این نهاد نماینده تیم میهمان در رویداد (ورزشی) است. |
EntityType
نوع موجودیت. توجه: در نظر گرفته نشده است که یک هستی شناسی جهانی باشد.
Enums | |
---|---|
ENTITY_TYPE_UNSPECIFIED | مشخص نشده است. استفاده نکنید. |
ENTITY_TYPE_PERFORMER | نهاد معرف هنرمند یا گروهی است که در یک کنسرت یا نمایش اجرا می کند. فقط زمانی قابل اعمال است که دسته رویداد کنسرت یا تئاتر باشد. |
ENTITY_TYPE_PLAYER | این نهاد نماینده تیم ورزشی یا بازیکن در رویداد است. فقط زمانی قابل اجراست که دسته رویداد ورزشی باشد. |
ENTITY_TYPE_CONCERT_TOUR | نهاد نشان دهنده توری است که این رویداد به آن تعلق دارد. فقط زمانی قابل اعمال است که دسته رویداد CONCERT باشد. |
ENTITY_TYPE_SPORTS_SERIES | نهاد یک تورنمنت ورزشی است که این رویداد به آن تعلق دارد. فقط زمانی قابل اجراست که دسته رویداد ورزشی باشد. |
ENTITY_TYPE_PLAY | موجودیت نشان دهنده نوع نمایش (مثلاً موزیکال، کمدی، باله و غیره) است که در رویداد اجرا می شود. فقط زمانی قابل اعمال است که دسته رویداد تئاتر باشد. |
دسته رویداد
زیرمجموعه ای از دسته های رویداد که ما تجربه محصول را برای آن سفارشی می کنیم. توجه: در نظر گرفته نشده است که یک هستی شناسی جهانی از رویدادها باشد.
Enums | |
---|---|
EVENT_CATEGORY_UNSPECIFIED | مشخص نشده است. استفاده نکنید. |
EVENT_CATEGORY_CONCERT | کنسرت ها |
EVENT_CATEGORY_SPORTS | رویدادهای ورزشی |
EVENT_CATEGORY_THEATRE | رویدادهای تئاتر |
EVENT_CATEGORY_EXHIBITS | نمایشگاه ها |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES | کارگاه ها و کلاس ها |
EventCreator
اطلاعات در مورد خالق رویداد. فقط مربوط به پلتفرم هایی است که شامل رویدادهای محتوای تولید شده توسط کاربر است.
فیلدها | |
---|---|
name | اختیاری. نام سازنده رویداد. بدون محدودیت شخصیت |
EventState
وضعیت رویداد.
Enums | |
---|---|
EVENT_STATE_UNSPECIFIED | مشخص نشده است. |
SCHEDULED | این رویداد برنامه ریزی شده است. |
RESCHEDULED | این رویداد دوباره برنامه ریزی شده است. |
CANCELLED | این رویداد لغو می شود. |
POSTPONED | این رویداد به تعویق افتاد. |
OrganizerType
نوع برگزار کننده.
Enums | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED | مشخص نشده است. |
PERSON | برای سازمان دهنده که یک شخص است. |
ORGANIZATION | برای سازمان دهنده که یک سازمان است. |
PublicIdentificationData
شناسه ها، صفحات وب، یا هر منبع عمومی دیگری که به یک نهاد ارجاع می دهد.
فیلدها | |
---|---|
relevant_ url[] | URL عمومی هر صفحه وب که فقط به موضوع اختصاص داده شده است. این می تواند شامل وب سایت های رسمی، دیسک ها، پلت فرم های رسانه های اجتماعی، صفحات ویکی پدیا یا imdb باشد، به عنوان مثال https://www.discogs.com/artist/1124645-Taylor-Swift ، https://www.wikidata.org/wiki/Q19320959 ، https://twitter.com/acmilan . (اختیاری) |
musicbrainz_ id | شناسه 36 کاراکتری musicbrainz هنرمند یا سایر نهادهای موسیقی، در صورت وجود. به https://musicbrainz.org/doc/MusicBrainz_Identifier مراجعه کنید. (اختیاری) |
محدوده زمانی
یک محدوده زمانی بسته-باز، یعنی [زمان_شروع، زمان_پایان).
فیلدها | |
---|---|
start_ time | حد پایین محدوده زمانی. |
end_ time | حد بالایی محدوده زمانی. |
TokenizationConfig
پیکربندی برای توکن سازی پردازشگر پرداخت که بر اساس هر بازرگان تنظیم شده است.
فیلدها | |
---|---|
tokenization_ parameter | یک پیکربندی توکنسازی معمولاً یک پارامتر tokenization_ دارد که کلید آن "دروازه" و مقدار آن نام پردازنده است. بقیه پارامترها به پردازنده بستگی دارد. برای اطلاعات بیشتر به اسناد Google Pay مراجعه کنید. نمونه Braintree: 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" مقدار: "production_xxx_yyy" } مثال خطی: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" } مثال Adyen: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" } |
billing_ information_ format | اطلاعات صورتحساب کاربر را که با FOP در Google Pay وارد شده است، در رمز پرداخت قرار دهید (به بالا مراجعه کنید). خالی گذاشتن فیلد معادل تعیین MIN است. |
BillingInformationFormat
چه مقدار از آدرس صورتحساب را از کاربر میخواهد و در توکن لحاظ میکند. مقادیر enum مربوط به پارامترهای موجود در Google Pay API هستند (به https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters مراجعه کنید) .
Enums | |
---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED | مشخص نشده است. پیشفرض MIN است. |
MIN | نام، کد کشور و کد پستی (تنظیم پیشفرض Google Pay). |
FULL | نام، آدرس خیابان، محل، منطقه، کد کشور و کد پستی. |
محتوای تورها و فعالیت ها
فیلدهای محتوای خاص تورها و فعالیت ها. هر عنصر در فیلد تکراری باید مستقل باشد تا امکان رندر جداگانه (مثلاً به عنوان نقطه گلوله) فراهم شود.
پر کردن محتوای تورها و فعالیتها به شدت برای تورها و فعالیتها توصیه میشود، اما اکیداً الزامی نیست. همه فیلدها از متن ساده و HTML مانند برای قالب بندی اولیه پشتیبانی می کنند. برچسبهای قالببندی HTML پشتیبانی شده:
برچسب های عبارت:
, , , : فقط سه تگ ذکر شده در بالا پشتیبانی می شوند.
می تواند برای شکستن خطوط در پاراگراف ها استفاده شود و // می تواند برای برجسته کردن یک متن مهم استفاده شود. هر برچسب عبارت دیگری نادیده گرفته می شود.
سایر برچسب ها و سبک های سفارشی مجاز نیستند و حذف خواهند شد. URL ها، لنگرها و پیوندها حذف می شوند و هرگز به کاربران نهایی نمایش داده نمی شوند.
نکات مهم: * داده های ارائه شده در highlights
، exclusion
و سایر فیلدهای خاص تر در توضیحات سرویس را تکرار نکنید. * از استفاده از برچسب های دیگر به جز موارد پشتیبانی شده ذکر شده در بالا خودداری کنید، زیرا محتویات داخل برچسب های پشتیبانی نشده پاک می شوند و ممکن است منجر به تجربه کاربری نامطلوب شوند.
فیلدها | |
---|---|
highlights[] | لیست قابل مشاهده برای کاربر از نکات برجسته. |
inclusions[] | فهرست مشمولان قابل مشاهده برای کاربر. |
exclusions[] | فهرست استثنائات قابل مشاهده برای کاربر. |
must_ know[] | فهرست یادداشتهای مهم قابل مشاهده برای کاربر، برای جزئیاتی مانند محدودیتهای سنی یا سایر شرایطی که این سرویس را نامناسب میکند، استفاده کنید. |
UnsupportedPartySizeOption
گزینه هایی برای مهمانی هایی که خارج از محدوده هستند.
فیلدها | |
---|---|
kind میدان اتحادیه . گزینه های موجود برای مهمانی هایی که خارج از محدوده هستند. kind می تواند تنها یکی از موارد زیر باشد: | |
call_ merchant | اندازه مهمانی هایی که خارج از محدوده هستند می توانند با کسب و کار تماس بگیرند. یک پیام از پیش تعریف شده برای کاربر نمایش داده می شود. نمونه متنی که باید نمایش داده شود: "برای مهمانی های بزرگتر از {waitlist_rules.max_party_size} لطفاً با شماره {phone} با رستوران تماس بگیرید." CallMerchant باید تنظیم شود، اما خالی خواهد بود. |
UpdateAdsAccountLinkRequest
درخواست پیام برای AdsAccountLinkingService.UpdateAdsAccountLink.
فیلدها | |
---|---|
ads_ account_ link | مورد نیاز. پیوند حساب Ads برای بهروزرسانی. فیلد |
update_ mask | اختیاری. لیست فیلدهایی که باید به روز شوند. |
UpdateBooking Request
درخواست به روز رسانی google.maps.booking.v1alpha.Booking
فیلدها | |
---|---|
update_ mask | ماسک فیلد تمام فیلدهای رزرو به روز رسانی می شود |
booking | رزرو به روز رسانی شود |
booking_ failure | اگر پردازش درخواست رزرو تایید شده ناهمزمان با شکست مواجه شد و وضعیت رزرو در حال بهروزرسانی به FAILED باشد، این قسمت باید خطای منطق تجاری را نشان دهد (به عنوان مثال، کاربر رزرو موجود را بسیار نزدیک به این زمان دارد). این فیلد فقط باید هنگام بهروزرسانی وضعیت رزرو به FAILED تنظیم شود و در غیر این صورت نادیده گرفته میشود. |
UpdateMerchantRequest
درخواست بهروزرسانی یک Merchant
.
فیلدها | |
---|---|
merchant | داده های تجاری جدید |
update_ mask | فیلدهای خاص برای به روز رسانی برای تاجر. |
UpdateOrderRequest
درخواست به روز رسانی google.maps.booking.v1alpha.Order
فیلدها | |
---|---|
update_ mask | ماسک فیلد تمام فیلدهای سفارش به روز می شود |
order | سفارش به روز رسانی شود |
UpdateServiceRequest
درخواست به روز رسانی یک Service
فیلدها | |
---|---|
service | داده های سرویس جدید |
update_ mask | فیلدهای خاص برای به روز رسانی برای سرویس. |
UriTemplate
الگویی که مشخص می کند گوگل چگونه باید URL های سایت خارجی را تولید کند.
فیلدها | |
---|---|
uri_ template | اختیاری. الگوی uri باید از RFC6570 پیروی کند، به https://datatracker.ietf.org/doc/html/rfc6570 مراجعه کنید. از قالب های سطح 2 پشتیبانی می کند. این پارامترها به مقادیر مشخص شده در موجودیت مربوطه خود حل می شوند. 5 پارامتر موجود برای پیوند رزرو غذا: 1) (الزامی) {availability_slot_start_seconds} :: پر شده از قسمت start_sec در فید در دسترس بودن 2) (الزامی) {availability_slot_duration_seconds} :: پر شده از duration_sec فیلد در دسترس بودن :: پر شده از قسمت party_size در فید در دسترس بودن 4) (اختیاری) {availability_availability_tag} :: پر شده از قسمت availability_tag در فید در دسترس بودن 5) (اختیاری) {resources_room_id} :: پر شده از قسمت room_id در فید در دسترس بودن مثال استفاده: 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=2123345art ? |
UserPurchaseRestriction
کاربران واجد شرایط خرید گزینه پرداخت را محدود می کند.
فیلدها | |
---|---|
new_ to_ merchant | یک گزینه پرداخت که فقط توسط کاربرانی قابل خرید است که قبلاً هرگز از یک تاجر خرید نکردهاند. |
new_ to_ payment_ option | یک گزینه پرداخت که فقط توسط کاربرانی قابل خرید است که قبلاً گزینه پرداخت مشابهی را خریداری نکرده اند. |
جلسه مجازی
اطلاعات در مورد جلسه مجازی/آنلاین. به عنوان مثال کلاس یوگا آنلاین، کلاس آشپزی مجازی و غیره.
فیلدها | |
---|---|
session_ instructions | دستورالعمل نحوه راه اندازی این کلاس مجازی. اگر شریک نشانی وب ویدیو را با رزرو وارد نکرده باشد، این متن باید شامل زمانی باشد که URL ویدیو با کاربر به اشتراک گذاشته میشود. به عنوان مثال "URL بزرگنمایی 30 دقیقه قبل از کلاس پست می شود." (توصیه می شود) |
session_ requirements | الزامات جلسه مجازی داده شده به عنوان مثال تشک یوگا، ظروف پخت و پز و غیره (توصیه می شود) |
virtual_ platform_ info | اطلاعاتی در مورد بستر مجازی مورد استفاده در این جلسه. (برای فعال کردن خدمات مجازی لازم است) |
is_ session_ prerecorded | مورد نیاز. اگر جلسه مجازی زنده نیست و از قبل ضبط شده است، این را درست تنظیم کنید. |
VirtualPlatformInfo
اطلاعاتی در مورد پلتفرمی که برای این جلسه مجازی استفاده خواهد شد.
فیلدها | |
---|---|
platform | پلتفرم مورد استفاده برای جلسه مجازی |
other_ platform_ name | نام پلتفرم اگر پلتفرم روی OTHER تنظیم شده باشد. (اگر پلتفرم روی OTHER تنظیم شده باشد، الزامی است) |
پلت فرم
Enum برای نشان دادن اینکه کدام پلتفرم مجازی توسط تاجر استفاده می شود.
Enums | |
---|---|
PLATFORM_UNSPECIFIED | استفاده نشده |
FLEXIBLE | تاجر انعطاف پذیر است که در کدام پلتفرم ویدیویی استفاده می کند. |
GOOGLE_HANGOUTS | محصول Google Hangouts. |
GOOGLE_MEET | محصول Google Meet. |
ZOOM | ارتباطات ویدئویی زوم. |
SKYPE | اسکایپ. |
YOUTUBE | پخش زنده در یوتیوب. |
OTHER | اگر پلتفرم ویدیویی استفاده شده با موارد ذکر شده در اینجا متفاوت باشد، باید تنظیم شود. |
قوانین فهرست انتظار
قوانین مربوط به پیوستن به لیست انتظار.
فیلدها | |
---|---|
min_ party_ size | مورد نیاز. باید یک عدد صحیح مثبت برای خدمات ارائه دهنده عملکرد لیست انتظار باشد. اگر سرویس یا تاجر عملکرد لیست انتظار را ارائه نمیکند، این نباید پر شود. |
max_ party_ size | مورد نیاز. باید یک عدد صحیح مثبت برای خدمات ارائه دهنده عملکرد لیست انتظار باشد. اگر سرویس یا تاجر عملکرد لیست انتظار را ارائه نمیکند، این نباید پر شود. |
supports_ additional_ request | اگر درست باشد، کاربر میتواند هنگام پیوستن به فهرست انتظار برای این سرویس، یک درخواست متن اضافی به صورت رایگان ارسال کند. |
above_ max_ party_ size_ options[] | گزینههایی را برای مهمانیهای بزرگتر از مجموعه max_party_size تنظیم کنید. اگر نباید گزینه های جایگزین برای پیوستن به لیست انتظار به مهمانان بزرگتر داده شود، خالی بگذارید. |