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} است.

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

نکات مهم:

  • سعی کنید از تگ‌های دیگری به جز تگ‌های پشتیبانی‌شده‌ی ذکر شده در بالا استفاده نکنید، زیرا محتوای درون تگ‌های پشتیبانی‌نشده حذف می‌شود و ممکن است منجر به یک تجربه کاربری نامطلوب شود.
  • سعی کنید از ساختارهای تو در تو و عمیق مانند بیش از ۳ سطح عنوان مختلف یا لیست‌های تو در تو خودداری کنید. حفظ ساختار مسطح، ساده و سرراست، به ایجاد یک تجربه کاربری بهتر کمک می‌کند.
  • اگر طرح‌بندی‌های پشتیبانی‌شده‌ی فعلی برای موارد استفاده‌ی شما کافی نیستند، لطفاً با تیم رزرو گوگل تماس بگیرید.
  • حداکثر اندازه توصیه شده ۳۲۰۰۰ کاراکتر است.
price

object ( Price )

قیمت خدمات.

priceInterpretation

enum ( PriceInterpretation )

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

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

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

deposit

object ( Deposit )

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

noShowFee

object ( NoShowFee )

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

requireCreditCard

enum ( RequireCreditCard )

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

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 )

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

rating

object ( Rating )

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

homeServiceData

object ( HomeServiceData )

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

virtualSession

object ( VirtualSession )

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

directMerchantPayment

object ( DirectMerchantPayment )

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

uriTemplate

object ( UriTemplate )

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

تفسیر قیمت

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

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

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

مثال‌ها: ۲۰ دلار برای کلاس یوگا؛ ۱۵ دلار برای کوتاهی موی کودک

STARTS_AT

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

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

مثال‌ها: ۳۰ دلار برای آرایش سگ، اما گزینه‌های بیشتر برای مصرف‌کننده ممکن است قیمت را افزایش دهد

NOT_DISPLAYED

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

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

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

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

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

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

مثال‌ها:

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

  • موزه‌ای که آخرین بلیط را می‌توان ۳۰ دقیقه قبل از بسته شدن خریداری کرد: '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 تنظیم شود تا نشان دهد که کاربران می‌توانند پس از شروع جایگاه‌ها از بلیط‌های خریداری شده استفاده کنند.

سیاست پذیرش

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

انوم‌ها
ADMISSION_POLICY_UNSPECIFIED استفاده نشده.
TIME_STRICT مشتریان ملزم به حضور در زمان شروع بازه زمانی موجود هستند و انتظار می‌رود که سرویس در زمان پایان بازه زمانی به پایان برسد. نمونه‌هایی از موارد استفاده TIME_STRICT: * توری که ساعت ۹ صبح شروع می‌شود و مستلزم رسیدن همه شرکت‌کنندگان در زمان شروع است و بازگشت حدود ساعت ۱۲ ظهر. * رزرو آرایشگاه ساعت ۳ بعد از ظهر روز شنبه که تقریباً ۳۰ دقیقه طول می‌کشد. * کلاس تناسب اندام از ساعت ۶ بعد از ظهر تا ۸ شب.
TIME_FLEXIBLE

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

نمونه‌هایی از موارد استفاده از TIME_FLEXIBLE: * بلیط موزه که می‌توان در هر زمانی از تاریخ خرید از آن استفاده کرد. * بلیط ورودی بعدازظهر به یک شهربازی که می‌توان از ساعت ۱۲ ظهر تا ۹ شب از آن استفاده کرد.

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

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

برای مثال، در سناریوی ورود به موزه، یک بلیط ورودی زمان‌بندی‌شده برای ساعت ۱۰ صبح مستلزم آن است که کاربر ساعت ۱۰ صبح در موزه باشد. زمان شروع بازه‌های زمانی خالی برای این سرویس، زمان ورود تعیین‌شده را نشان می‌دهد. با این حال، زمان پایان صرفاً به عنوان کلیدی برای شناسایی بازه زمانی خالی برای رزرو استفاده می‌شود.

سیاست لغو

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

نمایش 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 برای نشان دادن نوع پیش‌پرداخت.

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

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

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

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

enum ( ChargeTiming )

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

chargeTimeBeforeStartTimeSec

string ( int64 format)

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

زمان‌بندی شارژ

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

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

فرم پذیرش خدمات

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

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

object ( ServiceIntakeFormField )

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

firstTimeCustomers
(deprecated)

boolean

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

returningCustomers
(deprecated)

boolean

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

فیلد فرم دریافت سرویس

فیلدی را تعریف می‌کند که در 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 یا ROPDOWN باشد، تنظیم کنید. برای شمارش گزینه‌های ممکن استفاده می‌شود.

isRequired

boolean

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

allowCustomAnswer

boolean

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

