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.> إلى تحويل الأطفال الذين تقلّ أعمارهم عن <ul> أو <ol>. سيتم تجاهل جميع الأطفال الآخرين. وسيتم أيضًا تجاهل أي علامات وسمات وأنماط داخلية، ونحن نحتفظ فقط بمحتوى النص الخالص.

علامة القسمة: <div>
سيتم تحليل جميع العلامات الداخلية المتوافقة مع العلامة <div> باستخدام القواعد المذكورة أعلاه، ويُرجى الإشارة ضمنًا إلى أنّ العلامة <div> نفسها لا تعني أي تجميع أو مسافة بادئة هنا. وسيتم أيضًا تجاهل أي سمات وأنماط داخلية.

علامات العبارة: <br> و<strong> و<em>:
يمكن استخدام العلامات الثلاث المذكورة أعلاه فقط. <br> يمكن استخدامها لكسر الأسطر في الفقرات، ويمكن استخدام <strong>/<em> لتمييز النص المهم. وسيتم تجاهل أي علامات عبارات أخرى.

علامات غير متوافقة:

  • علامات <html> و<header> و <body> غير مسموح بها.
  • ولا يمكن استخدام أي علامات أخرى غير مذكورة أعلاه (مثل <table> و<td> ...).
    ستتم إزالة أي عناوين URL وعلامات ارتساء وروابط ولن يتم عرضها مطلقًا للمستخدمين. إذا أردت استخدام الصور لترك انطباع غني لدى المستخدم، يُرجى استخدام الحقل "relatedMedia" أدناه لإرسال عناوين URL لصورك.

ملاحظات مهمّة:

  • حاول عدم استخدام علامات أخرى باستثناء العلامات المتوافقة المذكورة أعلاه، لأنّه ستتم إزالة المحتوى ضمن العلامات غير المتوافقة، وقد يؤدي ذلك إلى تقديم تجربة غير مرغوب فيها للمستخدم.
  • حاول تجنب البنى المتداخلة العميقة مثل أكثر من 3 مستويات عناوين مختلفة أو قوائم متداخلة. يساعد المحافظة على بساطة البنية وبساطتها ومباشرةً في تقديم تجربة أفضل للمستخدم.
  • إذا لم تكن التنسيقات المتوافقة حاليًا كافية لحالات الاستخدام، يُرجى التواصل مع فريق "الحجز عبر Google".
  • والحدّ الأقصى المقترَح هو 32,000 حرف.
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)

الصور ذات الصلة بهذه الخدمة. ستزحف Google إلى الوسائط وتخزّنها لضمان عرضها للمستخدمين النهائيين بأكثر الطرق فعالية. (اختياري)
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 ولم تكن الخدمة مجانية أو عدم ضبط نوع الدفع المسبق على "مطلوب".

PriceInterpretation

توضح كيفية تفسير السعر وعرضه للمستخدم.

عمليات التعداد
PRICE_INTERPRETATION_UNSPECIFIED تفسير السعر غير محدد، ويتم الضبط تلقائيًا على EXACT_AMOUNT.
EXACT_AMOUNT

الحالات التي يجب فيها تفسير السعر على أنّه قيمة محدّدة

أمثلة: 20 دولارًا لفصل اليوغا، و15 دولارًا لقص شعر الطفل
STARTS_AT

يشير ذلك المصطلح إلى تغيّر سعر خدمة ما، مع العِلم أنّ الحدّ الأدنى للسعر معروف وعرضه للمستهلكين. ويمكن للمستهلكين اتخاذ خيارات تزيد السعر.

تجدر الإشارة إلى أنّ أي خدمة تستخدم السعر الحالي يجب أن تستخدم PrepaymentType NOT_SUPPORTED.

أمثلة: 30 ريال سعودي للعناية بالكلاب، ولكن قد تؤدّي خيارات المستهلك الإضافية إلى زيادة السعر
NOT_DISPLAYED

عندما يتغيّر سعر خدمة ولا يتم عرض أي معلومات عن السعر للمستهلكين مسبقًا.

تجدر الإشارة إلى أنّ أي خدمة تستخدم حساب السعر هذا يجب أن تستخدم نوع الدفع المسبق NOT_SUPPORTED ويجب أن يكون السعر فارغًا.

