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)
  }
}
زمینه های
name

string

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

serviceName

string

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

localizedServiceName

object ( Text )

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

description

string

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

localizedDescription

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 )

قیمت خدمات.

priceInterpretation

enum ( PriceInterpretation )

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

rules

object ( SchedulingRules )

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

prepaymentType

enum ( PrepaymentType )

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

prepaymentTerms

object ( PrepaymentTerms )

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

form[]
(deprecated)

object ( ServiceIntakeForm )

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

intakeForm

object ( ServiceIntakeForm )

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

perTicketIntakeForm

object ( ServiceIntakeForm )

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

taxRate

object ( TaxRate )

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

paymentOptionId[]

string

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

deposit

object ( Deposit )

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

noShowFee

object ( NoShowFee )

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

requireCreditCard

enum ( RequireCreditCard )

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

type

enum ( ServiceType )

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

ticketType[]

object ( TicketType )

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

relatedMedia[]

object ( RelatedMedia )

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

serviceAttributeValueId[]

object ( ServiceAttributeValueId )

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

waitlistRules

object ( WaitlistRules )

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

ticketingVerticalSpecificData

object ( TicketingVerticalSpecificData )

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

integrationType

enum ( IntegrationType )

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

perOrderFee

object ( PerOrderFee )

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

toursAndActivitiesContent

object ( ToursAndActivitiesContent )

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

location[]

object ( Location )

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

rating

object ( Rating )

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

homeServiceData

object ( HomeServiceData )

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

virtualSession

object ( VirtualSession )

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

directMerchantPayment

object ( DirectMerchantPayment )

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

تفسیر قیمت

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

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.
}
زمینه های
minAdvanceOnlineCanceling

string ( int64 format)

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

lateCancellationFee
(deprecated)

object ( Price )

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

noshowFee
(deprecated)

object ( Price )

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

admissionPolicy

enum ( AdmissionPolicy )

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

cancellationPolicy

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 تنها می تواند یکی از موارد زیر باشد:

minAdvanceBooking

string ( int64 format)

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

minBookingBufferBeforeEndTime

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)
    }
  ]
}
زمینه های
refundCondition[]

object ( RefundCondition )

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

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

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

نمایندگی JSON
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
زمینه های
minDurationBeforeStartTime

string ( Duration format)

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

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

refundPercent

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
}
زمینه های
chargeTiming

enum ( ChargeTiming )

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

chargeTimeBeforeStartTimeSec

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 استفاده کنید.

localizedLabel

object ( Text )

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

value[]

string

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

choiceText[]

object ( Text )

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

isRequired

boolean

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

allowCustomAnswer

boolean

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

additionalOption[]

object ( Text )

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

ticketTypeRestrict[]

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)
  },
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  }
}
زمینه های
ticketTypeId

string

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

shortDescription

string

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

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

localizedShortDescription

object ( Text )

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

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

price

object ( Price )

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

perTicketFee

object ( PerTicketFee )

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

optionDescription

string

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

localizedOptionDescription

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

هزینه بلیط

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

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

object ( Price )

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

facilityFee

object ( Price )

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

taxes

object ( Price )

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

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

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

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

string

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

type

enum ( MediaType )

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

localizedCaption

object ( Text )

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

attribution

object ( Attribution )

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

caption
(deprecated)

string

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

نوع رسانه

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

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

انتساب

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

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

object ( Text )

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

text
(deprecated)

string

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

ServiceAttributeValueId

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

نمایندگی JSON
{
  "attributeId": string,
  "valueId": string
}
زمینه های
attributeId

string

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

valueId

string

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

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

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

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

integer

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

maxPartySize

integer

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

supportsAdditionalRequest

boolean

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

aboveMaxPartySizeOptions[]

object ( UnsupportedPartySizeOption )

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

UnsupportedPartySizeOption

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

نمایندگی JSON
{
  "callMerchant": {
    object (CallMerchant)
  }
}
زمینه های
callMerchant

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)
}
زمینه های
eventCategory

enum ( EventCategory )

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

eventUrl

string

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

entity[]

object ( Entity )

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

eventAttendanceMode

enum ( AttendanceMode )

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

eventVirtualLocationUrl[]

string

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

eventOrganizer

object ( Text )

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

eventOrganizerUrl

string

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

eventOrganizerType

enum ( OrganizerType )

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

eventSourceUrl[]

string

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

eventState

enum ( EventState )

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

دسته رویداد

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

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 استفاده کنید. (اختیاری)

entityType

enum ( EntityType )

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

entityRole

enum ( EntityRole )

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

publicIdentificationData

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
}
زمینه های
relevantUrl[]

string

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

musicbrainzId

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 این رویداد به تعویق افتاد.

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)
  }
}
زمینه های
deliveryFee

object ( Price )

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

processingFee

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 )

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

mustKnow[]

object ( Text )

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

محل

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

نمایندگی JSON
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
زمینه های
placeId

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 )

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

locationType

enum ( LocationType )

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

locationId

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 صفر باشد می توان آن را حذف کرد.

numberOfRatings

string

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

HomeServiceData

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

نمایندگی JSON
{
  "categoryType": string,
  "jobType": string
}
زمینه های
categoryType

string

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

jobType

string

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

جلسه مجازی

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

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

object ( Text )

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

sessionRequirements

object ( Text )

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

virtualPlatformInfo

object ( VirtualPlatformInfo )

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

isSessionPrerecorded

boolean

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

VirtualPlatformInfo

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

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

enum ( Platform )

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

otherPlatformName

object ( Text )

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

سکو

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

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

DirectMerchantPayment

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

نمایندگی JSON
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
زمینه های
paymentMethods[]

object ( Text )

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

مواد و روش ها

create

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

delete

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

patch

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