Package google.maps.booking.v1alpha

شاخص

AdsAccountLinkingService

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

اطلاعیه رزرو

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

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

rpc UpdateBooking( UpdateBookingRequest ) returns ( Booking )

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

محدوده مجوز

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

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

rpc UpdateOrder( UpdateOrderRequest ) returns ( Order )

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

محدوده مجوز

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

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

خوراک

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

GetStatus

rpc GetStatus( GetStatusRequest ) returns ( FeedStatus )

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

محدوده مجوز

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

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

rpc ListStatus( ListStatusRequest ) returns ( ListStatusResponse )

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

محدوده مجوز

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

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

Invalidation Service

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

InvalidateResource

rpc InvalidateResource( InvalidateResourceRequest ) returns ( Empty )

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

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

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

محدوده مجوز

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

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

وضعیت موجودی

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

GetMerchantStatus

rpc GetMerchantStatus( GetMerchantStatusRequest ) returns ( MerchantStatus )

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

محدوده مجوز

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

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

rpc ListMerchantStatuses( ListMerchantStatusesRequest ) returns ( ListMerchantStatusesResponse )

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

محدوده مجوز

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

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

InventoryUpdate

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

BatchDeleteGenericRecords

rpc BatchDeleteGenericRecords( BatchDeleteGenericRecordsRequest ) returns ( Empty )

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

محدوده مجوز

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

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

rpc BatchPushGenericRecord( BatchPushGenericRecordRequest ) returns ( Empty )

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

محدوده مجوز

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

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

rpc BatchReplaceServiceAvailability( BatchReplaceServiceAvailabilityRequest ) returns ( BatchReplaceServiceAvailabilityResponse )

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

محدوده مجوز

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

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

rpc CreateMerchant( CreateMerchantRequest ) returns ( Merchant )

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

محدوده مجوز

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

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

rpc CreateService( CreateServiceRequest ) returns ( Service )

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

محدوده مجوز

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

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

rpc DeleteMerchant( DeleteMerchantRequest ) returns ( Empty )

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

محدوده مجوز

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

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

rpc DeleteService( DeleteServiceRequest ) returns ( Empty )

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

محدوده مجوز

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

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

rpc ReplaceServiceAvailability( ReplaceServiceAvailabilityRequest ) returns ( ServiceAvailability )

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

محدوده مجوز

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

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

rpc UpdateMerchant( UpdateMerchantRequest ) returns ( Merchant )

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

محدوده مجوز

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

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

rpc UpdateService( UpdateServiceRequest ) returns ( Service )

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

محدوده مجوز

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

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

ActionLinkType

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

Enums

رویداد Metadata

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

فیلدها
surface

Surface

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

سطح

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

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

ActionPlatform

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

Enums
ACTION_PLATFORM_UNSPECIFIED پلت فرم نامشخص است.
ACTION_PLATFORM_WEB_APPLICATION پلتفرم اکشن به طور کلی وب است.
ACTION_PLATFORM_MOBILE_WEB پلت فرم اکشن وب روی دستگاه های تلفن همراه است.
ACTION_PLATFORM_ANDROID پلتفرم اکشن سیستم عامل اندروید است.
ACTION_PLATFORM_IOS پلتفرم اکشن iOS است.

ایالت

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

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

نصیحت

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

فیلدها
text

Text

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

در دسترس بودن

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

فیلدها
start_ time

Timestamp

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

duration

Duration

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

spots_ total

int64

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

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

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

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

int64

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

availability_ tag

string

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

resources

Resources

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

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

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

string

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

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

recurrence

Recurrence

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

schedule_ exception[]

ScheduleException

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

deposit

Deposit

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

no_ show_ fee

NoShowFee

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

prepayment

Prepayment

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

require_ credit_ card

RequireCreditCard

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

ticket_ type_ id[]

string

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

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

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

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

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

(اختیاری)

duration_ requirement

DurationRequirement

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

scheduling_ rule_ overrides

SchedulingRuleOverrides

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

confirmation_ mode

ConfirmationMode

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

linkout_ required_ reason

LinkoutRequiredReason

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

ConfirmationMode

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

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

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

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

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

LinkoutRequiredReason

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

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

عود

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

الزامات:

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

Timestamp

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

repeat_ every

Duration

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

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

ScheduleException

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

فیلدها
time_ range

TimeRange

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

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

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

SchedulingRuleOverrides

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

فیلدها
last_ bookable_ sec

int64

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

first_ bookable_ sec

int64

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

last_ online_ cancellable_ sec

int64

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

BatchDeleteGenericRecordsRequest

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

فیلدها
parent

string

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

records[]

GenericDeleteRecord

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

درخواست BatchPushGenericRecord

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

فیلدها
parent

string

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

records[]

GenericRecord

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

BatchReplaceServiceAvailability Request

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

فیلدها
parent

string

قالب partners/{partner_id} .

extended_ service_ availability[]

ExtendedServiceAvailability

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

BatchReplaceServiceAvailabilityResponse

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

فیلدها
extended_ service_ availability[]

ExtendedServiceAvailability

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

رزرو

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

فیلدها
name

string

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

merchant_ id

string

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

service_ id

string

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

start_ time

Timestamp

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

duration

Duration

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

client_ information

ClientInformation

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

status

BookingStatus

وضعیت رزرو

payment_ information

PaymentInformation

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

party_ size

int64

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

رزرو شکست

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

فیلدها
cause

Cause

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

rejected_ card_ type

CreditCardType

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

description

string

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

payment_ failure

PaymentFailureInformation

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

علت

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

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

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

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

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

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

فیلدها
threeds1_ parameters

ThreeDS1Parameters

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

ThreeDS1Parameters

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

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

فیلدها
acs_ url

string

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

pa_ req

string

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

transaction_ id

string

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