additionalOption[]

object ( Text )

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

ticketTypeRestrict[]

string

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

hint

object ( Text )

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

نوع فیلد

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

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

نوع سرویس

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

انوم‌ها
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 برای تمایز قائل شدن بین بلیط‌هایی با قیمت‌ها و/یا موجودی‌های مختلف به دلیل انواع مختلف کاربر، ویژگی‌های مختلف سرویس یا گزینه‌ها/افزونه‌های مختلف استفاده می‌شود.

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

نمایش 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)
}
فیلدها
ticketTypeId

string

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

shortDescription

string

توضیح مختصری در مورد این TicketType.

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

localizedShortDescription

object ( Text )

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

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

price

object ( Price )

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

perTicketFee

object ( PerTicketFee )

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

priceDisplayType

enum ( PriceDisplayType )

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

optionDescription

string

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

localizedOptionDescription

object ( Text )

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

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

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

مثال ۲: یک کایاک اجاره‌ای چند ساعته با قابلیت اضافه کردن کیسه خواب اختیاری، shortDescription می‌تواند "۳ ساعت" باشد و optionDescription می‌تواند "با کیسه خواب" یا "بدون کیسه خواب" باشد: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "spanish" } }

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

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

inventoryType

enum ( InventoryType )

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

هزینه بلیط

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

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

object ( Price )

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

facilityFee

object ( Price )

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

taxes

object ( Price )

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

نوع نمایش قیمت

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

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

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

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

نوع موجودی

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

انوم‌ها
INVENTORY_TYPE_UNSPECIFIED نوع موجودی مشخص نیست.
INVENTORY_TYPE_PRIMARY موجودی اولیه.
INVENTORY_TYPE_VERIFIED_RESALE موجودی تایید شده برای فروش مجدد.
INVENTORY_TYPE_RESALE موجودی فروش مجدد.
INVENTORY_TYPE_AGGREGATOR موجودی تجمیع‌کننده. تجمیع‌کننده (مثلاً www.bandsintown.com) به این معنی است که شریک، اطلاعات رویدادها و بلیط‌ها را ارائه می‌دهد. اما بلیط‌ها مستقیماً توسط شریک فروخته نمی‌شوند. فروشنده واقعی بلیط می‌تواند اصلی، فروش مجدد تأیید شده یا فروش مجدد باشد. اکنون ما فقط نوع موجودی شریک سطح بالا را متمایز می‌کنیم و نوع موجودی فروشنده واقعی بلیط را در یک تجمیع‌کننده نادیده می‌گیریم.

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

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

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

string

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

type

enum ( MediaType )

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

localizedCaption

object ( Text )

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

attribution

object ( Attribution )

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

caption
(deprecated)

string

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

مدیاتایپ

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

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

انتساب

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

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

object ( Text )

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

text
(deprecated)

string

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

شناسه‌ی مقدار ویژگی سرویس

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

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

string

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

valueId

string

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

قوانین لیست انتظار

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

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

integer

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

maxPartySize

integer

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

supportsAdditionalRequest

boolean

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

aboveMaxPartySizeOptions[]

object ( 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 می‌تواند فقط یکی از موارد زیر باشد:
callMerchant

object ( CallMerchant )

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

کال مرچنت

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

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

داده‌های خاص عمودی

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

نمایش 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)
  }
}
فیلدها
eventCategory

enum ( EventCategory )

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

eventUrl

string

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

entity[]

object ( Entity )

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

eventAttendanceMode

enum ( AttendanceMode )

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

eventVirtualLocationUrl[]

string

اختیاری. آدرس اینترنتی (URL) که می‌توان رویداد را در آن تماشا کرد.

eventOrganizer

object ( Text )

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

eventOrganizerUrl

string

اختیاری. نشانی اینترنتی (URL) برگزارکننده‌ای که میزبان رویداد است.

eventOrganizerType

enum ( OrganizerType )

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

eventSourceUrl[]

string

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

eventState

enum ( EventState )

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

brandName

object ( Text )

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

eventCreator

object ( EventCreator )

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

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

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

انوم‌ها
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) صفحه وبی که به طور واضح موجودیت را توصیف می‌کند. این صفحه وب در وب‌سایت شریک برای موجودیت مورد نظر (در صورت وجود) است؛ برای سایر URLهای عمومی موجودیت، از آدرس اینترنتی مرتبط (relatedUrl) در publicIdentificationData استفاده کنید. (اختیاری)

entityType

enum ( EntityType )

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

entityRole

enum ( EntityRole )

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

publicIdentificationData

object ( PublicIdentificationData )

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

نوع موجودیت

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

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

نقش نهادی

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

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

داده‌های شناسایی عمومی

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

