REST Resource: inventory.partners.merchants.services

منبع: خدمات

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

نمایندگی JSON
{
  "name": string,
  "serviceName": string,
  "localizedServiceName": {
    object (Text)
  },
  "description": string,
  "localizedDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "priceInterpretation": enum (PriceInterpretation),
  "rules": {
    object (SchedulingRules)
  },
  "prepaymentType": enum (PrepaymentType),
  "prepaymentTerms": {
    object (PrepaymentTerms)
  },
  "form": [
    {
      object (ServiceIntakeForm)
    }
  ],
  "intakeForm": {
    object (ServiceIntakeForm)
  },
  "perTicketIntakeForm": {
    object (ServiceIntakeForm)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionId": [
    string
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "type": enum (ServiceType),
  "ticketType": [
    {
      object (TicketType)
    }
  ],
  "relatedMedia": [
    {
      object (RelatedMedia)
    }
  ],
  "serviceAttributeValueId": [
    {
      object (ServiceAttributeValueId)
    }
  ],
  "waitlistRules": {
    object (WaitlistRules)
  },
  "ticketingVerticalSpecificData": {
    object (TicketingVerticalSpecificData)
  },
  "integrationType": enum (IntegrationType),
  "perOrderFee": {
    object (PerOrderFee)
  },
  "toursAndActivitiesContent": {
    object (ToursAndActivitiesContent)
  },
  "location": [
    {
      object (Location)
    }
  ],
  "rating": {
    object (Rating)
  },
  "homeServiceData": {
    object (HomeServiceData)
  },
  "virtualSession": {
    object (VirtualSession)
  },
  "directMerchantPayment": {
    object (DirectMerchantPayment)
  },
  "uriTemplate": {
    object (UriTemplate)
  }
}
فیلدها
name

string

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

service Name

string

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

localized Service Name

object ( Text )

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

description

string

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

localized Description

object ( 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 ها، لنگرها و پیوندها حذف می شوند و هرگز به کاربران نهایی نمایش داده نمی شوند. اگر می‌خواهید از عکس‌ها برای ایجاد یک تجربه کاربری غنی استفاده کنید، لطفاً از فیلد "relatedMedia" زیر برای ارسال URL عکس‌های خود استفاده کنید.

نکات مهم:

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

object ( Price )

قیمت خدمات.

price Interpretation

enum ( PriceInterpretation )

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

rules

object ( SchedulingRules )

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

prepayment Type

enum ( PrepaymentType )

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

prepayment Terms

object ( PrepaymentTerms )

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

form[]
(deprecated)

object ( ServiceIntakeForm )

منسوخ شده است. لطفا از intakeForm و perTicketIntakeForm استفاده کنید.

intake Form

object ( ServiceIntakeForm )

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

per Ticket Intake Form

object ( ServiceIntakeForm )

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

tax Rate

object ( TaxRate )

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

payment Option Id[]

string

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

deposit

object ( Deposit )

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

no Show Fee

object ( NoShowFee )

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

require Credit Card

enum ( RequireCreditCard )

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

type

enum ( ServiceType )

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

ticket Type[]

object ( TicketType )

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

related Media[]

object ( RelatedMedia )

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

service Attribute Value Id[]

object ( ServiceAttributeValueId )

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

waitlist Rules

object ( WaitlistRules )

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

ticketing Vertical Specific Data

object ( TicketingVerticalSpecificData )

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

integration Type

enum ( IntegrationType )

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

per Order Fee

object ( PerOrderFee )

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

tours And Activities Content

object ( ToursAndActivitiesContent )

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

location[]

object ( Location )

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

rating

object ( Rating )

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

home Service Data

object ( HomeServiceData )

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

virtual Session

object ( VirtualSession )

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

direct Merchant Payment

object ( DirectMerchantPayment )

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

uri Template

object ( UriTemplate )

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

تفسیر قیمت

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

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

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

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

STARTS_AT

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

توجه داشته باشید که هر سرویسی که از این تفسیر قیمت استفاده می‌کند باید از PrepaymentType NOT_SUPPORTED استفاده کند.

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

NOT_DISPLAYED

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

توجه داشته باشید که هر سرویسی که از این PriceInterpretation استفاده می‌کند باید از PrepaymentType NOT_SUPPORTED استفاده کند و قیمت باید خالی باشد.

مثال: مشاوره برای خدمات خانگی

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

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

نمایندگی JSON
{
  "minAdvanceOnlineCanceling": string,
  "lateCancellationFee": {
    object (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

  // Union field min_booking_buffer can be only one of the following:
  "minAdvanceBooking": string,
  "minBookingBufferBeforeEndTime": string
  // End of list of possible types for union field min_booking_buffer.
}
فیلدها
min Advance Online Canceling

string ( int64 format)

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

lateCancellationFee
(deprecated)

object ( Price )

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

noshowFee
(deprecated)

object ( Price )

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

admission Policy

enum ( AdmissionPolicy )

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

cancellation Policy

object ( 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

string ( int64 format)

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

min Booking Buffer Before End Time

string ( int64 format)

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

سیاست لغو

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

نمایندگی JSON
{
  "refundCondition": [
    {
      object (RefundCondition)
    }
  ]
}
فیلدها
refund Condition[]

object ( RefundCondition )

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

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

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

نمایندگی JSON
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
فیلدها
min Duration Before Start Time

string ( Duration format)

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

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

refund Percent

integer ( uint32 format)

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

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

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

Enums
PREPAYMENT_TYPE_UNSPECIFIED به طور پیش‌فرض فرض می‌کنیم که پیش‌پرداخت NOT_SUPPORTED است.
REQUIRED کاربر باید در زمان رزرو این سرویس را پرداخت کند.
OPTIONAL کاربر می تواند انتخاب کند که این سرویس را در زمان رزرو یا بعد از آن پیش پرداخت کند، اما برای رزرو الزامی نیست.
NOT_SUPPORTED پیش پرداخت برای این سرویس پشتیبانی نمی شود.

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

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

نمایندگی JSON
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
فیلدها
charge Timing

enum ( ChargeTiming )

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

charge Time Before Start Time Sec

string ( int64 format)

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

ChargeTiming

Enum برای تعیین زمان شارژ نسبت به زمان خرید.

Enums
CHARGE_TIMING_UNSPECIFIED استفاده نشده
CHARGE_NOW مشتری بلافاصله شارژ می شود.
CHARGE_LATER بعداً هزینه مشتری دریافت می شود.

ServiceIntakeForm

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

نمایندگی JSON
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
فیلدها
field[]

object ( ServiceIntakeFormField )

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

firstTimeCustomers
(deprecated)

boolean

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

returningCustomers
(deprecated)

boolean

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

ServiceIntakeFormField

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

نمایندگی JSON
{
  "id": string,
  "type": enum (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
فیلدها
id

string

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

type

enum ( FieldType )

نوع این رشته

label

string

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

localized Label

object ( Text )

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

value[]

string

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

choice Text[]

object ( Text )

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

is Required

boolean

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

allow Custom Answer

boolean

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

additional Option[]

object ( Text )

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

ticket Type Restrict[]

string

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

hint

object ( Text )

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

نوع فیلد

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

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

نوع سرویس

انواع خدمات از پیش تعریف شده

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

TicketType

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

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

نمایندگی JSON
{
  "ticketTypeId": string,
  "shortDescription": string,
  "localizedShortDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "priceDisplayType": enum (PriceDisplayType),
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  },
  "inventoryType": enum (InventoryType)
}
فیلدها
ticket Type Id

string

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

short Description

string

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

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

localized Short Description

object ( Text )

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

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

price

object ( Price )

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

per Ticket Fee

object ( PerTicketFee )

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

price Display Type

enum ( PriceDisplayType )

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

option Description

string

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

localized Option Description

object ( Text )

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

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

مثال 1: بلیط ورودی با انواع مختلف "بزرگسال"، "کودک" و زبان به عنوان گزینه اضافی، لیست TicketType مورد انتظار این خواهد بود: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: " انگلیسی" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localized "Optionenglishion" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } }

مثال 2: اجاره کایاک چند ساعته با افزودنی کیسه خشک اختیاری، shortDescription می تواند "3 ساعت" باشد و optionDescription می تواند "با کیسه خشک" یا "بدون کیسه خشک" باشد: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 ساعت" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 ساعت" } localizedOptionDescription { value: "اسپانیایی" } } - { ticketTypeId: "3ket" localizedShortDescription { value: "3 ساعت" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 ساعت" } localizedOptionDescription { value: "spanish" } }

اختیاری است، اما اگر هر نوع بلیط در سرویس دارای این فیلد تنظیم شده باشد، انتظار داریم همه انواع بلیط های دیگر نیز این فیلد را تنظیم کنند (یک گزینه پیش فرض Description می تواند استفاده شود). به عنوان مثال [{ticket_type_1, adult, English}, {ticket_type_1, adult, ''}] لیست معتبری نیست.

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

inventory Type

enum ( InventoryType )

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

هزینه بلیط

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

نمایندگی JSON
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
فیلدها
service Charge

object ( Price )

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

facility Fee

object ( Price )

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

taxes

object ( Price )

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

PriceDisplayType

فرمت قیمت نمایش داده شده در صفحه فرود را نشان می دهد.

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

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

Enums
PRICE_DISPLAY_TYPE_UNSPECIFIED نوع نمایش قیمت مشخص نشده است. Google تعیین خواهد کرد که کدام قالب را نشان دهد.
PRICE_DISPLAY_TYPE_BASE قیمت نشان داده شده در صفحه فرود، قیمت پایه است.
PRICE_DISPLAY_TYPE_ALL_IN قیمت نشان داده شده در صفحه فرود شامل کلیه هزینه ها و مالیات است.

InventoryType

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

Enums
INVENTORY_TYPE_UNSPECIFIED نوع موجودی مشخص نشده است.
INVENTORY_TYPE_PRIMARY موجودی اولیه
INVENTORY_TYPE_VERIFIED_RESALE موجودی فروش مجدد تایید شده
INVENTORY_TYPE_RESALE موجودی مجدد فروش.
INVENTORY_TYPE_AGGREGATOR موجودی تجمیع کننده.

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

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

نمایندگی JSON
{
  "url": string,
  "type": enum (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
فیلدها
url

string

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

type

enum ( MediaType )

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

localized Caption

object ( Text )

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

attribution

object ( Attribution )

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

caption
(deprecated)

string

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

MediaType

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

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

انتساب

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

نمایندگی JSON
{
  "localizedText": {
    object (Text)
  },
  "text": string
}
فیلدها
localized Text

object ( Text )

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

text
(deprecated)

string

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

ServiceAttributeValueId

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

نمایندگی JSON
{
  "attributeId": string,
  "valueId": string
}
فیلدها
attribute Id

string

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

value Id

string

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

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

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

نمایندگی JSON
{
  "minPartySize": integer,
  "maxPartySize": integer,
  "supportsAdditionalRequest": boolean,
  "aboveMaxPartySizeOptions": [
    {
      object (UnsupportedPartySizeOption)
    }
  ]
}
فیلدها
min Party Size

integer

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

max Party Size

integer

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

supports Additional Request

boolean

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

above Max Party Size Options[]

object ( UnsupportedPartySizeOption )

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

UnsupportedPartySizeOption

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

نمایندگی JSON
{

  // Union field kind can be only one of the following:
  "callMerchant": {
    object (CallMerchant)
  }
  // End of list of possible types for union field kind.
}
فیلدها
kind میدان اتحادیه . گزینه های موجود برای مهمانی هایی که خارج از محدوده هستند. kind می تواند تنها یکی از موارد زیر باشد:
call Merchant

object ( CallMerchant )

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

Call Merchant

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

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

TicketingVerticalSpecificData

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

نمایندگی JSON
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState),
  "brandName": {
    object (Text)
  },
  "eventCreator": {
    object (EventCreator)
  }
}
فیلدها
event Category

enum ( EventCategory )

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

event Url

string

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

entity[]

object ( Entity )

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

event Attendance Mode

enum ( AttendanceMode )

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

event Virtual Location Url[]

string

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

event Organizer

object ( Text )

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

event Organizer Url

string

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

event Organizer Type

enum ( OrganizerType )

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

event Source Url[]

string

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

event State

enum ( EventState )

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

brand Name

object ( Text )

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

event Creator

object ( EventCreator )

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

دسته رویداد

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

Enums
EVENT_CATEGORY_UNSPECIFIED مشخص نشده است. استفاده نکنید.
EVENT_CATEGORY_CONCERT کنسرت ها
EVENT_CATEGORY_SPORTS رویدادهای ورزشی
EVENT_CATEGORY_THEATRE رویدادهای تئاتر
EVENT_CATEGORY_EXHIBITS نمایشگاه ها
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES کارگاه ها و کلاس ها

موجودیت

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

نمایندگی JSON
{
  "id": string,
  "name": string,
  "url": string,
  "entityType": enum (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
فیلدها
id

string

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

name

string

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

url

string

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

entity Type

enum ( EntityType )

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

entity Role

enum ( EntityRole )

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

public Identification Data

object ( PublicIdentificationData )

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

EntityType

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

Enums
ENTITY_TYPE_UNSPECIFIED مشخص نشده است. استفاده نکنید.
ENTITY_TYPE_PERFORMER نهاد معرف هنرمند یا گروهی است که در یک کنسرت یا نمایش اجرا می کند. فقط زمانی قابل اعمال است که دسته رویداد کنسرت یا تئاتر باشد.
ENTITY_TYPE_PLAYER این نهاد نماینده تیم ورزشی یا بازیکن در رویداد است. فقط زمانی قابل اجراست که دسته رویداد ورزشی باشد.
ENTITY_TYPE_CONCERT_TOUR نهاد نشان دهنده توری است که این رویداد به آن تعلق دارد. فقط زمانی قابل اعمال است که دسته رویداد CONCERT باشد.
ENTITY_TYPE_SPORTS_SERIES نهاد یک تورنمنت ورزشی است که این رویداد به آن تعلق دارد. فقط زمانی قابل اجراست که دسته رویداد ورزشی باشد.
ENTITY_TYPE_PLAY موجودیت نشان دهنده نوع نمایش (مثلاً موزیکال، کمدی، باله و غیره) است که در رویداد اجرا می شود. فقط زمانی قابل اعمال است که دسته رویداد تئاتر باشد.

EntityRole

نقش نهاد در رویداد.

Enums
ENTITY_ROLE_UNSPECIFIED مشخص نشده است.
ENTITY_ROLE_HEADLINER این نهاد نشان دهنده یک تیتر یا مجری پیشرو در رویداد است.
ENTITY_ROLE_SUPPORTER این نهاد یک مجری حامی در رویداد را نمایندگی می کند.
ENTITY_ROLE_HOME_TEAM این نهاد نماینده تیم میزبان در رویداد (ورزشی) است.
ENTITY_ROLE_AWAY_TEAM این نهاد نماینده تیم میهمان در رویداد (ورزشی) است.

PublicIdentificationData

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

نمایندگی JSON
{
  "relevantUrl": [
    string
  ],
  "musicbrainzId": string
}
فیلدها
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 مراجعه کنید. (اختیاری)

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

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

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

OrganizerType

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

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

EventState

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

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

EventCreator

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

نمایندگی JSON
{
  "name": string
}
فیلدها
name

string

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

IntegrationType

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

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

PerOrderFee

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

نمایندگی JSON
{
  "deliveryFee": {
    object (Price)
  },
  "processingFee": {
    object (Price)
  }
}
فیلدها
delivery Fee

object ( Price )

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

processing Fee

object ( Price )

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

محتوای تورها و فعالیت ها

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

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

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

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

نکات مهم: * داده های ارائه شده در highlights ، exclusion و سایر فیلدهای خاص تر در توضیحات سرویس را تکرار نکنید. * از استفاده از برچسب های دیگر به جز موارد پشتیبانی شده ذکر شده در بالا خودداری کنید، زیرا محتویات داخل برچسب های پشتیبانی نشده پاک می شوند و ممکن است منجر به تجربه کاربری نامطلوب شوند.

نمایندگی JSON
{
  "highlights": [
    {
      object (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
فیلدها
highlights[]

object ( Text )

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

inclusions[]

object ( Text )

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

exclusions[]

object ( Text )

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

must Know[]

object ( Text )

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

مکان

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

نمایندگی JSON
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
فیلدها
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

object ( GeoCoordinates )

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

location Type

enum ( LocationType )

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

location Id

string

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

نوع مکان

نوع این مکان.

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

رتبه بندی

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

نمایندگی JSON
{
  "value": number,
  "numberOfRatings": string
}
فیلدها
value

number

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

number Of Ratings

string

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

HomeServiceData

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

نمایندگی JSON
{
  "categoryType": string,
  "jobType": string
}
فیلدها
category Type

string

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

job Type

string

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

جلسه مجازی

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

نمایندگی JSON
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
فیلدها
session Instructions

object ( Text )

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

session Requirements

object ( Text )

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

virtual Platform Info

object ( VirtualPlatformInfo )

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

is Session Prerecorded

boolean

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

VirtualPlatformInfo

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

نمایندگی JSON
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
فیلدها
platform

enum ( Platform )

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

other Platform Name

object ( Text )

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

پلت فرم

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

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

پیش پرداخت

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

نمایندگی JSON
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
فیلدها
payment Methods[]

object ( Text )

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

ادرار کردن

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

نمایندگی JSON
{
  "uriTemplate": string
}
فیلدها
uri Template

string

اختیاری. الگوی URI باید RFC6570 را دنبال کند ، به https://datatracker.ietf.org/doc/html/rfc6570 مراجعه کنید. از الگوهای سطح 2 پشتیبانی می کند. این پارامترها به مقادیر آنها مشخص شده در موجودات مربوطه برطرف می شود.

5 available parameters for Dining Reservation Linkout: 1) (required) {availability_slot_start_seconds} :: populated from startSec field in availability feed 2) (required) {availability_slot_duration_seconds} :: populated from durationSec field in availability feed 3) (optional) {resources_party_size} :: از قسمت Partysize در فید در دسترس بودن 4) (اختیاری) {در دسترس بودن_ائیل بودن_تگ} :: از قسمت در دسترس بودن در دسترس در دسترس بودن 5) (اختیاری) {Resources_room_id} :: جمعیتی از قسمت رده در دسترس در دسترس است.

استفاده از مثال: http://example.com/book/restaurant؟start= { availability_slot_start_seconds} & num_guests = {party_size} * startSec = 123456 * partysize = 2 https://example.com/xample.com/restauranteaurantkeaurantkntaurantkntaurantkntarantkntarantkntarantsobreanteaurantkntaurantkntarantsobooksoverantsobook/

روش ها

create

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

delete

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

patch

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