Package google.maps.booking.v1alpha

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

repeat_every

ExtendedServiceAvailability

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

مثال: در دسترس بودن با مدت زمان 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 صبح شروع می‌شود تحت تأثیر قرار نمی‌گیرد.

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 لغو کرد. این فیلد همه قوانین لغو در سطح خدمات را لغو می کند. (اختیاری)

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

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

parent

string

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

records[]

GenericRecord

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

BatchReplaceServiceAvailability Request

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

فیلدها

فیلدها
`parent`	`string` قالب `partners/{partner_id}` .
`extended_service_availability[]`	`ExtendedServiceAvailability` در دسترس بودن سرویس گسترده که برای جایگزینی اسلات های موجود استفاده می شود.

parent

string

قالب partners/{partner_id} .

extended_service_availability[]

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

BatchReplaceServiceAvailabilityResponse

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

فیلدها

فیلدها
`extended_service_availability[]`	`ExtendedServiceAvailability` پیام‌های در دسترس بودن سرویس توسعه‌یافته با موفقیت به‌روزرسانی شدند که برای جایگزینی شکاف‌های در دسترس بودن موجود استفاده شدند.

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 تنظیم شود.

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` شرایط بازپرداخت صفر یا بیشتر مربوط به سیاست.

refund_condition[]

RefundCondition

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

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

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

فیلدها

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

min_duration_before_start_time

مدت زمان قبل از زمان شروع، تا زمانی که مشتری بتواند بخشی از هزینه خدمات مشخص شده در 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` آدرس ایمیل مشتری

ایجاد MerchantRequest

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

فیلدها

فیلدها
`parent`	`string` نام منبع والد برای شریک صاحب این تاجر، در قالب `partners/{partner_id}` .
`merchant_id`	`string` شناسه فروشنده برای استفاده برای این تاجر.
`merchant`	`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` سرویس برای ایجاد.

parent

string

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

service_id

string

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

service

Service

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

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

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

فیلدها

فیلدها
`credit_card_type[]`	`CreditCardType` لیستی از کارت های اعتباری پشتیبانی شده در صورت خالی بودن کارت اعتباری پشتیبانی نمی شود.

credit_card_type[]

CreditCardType

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

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

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

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

حذف MerchantRequest

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

فیلدها

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

name

string

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

DeleteServiceRequest

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

فیلدها

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

name

string

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

سپرده گذاری

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

فیلدها

فیلدها
`deposit`	`Price` مبلغ سپرده.
`min_advance_cancellation_sec`	`int64` حداقل لغو پیش پرداخت برای واریز.
`deposit_type`	`PriceType` نحوه تعیین سپرده را از در دسترس بودن تعریف می کند.

deposit

مبلغ سپرده.

min_advance_cancellation_sec

int64

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

deposit_type

PriceType

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

DirectMerchantPayment

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

فیلدها

فیلدها
`payment_methods[]`	`Text` به کاربران توصیه می شود فقط از طریق روش های پرداخت ذکر شده در زیر پرداخت کنند.

payment_methods[]

Text

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

محدوده مدت

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

فیلدها

فیلدها
`min_duration`	`Duration` حداقل مدت.
`max_duration`	`Duration` حداکثر مدت.

min_duration

حداقل مدت.

max_duration

حداکثر مدت.

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

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

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

نوع تحقق

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

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

حداقل هزینه

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

فیلدها