md_ merchant_ data

string

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

وضعیت رزرو

وضعیت یک رزرو

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

Call Merchant

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

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

سیاست لغو

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

فیلدها
refund_ condition[]

RefundCondition

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

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

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

فیلدها
min_ duration_ before_ start_ time

Duration

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

refund_ percent

uint32

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

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

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

فیلدها
given_ name

string

نام مشتری

family_ name

string

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

address

PostalAddress

آدرس مشتری

telephone

string

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

email

string

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

CreateAdsAccountLinkRequest

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

فیلدها
parent

string

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

ایجاد MerchantRequest

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

فیلدها
parent

string

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

merchant_ id

string

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

merchant

Merchant

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

CreateServiceRequest

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

فیلدها
parent

string

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

service_ id

string

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

service

Service

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

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

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

فیلدها
credit_ card_ type[]

CreditCardType

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

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

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

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

DeleteAdsAccountLinkRequest

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

فیلدها
name

string

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

حذف MerchantRequest

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

فیلدها
name

string

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

DeleteServiceRequest

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

فیلدها
name

string

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

سپرده گذاری

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

فیلدها
deposit

Price

مبلغ سپرده.

min_ advance_ cancellation_ sec

int64

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

deposit_ type

PriceType

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

DirectMerchantPayment

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

فیلدها
payment_ methods[]

Text

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

محدوده مدت

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

فیلدها
min_ duration

Duration

حداقل مدت.

max_ duration

Duration

حداکثر مدت.

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

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

فیلدها
text

Text

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

ExtendedServiceAvailability

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

فیلدها
merchant_ id

string

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

service_ id

string

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

start_ time_ restrict

Timestamp

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

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

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

  availability.duration == duration_restrict

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

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

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

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

end_ time_ restrict

Timestamp

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

duration_ restrict

Duration

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

resources_ restrict

Resources

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

availability[]

Availability

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

FeedStatistics

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

فیلدها
new_ items

int64

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

existing_ items

int64

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

deleted_ items

int64

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

وضعیت فید

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

فیلدها
name

string

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

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

State

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

error_ details

string

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

statistics

FeedStatistics

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

ایالت

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

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

Food OrderingMetadata

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

فیلدها
fee_ details[]

FeeDetails

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

advance_ order_ details

AdvanceOrderDetails

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

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

Duration

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

fulfillment_ lead_ time_ duration_ range

DurationRange

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

AdvanceOrderDetails

برای سفارش از قبل پشتیبانی

فیلدها
is_ supported

bool

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

FeeDetails

جزئیات هزینه

فیلدها
type

FeeType

نوع کارمزد (الزامی)

fee_ amount

FeeAmount

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

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

QuantitativeValue

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

amount_options فیلد اتحادیه. گزینه هایی برای تعیین مقدار پولی amount_options فقط می تواند یکی از موارد زیر باشد:
amount

Money

مبلغ ثابت به عنوان مثال USD 3.5.

amount_ range

MoneyRange

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

amount_ unknown

bool

مقدار نامعلوم

FeeType

نوع کارمزد

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

FulfillmentOption

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

فیلدها
fulfillment_ type

FulfillmentType

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

available_ day[]

AvailableDay

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

fee_ details

FeeDetails

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

minimum_ order

Price

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

روز در دسترس

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

فیلدها
fulfillment_ date

Date

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

last_ ordering_ time

Timestamp

مورد نیاز. مهر زمانی یونیکس آخرین باری که کاربر می‌توانست سفارش دهد و اقلام را تا 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

NoFee

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

base_ fee

MinimumFee

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

fixed_ fee

FixedFee

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

فیکس فیکس

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

فیلدها
amount

Price

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

نوع تحقق

نوع انجام مرتبط با پیوند اقدام.

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

حداقل هزینه

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

فیلدها
base_ fee_ amount

Price

مورد نیاز. مبلغ کارمزد پایه برای روش انجام.

NoFee

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

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

GenericDeleteRecord

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

فیلدها
delete_ time

Timestamp

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

record_type فیلد اتحادیه. کپسوله کردن انواع مختلف فید (ndjson، مبتنی بر پروتو، و غیره) شریک می تواند یک رکورد کامل مشابه نحوه ارائه یک رکورد در یک فید یا BatchPush API ارائه دهد. شرکا همچنین این گزینه را دارند که فقط فیلدهای ضروری یک رکورد را که برای شناسایی منحصربفرد آن لازم است، لحاظ کنند. record_type تنها می تواند یکی از موارد زیر باشد:
data_ record

bytes

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

proto_ record

Any

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

GenericRecord

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

فیلدها
generation_ timestamp

Timestamp

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

record_type فیلد اتحادیه. کپسوله کردن انواع مختلف فید (ndjson، مبتنی بر پروتو، و غیره) record_type تنها می تواند یکی از موارد زیر باشد:
data_ record

bytes

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

proto_ record

Any

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

مختصات جغرافیایی

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

فیلدها
latitude

double

عرض جغرافیایی بر حسب درجه (اختیاری)

longitude

double

طول جغرافیایی بر حسب درجه (اختیاری)

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

PostalAddress

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

unstructured_ address

string

یک آدرس بدون ساختار نیز می تواند به عنوان یک بازگشت ارائه شود. به عنوان مثال "1600 amphitheatre parkway view mountain, ca 94043"

GetAdsAccountLinkRequest

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

فیلدها
name

string

مورد نیاز. نام پیوند حساب Ads برای بازیابی. قالب: partners/{partner}/adsAccountLinks/{ads_account_link}

GetMerchantStatusRequest

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

فیلدها
name

string

مورد نیاز. نام منبع، در قالب شرکا/{partner_id}/merchants/{merchant_id}/status.

GetStatusRequest

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

فیلدها
name

string

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

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

HomeServiceData

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