أمثلة: استشارة لخدمة منزلية

SchedulingRules

قواعد الجدولة لخدمة.

تمثيل 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"، يتم احتساب آخر وقت قابل للحجز على النحو التالي (<وقت بدء الخانة> - "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 ...}`

  • متحف يمكن فيه شراء التذكرة الأخيرة قبل 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 للإشارة إلى أنه يمكن للمستخدمين استخدام التذاكر التي تم شراؤها بعد بدء الخانات.

AdmissionPolicy

سياسة القبول في هذه الخدمة.

عمليات التعداد
ADMISSION_POLICY_UNSPECIFIED غير مستخدَمة
TIME_STRICT ويُطلب من العملاء أن يكونوا حاضرين في وقت بدء خانة مدى التوفّر، ومن المتوقّع أن تنتهي الخدمة في وقت انتهاء الخانة. أمثلة على حالات استخدام TIME_STRICT: * جولة تبدأ في الساعة 9 صباحًا وتتطلب من كل الحاضرين الوصول في وقت البدء، وتعود في حوالي الساعة 12 ظهرًا. * حجز قص شعر في الساعة 3 بعد الظهر يوم السبت، ويستغرق حوالي 30 دقيقة. * صف لياقة بدنية من الساعة 6 مساءً إلى 8 مساءً.
TIME_FLEXIBLE

يمكن للعملاء الوصول في أي وقت بين وقتَي البدء والانتهاء لخانة مدى التوفّر لاستخدام هذا الحجز.

أمثلة على حالات استخدام TIME_FLEXIBLE: * تذكرة متحف يمكن استخدامها خلال أي وقت في تاريخ الشراء. * دخول إلى مدينة الملاهي بعد الظهر ويمكن استخدامها من الساعة 12 ظهرًا إلى 9 مساءً.
TIMED_ENTRY_WITH_FLEXIBLE_DURATION

ويحتاج العملاء إلى الوصول إلى التاجر في وقت بدء خانة مدى التوفّر، ولكن يمكنهم المغادرة في أي وقت.

على سبيل المثال، وفقًا لسيناريو الدخول إلى المتحف، يُطلب من المستخدم التواجد في الساعة 10 صباحًا عند شراء تذكرة دخول في الوقت المحدّد في الساعة 10 صباحًا. يمثّل وقت بدء خانات التوفّر لهذه الخدمة وقت الدخول المحدَّد. ومع ذلك، يتم استخدام وقت الانتهاء فقط كمفتاح لتحديد خانة مدى التوفّر للحجز.

CancellationPolicy

سياسة الإلغاء لخدمة.

تمثيل JSON 
{
  "refundCondition": [
    {
      object (RefundCondition)
    }
  ]
}
الحقول
refundCondition[]

object (RefundCondition)

لا تتوفر أي شروط أو أكثر من شروط ردّ الأموال السارية على هذه السياسة.

RefundCondition

تحدد شرطًا واحدًا لردّ الأموال. يمكن استخدام شروط متعددة لردّ الأموال معًا لوصف "خطوات ردّ الأموال" كفترات مختلفة قبل بدء الخدمة.

تمثيل JSON 
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
الحقول
minDurationBeforeStartTime

string (Duration format)

هي المدة التي تسبق وقت البدء حتى يتمكّن العميل من استرداد جزء من تكلفة الخدمة المحدَّدة في refundPercent. عند ضبط هذه السياسة على 0 (الخيار التلقائي)، يمكن إلغاء الخدمة في أي وقت.

مدة بالثواني مؤلفة من تسعة أرقام كسور وتنتهي بـ "s". مثال: "3.5s".
refundPercent

integer (uint32 format)

النسبة المئوية التي يمكن استردادها، طالما تم إلغاء حجز الخدمة قبل minDurationBeforeStartTime على الأقل من وقت بدء الخدمة، في النطاق الذي يتراوح بين [0 و100]. وفي حال الضبط على 0 (القيمة التلقائية)، لا يمكن استرداد الأموال المدفوعة مقابل الخدمة. عند الضبط على 100، تكون هذه الخدمة قابلة للاسترداد بالكامل.

PrepaymentType

حقل التعداد للإشارة إلى نوع الدفع المسبق.

عمليات التعداد
PREPAYMENT_TYPE_UNSPECIFIED سنفترض افتراضيًا أن الدفعة المسبقة ليست NOT_SUPPORTED.
REQUIRED يجب على المستخدم دفع رسوم هذه الخدمة عند الحجز.
OPTIONAL يمكن للمستخدم اختيار الدفع المسبق لهذه الخدمة عند الحجز أو في وقت لاحق، ولكنها ليست مطلوبة لإجراء الحجز.
NOT_SUPPORTED الدفع المسبق غير معتمد لهذه الخدمة.

PrepaymentTerms

معلومات محدّدة عن موعد إتمام الدفع المسبق.

تمثيل JSON 
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
الحقول
chargeTiming

enum (ChargeTiming)

وقت حدوث الرسوم مقارنةً بوقت الشراء
chargeTimeBeforeStartTimeSec

string (int64 format)

يشير ذلك إلى الوقت بالثواني قبل وقت بدء الخدمة الذي يتم فيه تحصيل رسوم من المستخدم. يجب ضبط هذا الحقل فقط عندما تكون قيمة ChargeTiming charge_LATER.

ChargeTiming

رقم Enum لتحديد وقت حدوث الرسوم مقارنةً بوقت الشراء.

عمليات التعداد
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. (اختياري)

FieldType

رقم Enum للإشارة إلى نوع الحقل.

عمليات التعداد
FIELD_TYPE_UNSPECIFIED سيتم تجاهل الحقول ذات النوع غير المحدّد أو غير المعروف.
SHORT_ANSWER حقل إدخال من سطر واحد للنص.
PARAGRAPH حقل إدخال متعدد الأسطر للنص.
MULTIPLE_CHOICE مجموعة من أزرار الاختيار التي تتطلب خيارًا واحدًا من بين العديد من الخيارات.
CHECKBOXES عنصر العدد واحد أو أكثر مع مربعات اختيار.
DROPDOWN اختيار من قائمة منسدلة
BOOLEAN زر نعم/لا.

ServiceType

أنواع الخدمات المحددة مسبقًا.

عمليات التعداد
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 هذا.

يمكن أن تكون هذه المعلومات مرئية للمستخدم، على سبيل المثال: "adult" (الأشخاص البالغون) و"التابع" و"المحاربون القدامى" و"الصف J" وما إلى ذلك. مطلوب، يجب أن يحتوي كل نوع تذكرة على وصف حتى يظهر للمستخدم. من الأفضل استخدام localizedShortDescription بدلاً منه.
localizedShortDescription

object (Text)

وصف قصير لنوع TicketType هذا مع دعم i18n.

يمكن أن تكون هذه المعلومات مرئية للمستخدم، على سبيل المثال: "adult" (الأشخاص البالغون) و"التابع" و"المحاربون القدامى" و"الصف J" وما إلى ذلك. مطلوب، يجب أن يحتوي كل نوع تذكرة على وصف حتى يظهر للمستخدم. يمكن تقديم قيم منفصلة لكل لغة.
price

object (Price)

سعر تذكرة واحدة من هذا النوع، غير شامل أي ضرائب. يتم تطبيق معدل ضريبة الخدمة على تذاكره.
perTicketFee

object (PerTicketFee)

رسوم إضافية لشراء هذه التذكرة (اختياري)
optionDescription

string

وصف لأي خيار إضافي يمثله نوع التذكرة هذا، في حال توفّره. تم إيقاف العمل به، ويمكنك استخدام localizedOptionDescription بدلاً منه.
localizedOptionDescription

object (Text)

وصف لأي خيار إضافي يمثله نوع التذكرة هذا، في حال توفّره. يمكن تقديم قيم منفصلة لكل لغة.

تكون الخيارات الإضافية مفيدة عندما يمثّل نوع التذكرة سمات متعدّدة.

مثال 1: تذكرة دخول بأنواع مختلفة 'adult', 'child' and language كخيار إضافي، قائمة التذاكر المتوقعة على النحو التالي: - { ticketsTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - {"english" } } - {ishticketTypeId: "localized_type_Description" localized_type_Description: "localized_type_type_Description" localized_type_type } localized-ticketType} مترجمة:

المثال 2: استئجار قارب كاياك لعدة ساعات مع إضافة إضافية لحقيبة الكاياك الجافّة الاختيارية، يمكن أن يكون محتوى Shorts الوصفي "3 ساعات" والخيار الذي يمكن أن يكون "مع حقيبة تجفيف" أو "بدون حقيبة جافة" أو "بدون حقيبة تجفيف": - { ticketsTypeId: "ticket_type_1" localizedDescription { value: "2 hours" } localizedOptionDescription: "english" ticketType} : localizedOptionId :Description_type } - localized OptionType } } - localized_ticketType } - {english" ticket_type }

اختياري، ولكن في حال ضبط هذا الحقل لأي نوع تذكرة ضمن الخدمة، نتوقّع أن يتم ضبط هذا الحقل أيضًا في جميع أنواع التذاكر الأخرى (يمكن استخدام خيار وصف تلقائي). على سبيل المثال [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] ليست قائمة صالحة.

لا يتم دعم سوى علامتَي تنسيق HTML: و
. وهي تُستخدم لتحديد الخيارات مع إضافة عنوان ووصف تفصيلي، على سبيل المثال: "مقاعد مميّزة
يوفّر هذا الخيار أماكن جلوس في الصناديق الخاصة، بما في ذلك مقاعد مبطّنة بالكامل وأجهزة تلفزيون خاصة وخدمة تقديم الطعام والمشروبات داخل المقعد. توفّر هذه المقاعد إطلالات خلابة على الملعب."

PerTicketFee

الرسوم التي يجب دفعها مقابل كل تذكرة يشتريها المستخدم.

تمثيل JSON 
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
الحقول
serviceCharge

object (Price)

يتم تقييم رسوم إضافية مقابل خدمة.
facilityFee

object (Price)

رسوم يتم فرضها على الموقع/المنشأة.
taxes

object (Price)

الضرائب المفروضة على التذاكر

RelatedMedia

الصور ذات الصلة بهذه الخدمة. وسيزحف محرّك بحث Google إلى هذه الوسائط لضمان عرضها بشكل صحيح للمستخدمين النهائيين. (اختياري)

تمثيل JSON 
{
  "url": string,
  "type": enum (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
الحقول
url

string

عنوان URL لمصدر الوسائط هذا. سيزحف محرك بحث Google إلى الوسائط المستضافة على عنوان URL هذا.
type

enum (MediaType)

نوع مصدر الوسائط هذا
localizedCaption

object (Text)

ترجمة وشرح الوسائط التي تتوافق مع تقنية i18n، لا يُسمح إلا بالنص العادي ستتم إزالة أي مكوّنات HTML. (اختياري)
attribution

object (Attribution)

معلومات تحديد المصدر عن مصدر الوسائط تجدر الإشارة إلى أنّه إذا كان من الضروري عرض الإسناد من خلال وسائل الإعلام للإشارة إلى المصوِّر أو الوكالة، يجب ضبط هذا الحقل. (اختياري)
caption
(deprecated)

string

تم إيقاف الترجمة والشرح وتفضيلها.

MediaType

رقم Enum للإشارة إلى نوع مصدر الوسائط هذا. الصور فقط هي المتوافقة. يُرجى التواصل مع فريق "الحجز عبر Google" إذا كانت هناك حاجة إلى دعم وسائط أخرى غير الصور.

عمليات التعداد
TYPE_UNSPECIFIED غير مستخدَمة
PHOTO يشير إلى أنّ الوسائط التي يوفّرها عنوان URL هي صورة.

معلومات تحديد المصدر

معلومات تحديد المصدر لهذه الوسائط

تمثيل JSON 
{
  "localizedText": {
    object (Text)
  },
  "text": string
}
الحقول
localizedText

object (Text)

النص الذي سيتم نسبه إلى المصوّر أو الوكالة التي تدعم i18n سيتم عرض هذا النص مع وسائط المصدر. تجدر الإشارة إلى أنّ النص العادي فقط هو الذي يمكن استخدامه في هذا الحقل، وستتم إزالة أي مكوّنات HTML (الإحالة المستندة إلى الرابط التشعّبي غير متاحة).
text
(deprecated)

string

تم إيقاف العمل بها، وتفضل استخدام localizedText.

ServiceAttributeValueId

تحدد قيمة معينة لسمة خدمة سيتم تطبيقها على إحدى الخدمات.

تمثيل JSON 
{
  "attributeId": string,
  "valueId": string
}
الحقول
attributeId

string

رقم تعريف السمة على النحو المحدّد في سمة Merchant.service_attribute، مثل "نوع الخدمة".
valueId

string

رقم تعريف قيمة هذه السمة، مثلاً "قصة شعر" يجب أن تُطابق القيمة valueId في تعريف سمة الخدمة.

WaitlistRules

القواعد المرتبطة بالانضمام إلى قائمة الانتظار

تمثيل 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)

يمكن لأحجام الحفلات خارج النطاق الاتصال بالنشاط التجاري. سيتم عرض رسالة محددة مسبقًا للمستخدم. نموذج النص المطلوب عرضه: "للأطراف التي يزيد حجمها عن {انتظار القائمة قاعدات.max_party_size} وتقديمها، يُرجى الاتصال بالمطعم على الرقم {phone}." يجب ضبط CallMerchant، ولكن تركه فارغًا.

CallMerchant

رسالة فارغة لاستخدامها في supportedPartySizeOption، وسيؤدي ضبطها إلى عرض خيار للمستخدمين للاتصال بالنشاط التجاري لإجراء حجز.

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

تمثّل هذه السمة عنوان URL الخاص بالفعالية على الموقع الإلكتروني للشريك. (اختياري)
entity[]

object (Entity)

قائمة بالكيانات المرتبطة بالحدث. (اختياري)
eventAttendanceMode

enum (AttendanceMode)

مطلوبة. نوع حضور الحدث.
eventVirtualLocationUrl[]

string

اختياريّ. تمثّل هذه السمة عنوان URL الذي يمكن من خلاله مشاهدة الحدث.
eventOrganizer

object (Text)

اختياريّ. المنظِّم الذي يستضيف الحدث.
eventOrganizerUrl

string

اختياريّ. عنوان URL الخاص بالمنظِّم الذي يستضيف الفعالية
eventOrganizerType

enum (OrganizerType)

اختياريّ. نوع المنظِّم.
eventSourceUrl[]

string

مطلوبة. عنوان URL للصفحات التي يمكن العثور على معلومات الأحداث أو الأوصاف فيها.
eventState

enum (EventState)

اختياريّ. حالة الحدث

EventCategory

مجموعة فرعية من فئات الأحداث التي نخصِّص تجربة المنتج لها. ملاحظة: هذه الميزة ليست مخصّصة للأحداث العالمية.

عمليات التعداد
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 العامة الأخرى للكيان، استخدِم relevantUrl في publicIdentificationData. (اختياري)
entityType

enum (EntityType)

نوع الكيان. (اختياري)
entityRole

enum (EntityRole)

دور الكيان في الحدث. (اختياري)
publicIdentificationData

object (PublicIdentificationData)

المراجع العامة للكيان (اختياري)

EntityType

نوع الكيان. ملاحظة: هذا يعني أنكم لا تحتوى على علم الوجود العالمي.

عمليات التعداد
ENTITY_TYPE_UNSPECIFIED غير محدَّد. يُرجى عدم الاستخدام.
ENTITY_TYPE_PERFORMER يمثّل الكيان الفنّان أو المجموعة التي تقدّم أداءً في حفلة موسيقية أو عرض. ينطبق ذلك فقط عندما تكون فئة الفعالية هي حفلة موسيقية أو مسرح.
ENTITY_TYPE_PLAYER يمثّل الكيان الفريق الرياضي أو اللاعب المشارك في الفعالية. ينطبق فقط عندما تكون فئة الحدث هي "رياضة".
ENTITY_TYPE_CONCERT_TOUR يمثل الكيان الجولة التي ينتمي إليها هذا الحدث. ينطبق ذلك فقط عندما تكون فئة الحدث CONCERT.
ENTITY_TYPE_SPORTS_SERIES يمثِّل الكيان دورة رياضية ينتمي إليها هذا الحدث. ينطبق فقط عندما تكون فئة الحدث هي "رياضة".
ENTITY_TYPE_PLAY يمثل الكيان نوع المسرحية (على سبيل المثال، الموسيقى، والكوميديا، والباليه، وما إلى ذلك) التي تم أداؤها في الحدث. ينطبق ذلك فقط عندما تكون فئة الحدث هي "المسرح".

EntityRole

دور الكيان في الحدث.

عمليات التعداد
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 عام لأي صفحة ويب مخصصة للموضوع فقط. يمكن أن يشمل ذلك المواقع الإلكترونية الرسمية أو منصات التواصل الاجتماعي أو صفحات wikipedia أو imdb، مثل https://www.discogs.com/artist/1124645-Taylor-Swift وhttps://www.wikidata.org/wiki/Q19320959 وhttps://twitter.com/acmilan. (اختياري)
musicbrainzId

string

معرّف musicbrainz للفنان أو الكيانات الموسيقية الأخرى، إن توفّر، والمكوّن من 36 حرفًا. يمكنك الاطّلاع على https://musicbrainz.org/doc/MusicBrainz_Identifier. (اختياري)

AttendanceMode

نوع حضور الحدث.

عمليات التعداد
ATTENDANCE_MODE_UNSPECIFIED غير محدَّد.
ONLINE للأحداث الافتراضية.
PHYSICAL للفعاليات المادية
PHYSICAL_ONLINE_MIXED للفعاليات المادية والافتراضية في الوقت نفسه

OrganizerType

نوع المنظِّم.

عمليات التعداد
ORGANIZER_TYPE_UNSPECIFIED غير محدَّد.
PERSON تمثّل هذه السمة المنظِّم من الأشخاص.
ORGANIZATION بالنسبة إلى المنظِّم الذي يمثّل مؤسسة

EventState

حالة الحدث

عمليات التعداد
EVENT_STATE_UNSPECIFIED غير محدَّد.
SCHEDULED تم تحديد موعد الحدث.
RESCHEDULED تم تحديد موعد جديد للفعالية.
CANCELLED تم إلغاء الحدث.
POSTPONED تم تأجيل الفعالية.

IntegrationType

إمكانية الدمج العميق المتاحة

عمليات التعداد
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)

رسوم لمعالجة طريقة الدفع الخاصة بالمستخدم.

ToursAndActivitiesContent

حقول المحتوى الخاصة بالجولات والأنشطة. يجب أن يكون كل عنصر في الحقل المتكرر مستقلاً للسماح بالعرض المنفصل (كنقطة تعداد مثلاً).

يُنصَح بشدة بتعبئة ToursAndActivityContent للجولات والأنشطة، إلا أنّ ذلك ليس شرطًا صارمًا. تدعم جميع الحقول النص العادي والنص بتنسيق 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 وعلى خرائط Google. راجع https://developers.google.com/places/web-service/place-id لمزيد من المعلومات عن أرقام تعريف الأماكن. إذا تم توفير معلومات النشاط التجاري، ستطابق Google الموقع الجغرافي مع هذا المكان.
name

string

تُستخدم اسم الموقع، ورقم الهاتف، وعنوان URL، والموقع الجغرافي لدعم مطابقة الموقع مع الأماكن الموجودة بالفعل على خرائط Google.

هذا الحقل اختياري، ولكنه قد يكون مطلوبًا في بعض السياقات. على سبيل المثال، لن تتم مطابقة موقع Service.location بدون اسم مع كيان تجاري، حتى لو كان الموقعان في العنوان نفسه. (اختياري)
telephone

string

رقم الهاتف العام للموقع الجغرافي بما في ذلك رموز البلد والمنطقة، مثل +14567891234. (اختياري)
url

string

عنوان URL للموقع الإلكتروني العام للمكان. (اختياري)
geo

object (GeoCoordinates)

المعلومات الجغرافية للموقع الجغرافي، بما في ذلك خط العرض وخط الطول والعنوان. (اختياري)
locationType

enum (LocationType)

يجب تقديم نوع الموقع الجغرافي إذا تم توفير هذا الموقع الجغرافي لإحدى الخدمات.
locationId

string

مرجع فريد للموقع داخل الخدمة. يمكن استخدام رقم التعريف هذا للإشارة إلى هذا الموقع الجغرافي في حقول الخدمة الأخرى. على سبيل المثال، في نموذج المعلومات المخصّص، يمكن استخدام مجموعة من معرّفات المواقع الجغرافية لتحديد خيارات المواقع الجغرافية لاستلام الطلب. في حال ضبط المعرّف، يجب أن يكون هذا المعرّف فريدًا في الخدمة نفسها. (اختياري)

LocationType

نوع هذا الموقع الجغرافي.

عمليات التعداد
LOCATION_TYPE_UNSPECIFIED لم يتم تحديد نوع الموقع الجغرافي.
VISITED_LOCATION الموقع الجغرافي الذي تزوره هذه الخدمة.
START_LOCATION يُعد الموقع الجغرافي الذي تبدأ فيه هذه الخدمة MEETING_LOCATION أيضًا.
END_LOCATION الموقع الجغرافي الذي تنتهي فيه هذه الخدمة.

Rating

لتعريف التقييم لكيان.

تمثيل 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 هي أنواع الوظائف ضمن فئة "السباكة".

VirtualSession

معلومات حول الجلسة الافتراضية/على الإنترنت. على سبيل المثال، دروس يوغا على الإنترنت، ودروس طبخ افتراضي، وما إلى ذلك.

تمثيل JSON 
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
الحقول
sessionInstructions

object (Text)

تعليمات حول طريقة إعداد هذا الصف الافتراضي إذا لم يضمِّن الشريك عنوان URL للفيديو مع الحجز، يجب أن يتضمّن هذا النص الوقت الذي ستتم فيه مشاركة عنوان URL للفيديو مع المستخدم. على سبيل المثال: "سيتم إرسال عنوان URL لتطبيق Zoom عبر البريد قبل 30 دقيقة من بدء الصف الدراسي". (إجراء يُنصح به)
sessionRequirements

object (Text)

متطلبات الجلسة الافتراضية المحدّدة على سبيل المثال، حصيرة يوغا، أو أدوات مائدة، إلخ (يُنصح به)
virtualPlatformInfo

object (VirtualPlatformInfo)

معلومات عن المنصة الافتراضية المستخدمة في هذه الجلسة. (مطلوب لتفعيل الخدمات الافتراضية)
isSessionPrerecorded

boolean

مطلوبة. اضبط ذلك على "صحيح" إذا لم تكن الجلسة الافتراضية مباشرة وتم تسجيلها مسبقًا.

VirtualPlatformInfo

معلومات حول المنصة التي سيتم استخدامها لهذه الجلسة الافتراضية.

تمثيل JSON 
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
الحقول
platform

enum (Platform)

النظام الأساسي المستخدم للجلسة الافتراضية.
otherPlatformName

object (Text)

اسم النظام الأساسي إذا تم ضبط النظام الأساسي على "غير ذلك". (مطلوب إذا تم ضبط النظام الأساسي على OTHER)

النظام الأساسي

حقل Enum للإشارة إلى المنصة الافتراضية التي سيستخدمها التاجر

عمليات التعداد
PLATFORM_UNSPECIFIED غير مستخدَمة
FLEXIBLE يجب أن يكون لدى التاجر مرونة في اختيار منصّة الفيديو التي يستخدمها.
GOOGLE_HANGOUTS Google Hangouts.
GOOGLE_MEET Google Meet.
ZOOM اتصالات الفيديو في Zoom:
SKYPE سكايب.
YOUTUBE البث المباشر في YouTube
OTHER يجب ضبطها إذا كانت منصة الفيديو المستخدَمة مختلفة عن تلك المذكورة هنا.

DirectMerchantPayment

معلومات حول كيفية دفع المستخدم مباشرةً إلى التاجر بدلاً من الدفع المُسبَق مقابل الخدمة عبر RwG.

تمثيل JSON 
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
الحقول
paymentMethods[]

object (Text)

ننصح المستخدمين بالدفع فقط من خلال طرق الدفع المذكورة أدناه.

الطُرق

create

 تنشئ السمة Service جديدة لتاجر يديره مجمّع السلع المحدّد وتعرضها.

delete

 يؤدي هذا الخيار إلى حذف السمة Service الحالية الخاصة بتاجر يديره مجمّع السلع المحدّد.

patch

 تُعدِّل السمة Service الحالية لتاجر يديره مجمّع السلع المحدّد وتُرجعه.