base_fee_amount

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

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"

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` از نام ، تلفن ، URL و GEO این مکان برای پشتیبانی از تطبیق مکان با مکانهایی که قبلاً در Google Maps حضور دارند استفاده می شود. این قسمت اختیاری است ، اما ممکن است در برخی زمینه ها مورد نیاز باشد. به عنوان مثال ، یک سرویس. محل بدون نام با یک نهاد تجاری مطابقت نخواهد داشت ، حتی اگر در همان آدرس قرار داشته باشند. (اختیاری)
`telephone`	`string` شماره تلفن عمومی محل از جمله کدهای کشور و منطقه آن ، به عنوان مثال +14567891234. (اختیاری)
`url`	`string` URL وب سایت عمومی مکان. (اختیاری)
`geo`	`GeoCoordinates` اطلاعات جغرافیایی محل ، از جمله عرض جغرافیایی ، طول جغرافیایی و آدرس. (اختیاری)
`location_type`	`LocationType` در صورت ارائه این مکان برای یک سرویس ، نوع مکان ، باید تأمین شود.
`location_id`	`string` مرجع منحصر به فرد از مکان در سرویس. از این شناسه می توان برای مراجعه به این مکان در سایر زمینه های خدمات استفاده کرد. به عنوان مثال در فرم ورودی سفارشی ، می توان از مجموعه ای از شناسه های مکان برای مشخص کردن گزینه های مکان انتخاب استفاده کرد. در صورت تنظیم ، این شناسه باید در همان سرویس بی نظیر باشد. (اختیاری)

نوع مکان

نوع این مکان

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

بازرگان

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

فیلدها
`name`	`string` نام منبع بازرگان ، که دارای فرمت `partners/{partner_id}/merchants/{merchant_id}` .
`merchant_name`	`string` از Merchant_Name ، Teleplle ، URL و GEO برای پشتیبانی از موجودی شریک زندگی با بازرگانانی که قبلاً در Google Maps حضور دارند استفاده می شود. این اطلاعات نمایش داده نمی شود. نام بازرگان.
`telephone`	`string` شماره تلفن عمومی بازرگان از جمله کدهای کشور و منطقه آن ، به عنوان مثال +14567891234.
`url`	`string` URL وب سایت عمومی بازرگان.
`geo`	`GeoCoordinates` اطلاعات جغرافیایی بازرگان ، از جمله عرض جغرافیایی ، طول و آدرس.
`category`	`string` دسته تجارت در پلتفرم Aggregator.
`num_bookings_30d (deprecated)`	`int64` این مورد منسوخ شده است! این زمینه مستهلک می شود.
`tax_rate_basis_points (deprecated)`	`uint32` این مورد منسوخ شده است! نرخ مالیات بازرگان در نقاط پایه (یک صدم یک درصد). به عنوان مثال ، اگر نرخ مالیات 7.5 ٪ باشد ، این قسمت باید روی 750 تنظیم شود. اگر این قسمت تنظیم نشده باقی بماند یا روی 0 تنظیم شود، کل قیمتی که برای هر سرویس ارائه شده توسط این تاجر از کاربر دریافت می‌شود، دقیقاً قیمتی است که توسط Service.price مشخص شده است. فرض می شود که قیمت خدمات از مالیات های قابل اعمال معاف است یا از قبل شامل آن می شود. مالیات ها به عنوان یک خط جداگانه به کاربر نشان داده نمی شود. اگر این قسمت روی مقدار غیر صفر تنظیم شود، کل قیمتی که برای هر سرویس ارائه شده توسط این تاجر از کاربر دریافت می‌شود، شامل قیمت خدمات به اضافه مالیات محاسبه‌شده با استفاده از نرخ مالیات ارائه‌شده در اینجا می‌شود. کسری از کوچکترین واحد پول (به عنوان مثال، کسری از یک سنت) با استفاده از نزدیکترین گرد کردن زوج گرد می شود. مالیات ها به عنوان یک خط جداگانه به کاربر نشان داده می شود. این قسمت مستهلک می شود ، لطفاً به جای آن از مالیات_رایت استفاده کنید.
`tax_rate`	`TaxRate` نرخ مالیات بازرگان. در صورت وجود این زمینه ، قسمت مستهلک شده مالیات_ rate_basis_points را نادیده می گیرد. یک پیام خالی (یعنی مالیات_ {}) نرخ مالیات اعمال شده را به صفر بازنشانی می کند.
`payment_restrictions`	`PaymentRestrictions` محدودیت در روش های پرداختی که این بازرگان می پذیرد. اگر این قسمت تنظیم نشده باشد ، هیچ محدودیتی وجود ندارد.
`payment_option[]`	`PaymentOption` گزینه های پرداخت موجود برای این بازرگان. خدمات تحت این بازرگان قادر خواهند بود گزینه های پرداختی را که اجازه می دهند به صورت جداگانه محدود کنند.
`payment_processor_config (deprecated)`	`PaymentProcessorConfig` این مورد منسوخ شده است! پیکربندی برای یک پردازنده پرداخت توکن ، اگر بازرگان از آن پشتیبانی می کند.
`tokenization_config`	`TokenizationConfig` پیکربندی برای یک پردازنده پرداخت توکن ، اگر بازرگان از آن پشتیبانی می کند.
`terms`	`Terms` شرایط و ضوابط بازرگان خاص هنگام رزرو سرویس از طریق Reserve با Google به کاربر نمایش داده می شود. علاوه بر این شرایط و ضوابط شریک جمع همیشه به کاربر نمایش داده می شود و نباید در اینجا ارائه شود.
`brand_id`	`string` یک رشته مات که مارک مصرف کننده را برای استفاده در هنگام نمایش انتساب شریک مشخص می کند. این زمینه به شرکای دارای مارک های مختلف مصرف کننده اجازه می دهد تا بازرگانان را برای همه مارک های موجود در همان خوراک فراهم کنند. یک برند از خصوصیات رو به مصرف کننده مانند نام ، آرم ، شرایط خدمات و خط مشی رازداری تشکیل شده است. اگر فقط یک برند شریک مصرف کننده وجود داشته باشد ، نیازی به تنظیم این زمینه ندارد و می توان آن را نادیده گرفت. اگر شریک زندگی ... آیا مارک های مختلف مصرف کننده وجود ندارد؟ -> این زمینه را نادیده بگیرید آیا مارک های مختلفی که پیکربندی شده اند؟ `If this field is set --> Associated consumer-facing brand attribution is used If this field is unset or the empty string --> Default consumer-facing brand attribution is used` توجه دقیق: اکثر شرکا نیازی به تنظیم این زمینه ندارند. اگر شریک زندگی بخواهد از این قسمت استفاده کند ، ابتدا باید برای پیکربندی مارک های جداگانه ، از جمله مارک پیش فرض ، ابتدا با ما تماس بگیرند.
`matching_hints`	`MerchantMatchingHints` نکات برای کمک به Google با یک بازرگان با مکانی در Google Maps مطابقت دارد. توجه: اکثر شرکا نیازی به تنظیم این قسمت ندارند ، زیرا Google با استفاده از اطلاعات ارائه شده در بالا ، بازرگانان را با مکان های Google Maps مطابقت می دهد. (اختیاری)
`service_attribute[]`	`ServiceAttribute` تعاریف مربوط به هرگونه ویژگی خدماتی که برای توصیف خدمات برای این بازرگان استفاده می شود. (اختیاری)
`action_link[]`	`ActionLink` اختیاری. یک URL اقدام با زبان مرتبط ، لیست کشورهایی که محدود به ، نوع و پلت فرم اختیاری هستند که نشان می دهد این پلتفرم باید روی کدام پلتفرم انجام شود
`waitlist_advisement`	`Advisement` اختیاری. مشاوره عمومی از یک بازرگان خاص برای کاربر که از طریق Reserve with Google به لیست انتظار می رود. زمینه های متن فردی در مشاوره باید به طول 100 بایت محدود شود.

بازرگانی

نکات مورد استفاده برای کمک به 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

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

محدوده پول

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

فیلدها

min_amount

Money

حداقل مقدار

max_amount

Money

حداکثر مقدار

نوشافی

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

فیلدها

fee

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

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

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

payment_transaction_id

string

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

پرداخت

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

فیلدها
`payment_option_id`	`string` این شناسه برای شناسایی این گزینه پرداخت استفاده می شود. این شناسه برای کل جمع جهانی جهانی است و با استفاده مجدد از یک ارزش در بین بازرگانان متعدد ، به کاربر امکان می دهد با گزینه پرداخت مربوطه در آن بازرگانان بپردازد. هنگام استفاده مجدد از یک بازرگان چندگانه ، به روزرسانی هر مقدار برای گزینه پرداخت تحت یک بازرگان ، هر گزینه پرداخت دیگری را با همان شناسه ، تحت یک بازرگان متفاوت به روز می کند. به همین ترتیب ، این بهترین روش است که تمام گزینه های پرداخت با همان شناسه ، همیشه به ارزش های یکسان بروزرسانی شود تا از هرگونه امکان رفتار کمبودی جلوگیری شود.
`name`	`string` نام گزینه پرداخت. این می تواند کاربر قابل مشاهده باشد.
`description`	`string` شرح گزینه پرداخت. این می تواند کاربر قابل مشاهده باشد.
`price`	`Price` قیمت گزینه پرداخت.
`tax_rate`	`TaxRate` نرخ مالیات برای این گزینه پرداخت. در صورت وجود این زمینه ، زمینه مالیات_ر موجود در بازرگان یا خدمات را تحت الشعاع قرار می دهد. یک پیام خالی (یعنی مالیات_ {}) نرخ مالیات اعمال شده را به صفر بازنشانی می کند.
`payment_option_type`	`PaymentOptionType` نوع این گزینه پرداخت. یکبار مصرف برای قطره ، چند کاربردی برای بسته ها و نامحدود برای عضویت.
`session_count`	`int64` این گزینه پرداخت می تواند برای چند جلسه استفاده شود. فقط برای چند جلسه / بسته ها معتبر است ، جایی که مقدار باید> 1 باشد.
`purchase_interval`	`TimeRange` گزینه پرداخت را می توان در این بازه خریداری کرد.
`valid_interval`	`TimeRange` گزینه پرداخت می تواند در این بازه استفاده شود (به عنوان مثال قیمت ویژه ژانویه 2017). در صورت وجود ، این امر بر اعتبار_دور و فعال سازی_تایپ غلبه می کند.
`valid_duration`	`Duration` مدت اعتبار گزینه پرداخت (به عنوان مثال عضویت 30 روزه).
`activation_type`	`ActivationType` تعیین می کند که چگونه تاریخ شروع اعتبار برای این گزینه پرداخت تعیین می شود.
`user_restriction`	`UserPurchaseRestriction` کاربران واجد شرایط برای خرید این گزینه پرداخت را محدود می کند. می توان برای محدود کردن گزینه پرداخت تبلیغاتی به زیر مجموعه ای از کاربران استفاده کرد. اگر تنظیم نشده باشد ، همه کاربران واجد شرایط هستند.

نوع فعال سازی

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

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

نوع پرداخت

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

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

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

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

فیلدها

processor

Processor

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

public_key

string

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

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

version

string

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

پردازنده

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

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

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

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

فیلدها

credit_card_restrictions

CreditCardRestrictions

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

پیشرو

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

فیلدها

delivery_fee

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

processing_fee

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

باجایی

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

فیلدها

service_charge

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

facility_fee

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

taxes

مالیات بلیط.

پست

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

فیلدها
`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". (الزامی)