فیلدها
category_ type

string

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

job_ type

string

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

IntegrationType

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

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

InvalidateResourceRequest

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

فیلدها
resource_ id

string

نام منبعی که باید باطل شود.

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

آیتم خط

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

فیلدها
service_ id

string

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

start_ sec

int64

زمان شروع شکاف قرار بر حسب ثانیه از زمان UTC از زمان یونیکس.

duration_ sec

int64

مدت زمان قرار ملاقات بر حسب ثانیه.

tickets[]

OrderedTickets

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

price

Price

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

status

BookingStatus

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

بلیط های سفارش داده شده

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

فیلدها
ticket_ id

string

شناسه یک نوع بلیط

count

int32

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

ListMerchantStatusesRequest

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

فیلدها
parent

string

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

page_ size

int32

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

page_ token

string

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

booking_ inventory_ status_ restrict

BookingInventoryStatus

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

waitlist_ inventory_ status_ restrict

WaitlistInventoryStatus

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

geo_ match_ restrict

GeoMatchingStatus

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

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[]

MerchantStatus

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

next_ page_ token

string

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

ListStatusRequest

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

فیلدها
name

string

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

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

int32

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

page_ token

string

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

state_ restrict

State

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

time_ range_ restrict

TimeRange

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

ListStatusResponse

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

فیلدها
status[]

FeedStatus

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

next_ page_ token

string

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

LocalizedString

نمونه ای از یک رشته در یک منطقه.

فیلدها
locale

string

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

value

string

پیام در منطقه بالا (UTF-8).

مکان

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

فیلدها
place_ id

string

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

name

string

نام مکان، تلفن، آدرس اینترنتی و جغرافیایی برای پشتیبانی از تطبیق مکان با مکان‌هایی که قبلاً در Google Maps وجود دارد استفاده می‌شود.

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

telephone

string

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

url

string

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

geo

GeoCoordinates

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

location_ type

LocationType

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

location_ id

string

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

نوع مکان

نوع این مکان.

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

بازرگان

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

فیلدها
name

string

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

merchant_ name

string

merchant_name، telephone، url و geo برای پشتیبانی از موجودی شریک منطبق با تاجرانی که قبلاً در Google Maps حضور دارند استفاده می‌شود. این اطلاعات نمایش داده نخواهد شد.

نام تاجر.

telephone

string

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

url

string

آدرس وب سایت عمومی تاجر.

geo

GeoCoordinates

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

category

string

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

num_bookings_30d
(deprecated)

int64

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

tax_rate_basis_points
(deprecated)

uint32

نرخ مالیات تاجر بر حسب واحد پایه (یک صدم درصد). مثلاً اگر نرخ مالیات 7.5 درصد باشد، این فیلد باید 750 باشد.

اگر این قسمت تنظیم نشده باقی بماند یا روی 0 تنظیم شود، کل قیمتی که برای هر سرویس ارائه شده توسط این تاجر از کاربر دریافت می‌شود، دقیقاً قیمتی است که توسط Service.price مشخص شده است. فرض می شود که قیمت خدمات از مالیات های قابل اعمال معاف است یا از قبل شامل آن می شود. مالیات ها به عنوان یک خط جداگانه به کاربر نشان داده نمی شود.

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

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

tax_ rate

TaxRate

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

payment_ restrictions

PaymentRestrictions

محدودیت‌هایی برای روش‌های پرداختی که این تاجر می‌پذیرد. اگر این فیلد تنظیم نشده باشد، فرض می کنیم که هیچ محدودیتی وجود ندارد.

payment_ option[]

PaymentOption

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

payment_processor_config
(deprecated)

PaymentProcessorConfig

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

tokenization_ config

TokenizationConfig

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

terms

Terms

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

brand_ id

string

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

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

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

اگر شریک ...

آیا برندهای متعددی برای مصرف کننده ندارید؟ --> این فیلد را نادیده بگیرید

آیا چندین برند پیکربندی شده است؟

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

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

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

matching_ hints

MerchantMatchingHints

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

service_ attribute[]

ServiceAttribute

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

waitlist_ advisement

Advisement

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

economic_ operator

EconomicOperator

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

MerchantMatchingHints

نکات مورد استفاده برای کمک به Google برای مطابقت دادن یک تاجر با مکانی در Google Maps.

فیلدها
place_ id

string

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

وضعیت فروشنده

وضعیت یک تاجر در پلتفرم Reserve with Google.

فیلدها
name

string

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

merchant_ name

string

نام تاجر ارائه شده توسط شرکا.

input_ geo_ info

GeoCoordinates

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

processing_ status

ProcessingStatus

وضعیت پردازش تاجر

booking_ status

BookingStatus

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

waitlist_ status

WaitlistStatus

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

geo_ match

PlaceInfo

مکان جغرافیایی این تاجر مطابقت دارد. در صورتی که تاجر با Geo مطابقت نداشته باشد، خالی است.

local_ services_ match

LocalServicesMatchInfo

خدمات محلی مطابقت این تاجر. اگر تاجر خدمات محلی نیست یا با هیچ ارائه‌دهنده‌ای مطابقت ندارد، خالی است.

direct_ urls[]

DirectUrl

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

وضعیت رزرو

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

فیلدها
has_ valid_ future_ inventory

bool

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

DirectUrl

URL که روی تاجر ظاهر می شود.

فیلدها
type

UrlType

این URL را تایپ کنید.

url

string

نشانی اینترنتی که ممکن است در این تاجر ظاهر شود.

UrlType

نوع URL ظاهری.

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

LocalServicesMatchInfo

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

فیلدها
matched_ providers[]

MatchedProvider

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

MatchedProvider

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

فیلدها
customer_ id

int64

شناسه مشتری خارجی خدمات محلی Google.

categories[]

string

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