نمایش JSON 
{
  "relevantUrl": [
    string
  ],
  "musicbrainzId": string
}
فیلدها
relevantUrl[]

string

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

musicbrainzId

string

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

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

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

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

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

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

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

وضعیت رویداد

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

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

خالق رویداد

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

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

string

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

نوع ادغام

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

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

هزینه هر سفارش

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

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

object ( Price )

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

processingFee

object ( Price )

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

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

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

پر کردن ToursAndActivitiesContent برای تورها و فعالیت‌ها اکیداً توصیه می‌شود، اما اکیداً الزامی نیست. همه فیلدها از متن ساده و متن شبه 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 و در نقشه‌های گوگل. برای اطلاعات بیشتر در مورد شناسه‌های مکان به https://developers.google.com/places/web-service/place-id مراجعه کنید. در صورت ارائه این شناسه، گوگل مکان را با این مکان مطابقت می‌دهد.

name

string

نام، تلفن، آدرس اینترنتی (URL) و اطلاعات جغرافیایی مکان برای تطبیق مکان با مکان‌های موجود در نقشه‌های گوگل (Google Maps) استفاده می‌شوند.

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

telephone

string

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

url

string

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

geo

object ( GeoCoordinates )

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

locationType

enum ( LocationType )

اگر این مکان برای ارائه خدمات ارائه می‌شود، نوع آن باید ارائه شود.

locationId

string

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

نوع مکان

نوع این مکان.

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

رتبه‌بندی

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

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

number

Average rating value (required when numberOfRatings > 0). The value must be in the range of [1, 5] and can be omitted if and only if the numberOfRatings is zero.

numberOfRatings

string

Number of ratings used in calculating the value (required).

HomeServiceData

Additional information required to be provided for home service vertical.

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

string

The high level category to which this home service belongs to. Eg plumber, electrician etc.

jobType

string

The job type under the category to which the given home service belongs to. Eg unclog_drain, install_faucet are the job types under plumber category.

VirtualSession

Information about virtual/online session. Eg Online yoga class, virtual cooking class etc.

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

object ( Text )

Instructions on how this virtual class is set up. If the partner does not include the video URL with the booking, then this text must include when the video URL will be shared with the user. Eg. “Zoom url will be mailed 30 minutes prior to the class”. (Recommended)

sessionRequirements

object ( Text )

Requirements for the given virtual session. Eg. yoga mat, cooking utensils etc. (Recommended)

virtualPlatformInfo

object ( VirtualPlatformInfo )

Information about the virtual platform used in this session. (Required to enable virtual services)

isSessionPrerecorded

boolean

Required. Set this as true if the virtual session is not live and is pre-recorded.

VirtualPlatformInfo

Information about platform which will be used for this virtual session.

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

enum ( Platform )

Platform used for virtual session.

otherPlatformName

object ( Text )

The name of the platform if the platform is set to OTHER. (Required if platform is set to OTHER)

پلتفرم

Enum to indicate which virtual platform would be used by the merchant.

انوم‌ها
PLATFORM_UNSPECIFIED Unused.
FLEXIBLE The merchant is flexible in which video platform they use.
GOOGLE_HANGOUTS Google Hangouts product.
GOOGLE_MEET Google Meet product.
ZOOM Zoom Video Communications.
SKYPE Skype.
YOUTUBE Livestreaming in YouTube.
OTHER Should be set if the video platform used is different from the ones mentioned here.

DirectMerchantPayment

Information about how the user can pay directly to the merchant instead of pre-paying for the service via RwG.

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

object ( Text )

Users would be advised to pay only via the payment methods mentioned below.

UriTemplate

A template specifying how Google should generate URLs to external site.

نمایش JSON 
{
  "uriTemplate": string
}
فیلدها
uriTemplate

string

Optional. The uri template must follow the RFC6570, see https://datatracker.ietf.org/doc/html/rfc6570 . Supports Level 2 templates. These parameters will be resolved to their values specified in their respective entities.

Available parameters for Dining Reservation Linkout: 1) (required) {availability_slot_start_seconds} :: populated from startSec field in availability feed 2) (required) {resources_party_size} :: populated from partySize field in availability feed 3) (optional) {availability_slot_duration_seconds} :: populated from durationSec field in availability feed 4) (optional) {availability_slot_availability_tag} :: populated from availabilityTag field in availability feed

Example usage: http://example.com/book/restaurant?start={availability_slot_start_seconds } &num_guests={resources_party_size}

With: * startSec = 123456 * partySize = 2

https://example.com/book/restaurant?start=123456&num_guests=2

روش‌ها

create

 Creates a new Service of a merchant managed by the specified aggregator, and returns it.

delete

 Deletes an existing Service of a merchant managed by the specified aggregator.

patch

 Updates an existing Service of a merchant managed by the specified aggregator, and returns it.