پیش پرداخت

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

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

قیمت

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

فیلدها
`price_micros`	`int64` قیمت در واحدهای خرد ارز. کسری از واحد کوچکترین واحد ارز با استفاده از نزدیکترین حتی گرد گرد می شوند. (به عنوان مثال برای 2.5 سنت دلار به 2 سنت ، 3.5 سنت دور به 4 سنت ، 0.5 سنت گرد به 0 سنت ، 2.51 سنت گرد تا 3 سنت).
`currency_code`	`string` ارز قیمتی که در ISO 4217 تعریف شده است.
`pricing_option_tag`	`string` یک رشته اختیاری و مات که گزینه قیمت گذاری را که با قیمت طولانی همراه است ، مشخص می کند.

تفسیر قیمت

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

Enums
`PRICE_INTERPRETATION_UNSPECIFIED`	تفسیر قیمت نامشخص ، پیش فرض به دقیق_مونت.
`EXACT_AMOUNT`	هنگامی که قیمت باید به عنوان یک ارزش خاص تعبیر شود. مثال: 20 دلار برای کلاس یوگا ؛ 15 دلار برای مدل موهای کودک
`STARTS_AT`	هنگامی که قیمت یک سرویس متغیر است اما حداقل قیمت شناخته شده و برای مصرف کنندگان نمایش داده می شود. مصرف کنندگان ممکن است انتخابی را انجام دهند که قیمت را افزایش می دهد. توجه داشته باشید که هر خدمتی که از این تفسیر قیمت استفاده می کند ، باید از پیش پرداخت not_supported استفاده کند. مثالها: 30 دلار برای نظافت سگ ، اما گزینه های اضافی مصرف کننده ممکن است قیمت را افزایش دهد
`NOT_DISPLAYED`	هنگامی که قیمت یک سرویس متغیر است و هیچ اطلاعات قیمت قبل از زمان برای مصرف کنندگان نمایش داده نمی شود. توجه داشته باشید که هر خدمتی که از این تفسیر قیمت استفاده می کند ، باید از پیش پرداختی not_supported استفاده کند و قیمت باید خالی باشد. مثال: مشاوره برای یک سرویس خانگی