PlaceInfo

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

فیلدها
name

string

نام مکان.

formatted_ address

string

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

place_ id

string

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

وضعیت پردازش

وضعیت پردازش تاجر

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

وضعیت لیست انتظار

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

فیلدها
has_ valid_ waitlist_ service

bool

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

Money Range

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

فیلدها
min_ amount

Money

حداقل مقدار.

max_ amount

Money

حداکثر مقدار.

NoShowFee

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

فیلدها
fee

Price

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

fee_ type

PriceType

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

سفارش دهید

سفارش قرار ملاقات با یک تاجر.

فیلدها
name

string

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

client_ information

ClientInformation

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

payment_ information

PaymentInformation

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

merchant_ id

string

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

item[]

LineItem

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

OrderOnline Metadata

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

فیلدها
fulfillment_ option[]

FulfillmentOption

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

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

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

فیلدها
prepayment_ status

PrepaymentStatus

وضعیت پیش پرداخت رزرو. اگر وضعیت prepayment PREPAYMENT_PROVIDED یا PREPAYMENT_REFUNDED باشد، pay_transaction_id حاوی شناسه تراکنش منحصر به فرد مرتبط است.

payment_ transaction_ id

string

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

گزینه پرداخت

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

فیلدها
payment_ option_ id

string

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

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

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

name

string

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

description

string

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

price

Price

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

tax_ rate

TaxRate

نرخ مالیات برای این گزینه پرداخت. اگر این فیلد وجود داشته باشد، فیلد tax_rate موجود در Merchant یا Service را لغو می‌کند. یک پیام خالی (یعنی tax_rate { }) نرخ مالیات اعمال شده را به صفر بازنشانی می کند.

payment_ option_ type

PaymentOptionType

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

session_ count

int64

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

purchase_ interval

TimeRange

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

valid_ interval

TimeRange

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

valid_ duration

Duration

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

activation_ type

ActivationType

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

user_ restriction

UserPurchaseRestriction

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

نوع فعال سازی

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

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

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

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

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

PaymentProcessorConfig

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

فیلدها
processor

Processor

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

public_ key

string

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

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

version

string

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

پردازنده

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

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

محدودیت های پرداخت

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

فیلدها
credit_ card_ restrictions

CreditCardRestrictions

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

PerOrderFee

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

فیلدها
delivery_ fee

Price

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

processing_ fee

Price

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

هزینه بلیط

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

فیلدها
service_ charge

Price

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

facility_ fee

Price

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

taxes

Price

به ازای مالیات بلیط

آدرس پستی

آدرس یک مشتری یا یک کسب و کار.

فیلدها
address_ country

string

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

address_ locality

string

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

address_ region

string

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

postal_ code

string

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

street_ address

string

آدرس خیابان، به عنوان مثال "1600 Amphitheatre Pkwy". (الزامی)

پیش پرداخت

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

فیلدها
price_ info

PriceInfo

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

وضعیت پیش پرداخت

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

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

قیمت

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

فیلدها
price_ micros

int64

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

currency_ code

string

واحد پول قیمتی که در ISO 4217 تعریف شده است.

pricing_ option_ tag

string

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

اطلاعات قیمت

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

فیلدها
price_ type

PriceType

نحوه اعمال قیمت یا محدوده قیمت (به ازای هر نفر یا ثابت) را مشخص می کند.

price_options فیلد اتحادیه . گزینه های قیمت این است که یا قیمت دقیق یا محدوده را مشخص کنید. price_options فقط می تواند یکی از موارد زیر باشد:
price

Price

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

price_ range

PriceRange

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

تفسیر قیمت

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

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

Price

حداقل مقدار.

max_ price

Price

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

نوع قیمت

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

Enums
FIXED_RATE_DEFAULT

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

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

PER_PERSON

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

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

مقدار کمی

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

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

double

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

value_ range

RangeValue

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

RangeValue

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

فیلدها
min_ value

double

حداقل ارزش.

max_ value

double

حداکثر مقدار

رتبه بندی

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

فیلدها
value

double

میانگین ارزش رتبه‌بندی (الزامی زمانی که number_of_ratings > 0 باشد). مقدار باید در محدوده [1، 5] باشد و اگر و فقط اگر تعداد_رتبه‌بندی‌ها صفر باشد می‌توان آن را حذف کرد.

number_ of_ ratings

uint64

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

رسانه های مرتبط

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

فیلدها
url

string

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

type

MediaType

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

localized_ caption

Text

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

attribution

Attribution

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

caption
(deprecated)

string

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

انتساب

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

فیلدها
localized_ text

Text

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

text
(deprecated)

string

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

MediaType

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

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

ReplaceServiceAvailabilityRequest

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

فیلدها
service_ availability

ServiceAvailability

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

RequireCreditCard

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

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

منابع

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

فیلدها
staff_ id

string

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

staff_ name

string

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

room_ id

string

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

room_ name

string

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

party_ size

int32

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

room_ description

Text

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

قوانین زمانبندی

قوانین زمانبندی برای یک سرویس

فیلدها
min_ advance_ online_ canceling

int64

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

late_cancellation_fee
(deprecated)

Price

هزینه انصراف در حداقل دوره اطلاع قبلی.

noshow_fee
(deprecated)

Price

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

admission_ policy

AdmissionPolicy

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

cancellation_ policy

CancellationPolicy

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

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

اگر "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" در صورت تنظیم باید مثبت باشد. اگر هر دو تنظیم نشده باشند، اسلات تا زمان شروع اسلات قابل رزرو است. اگر هر دو فیلد تنظیم شده باشند، فقط یک مقدار انتخاب می شود در حالی که مقدار دیگر نادیده گرفته می شود - ما نمی توانیم به طور قابل اعتماد پیش بینی کنیم که کدام مقدار انتخاب شده است.