نوع قیمت

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

Enums

FIXED_RATE_DEFAULT

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

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

PER_PERSON

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

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

مقدار کمی

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

فیلدها

فیلد اتحادیه 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

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

number_of_ratings

uint64

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

وابسته

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

فیلدها
`url`	`string` URL این منبع رسانه ای. Google رسانه های میزبانی شده در این URL را خزنده می کند.
`type`	`MediaType` نوع این منبع رسانه ای.
`localized_caption`	`Text` عنوان رسانه ای که از i18n پشتیبانی می کند ، فقط متن ساده پشتیبانی می شود. هر مؤلفه HTML سلب می شود. (اختیاری)
`attribution`	`Attribution` اطلاعات مربوط به منبع رسانه. توجه داشته باشید که در صورت نیاز به انتساب برای نمایش با رسانه ها برای اعتبار به عکاس یا آژانس ، این زمینه باید تنظیم شود. (اختیاری)
`caption (deprecated)`	`string` این مورد منسوخ شده است! مستهلک ، ترجیح می دهید از boalized_caption استفاده کنید.

انتساب

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

فیلدها

localized_text

Text

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

text
 (deprecated)

string

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

واسطه

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

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

chepraceserviceailabilityrequest

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

فیلدها

service_availability

ServiceAvailability

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

costecreditcard

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

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

منابع

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

فیلدها
`staff_id`	`string` شناسه اختیاری برای یک کارمند ارائه دهنده خدمات. این زمینه عضو کارکنان را در همه بازرگانان ، خدمات و سوابق در دسترس بودن مشخص می کند. همچنین باید با گذشت زمان پایدار باشد تا همبستگی با رزرو گذشته فراهم شود. در صورت حضور Staff_Name ، این قسمت باید حضور داشته باشد.
`staff_name`	`string` نام اختیاری یک کارمند ارائه دهنده خدمات. این قسمت برای کاربرانی که رزرو می کنند نمایش داده می شود و بر خلاف یک شناسه مات ، باید قابل خواندن باشد. در صورت حضور Staff_ID ، این قسمت باید حضور داشته باشد.
`room_id`	`string` یک شناسه اختیاری برای اتاقی که در آن واقع شده است. این قسمت اتاق را در همه بازرگانان ، خدمات و سوابق در دسترس بودن مشخص می کند. همچنین باید با گذشت زمان پایدار باشد تا همبستگی با رزرو گذشته فراهم شود. در صورت وجود اتاق_ نام ، این قسمت باید حضور داشته باشد.
`room_name`	`string` یک نام اختیاری برای اتاقی که در آن واقع شده است. این قسمت برای کاربرانی که رزرو می کنند نمایش داده می شود و باید بر خلاف یک شناسه مات ، قابل خواندن باشد. (اختیاری اما لازم است اگر اتاق_د وجود داشته باشد) در ناهار خوری یک اتاق فقط باید برای مناطق نشیمن مانند نوار یا پاسیو استفاده شود و نباید برای منوهای قیمت ثابت ، فعالیتهای ویژه یا هر مقدار غیر اتاق دیگر استفاده شود (مانند رزرو یا شام). به شدت توصیه می شود که فضای صندلی پیش فرض اتاقی در ارتباط با آن نداشته باشد.
`party_size`	`int32` فقط برای ناهار خوری قابل اجرا است: اندازه مهمانی که در این شکاف می تواند در آن جای بگیرد. یک رستوران می تواند در همان زمان با چندین شکاف همراه باشد ، هر کدام یک مهمانی متفاوت را مشخص می کنند ، اگر به عنوان مثال 2 ، 3 یا 4 نفر با رزرو نشسته باشند.

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

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

فیلدها
`min_advance_online_canceling`	`int64` حداقل اخطار قبلی در ثانیه های لازم برای لغو قرار ملاقات رزرو شده به صورت آنلاین. (اختیاری)
`late_cancellation_fee (deprecated)`	`Price` این مورد منسوخ شده است! هزینه لغو در حداقل دوره اخطار قبلی.
`noshow_fee (deprecated)`	`Price` این مورد منسوخ شده است! هزینه بدون نمایش بدون لغو.
`admission_policy`	`AdmissionPolicy` خط مشی پذیرش که در مورد این سرویس اعمال می شود. در صورت عدم استفاده ، به طور پیش فرض به TIME_STRICT. (اختیاری)
`cancellation_policy`	`CancellationPolicy` برنامه ریزی قوانین لغو قوانین. (برای کارها لازم است)
Union Field `min_booking_buffer` . مدت زمان (در ثانیه) از زمانی که آخرین رزرو می تواند با شروع یا پایان کار در دسترس باشد. اگر "min_advance_booking" تنظیم شود ، آخرین زمان قابل رزرو به صورت (<زمان شروع کار> - "min_advance_booking" محاسبه می شود). اگر "min_booking_buffer_before_end_time" تنظیم شده باشد ، آخرین زمان قابل رزرو به صورت (<زمان پایان شکاف> - "min_booking_buffer_before_end_time" محاسبه می شود). توجه داشته باشید که در صورت تنظیم ، مقدار "min_booking_buffer_before_end_time" باید مثبت باشد. اگر هر دو مورد باز نیستند ، شکاف قابل رزرو است تا زمان شروع شکاف. اگر هر دو قسمت تنظیم شوند ، فقط یک مقدار انتخاب می شود در حالی که مقدار دیگر نادیده گرفته می شود-ما نمی توانیم با اطمینان پیش بینی کنیم که کدام مقدار انتخاب شده است. مثال ها: مدل مو که حداقل 1 ساعت قبل از زمان شروع باید رزرو شود. 'SHANLING_RULES {min_advance_booking: 3600 ...} ` موزه ای که آخرین بلیط را می توان 30 دقیقه قبل از بسته شدن خریداری کرد: "برنامه ریزی_رول {min_booking_buffer_before_end_time: 1800 ...} ' بلیط فیلم که باید قبل از زمان شروع خریداری شود. 'scheduling_rules {...}' (این قسمت را خالی بگذارید) (اختیاری) `min_booking_buffer` تنها یکی از موارد زیر است:
`min_advance_booking`	`int64` مدت زمان (در ثانیه) از زمانی که آخرین رزرو با شروع شکاف در دسترس بودن می تواند انجام شود.
`min_booking_buffer_before_end_time`	`int64` مدت زمان (در ثانیه) از زمانی که آخرین رزرو می تواند با پایان یافتن شکاف در دسترس باشد. اگر این قسمت تنظیم شده باشد ، قسمت "Admission_policy" باید روی Time_Flexible تنظیم شود تا مشخص شود کاربران می توانند پس از شروع اسلات از بلیط های خریداری شده استفاده کنند.

پذیرش

سیاست پذیرش این سرویس.

Enums
`ADMISSION_POLICY_UNSPECIFIED`	استفاده نشده
`TIME_STRICT`	مشتریان موظفند در زمان شروع شکاف در دسترس بودن حضور داشته باشند و انتظار می رود این سرویس در پایان زمان شکاف به پایان برسد. نمونه هایی از موارد استفاده از Time_Strict: * تور که از ساعت 9 صبح شروع می شود و به همه شرکت کنندگان نیاز دارد تا در زمان شروع وارد شوند و حدود ساعت 12 شب باز می گردد. * رزرو مدل مو در ساعت 3 بعد از ظهر روز شنبه که تقریباً 30 دقیقه طول خواهد کشید. * کلاس تناسب اندام از 6:00 تا 8 عصر.
`TIME_FLEXIBLE`	مشتریان می توانند در هر زمان بین زمان شروع و پایان شکاف در دسترس بودن برای استفاده از این رزرو وارد شوند. نمونه هایی از موارد استفاده قابل استفاده TIME_FLEPLIBLE: * بلیط موزه ای که می تواند در هر زمان در تاریخ خرید استفاده شود. * پذیرش بعد از ظهر در یک پارک تفریحی که از ساعت 12 تا 9 عصر قابل استفاده است.
`TIMED_ENTRY_WITH_FLEXIBLE_DURATION`	مشتریان باید در زمان شروع شکاف در دسترس بودن به بازرگان برسند اما می توانند هر زمان که بخواهند ترک کنند. به عنوان مثال ، در سناریوی پذیرش موزه ، بلیط ورود به موقع برای 10 صبح نیاز دارد که کاربر ساعت 10 صبح در موزه باشد. زمان شروع شکافهای در دسترس برای این سرویس ، زمان ورود تعیین شده را نشان می دهد. با این حال ، زمان پایان صرفاً به عنوان یک کلید برای شناسایی شکاف در دسترس بودن برای رزرو استفاده می شود.

خدمات

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