مثال ها:

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

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

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

min_ advance_ booking

int64

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

min_ booking_ buffer_ before_ end_ time

int64

مدت زمان (بر حسب ثانیه) از زمانی که می توان آخرین رزرو را انجام داد تا زمانی که شکاف دسترسی به پایان می رسد. اگر این فیلد تنظیم شده باشد، قسمت "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

string

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

service_ name

string

نام سرویس، به عنوان مثال "مدل موی مردانه". منسوخ شده است، به جای آن از localized_service_name استفاده کنید.

localized_ service_ name

Text

نام سرویس، به عنوان مثال "مدل موی مردانه". احتمالاً در چندین منطقه.

description

string

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

localized_ description

Text

شرح خدمات قابل مشاهده توسط کاربر.

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

برچسب‌های قالب‌بندی HTML پشتیبانی شده:

تگ های عنوان: <h1>، <h2>، <h3>، <h4>، <h5>، <h6>
از تگ های عنوان می توان برای نمایش عناوین و عنوان های فرعی استفاده کرد. به عنوان مثال، <h1> سفرنامه</h1> متن درون خطی را به عنوان مهمترین عنوان بخش نمایش می دهد. توجه داشته باشید که هر تگ، سبک یا ویژگی داخلی HTML نادیده گرفته خواهد شد. برای مثال، <h1 style=".."> مانند <h1> رفتار خواهد شد. فقط متن خالص حفظ خواهد شد.

برچسب پاراگراف: <p>
از تگ پاراگراف می توان برای برجسته کردن یک مقدمه یا مطالب دقیق استفاده کرد. هر تگ داخلی، سبک یا ویژگی نادیده گرفته می شود، به استثنای چند مورد: <br>، <strong> و <em>. لطفاً برای جزئیات بیشتر قسمت برچسب عبارت زیر را ببینید.

برچسب های لیست: <ul>، <ol>، <li>
تگ <ul> را می توان با تگ <li> برای نمایش لیست های نامرتب و تگ <ol> را می توان با <li> برای نمایش لیست های مرتب استفاده کرد. این یک راه خوب برای نمایش چک لیست ها، برنامه ها، یا هر لیست دیگری است که متناسب با موارد استفاده شما باشد.
مثال: برای نمایش لیستی از ویژگی های یک سفر دریایی:
<ol>
<li>منظره شگفت انگیز اقیانوس و شانس بازی با حیات وحش.</li>
<li>تدارکات و خدمات سفر با دقت طراحی شده است.</li>
<li>تضمین کمترین قیمت.</li>
</ol>
توجه داشته باشید که فقط کودکان <li> تحت تگ های <ul> یا <ol> تبدیل خواهند شد. همه بچه های دیگر کنار گذاشته می شوند. همچنین، هر تگ داخلی، ویژگی و سبک نادیده گرفته خواهد شد. ما فقط محتوای متن خالص را حفظ می کنیم.

تگ تقسیم: <div>
همه تگ های داخلی پشتیبانی شده تگ <div> با قوانین ذکر شده در بالا تجزیه می شوند، به این معنی که تگ <div> به خودی خود به معنای گروه بندی یا تورفتگی در اینجا نیست. همچنین، هر گونه ویژگی و سبک درونی نادیده گرفته خواهد شد.

برچسب‌های عبارت: <br>، <strong>، <em>:
فقط سه تگ ذکر شده در بالا پشتیبانی می شوند. <br> می تواند برای شکستن خطوط در پاراگراف ها و <strong>/<em> برای برجسته کردن متن مهم استفاده شود. هر برچسب عبارت دیگری نادیده گرفته می شود.

برچسب های پشتیبانی نشده:

  • تگ های <html>، <header> و <body> مجاز نیستند.
  • هر برچسب دیگری که در بالا ذکر نشده است پشتیبانی نمی شود (به عنوان مثال <table>، <td> ...).
    URL ها، لنگرها و پیوندها حذف می شوند و هرگز به کاربران نهایی نمایش داده نمی شوند. اگر می‌خواهید از عکس‌ها برای ایجاد یک تجربه کاربری غنی استفاده کنید، لطفاً از فیلد "related_media" زیر برای ارسال URL عکس‌های خود استفاده کنید.

نکات مهم:

  • سعی کنید از تگ های دیگر به جز موارد پشتیبانی شده ذکر شده در بالا استفاده نکنید، زیرا محتویات داخل برچسب های پشتیبانی نشده پاک می شوند و ممکن است منجر به تجربه کاربری نامطلوب شوند.
  • سعی کنید از ساختارهای تودرتو عمیق مانند بیش از 3 سطح سرفصل مختلف یا لیست های تودرتو اجتناب کنید. صاف، ساده و سرراست نگه داشتن ساختار به ایجاد تجربه کاربری بهتر کمک می کند.
  • اگر طرح‌بندی‌های پشتیبانی‌شده در حال حاضر برای موارد استفاده شما کافی نیست، لطفاً با تیم رزرو با Google تماس بگیرید.
  • حداکثر اندازه توصیه شده 32000 کاراکتر است.
price

Price

قیمت خدمات.

price_ interpretation

PriceInterpretation

نحوه تفسیر و نمایش قیمت به کاربر را شرح می دهد. می تواند توسط هر عمودی به جز Dining و Things To Do برای پیکربندی نمایش قیمت خدمات استفاده شود.

rules

SchedulingRules

قوانین رزرو/لغو قرار ملاقات

prepayment_ type

PrepaymentType

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

prepayment_ terms

PrepaymentTerms

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

form[]
(deprecated)

ServiceIntakeForm

منسوخ شده است. لطفاً از intake_form و per_ticket_intake_form استفاده کنید.

intake_ form

ServiceIntakeForm

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

per_ ticket_ intake_ form

ServiceIntakeForm

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

tax_ rate

TaxRate

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

payment_ option_ id[]

string

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

deposit

Deposit

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

no_ show_ fee

NoShowFee

هزینه عدم نمایش را تعریف می کند که ممکن است از کاربر دریافت شود. در صورتی که مشخص شده بود، سرویس بدون هزینه نمایش را لغو می کند. تنظیم این پیام بر روی یک پیام NoShowFee خالی، هزینه بدون نمایش در سطح سرویس را حذف می کند. (اختیاری)

require_ credit_ card

RequireCreditCard

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

type

ServiceType

نوع از پیش تعریف شده این سرویس. (اختیاری)

ticket_ type[]

TicketType

انواع بلیط های قابل رزرو/خرید برای این سرویس، در صورت پشتیبانی از بلیط. (اختیاری)

related_ media[]

RelatedMedia

عکس های مربوط به این سرویس Google رسانه‌ها را می‌خزد و ذخیره می‌کند تا مطمئن شود که به کارآمدترین روش برای کاربران نهایی نمایش داده می‌شوند. (اختیاری)

service_ attribute_ value_ id[]

ServiceAttributeValueId

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

waitlist_ rules

WaitlistRules

قوانین پیوستن به لیست انتظار

ticketing_ vertical_ specific_ data

TicketingVerticalSpecificData

اطلاعات اضافی منحصر به فرد برای رویداد عمودی بلیط. (اختیاری)

integration_ type

IntegrationType

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

per_ order_ fee

PerOrderFee

برای خرید این سرویس هزینه های سطح سفارش دهید. (اختیاری)

tours_ and_ activities_ content

ToursAndActivitiesContent

فیلدهای محتوای خاص تورها و فعالیت ها.

location[]

Location

مکان های مرتبط با این سرویس نکات مهم: اگر چندین مکان بازدید شده مرتبط با این سرویس وجود دارد، یا START_LOCATION با VISITED_LOCATION متفاوت است، START_LOCATION باید مشخص شود. مثال: - یک تور دوچرخه سواری با راهنما که از سه مکان بازدید می کند، محل شروع باید مشخص شود. - یک جلسه تور اتوبوس در لابی هتل و سپس رفتن به محل بازدید. مکان جلسه باید مشخص شود.

rating

Rating

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

home_ service_ data

HomeServiceData

اطلاعات اضافی منحصر به فرد برای خدمات خانگی عمودی. (اختیاری)

virtual_ session

VirtualSession

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

direct_ merchant_ payment

DirectMerchantPayment

اختیاری. اطلاعات اضافی که در صورت نیاز کاربر به پرداخت مستقیم به تاجر، باید اضافه شود. نکته مهم: RwG در این تراکنش دخیل نیست. اگر virtual_session تعریف شده باشد و سرویس رایگان نباشد یا prepayment_type روی REQUIRED تنظیم نشده باشد، لازم است.

uri_ template

UriTemplate

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

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

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

فیلدها
charge_ timing

ChargeTiming

زمانی که شارژ نسبت به زمان خرید اتفاق می افتد.

charge_ time_ before_ start_ time_ sec

int64

زمان بر حسب ثانیه قبل از زمان شروع سرویس که هزینه پرداخت از کاربر دریافت می شود. این فیلد فقط زمانی باید تنظیم شود که 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

string

شناسه‌ای که به‌طور منحصربه‌فرد این ویژگی خدمات را در میان سایر ویژگی‌های یک تاجر شناسایی می‌کند، مثلاً «نوع حساب».

attribute_ name

string

یک نام قابل مشاهده برای کاربر برای این ویژگی، به عنوان مثال "نوع حساب".

value[]

Value

تمام مقادیر ممکن برای این ویژگی سرویس.

ارزش

یک مقدار ممکن برای یک ویژگی سرویس خاص را نشان می دهد.

فیلدها
value_ id

string

شناسه‌ای که به‌طور منحصربه‌فرد این مقدار را در میان سایر ویژگی‌های این سرویس شناسایی می‌کند، مثلاً «شخصی».

value_ name

string

یک نام قابل مشاهده برای مقدار، به عنوان مثال "شخصی".

ServiceAttributeValueId

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

فیلدها
attribute_ id

string

شناسه یک ویژگی همانطور که در Merchant.service_attribute تعریف شده است، به عنوان مثال "نوع سرویس".

value_ id

string

شناسه مقدار این ویژگی، به عنوان مثال "مشکل مو". باید با یک value_id در تعریف ویژگی سرویس مطابقت داشته باشد.

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

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

فیلدها
name

string

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

start_ time_ restrict

Timestamp

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

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

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

  availability.duration == duration_restrict

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

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

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

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

end_ time_ restrict

Timestamp

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

duration_ restrict

Duration

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

resources_ restrict

Resources

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

availability[]

Availability

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

ServiceIntakeForm

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

فیلدها
field[]

ServiceIntakeFormField

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

first_time_customers
(deprecated)

bool

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

returning_customers
(deprecated)

bool

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

ServiceIntakeFormField

فیلدی را تعریف می کند که در ServiceIntakeForm گنجانده شده است.

فیلدها
id

string

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

type

FieldType

نوع این رشته

label

string

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

localized_ label

Text

متنی که برای این فیلد به کاربر نشان داده می شود. فیلد را می توان در چندین منطقه ارائه کرد. (الزامی)

value[]

string

اگر و فقط اگر نوع فیلد LOCATION_SEARCH باشد، تنظیم کنید. لطفاً از "location_id" در قسمت "location" برای تعیین مقدار مکان استفاده کنید.

choice_ text[]

Text

اگر و فقط اگر نوع فیلد MULTIPLE_CHOICE، CHECKBOXES یا DROPDOWN باشد، تنظیم کنید. برای برشمردن گزینه های ممکن استفاده می شود.