فیلدها
`name`	`string` نام منبع خدمات ، که دارای فرمت `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}` .
`service_name`	`string` نام این سرویس ، به عنوان مثال "مدل موهای مردانه". به جای آن ، به جای آن ، از boalized_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 ، لنگرها و پیوندها محروم می شوند و هرگز برای کاربران نهایی نمایش داده نمی شوند. اگر می خواهید از عکس ها برای ایجاد یک تجربه کاربر غنی استفاده کنید ، لطفاً برای ارسال URL های عکس خود از قسمت "reged_media" در زیر استفاده کنید. نکات مهم: سعی کنید از برچسب های دیگر به جز موارد پشتیبانی شده در بالا استفاده نکنید ، زیرا محتویات موجود در برچسب های پشتیبانی نشده سلب می شود و ممکن است به یک تجربه کاربر نامطلوب منجر شود. سعی کنید از ساختارهای عمیق تو در تو مانند بیش از 3 سطح مختلف عنوان یا لیست های تو در تو خودداری کنید. نگه داشتن ساختار صاف ، ساده و ساده ، به ایجاد یک تجربه کاربری بهتر کمک می کند. اگر طرح های پشتیبانی شده در حال حاضر برای موارد استفاده شما کافی نیستند ، لطفاً با Google Team به Reserve دسترسی پیدا کنید. حداکثر اندازه توصیه شده 32000 کاراکتر است.
`price`	`Price` قیمت خدمات.
`price_interpretation`	`PriceInterpretation` نحوه تفسیر قیمت و نمایش به کاربر را توصیف می کند. می تواند توسط هر عمودی به جز ناهار خوری و کارهایی که برای پیکربندی نمایش قیمت خدمات انجام می شود ، استفاده شود.
`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` نرخ مالیات خدمات در صورت وجود این زمینه ، هرگونه تنظیم مالیات_ را در سطح بازرگان غلبه می کند. یک پیام خالی (یعنی مالیات_ {}) نرخ مالیات اعمال شده را به صفر بازنشانی می کند.
`payment_option_id[]`	`string` لیستی از شناسه های ارجاع گزینه های پرداخت که می تواند برای پرداخت این سرویس استفاده شود. گزینه های پرداخت واقعی در سطح بازرگان تعریف شده است و همچنین می تواند در بین بازرگانان متعدد به اشتراک گذاشته شود.
`deposit`	`Deposit` تعریف می کند که چگونه یک سپرده برای کاربر شارژ می شود. در صورت مشخص شدن ، سپرده خدمات را نادیده می گیرد. تنظیم این در یک پیام سپرده خالی ، هرگونه سپرده در سطح خدمات را حذف می کند. (اختیاری)
`no_show_fee`	`NoShowFee` هزینه نمایشی را که ممکن است برای کاربر شارژ شود تعریف می کند. در صورت مشخص شدن خدمات ، هیچ هزینه نمایش را نادیده می گیرد. تنظیم این در یک پیام خالی Noshowfee ، هر سطح خدمات را بدون هزینه نمایش حذف می کند. (اختیاری)
`require_credit_card`	`RequireCreditCard` نشان می دهد که آیا کاربر برای رزرو این سرویس باید کارت اعتباری ارائه دهد. این قسمت می تواند در سطح در دسترس بودن ناعادلانه باشد. (اختیاری)
`action_link[]`	`ActionLink` پیوند عمل مربوط به این سرویس. اگر پیوند عمل وجود دارد ، نوع (به تصویر زیر مراجعه کنید) باید در سرویس تنظیم شود.
`type`	`ServiceType` نوع از پیش تعریف شده این سرویس. (اختیاری)
`ticket_type[]`	`TicketType` در صورت پشتیبانی بلیط ، انواع بلیط هایی که برای این سرویس قابل رزرو و خریداری هستند. (اختیاری)
`related_media[]`	`RelatedMedia` عکسهای مربوط به این سرویس. Google رسانه ها را خزیده و ذخیره می کند تا اطمینان حاصل شود که آنها به کارآمدترین روش برای کاربران نهایی نمایش داده می شوند. (اختیاری)
`service_attribute_value_id[]`	`ServiceAttributeValueId` مقادیر ویژگی خدمات که برای این سرویس اعمال می شود (اختیاری). هر سرویس ممکن است برای هر ویژگی سرویس که در بازرگان مربوطه تعریف شده است ، صفر یا بیشتر باشد. (اختیاری)
`waitlist_rules`	`WaitlistRules` قوانین برای پیوستن به لیست انتظار.
`ticketing_vertical_specific_data`	`TicketingVerticalSpecificData` اطلاعات اضافی منحصر به فرد برای بلیط بلیط رویداد عمودی. (اختیاری)
`integration_type`	`IntegrationType` عمق ادغام ما از این سرویس پشتیبانی می کنیم. (اختیاری) بی ربط برای شرکا با ادغام استارت. پایان تا پایان همیشه برای این شرکا غیرفعال خواهد شد.
`per_order_fee`	`PerOrderFee` هزینه های سطح برای خرید این سرویس را سفارش دهید. (اختیاری)
`tours_and_activities_content`	`ToursAndActivitiesContent` زمینه های محتوا مخصوص تورها و فعالیتها.
`location[]`	`Location` مکان های مربوط به این سرویس. یادداشت های مهم: اگر چندین مکان بازدید شده در رابطه با این سرویس وجود داشته باشد ، یا start_location با ised_location متفاوت است ، باید start_location مشخص شود. مثال: - یک تور دوچرخه سواری با هدایت که از سه مکان بازدید می کند ، باید محل شروع کار مشخص شود. - یک جلسه تور اتوبوس در یک لابی هتل و سپس به محل بازدید از آن بروید. مکان جلسه باید مشخص شود.
`rating`	`Rating` رتبه بندی کاربر برای این سرویس به عنوان یک معیار کل در تمام بررسی ها.
`home_service_data`	`HomeServiceData` اطلاعات اضافی منحصر به فرد برای خدمات خانگی عمودی. (اختیاری)
`virtual_session`	`VirtualSession` اختیاری. اطلاعات مربوط به جلسه مجازی. برای فعال کردن خدمات مجازی لازم است.
`direct_merchant_payment`	`DirectMerchantPayment` اختیاری. اطلاعات اضافی که در صورت نیاز به کاربر نیاز به پرداخت مستقیم به بازرگان دارد ، باید اضافه شود. نکته مهم: RWG در این معامله دخیل نخواهد بود. در صورت تعریف Virtual_Session و سرویس رایگان یا پیش پرداخت_تایپ مورد نیاز نیست.