is_ required

bool

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

allow_ custom_ answer

bool

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

additional_ option[]

Text

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

ticket_ type_ restrict[]

string

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

hint

Text

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

نوع فیلد

Enum برای نشان دادن نوع فیلد.

Enums
FIELD_TYPE_UNSPECIFIED فیلدهایی از نوع نامشخص یا ناشناخته نادیده گرفته خواهند شد.
SHORT_ANSWER یک فیلد ورودی یک خطی برای متن.
PARAGRAPH یک فیلد ورودی چند خطی برای متن.
MULTIPLE_CHOICE مجموعه ای از دکمه های رادیویی که نیاز به یک انتخاب از بین گزینه های متعدد دارد.
CHECKBOXES یک یا چند مورد شمارش شده با کادرهای تأیید.
DROPDOWN انتخابی از یک کشویی
BOOLEAN یک دکمه بله/خیر

نرخ مالیات

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

فیلدها
micro_ percent

int32

نرخ مالیات بر حسب میلیونم یک درصد، که عملاً 6 اعشار دقت را نشان می دهد. به عنوان مثال، اگر نرخ مالیات 7.253 درصد باشد، این فیلد باید 7253000 تنظیم شود.

اگر این قسمت تنظیم نشده باقی بماند یا روی 0 تنظیم شود، کل قیمتی که برای هر سرویس ارائه شده توسط این تاجر از کاربر دریافت می‌شود، دقیقاً قیمتی است که توسط Service.price مشخص شده است. فرض می شود که قیمت خدمات از مالیات های قابل اعمال معاف است یا از قبل شامل آن می شود. مالیات ها به عنوان یک خط جداگانه به کاربر نشان داده نمی شود.

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

شرایط

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

فیلدها
url

string

به صورت اختیاری، URL به شرایط و ضوابط.

text

string

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

localized_ text

Text

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

متن

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

فیلدها
value

string

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

localized_ value[]

LocalizedString

مقادیر متن به ازای هر محلی. اختیاری.

TicketType

TicketType برای تمایز بین بلیط هایی با قیمت ها و/یا در دسترس بودن متفاوت به دلیل انواع مختلف کاربر، ویژگی های خدمات مختلف، یا گزینه ها/افزونه های مختلف استفاده می شود.

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

فیلدها
ticket_ type_ id

string

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

short_ description

string

توضیح کوتاهی برای این TicketType.

این می تواند توسط کاربر قابل مشاهده باشد، به عنوان مثال، "بزرگسال"، "کودک"، "کهنه سرباز"، "ردیف J"، و غیره. لازم است، هر نوع بلیط باید دارای توضیحاتی باشد تا کاربر قابل مشاهده باشد. منسوخ شده است، به جای آن از localized_short_description استفاده کنید.

localized_ short_ description

Text

توضیح کوتاهی درباره این TicketType با پشتیبانی از i18n.

این می تواند توسط کاربر قابل مشاهده باشد، به عنوان مثال، "بزرگسال"، "کودک"، "کهنه سرباز"، "ردیف J"، و غیره. لازم است، هر نوع بلیط باید دارای توضیحاتی باشد تا کاربر قابل مشاهده باشد. مقادیر جداگانه ای را می توان برای هر منطقه ارائه کرد.

price

Price

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

per_ ticket_ fee

PerTicketFee

هزینه های اضافی برای خرید این بلیط. (اختیاری)

price_ display_ type

PriceDisplayType

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

option_ description

string

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

localized_ option_ description

Text

شرح هر گزینه اضافی که این نوع بلیط نشان دهنده آن است، در صورت وجود. مقادیر جداگانه ای را می توان برای هر منطقه ارائه کرد.

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

مثال 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

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

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

EventCategory

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

event_ url

string

نشانی وب رویداد در وب سایت شریک. (اختیاری)

entity[]

Entity

فهرستی از نهادهای مرتبط با رویداد. (اختیاری)

event_ attendance_ mode

AttendanceMode

مورد نیاز. نوع حضور در رویداد

event_ virtual_ location_ url[]

string

اختیاری. نشانی اینترنتی جایی که می توان رویداد را تماشا کرد.

event_ organizer

Text

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

event_ organizer_ url

string

اختیاری. URL سازمان دهنده که رویداد را میزبانی می کند.

event_ organizer_ type

OrganizerType

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

event_ source_ url[]

string

مورد نیاز. URL صفحاتی که اطلاعات یا توضیحات رویداد را می توان یافت.

event_ state

EventState

اختیاری. وضعیت رویداد.

brand_ name

Text

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

event_ creator

EventCreator

اختیاری. اطلاعات در مورد خالق رویداد.

حالت حضور و غیاب

نوع حضور در رویداد

Enums
ATTENDANCE_MODE_UNSPECIFIED مشخص نشده است.
ONLINE برای رویدادهای مجازی
PHYSICAL برای رویدادهای فیزیکی
PHYSICAL_ONLINE_MIXED برای رویدادهایی که هم فیزیکی و هم مجازی هستند.

موجودیت

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

فیلدها
id

string

شناسه منحصر به فرد موجودیت در پایگاه داده شریک. (اختیاری)

name

string

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

url

string

آدرس صفحه وب که به طور واضح موجودیت را توصیف می کند. در صورت وجود، این صفحه وب در وب سایت شریک برای نهاد است. برای سایر URL های عمومی موجودیت، از relevant_url در public_identification_data استفاده کنید. (اختیاری)

entity_ type

EntityType

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

entity_ role

EntityRole

نقش نهاد در رویداد. (اختیاری)

public_ identification_ data

PublicIdentificationData

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

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

string

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

EventState

وضعیت رویداد.