پیش پرداخت

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

فیلدها

charge_timing

ChargeTiming

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

charge_time_before_start_time_sec

int64

چند ثانیه قبل از زمان شروع سرویس که کاربر برای پرداخت هزینه می شود. این قسمت فقط باید تنظیم شود که ChargetIming Charge_later باشد.

چرب کننده

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`	خدماتی که به کاربران امکان خرید از بازرگان داده شده را می دهد. این می تواند تحویل یا وانت باشد.

سرویس دهی

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

فیلدها

attribute_id

string

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

attribute_name

string

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

value[]

Value

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

ارزش

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

فیلدها

value_id

string

شناسه ای که به طور منحصر به فرد این ارزش را در میان دیگران برای این ویژگی سرویس ، به عنوان مثال "شخصی" مشخص می کند.

value_name

string

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

serviceattributeValueid

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

فیلدها

attribute_id

string

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

value_id

string

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

امکان پذیر

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

فیلدها
`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 UNSET به معنای شروع تمام زمان در start_time_restrict است.
`end_time_restrict`	`Timestamp` تنظیم END_TIME_RESTRICT هنگام ترک Start_Time_Restrict Unset به معنای تمام وقت تا end_time_restrict تفسیر می شود.
`duration_restrict`	`Duration` تنظیم مدت زمان بیشتر دامنه بروزرسانی را فقط با در دسترس بودن با مدت زمان تطبیق محدود می کند.
`resources_restrict`	`Resources` تنظیم Resources_Restrict بیشتر دامنه بروزرسانی را فقط به این مجموعه از منابع محدود می کند. تمام زمینه های شناسه منابع باید دقیقاً مطابقت داشته باشند.
`availability[]`	`Availability` لیست جدید در دسترس بودن.

سرویس دهی سرویس

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

فیلدها

field[]

ServiceIntakeFormField

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

first_time_customers
 (deprecated)

bool

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

returning_customers
 (deprecated)

bool

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

ServiceIntakeFormfield

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

فیلدها
`id`	`string` رشته ای از یک شریک جمع کننده که منحصر به فرد یک فیلد فرم را مشخص می کند. این شناسه باید همانند ID در پاسخ به فرم مربوطه باشد و باید در سطح سرویس و در هر فرم دریافت بلیط بی نظیر باشد. (الزامی)
`type`	`FieldType` نوع این قسمت
`label`	`string` متنی که برای این قسمت به کاربر نشان داده شده است. مستهلک ، لطفاً به جای آن از `localized_label` استفاده کنید.
`localized_label`	`Text` متنی که برای این قسمت به کاربر نشان داده شده است. این زمینه را می توان در چندین محلی تهیه کرد. (الزامی)
`value[]`	`string` اگر و فقط در صورتی که نوع فیلد مکان باشد ، تنظیم کنید. لطفاً برای مشخص کردن مقدار مکان از "focation_id" در قسمت "مکان" استفاده کنید.
`choice_text[]`	`Text` اگر و فقط اگر نوع فیلد چندگانه ، کادر انتخاب یا کشویی باشد ، تنظیم کنید. برای شمارش گزینه های احتمالی استفاده می شود.
`is_required`	`bool` نشان می دهد که آیا پاسخی به این قسمت توسط کاربر لازم است یا خیر.
`allow_custom_answer`	`bool` نشان می دهد که آیا یک مقدار سفارشی در پاسخ های اضافی برای پاسخ از پیش تعریف شده مجاز است یا خیر. این فقط در شرایطی قابل اجرا است که نوع Field_search باشد. (اختیاری)
`additional_option[]`	`Text` گزینه های اضافی علاوه بر مقادیر ارائه شده ارائه شده است. فقط در صورت استفاده از نوع فیلد socation_search قابل اجرا است. Eg in addition to the provided location list, another available option can be "I will contact supplier later". (اختیاری)
`ticket_type_restrict[]`	`string` If this question should only be shown when the user books certain ticket types, this field should be set as the set of applicable ticket type ids. Leave the field empty if the question is always applicable.
`hint`	`Text` The hint text for input, which shows up as a text placeholder. This is only applicable when the field type is SHORT_ANSWER or PARAGRAPH. (اختیاری)

FieldType

Enum to indicate the type of field.

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

TaxRate

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

فیلدها

micro_percent

int32

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

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

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

شرایط

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

فیلدها

url

string

Optionally, the URL to the Terms and Conditions.

text

string

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

localized_text

Text

The localized text to be displayed to the user.

متن

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

فیلدها

value

string

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

localized_value[]

LocalizedString

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

TicketType

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

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