Enums
EVENT_STATE_UNSPECIFIED مشخص نشده است.
SCHEDULED این رویداد برنامه ریزی شده است.
RESCHEDULED این رویداد دوباره برنامه ریزی شده است.
CANCELLED این رویداد لغو می شود.
POSTPONED این رویداد به تعویق افتاد.

OrganizerType

نوع برگزار کننده.

Enums
ORGANIZER_TYPE_UNSPECIFIED مشخص نشده است.
PERSON برای سازمان دهنده که یک شخص است.
ORGANIZATION برای سازمان دهنده که یک سازمان است.

PublicIdentificationData

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

فیلدها
relevant_ url[]

string

URL عمومی هر صفحه وب که فقط به موضوع اختصاص داده شده است. این می تواند شامل وب سایت های رسمی، دیسک ها، پلت فرم های رسانه های اجتماعی، صفحات ویکی پدیا یا imdb باشد، به عنوان مثال https://www.discogs.com/artist/1124645-Taylor-Swift ، https://www.wikidata.org/wiki/Q19320959 ، https://twitter.com/acmilan . (اختیاری)

musicbrainz_ id

string

شناسه 36 کاراکتری musicbrainz هنرمند یا سایر نهادهای موسیقی، در صورت وجود. به https://musicbrainz.org/doc/MusicBrainz_Identifier مراجعه کنید. (اختیاری)

محدوده زمانی

یک محدوده زمانی بسته-باز، یعنی [زمان_شروع، زمان_پایان).

فیلدها
start_ time

Timestamp

حد پایین محدوده زمانی.

end_ time

Timestamp

حد بالایی محدوده زمانی.

TokenizationConfig

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

فیلدها
tokenization_ parameter

map<string, string>

یک پیکربندی توکن‌سازی معمولاً یک پارامتر 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

BillingInformationFormat

اطلاعات صورت‌حساب کاربر را که با 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[]

Text

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

inclusions[]

Text

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

exclusions[]

Text

فهرست استثنائات قابل مشاهده برای کاربر.

must_ know[]

Text

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

UnsupportedPartySizeOption

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

فیلدها
kind میدان اتحادیه . گزینه های موجود برای مهمانی هایی که خارج از محدوده هستند. kind می تواند تنها یکی از موارد زیر باشد:
call_ merchant

CallMerchant

اندازه مهمانی هایی که خارج از محدوده هستند می توانند با کسب و کار تماس بگیرند. یک پیام از پیش تعریف شده برای کاربر نمایش داده می شود. نمونه متنی که باید نمایش داده شود: "برای مهمانی های بزرگتر از {waitlist_rules.max_party_size} لطفاً با شماره {phone} با رستوران تماس بگیرید." CallMerchant باید تنظیم شود، اما خالی خواهد بود.

UpdateAdsAccountLinkRequest

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

فیلدها
update_ mask

FieldMask

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

UpdateBooking Request

درخواست به روز رسانی google.maps.booking.v1alpha.Booking

فیلدها
update_ mask

FieldMask

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

booking

Booking

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

booking_ failure

BookingFailure

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

UpdateMerchantRequest

درخواست به‌روزرسانی یک Merchant .

فیلدها
merchant

Merchant

داده های تجاری جدید

update_ mask

FieldMask

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

UpdateOrderRequest

درخواست به روز رسانی google.maps.booking.v1alpha.Order

فیلدها
update_ mask

FieldMask

ماسک فیلد تمام فیلدهای سفارش به روز می شود

order

Order

سفارش به روز رسانی شود

UpdateServiceRequest

درخواست به روز رسانی یک Service

فیلدها
service

Service

داده های سرویس جدید

update_ mask

FieldMask

فیلدهای خاص برای به روز رسانی برای سرویس.

UriTemplate

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

فیلدها
uri_ template

string

اختیاری. الگوی 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

bool

یک گزینه پرداخت که فقط توسط کاربرانی قابل خرید است که قبلاً هرگز از یک تاجر خرید نکرده‌اند.

new_ to_ payment_ option

bool

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

جلسه مجازی

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

فیلدها
session_ instructions

Text

دستورالعمل نحوه راه اندازی این کلاس مجازی. اگر شریک نشانی وب ویدیو را با رزرو وارد نکرده باشد، این متن باید شامل زمانی باشد که URL ویدیو با کاربر به اشتراک گذاشته می‌شود. به عنوان مثال "URL بزرگنمایی 30 دقیقه قبل از کلاس پست می شود." (توصیه می شود)

session_ requirements

Text

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

virtual_ platform_ info

VirtualPlatformInfo

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

is_ session_ prerecorded

bool

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

VirtualPlatformInfo

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

فیلدها
platform

Platform

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

other_ platform_ name

Text

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

پلت فرم

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

Enums
PLATFORM_UNSPECIFIED استفاده نشده
FLEXIBLE تاجر انعطاف پذیر است که در کدام پلتفرم ویدیویی استفاده می کند.
GOOGLE_HANGOUTS محصول Google Hangouts.
GOOGLE_MEET محصول Google Meet.
ZOOM ارتباطات ویدئویی زوم.
SKYPE اسکایپ.
YOUTUBE پخش زنده در یوتیوب.
OTHER اگر پلتفرم ویدیویی استفاده شده با موارد ذکر شده در اینجا متفاوت باشد، باید تنظیم شود.

قوانین فهرست انتظار

قوانین مربوط به پیوستن به لیست انتظار.

فیلدها
min_ party_ size

int32

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

max_ party_ size

int32

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

supports_ additional_ request

bool

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

above_ max_ party_ size_ options[]

UnsupportedPartySizeOption

گزینه‌هایی را برای مهمانی‌های بزرگ‌تر از مجموعه max_party_size تنظیم کنید. اگر نباید گزینه های جایگزین برای پیوستن به لیست انتظار به مهمانان بزرگتر داده شود، خالی بگذارید.