فیلدها
`ticket_type_id`	`string` The ticket id is used to differentiate among different ticket types of the same service, and is only expected to be unique within a service.
`short_description`	`string` A short description to this TicketType. This can be user visible, eg, “adult”, "child", “veteran”, “Row J”, etc. Required, each ticket type should have a description to be user visible. Deprecated, use localized_short_description instead.
`localized_short_description`	`Text` A short description to this TicketType with i18n support. This can be user visible, eg, “adult”, "child", “veteran”, “Row J”, etc. Required, each ticket type should have a description to be user visible. Separate values could be supplied for each locale.
`price`	`Price` The price of a single ticket of this type, exclusive of any taxes. The tax rate of Service is applied to its tickets.
`per_ticket_fee`	`PerTicketFee` Additional fees for purchasing this ticket. (اختیاری)
`option_description`	`string` Description of any additional option which this ticket type represents, if any. Deprecated, use localized_option_description instead.
`localized_option_description`	`Text` Description of any additional option which this ticket type represents, if any. Separate values could be supplied for each locale. Additional options are useful when the ticket type represents multiple dimensions. Example 1: an admission ticket with different types 'adult', 'child' and language as an additional option, the expected TicketType list would be: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } } Example 2: an multi-hour kayak rental with optional dry bag add-on, the short_description could be "3 hours" and the option_description could be either "with dry bag" or "without dry bag": - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } } Optional, but if any ticket type within the service has this field set, we expect all other ticket types to have this field set as well (a default option_description could be used). Eg [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] is not a valid list. Only two HTML formatting tags are supported: and . They are intended to be used for specifying options with both a title and detailed description, for example: " Premium Seating This option offers seating at the private boxes including fully cushioned seats, private TVs, in-seat food and beverage service. These seats provide picturesque views of the field."

TicketingVerticalSpecificData

Additional information unique to the event ticketing vertical.

فیلدها
`event_category`	`EventCategory` The category of the event. Set only when event falls into one of the predefined categories. (اختیاری)
`event_url`	`string` The URL of the event on the partner's website. (اختیاری)
`entity[]`	`Entity` A list of entities related to the event. (اختیاری)
`event_attendance_mode`	`AttendanceMode` مورد نیاز. The type of the event attendance.
`event_virtual_location_url[]`	`string` اختیاری. URL where the event can be watched.
`event_organizer`	`Text` اختیاری. Organizer who hosts the event.
`event_organizer_url`	`string` اختیاری. URL of the organizer who hosts the event.
`event_organizer_type`	`OrganizerType` اختیاری. The type of the organizer.
`event_source_url[]`	`string` مورد نیاز. URL of the pages where the event information or descriptions can be found.
`event_state`	`EventState` اختیاری. State of the event.

AttendanceMode

The type of the event attendance.

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

موجودیت

Represents an entity related to the event.

فیلدها
`id`	`string` Unique identifier of the entity in the partner's database. (اختیاری)
`name`	`string` Name of the entity. (الزامی)
`url`	`string` Url of the webpage that unambiguously describes the entity. This is the webpage on the partner's website for the entity if any; for other public URLs of the entity, use relevant_url in public_identification_data. (اختیاری)
`entity_type`	`EntityType` The type of the entity. (اختیاری)
`entity_role`	`EntityRole` The role of the entity in the event. (اختیاری)
`public_identification_data`	`PublicIdentificationData` Public references of the entity. (اختیاری)

EntityRole

The role of the entity in the event.

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

EntityType

The type of the entity. Note: not intended to be a universal ontology.

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

EventCategory

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

Enums
`EVENT_CATEGORY_UNSPECIFIED`	مشخص نشده است. Do not use.
`EVENT_CATEGORY_CONCERT`	کنسرت ها
`EVENT_CATEGORY_SPORTS`	Sports events.
`EVENT_CATEGORY_THEATRE`	Theatre events.
`EVENT_CATEGORY_EXHIBITS`	نمایشگاه ها
`EVENT_CATEGORY_WORKSHOPS_AND_CLASSES`	Workshops and Classes.

EventState

State of the event.

Enums
`EVENT_STATE_UNSPECIFIED`	مشخص نشده است.
`SCHEDULED`	The event is scheduled.
`RESCHEDULED`	The event is rescheduled.
`CANCELLED`	The event is cancelled.
`POSTPONED`	The event is postponed.

OrganizerType

The type of the organizer.

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

PublicIdentificationData

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

فیلدها

relevant_url[]

string

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

musicbrainz_id

string

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

TimeRange

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

فیلدها

start_time

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

end_time

BillingInformationFormat

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

TokenizationConfig

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

فیلدها

tokenization_parameter

map<string, string>

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

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

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

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

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

billing_information_format

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

BillingInformationFormat

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

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

ToursAndActivitiesContent

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

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

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

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

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

فیلدها
`highlights[]`	`Text` The user-visible list of highlights.
`inclusions[]`	`Text` The user-visible list of inclusions.
`exclusions[]`	`Text` The user-visible list of exclusions.
`must_know[]`	`Text` The user-visible list of important notes, use for details such as age restrictions or other conditions that make this service unsuitable.

UnsupportedPartySizeOption

Options for parties that are out of range.

فیلدها

call_merchant

CallMerchant

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

UpdateBookingRequest

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

فیلدها

update_mask

Field mask of all booking fields to be updated

booking

Booking

The booking to be updated

booking_failure

BookingFailure

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

UpdateMerchantRequest

The request to update a Merchant .

فیلدها

merchant

Merchant

The new merchant data.

update_mask

The specific fields to update for the merchant.

UpdateOrderRequest

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

فیلدها

update_mask

Field mask of all order fields to be updated

order

Order

The order to be updated

UpdateServiceRequest

The request to update a Service .

فیلدها

service

Service

The new service data.

update_mask