Package google.maps.booking.v1alpha

string

عنوان URL لنقطة الدخول لرابط الإجراء هذا.

string

تشير علامة اللغة BCP-47 إلى اللغة التي يتوفّر بها المحتوى من معرّف الموارد المنتظم (URI) هذا.

string

رمز البلد وفقًا لترميز ISO 3166-1 alpha-2 اترك هذا الحقل فارغًا للوصول غير المحدود.

ActionPlatform

النظام الأساسي الذي يجب تنفيذ هذا الإجراء عليه في حال ترك هذا الحقل بدون ضبط، سيتم استخدام ACTION_PLATFORM_WEB_APPLICATION كإجراء احتياطي.

ActionLinkType

نوع الإجراء المحدَّد مسبقًا

OrderOnlineMetadata

البيانات الوصفية لرابط الطلب على الإنترنت تتيح إجراءً باستخدام ActionLinkType من النوع ACTION_LINK_TYPE_SHOP_ONLINE.

FoodOrderingMetadata

البيانات الوصفية لعناوين روابط طلب الطعام نوع الإجراء المتوافق: * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT لا يتوافق مع ACTION_LINK_TYPE_ORDER_FOOD.

EventMetadata

معلومات إضافية عن رابط الإجراء الذي يكون فريدًا لقطاع الأحداث

Surface

مساحة عرض الحدث المحدّدة مسبقًا والمرتبطة برابط إجراء لا يُستخدَم هذا الإجراء إلّا في مجال "الفعاليات".

string

المعرّف اسم المورد في AdsAccountLink التنسيق: partners/{partner}/adsAccountLinks/{ads_account_link}

string

مطلوب. قائمة أرقام تعريف سلع المستودع المطلوب ربطها بحساب "إعلانات Google"

State

النتائج فقط. حالة رابط حساب "إعلانات Google".

Text

رسالة مخصّصة يتم عرضها للمستخدم عند الحجز من خلال ميزة "الحجز عبر Google".

Timestamp

وقت بدء خانة الموعد

Duration

مدة خانة الموعد

int64

إجمالي عدد الوظائف المتوفّرة والوظائف المتوفّرة أمثلة:

• صف يوغا من 10 أماكن مع 3 محجوزة: availability {spots_total: 10, spots_open: 7 ...}
• جلسة تدليك على كرسي تم حجزها بالكامل: availability {spots_total: 1, spots_open: 0 ...}

ملاحظة: في حال إرسال الطلبات باستخدام تنسيق ضغط مدى التوفّر المحدّد أدناه، سيتم استنتاج هذين الحقلَين.

• يشير تكرار الحدث إلى spots_total=1 وspots_open=1.
• يشير الخطأ ScheduleException إلى spots_total=1 وspots_open=0.

int64

عدد الأماكن المفتوحة.

string

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

Resources

موارد اختيارية تُستخدَم لإزالة الغموض عن خانة مدى التوفّر هذه عن غيرها عندما يكون موظفون أو غرف مختلفة جزءًا من الخدمة.

على سبيل المثال، صفّ اليوغا نفسه مع مدرّسين:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }

string

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

يتجاهل هذا الحقل أيّ ids لـ payment_option تم تحديدها في رسالة الخدمة. وبالمثل، لا يجب أن تكون معرّفات payment_option_ids المحدّدة هنا متوفّرة في رسالة الخدمة، ولكن يجب تحديدها على مستوى التاجر.

Recurrence

معلومات تكرار مدى التوفّر التي تمثّل أكثر من وقت بدء واحد يجب أن يحتوي التكرار على مواعيد ليوم عمل واحد.

ScheduleException

الأوقات التي لا يمكن فيها جدولة هذه الخدمة للحد من عدد رسائل schedule_exception، ننصحك بدمج الاستثناءات المجاورة.

Deposit

يمكنك أيضًا إيداع مبلغ اختياري في مدى التوفّر هذا. لإلغاء إيداع الخدمة في حال تحديد واحد.

NoShowFee

رسوم اختيارية لعدم الحضور في هذا مدى التوفّر يؤدي هذا الإجراء إلى إلغاء رسوم عدم العرض للخدمة في حال تحديد أحدها.

Prepayment

اختياريّ. معلومات اختيارية للدفع المسبق لمدى التوفّر.

RequireCreditCard

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

string

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

• خدمة بأربعة أنواع تذاكر: TicketType {ticket_type_id: "adult_1" Short_description: "الأشخاص البالغون أيام الأسبوع"} TicketType {ticket_type_id: "adult_2" Short_description: "Adult weeks"} TicketType {ticket_type_id: "youth_1" Short_description: "Youth Fridays"} TicketType {ticket_type_id: "youth_2" Short_description: "عطلات نهاية الأسبوع للشباب"}

لتمثيل المستودع خلال أيام الأسبوع: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. لتمثيل المستودع خلال موسم الأعياد: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

• خدمة تشمل ثلاثة أنواع من التذاكر: TicketType {ticket_type_id: "adult" Short_description: "Adult"} TicketType {ticket_type_id: "youth" Short_description: "Youth"} TicketType {ticket_type_id: "senior" Short_description: "كبار السن"}

للإشارة إلى أنّ أنواع التذاكر الثلاثة متوفّرة في هذه الفترة الزمنية، استخدِم availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} أو ‎availability {...}‎ (لا تضبط ticket_type_id في هذه الفتحة).

(اختياري)

DurationRequirement

شرط إظهار مدة الخانات و/أو وقت الانتهاء. سيتم تجاهل هذا الحقل إذا كانت الفتحة غير متاحة. لا يتم استخدامها في مجال "نشاطات مقترَحة". (اختياري)

SchedulingRuleOverrides

قواعد جدولة مدى التوفّر في حال تعبئة الحقول، سيتم إلغاء أي قواعد جدولة مقابلة في SchedulingRules على مستوى الخدمة.

ConfirmationMode

وضع التأكيد الذي سيتم استخدامه عند حجز مدى التوفّر هذا يجب تأكيد محاولات إنشاء الحجوزات للبيانات المتاحة باستخدام وضع التأكيد CONFIRMATION_MODE_SYNCHRONOUS أو رفضها على الفور. يجب رفض محاولات إنشاء حجوزات لبيانات التوفّر التي تستخدم وضع التأكيد CONFIRMATION_MODE_ASYNCHRONOUS على الفور أو إنشاؤها بالحالة PENDING.

LinkoutRequiredReason

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

Timestamp

الحد الأقصى الشامل للطابع الزمني بالتوقيت العالمي المنسق الذي تتكرر فيه معلومات التوفّر.

Duration

يحدِّد الوقت بين خانات مدى التوفّر المتعاقبة.

مثال: إذا كانت مدة مدى التوفّر 20 دقيقة، وقيمة repeat_every هي 30 دقيقة، وقيمة start_time هي 9:00 صباحًا، وقيمة repeat_until هي 11:00 صباحًا، ستظهر خانات زمنية من الساعة 9:00 إلى 9:20 صباحًا، ومن الساعة 9:30 إلى 9:50 صباحًا، ومن الساعة 10:00 إلى 10:20 صباحًا، ومن الساعة 10:30 إلى 10:50 صباحًا، ومن الساعة 11:00 إلى 11:20 صباحًا. (معلومات مطلوبة)

TimeRange

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

مثال: إذا حدّدت الإعادة مدة 20 دقيقة، وقيمة repeat_every‏ 30 دقيقة، وقيمة start_time‏ 9:00 صباحًا، وقيمة repeat_until‏ 11:00 صباحًا، سيؤدي ذلك إلى أن يصبح "الاستثناء في الجدول الزمني" الذي يتضمن نطاقًا زمنيًا من 9:45 صباحًا إلى 11:00 صباحًا غير متاح في الفترات من 9:30 صباحًا إلى 9:50 صباحًا، ومن 10 صباحًا إلى 10:20 صباحًا، ومن 10:30 صباحًا إلى 10:50 صباحًا.

ملاحظة: لن تتأثر الفترة الزمنية التي تبدأ في الساعة 11 صباحًا بما أنّ النطاق الزمني مغلق.

int64

آخر مرة (بالثواني) يمكن فيها حجز هذه الفتحة يجب أن يكون الطابع الزمني هذا قبل start_sec من الفتحة الزمنية التي يجب الالتزام بها (إذا كان من المفترض أن يتمكّن المستخدمون من الحجز بعد وقت البدء، استخدِم SchedulingRules.min_booking_before_end_time على مستوى الخدمة). في حال توفّره، سيتم إلغاء أي عنصر محدّد في min_booking_buffers لقواعد scheduleRules للخدمة المقابلة.

int64

المرة الأولى (بالثواني) التي يمكن فيها حجز هذه الخانة. يجب أن يكون الطابع الزمني قبل start_sec من الفتحة، أو last_bookable_sec إذا تم تحديده.

int64

إذا تم ضبطها، آخر وقت (بالثواني منذ بداية حقبة يونكس) يمكن فيه إلغاء خانة الموعد المحدّدة هذه من خلال ميزة "الحجز عبر Google" سيُلغي هذا الحقل أي قواعد إلغاء على مستوى الخدمة. (اختياري)

string

اسم المورد، بتنسيق - partners/{partner_id}/feeds/{feed_name}

GenericDeleteRecord

السجلّات التي سيتم حذفها يُسمح بحد أقصى 1000 سجلّ في طلب بيانات واحد من واجهة برمجة التطبيقات.

string

اسم المورد بالتنسيق partners/{partner_id}/feeds/{feed_name}

GenericRecord

السجلّات التي سيتم إدراجها و/أو تعديلها يُسمح بحد أقصى 1000 سجلّ في طلب بيانات واحد من واجهة برمجة التطبيقات.

string

تنسيق partners/{partner_id}

ExtendedServiceAvailability

مدى توفّر الخدمة الموسّع الذي يُستخدَم لاستبدال خانات مدى التوفّر الحالية

ExtendedServiceAvailability

الرسائل التي تم تعديلها بنجاح والتي تم استخدامها بدلاً من خانات مدى التوفّر الحالية

string

اسم مورد الحجز: partners/{partner ID}/bookings/{booking ID}

string

معرّف التاجر للخانة

string

رقم تعريف خدمة التاجر

Timestamp

وقت بدء خانة الموعد

Duration

مدة خانة الموعد

ClientInformation

المعلومات الشخصية للعميل الذي يحدد الموعد

BookingStatus

حالة الحجز

PaymentInformation

معلومات عن معاملات الدفع ذات الصلة بالحجز

int64

عدد الضيوف في الحجز

Cause

سبب تعذُّر الحجز. (معلومات مطلوبة)

CreditCardType

(مطلوب فقط إذا كان السبب هو PAYMENT_ERROR_CARD_TYPE_REJECTED)

string

يُستخدَم هذا الحقل الاختياري لكي يُدرِج الشريك معلومات إضافية بغرض تصحيح الأخطاء فقط. (اختياري)

PaymentFailureInformation

معلومات حول تعذُّر عمليات الدفع

ThreeDS1Parameters

المَعلمات التي يستخدمها مجمِّع RwG لبدء بروتوكول مصادقة 3DS1 مع المستخدم سيتم تجاهلها ما لم يتم ضبط BookingFailure.cause على PAYMENT_REQUIRES_3DS1.

string

عنوان URL الذي يتم من خلاله تحميل نموذج لتقديمه إلى المستخدم للمصادقة.

string

طلب مصادقة الدفع ليتم نشره على نموذج ACSUrl في حال توفّره.

string

معرّف يستخدمه موفّر خدمة إدارة الهوية وإمكانية الوصول ليتم نشره على نموذج ACSUrl في حال توفّره.

string

بيانات التاجر: ليتم نشره على نموذج ACSUrl في حال توفّره.

RefundCondition

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

Duration

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

uint32

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

string

الاسم الأول للعميل

string

اسم عائلة العميل

PostalAddress

عنوان العميل

string

رقم هاتف العميل

string

عنوان البريد الإلكتروني للعميل

string

مطلوب. المرجع الرئيسي الذي سيتم إنشاء رابط الحساب هذا على "إعلانات Google" فيه وهذا الرقم مماثل لرقم تعريف حساب "مركز الشركاء". التنسيق: partners/{partner}

string

مطلوب. رقم التعريف المطلوب استخدامه لربط حساب "إعلانات Google". هذا الرقم هو نفسه الرقم التعريفي لعميل "إعلانات Google". لمعرفة التفاصيل، يُرجى الاطّلاع على https://support.google.com/google-ads/answer/1704344 التنسيق : xxx-xxx-xxxx.

AdsAccountLink

مطلوب. AdsAccountLink المطلوب إنشاؤه.

string

اسم المورد الرئيسي للشريك الذي يملك هذا التاجر، بالتنسيق partners/{partner_id}.

string

معرّف التاجر المطلوب استخدامه لهذا التاجر.

Merchant

الجهة المسؤولة عن إنشاء المحتوى

string

اسم المورد الرئيسي للتاجر الذي يملك هذه الخدمة، بالتنسيق partners/{partner_id}/merchants/{merchant_id}.

string

معرّف الخدمة المطلوب استخدامه لهذه الخدمة.

Service

الخدمة المطلوب إنشاؤها.

CreditCardType

قائمة ببطاقات الائتمان المتوافقة لا يمكن استخدام بطاقات الائتمان إذا كانت فارغة.

string

مطلوب. اسم AdsAccountLink المطلوب حذفه. التنسيق: Partners/{partner}/adsAccountLinks/{ads_account_link}

string

اسم المورد للتاجر الذي تريد حذفه. بالتنسيق partners/{partner_id}/merchants/{merchant_id}

string

اسم مورد الخدمة المطلوب حذفه. بتنسيق partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Price

مبلغ الإيداع

int64

الحد الأدنى لفترة الإلغاء المُسبَق للإيداع

PriceType

تحدد طريقة تحديد الإيداع استنادًا إلى مدى التوفر.

Text

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

Duration

الحد الأدنى للمدة.

Duration

الحد الأقصى للمدة

Text

مطلوب. اسم المشغّل الاقتصادي وعنوانه ورقم هاتفه وعنوان بريده الإلكتروني، أي الشركة المصنّعة أو الممثّل المفوّض أو المستورد أو الموزّع أو مقدّم خدمة توصيل الطلبات أو أي شخص طبيعي أو قانوني آخر يخضع لالتزامات متعلّقة بتصنيع المنتجات أو توفيرها أو تفعيلها. تمثيل سلسلة بتنسيق حر للمشغّل_الاقتصادي يمكن تنسيق هذه المعلومات باستخدام " " و"\n".

string

هذا حقل إلزامي مطلوب لتحديد التاجر الذي تنتمي إليه رسائل التوفّر أدناه.

string

هذا حقل إلزامي لتحديد الخدمة التي تنتمي إليها رسائل مدى التوفّر أدناه.

Timestamp

في حال توفّرها، سنعتبر كيانات مدى التوفّر المقدَّمة بمثابة لقطة كاملة من [start_time_restrict, end_time_restrict). وهذا يعني أنّه سيتم حذف جميع بيانات مدى التوفّر الحالية إذا كان الشرط التالي صحيحًا:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

في حال ضبط رسالة مدة، يتم فرض قيود إضافية على الشرط:

  availability.duration == duration_restrict

في حال ضبط رسالة resources_restrict، سيتم تقييد الشرط بشكل أكبر:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

تُستخدَم هذه الحقول عادةً لتقديم معلومات كاملة عن مدى التوفّر في نطاق زمني معيّن.

يتم تفسير ضبط start_time_restrict أثناء ترك end_time_restrict على تفسير جميع الأوقات بدءًا من start_time_restrict.

Timestamp

إذا تم ضبط end_time_restrict مع ترك start_time_restrict بدون ضبط، يتم تفسير ذلك على أنّه كل الوقت حتى end_time_restrict.

Duration

يؤدي ضبط المدة إلى حصر نطاق التعديل في مدى التوفّر فقط مع المدة المطابقة.

Resources

يؤدي ضبط resources_restrict إلى تقييد نطاق التحديث على هذه المجموعة من الموارد فقط. يجب أن تتطابق جميع حقول أرقام التعريف للموارد تمامًا.

Availability

تمثّل هذه السمة القائمة الجديدة لمدى التوفّر.

int64

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

int64

العناصر الحالية التي تم تعديلها حسب الحاجة استنادًا إلى معلومات أحدث من الخلاصة

int64

لم تعُد العناصر متوفّرة في هذه الخلاصة، وتمت إزالتها نتيجةً لذلك.

string

اسم مورد الخلاصة، والذي يحتوي على تنسيق

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

State

حالة معالجة هذه الخلاصة.

string

سلسلة قابلة للقراءة من قِبل البشر تقدّم المزيد من التفاصيل في حال تعذّر علينا معالجة هذه الخلاصة.

FeedStatistics

إحصاءات خاصة بهذه الخلاصة

FeeDetails

تفاصيل الرسوم المفروضة على المستخدم بالإضافة إلى إجمالي المنتجات يتم تكرار هذا الإجراء لأنواع مختلفة من الرسوم، مثل رسوم الخدمة ورسوم التسليم وما إلى ذلك.

AdvanceOrderDetails

تفاصيل حول ميزة الطلب المتقدّم، والتي تُعرف أيضًا باسم "الطلب مسبقًا"، حيث يمكن للمستخدم تقديم طلب لاستلامه في وقت لاحق

Duration

مدة ثابتة على سبيل المثال: 30 دقيقة

DurationRange

نطاق المدة أمثلة: * من 30 دقيقة إلى 45 دقيقة * أكثر من 30 دقيقة * أقل من 50 دقيقة

bool

صحيح إذا كانت الطلبات المُسبَقة، المعروفة أيضًا باسم "الطلب مسبقًا"، متاحة. (معلومات مطلوبة)

FeeType

نوع الرسوم (معلومات مطلوبة)

FeeAmount

مبلغ الرسوم بعملة الوحدة أو نسبة مئوية من قيمة سلة التسوّق أو الاثنين معًا (معلومات مطلوبة)

QuantitativeValue

الرسوم كنسبة مئوية من قيمة سلة التسوّق يتيح استخدام نطاق (محدد وغير محدود) أو نسبة مئوية ثابتة. يجب أن تتراوح القيمة بين 0 و100. أمثلة: * ثابت 5.5% * 5.5% على الأقل * 5.5% على الأكثر * 4.5% إلى 5.5%

Money

مبلغ ثابت على سبيل المثال، 3.5 دولار أمريكي.

MoneyRange

نطاق المبلغ أمثلة: * من 3.5 إلى 5.5 دولار أمريكي * 3.5 دولار أمريكي على الأقل * 5.5 دولار أمريكي كحدّ أقصى

bool

مبلغ غير معروف.

FulfillmentType

مطلوب. تمثّل هذه السمة نوع توصيل الطلب.

AvailableDay

مطلوب. قائمة بالأيام التي تتوفّر فيها طريقة التسليم هذه (يُفضّل أن يكون هناك يومان على الأقل)

FeeDetails

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

Price

مطلوب. الحد الأدنى للطلب لطريقة التسليم المرتبطة برابط الإجراء

Date

مطلوب. تاريخ متاح لطريقة توصيل الطلب. يتم افتراض أنّ هذه المنتجات مطابقة للمنطقة الزمنية للتاجر.

Timestamp

مطلوب. الطابع الزمني لنظام التشغيل يونكس آخر مرة تمكّن فيها المستخدم من طلب السلع واستلامها من خلال fulfillment_date بعبارة أخرى، بعد آخر وقت للطلب، لن يتم عرض تاريخ التسليم على أنّه متاح.

على سبيل المثال، إذا كان تاريخ التسليم هو ‎10-08-2020: - تعني قيمة last_ordering_time‏ ‎10-08-2020 18:00 أنّه على العميل تقديم هذا الطلب قبل الساعة 6 مساءً في اليوم نفسه من أجل استلام طلبه في ‎10-08-2020. - إذا كانت القيمة last_ordering_time هي 2020-08-08 20:00، يجب أن يقدّم العميل طلبه في موعد أقصاه 8 مساءً من أجل تلقّي طلبه في 10-08-2020.

NoFee

لا يتم تحصيل رسوم مقابل طريقة التسليم.

MinimumFee

الرسوم الأساسية المرتبطة بطريقة التسليم

FixedFee

الرسوم الثابتة المرتبطة بطريقة توصيل الطلبات

Price

مطلوب. مبلغ الرسوم الثابتة لطريقة توصيل الطلبات.

Price

مطلوب. مبلغ الرسوم الأساسية لطريقة التسليم

Timestamp

مطلوب. يُستخدَم الطابع الزمني هذا لتحديد ترتيب تطبيق عملية الحذف على المستودع.

bytes

للخلاصات غير المستندة إلى أولي.

Any

بالنسبة إلى الخلاصات القائمة على النماذج الأوّلية.

Timestamp

مطلوب. يُستخدم هذا الطابع الزمني لضمان الترتيب الصحيح لتعديلات المستودع.

bytes

للخلاصات غير المستندة إلى أولي.

Any

للخلاصات المستندة إلى النماذج

double

خط العرض بالدرجات. (اختياري)

double

خط الطول بالدرجات (اختياري)

PostalAddress

العنوان البريدي للموقع الجغرافي، المفضَّل

string

يمكن أيضًا تقديم عنوان غير منظَّم كعنوان احتياطي. على سبيل المثال: "1600 amphitheatre parkway mountain view, ca 94043"

string

مطلوب. اسم رابط حساب "إعلانات Google" المطلوب استرجاعه. تنسيق الملف: partners/{partner}/adsAccountLinks/{ads_account_link}

string

مطلوب. اسم المورد بتنسيق الشركاء/{partner_id}/merchants/{merchant_id}/status

string

اسم مصدر الخلاصة الذي يتّبع التنسيق

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

string

الفئة ذات المستوى العالي التي تنتمي إليها هذه الخدمة المنزلية. مثلاً: سباك أو كهربائي أو غير ذلك

string

تمثّل هذه السمة نوع الوظيفة ضمن الفئة التي تنتمي إليها الخدمة المنزلية المحدّدة. مثلاً: unclog_drain، install_faucet هي أنواع المهام ضمن فئة السباكة.

string

اسم المورد المطلوب إبطال صلاحيته.

على سبيل المثال، بالنسبة إلى مورد Pickup، يجب أن يكون الاسم بالتنسيق partners/{partner_id}/pickups/{pickup_id}. يجب أن تزيل عمليات التنفيذ النُسخ المخزّنة مؤقتًا من المورد المحدّد.

string

رقم تعريف خدمة التاجر.

int64

وقت بدء خانة المواعيد بالثواني من خلال التوقيت العالمي المنسَّق (UTC) منذ حقبة Unix.

int64

مدة خانة المواعيد بالثواني.

OrderedTickets

عدد التذاكر التي تم طلبها حسب نوع التذكرة

Price

السعر الإجمالي (باستثناء الضرائب) لهذا البند

BookingStatus

حالة العنصر.

string

معرّف نوع التذكرة

int32

عدد التذاكر التي تم طلبها لهذا النوع.

string

مطلوب. العنصر الرئيسي الذي يملك هذه المجموعة من حالات التجار التنسيق: partners/{partner_id}/merchants

int32

مطلوب. الحد الأقصى لعدد العناصر التي سيتم عرضها يُرجى العِلم أنّ الخادم قد يُقلّل حجم الصفحة.

string

اختياريّ. قيمة nextPageToken التي تم إرجاعها من ListMerchantStatusResponse السابقة، إن توفّرت.

BookingInventoryStatus

اختياريّ. قيد اختياري لفلترة النتائج حسب حالة مستودع الحجز

WaitlistInventoryStatus

اختياريّ. قيود اختيارية لفلترة النتائج حسب حالة مستودع قائمة الانتظار.

GeoMatchingStatus

اختياريّ. قيد اختياري لفلترة النتائج حسب حالة مطابقة الموقع الجغرافي.

MerchantStatus

قائمة بحالات التجّار التي تستوفي شروط الفلتر

string

رمز مميز لاسترداد الصفحة التالية من النتائج. ليست هناك نتائج أخرى في القائمة إذا كانت فارغة.

string

اسم مورد الخلاصة، والذي يحتوي على تنسيق

• partners/{partner_id}/feeds/merchants
• partners/{partner_id}/feeds/services
• partners/{partner_id}/feeds/availability

int32

الحد الأقصى لعدد العناصر التي سيتم عرضها

string

القيمة التالية_page_token التي يتم عرضها من طلب قائمة سابق، إن وجد.

State

إجراء اختياري لفلترة النتائج حسب حالة الخلاصة

TimeRange

تقييد اختياري لفلترة النتائج حسب الحد الأقصى والأدنى. إذا لم يتم ضبط start_time، سيتم ضبطه تلقائيًا على بداية وقت نظام التشغيل Unix. إذا لم يتم ضبط end_time، سيتم ضبطها تلقائيًا على "الآن".

FeedStatus

قائمة بترتيب عكسي زمني لحالات الخلاصات المحمَّلة يستند الحد الأقصى لعدد السلع التي يتم عرضها إلى حقل page_size في الطلب.

string

رمز مميّز لاسترداد الصفحة التالية من النتائج لا تتوفّر نتائج أخرى في القائمة إذا كانت فارغة.

string

رمز اللغة وفق معيار IETF BCP 47، مثل "en" و"mas" و"zh-Hant" و"de-CH-1901" يُرجى الاطّلاع على http://www.w3.org/International/articles/language-tags/.

string

الرسالة باللغة المذكورة أعلاه (UTF-8)

string

رقم تعريف المكان لأحد الأماكن في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". اطّلِع على https://developers.google.com/places/web-service/place-id للحصول على مزيد من المعلومات عن أرقام تعريف الأماكن. إذا تمّ توفير هذه السمة، ستطابق Google الموقع الجغرافي لهذا المكان.

string

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

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

string

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

string

عنوان URL للموقع الإلكتروني العلني للموقع الجغرافي (اختياري)

GeoCoordinates

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

LocationType

يجب تقديم نوع الموقع إذا كان هذا الموقع مخصصًا لخدمة.

string

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

string

اسم مورد التاجر، الذي يكون بالتنسيق partners/{partner_id}/merchants/{merchant_id}.

string

تُستخدَم السمات merchant_name وtelephone وurl وgeo لتسهيل مطابقة مستودع الشركاء مع التجّار المدرَجين حاليًا على "خرائط Google". لن يتم عرض هذه المعلومات.

اسم التاجر.

string

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

string

عنوان URL للموقع الإلكتروني العلني للتاجر.

GeoCoordinates

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

string

فئة النشاط التجاري في منصة المجمّع

int64

تم إيقاف العمل بهذا الحقل.

uint32

معدّل الضريبة الذي يدفعه التاجر بالنقاط الأساسية (واحد من المائة من النسبة المئوية). على سبيل المثال، إذا كان معدّل الضريبة ‏7.5%، يجب ضبط هذا الحقل على 750.

في حال عدم ضبط هذا الحقل أو ضبطه على 0، يكون السعر الإجمالي الذي يتم تحصيله من المستخدم مقابل أي خدمة يوفّرها هذا التاجر هو السعر الدقيق الذي يحدّده Service.price. يُفترض أن يكون سعر الخدمة معفى من الضرائب السارية أو شاملًا لها. ولن تظهر الضرائب للمستخدم كعنصر منفصل.

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

تم إيقاف هذا الحقل نهائيًا، يُرجى استخدام tax_rate بدلاً منه.

TaxRate

معدّل الضريبة للتاجر. في حال توفّر هذا الحقل، يلغي هذا الحقل حقل tax_rate_basis_points المتوقّف نهائيًا. ستؤدي رسالة فارغة (أي tax_rate { }) إلى إعادة ضبط معدّل الضريبة المطبَّق على الصفر.

PaymentRestrictions

القيود المفروضة على طرق الدفع التي يقبلها هذا التاجر نفترض أنّه لا تتوفّر أي قيود إذا لم يتم ضبط هذا الحقل.

PaymentOption

خيارات الدفع المتاحة لهذا التاجر ستتمكّن الخدمات التابعة لهذا التاجر من الحدّ بشكل فردي من خيارات الدفع التي تسمح بها.

PaymentProcessorConfig

إعدادات معالج دفعات يستخدم الرموز المميّزة، إذا كان التاجر يقدّم هذه الميزة

TokenizationConfig

إعدادات معالج دفعات يستخدم الرموز المميّزة، إذا كان التاجر يقدّم هذه الميزة

Terms

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

string

سلسلة مبهمة تحدّد العلامة التجارية الموجّهة للمستهلِكين والتي يجب استخدامها عند عرض إحالة الشريك يسمح هذا الحقل للشركاء الذين لديهم علامات تجارية متعدّدة موجّهة للمستهلكين بتقديم تجّار لجميع العلامات التجارية ضمن الخلاصة نفسها.

تتكوّن العلامة التجارية من خصائص موجّهة للمستهلكين، مثل الاسم والشعار وبنود الخدمة وسياسة الخصوصية.

إذا كانت هناك علامة تجارية واحدة فقط للشريك موجّهة للمستهلكين، ليس عليك ضبط هذا الحقل ويمكن تجاهله.

إذا كان الشريك...

ألا تمتلك علامات تجارية متعددة تستهدف المستهلكين؟ --> تجاهُل هذا الحقل

هل هناك علامات تجارية متعددة تم إعدادها؟

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

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

MerchantMatchingHints

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

ServiceAttribute

تعريفات لأيّ سمات خدمة مستخدَمة لوصف الخدمات لهذا التاجر (اختياري)

ActionLink

اختياريّ. عنوان URL للإجراء مع اللغة المرتبطة به وقائمة البلدان التي يقتصر عليها الإجراء والنوع والنظام الأساسي الاختياري الذي يشير إلى النظام الأساسي الذي يجب تنفيذ هذا الإجراء عليه

Advisement

اختياريّ. نصائح عامة من تاجر محدَّد بشأن مستخدم ينضم إلى قائمة انتظار من خلال ميزة "الحجز عبر Google" يجب أن يقتصر طول الحقول النصية الفردية في النصيحة على 100 بايت.

EconomicOperator

اختياريّ. يجب توفير معلومات المشغّل الاقتصادي المرتبطة بهذا التاجر المحدّد للامتثال للوائح التنظيمية. (اختياري)

string

رقم تعريف المكان لأحد الأماكن في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". اطّلِع على https://developers.google.com/places/web-service/place-id للحصول على مزيد من المعلومات عن أرقام تعريف الأماكن.

string

اسم مورد حالة التاجر، بالتنسيق التالي: partners/{partner_id}/merchants/{merchant_id}/status

string

اسم التاجر الذي يقدّمه الشركاء

GeoCoordinates

قدّم الشركاء معلومات الموقع الجغرافي للتاجر.

ProcessingStatus

حالة معالجة التاجر

BookingStatus

الحالة المتعلّقة بدمج الحجز من البداية إلى النهاية

WaitlistStatus

الحالة المتعلّقة بدمج قائمة الانتظار

PlaceInfo

الموقع الجغرافي المطابق لهذا التاجر فارغ إذا لم يكن التاجر مطابقًا للموقع الجغرافي.

LocalServicesMatchInfo

تطابق "الخدمات المحلّية" مع هذا التاجر تكون فارغة إذا لم تكن تاجر خدمات محلية أو غير مطابقة مع أي مقدّمي خدمات.

DirectUrl

قائمة بعناوين URL لعرض محتوى مستودع التاجر الحالي يُرجى العلم أنّ ذلك لا يعني أنّ المستودع الإعلاني معروض فعليًا، وقد يختلف عنوان URL عن العناوين المرئية للجميع.

bool

صحيح إذا كان لدى التاجر مستودع خلال فترة 30 يومًا القادمة. لا يضمن ذلك عرض التاجر للتاجر.

UrlType

نوع عنوان URL هذا

string

عنوان URL الذي قد يظهر لهذا التاجر

MatchedProvider

مقدّمو الخدمات المطابقون يمكن مطابقة التاجر مع عدّة مقدِّمي خدمات.

int64

الرقم التعريفي الخارجي للعميل في "الخدمات المحلّية" من Google

string

فئات الخدمات المحلّية (المجالات). على سبيل المثال، "plumber" و"carpet_cleaning".

string

اسم المكان

string

عنوان منسَّق باللغة المحلية

string

رقم تعريف المكان على Google لهذا المكان ويمكن استخدامه لإنشاء عنوان URL في "خرائط Google" أو استرجاع المزيد من التفاصيل عن المكان. يُرجى الاطّلاع على https://developers.google.com/places/web-service/place-id للاطّلاع على أمثلة على الاستخدام.

bool

صحيح إذا كان التاجر يقدّم خدمة قائمة الانتظار. لا يضمن عرض إعلان التاجر.

Money

الحدّ الأدنى للمبلغ.

Money

الحد الأقصى للمبلغ

Price

المبلغ الذي قد يتم تحصيله من المستخدم في حال عدم حضوره في إطار الحجز.

PriceType

تحدِّد كيفية تحديد الرسوم استنادًا إلى مدى التوفّر.

string

اسم مورد الطلب: partners/{partner ID}/orders/{order ID}

ClientInformation

المعلومات الشخصية للعميل الذي قدّم الطلب

PaymentInformation

معلومات عن معاملات الدفع ذات الصلة بالطلب

string

معرّف التاجر الذي تعود إليه جميع الخدمات في هذا الطلب

LineItem

العناصر بهذا الترتيب.

FulfillmentOption

خيارات توصيل الطلب المتاحة لرابط اتخاذ إجراء على الإنترنت

PrepaymentStatus

حالة الدفعة المُسبَقة للحجز إذا كانت حالة الدفع المسبق الدفع PREPAYMENT_PROVIDED أو PREPAYMENT_REFUNDED، سيحتوي عنوان payment_transaction_id على معرّف المعاملة الفريد المرتبط.

string

المعرّف الفريد لمعاملة دفع مرتبطة بالحجز فارغة إذا لم يكن ذلك منطبقًا.

string

ويُستخدَم هذا المعرّف لتحديد خيار الدفع هذا.

يكون رقم التعريف هذا موحّدًا في مجمّع البيانات بالكامل، وسيسمح إعادة استخدام قيمة في بائعين متعددين للمستخدم بالدفع باستخدام خيار الدفع المقابل لدى هؤلاء البائعين.

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

string

اسم خيار الدفع. ويمكن أن يكون هذا المحتوى مرئيًا للمستخدم.

string

وصف خيار الدفع. ويمكن أن يكون هذا المحتوى مرئيًا للمستخدم.

Price

سعر خيار الدفع

TaxRate

معدّل الضريبة لخيار الدفع هذا. يُلغي هذا الحقل، في حال توفّره، حقل "tax_rate" (معدّل الضريبة) الوارد في "التاجر" أو "الخدمة". ستؤدي الرسالة الفارغة (على سبيل المثال: tax_rate { }) إلى إعادة ضبط معدل الضريبة المطبَّق على صفر.

PaymentOptionType

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

int64

عدد الجلسات التي يمكن استخدام خيار الدفع هذا فيها لا يُسمَح باستخدامها إلا مع الحِزم أو الجلسات المتعددة، حيث يجب أن تكون القيمة أكبر من 1.

TimeRange

يمكن شراء خيار الدفع خلال هذه الفترة.

TimeRange

ويمكن استخدام خيار الدفع خلال هذه الفترة (على سبيل المثال، السعر الخاص لشهر كانون الثاني (يناير) 2017). وفي حال توفُّرها، ستلغي هذه الدالة السمة valid_duration وactivate_type.

Duration

مدة صلاحية خيار الدفع (مثل اشتراك لمدة 30 يومًا).

ActivationType

يحدد كيفية تحديد تاريخ بدء الصلاحية لخيار الدفع هذا.

UserPurchaseRestriction

تقييد المستخدمين المؤهَّلين لشراء خيار الدفع هذا يمكن استخدامها لتقييد خيار دفع ترويجي بمجموعة فرعية من المستخدمين. وفي حال عدم ضبطها، يكون جميع المستخدمين مؤهّلين.

Processor

تحدّد هذه السمة الشريك المسؤول عن معالجة المعاملات التي تنطبق عليه هذه الإعدادات.

string

المفتاح المستخدَم لتحديد هذا التاجر لدى جهة معالجة المعاملات.

بالنسبة إلى Stripe، يُرجى الرجوع إلى: https://stripe.com/docs/dashboard#api-keys بالنسبة إلى Braintree، يُرجى الرجوع إلى: https://articles.braintreepayments.com/control-panel/important-gateway-credentials

string

رقم إصدار واجهة برمجة التطبيقات الذي تم إرساله إلى جهة معالجة المعاملات مع طلبات الدفع.

CreditCardRestrictions

قيود على بطاقات الائتمان التي يقبلها هذا التاجر نفترض أنّه يتم قبول جميع بطاقات الائتمان إذا لم يتم ضبط هذا الحقل. يُرجى العلم أنّ قائمة البطاقات المتوافقة مع CreditCardType ستتزايد بمرور الوقت، ما يعني أنّ ترك هذا الحقل فارغًا سيؤدي إلى تغيير الإعدادات في المستقبل.

Price

قد تختلف هذه الرسوم حسب طريقة التسليم.

Price

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

Price

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

Price

رسوم يتم دفعها مقابل المكان أو المنشأة

Price

تُطبَّق الضرائب على كلّ تذكرة.

string

البلد، المحدّد باستخدام رمز البلد المكوّن من حرفَين حسب المعيار ISO 3166-1 alpha-2، مثل "US" (سمة مطلوبة)

string

اسم المنطقة، مثل "ماونتن فيو" (معلومات مطلوبة)

string

المنطقة، مثلاً "CA". هذا الحقل مطلوب فقط في البلدان التي تكون فيها المنطقة عادةً جزءًا من العنوان. (اختياري)

string

الرمز البريدي، مثل "94043" (معلومات مطلوبة)

string

عنوان الشارع، على سبيل المثال: " 1600 Amphitheatre Pkwy". (معلومات مطلوبة)

PriceInfo

حاوية لتفاصيل السعر

int64

السعر بوحدات ميكرو تعادل العملة ويتم تقريب كسور أصغر وحدة عملة باستخدام أقرب تقريب زوجي. (على سبيل المثال، بالنسبة إلى 2.5 سنت أمريكي مقرَّب إلى سنتَين، 3.5 سنت مقرَّبة إلى 4 سنتات، و0.5 سنت مقرَّبة إلى 0 سنت، و2.51 سنت مقرَّبة إلى 3 سنت).

string

العملة المحدّدة في ISO 4217 للسعر

string

سلسلة اختيارية ومعتمة تحدد خيار السعر المرتبط بالسعر الموسّع.

PriceType

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

Price

سعر خدمة أو رسوم

PriceRange

الحد الأعلى و/أو الأدنى للخدمة أو الرسوم.

Price

الحدّ الأدنى للمبلغ.

Price

الحد الأقصى للمبلغ. يجب أن تكون دائمًا > min_price.

double

أي قيمة فردية. على سبيل المثال: 5.6

RangeValue

نطاق من القيم التي يمكن أيضًا أن تكون مفتوحة أو محدودة. أمثلة: * 5.5 على الأقل * 5.5 بحد أقصى * من 5.5 إلى 6.5

double

الحد الأدنى للقيمة

double

القيمة القصوى

double

متوسط قيمة التقييم (مطلوبة عندما يكون number_of_ratings > 0). يجب أن تكون القيمة ضمن النطاق [1، 5] ويمكن حذفها إذا كانت قيمة عدد_التقييمات تساوي صفرًا فقط.

uint64

عدد التقييمات المُستخدَمة في احتساب القيمة (مطلوب)

string

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

MediaType

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

Text

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

Attribution

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

string

تم إيقافه نهائيًا، ويُفضّل استخدام localized_caption.

Text

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

string

تم إيقافه نهائيًا، ويُفضّل استخدام localized_text.

ServiceAvailability

مدى توفّر الخدمة المستخدَمة لاستبدال الخدمات الحالية.

string

رقم تعريف اختياري لموظف يقدّم الخدمة يحدِّد هذا الحقل موظف الدعم في جميع سجلات التجّار والخدمات ومدى التوفّر. يجب أيضًا أن تكون مستقرة بمرور الوقت للسماح بالارتباط مع الحجوزات السابقة. يجب أن يكون هذا الحقل متوفرًا في حال توفّر employee_name.

string

اسم اختياري لموظف يقدّم الخدمة. سيتم عرض هذا الحقل للمستخدمين الذين يجرون حجزًا، ويجب أن يكون سهل الفهم، وليس معرّفًا مبهمًا. يجب أن يكون هذا الحقل متوفّرًا إذا كان staff_id متوفّرًا.

string

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

string

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

int32

تنطبق هذه السمة على "تناول الطعام" فقط: حجم المجموعة التي يمكن استيعابها خلال هذه الفترة الزمنية. يمكن ربط مطعم بعدة خانات في الوقت نفسه، بحيث يحدد كل منها قيمة Party_size مختلفة، إذا كان بإمكان شخصين أو 3 أو 4 أشخاص مثلاً الجلوس في حجز.

Text

اختياريّ. وصف مترجم للغرفة. وفي حال ضبطها، يجب تقديم قيمة تلقائية. ويُفضَّل أيضًا توفير لغات شائعة للغة التاجر. (اختياري)

int64

الحد الأدنى من الإشعار المُسبَق بالثواني المطلوب لإلغاء موعد محجوز على الإنترنت. (اختياري)

Price

رسوم الإلغاء خلال الحد الأدنى لمدة الإشعار المُسبَق

Price

رسوم عدم الحضور بدون إلغاء الاشتراك

AdmissionPolicy

سياسة الدخول السارية على هذه الخدمة في حال ترك السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على TIME_STRICT. (اختياري)

CancellationPolicy

سياسة إلغاء قواعد الجدولة (مطلوبة لميزة "نشاطات مقترَحة")

int64

المدة (بالثواني) بدءًا من وقت إجراء آخر حجز حتى تاريخ بدء خانة مدى التوفّر.

int64

المدة (بالثواني) من وقت إجراء آخر حجز إلى وقت انتهاء خانة مدى التوفّر إذا تم تعيين هذا الحقل، فستتغير "admission_policy" على TIME_FLEXIBLE للإشارة إلى أنّه يمكن للمستخدمين استخدام التذاكر التي تم شراؤها بعد بدء الخانات.

string

اسم مورد الخدمة الذي يكون بالتنسيق partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.

string

اسم الخدمة، مثل "قصة شعر للرجال" تم إيقاف هذه السمة نهائيًا، لذا استخدِم localized_service_name بدلاً منها.

Text

اسم الخدمة، مثل "قصة شعر للرجال" ربما في عدة لغات.

string

وصف الخدمة المرئي للمستخدم متوقّفة نهائيًا، لذا استخدِم localized_description بدلاً منها.

Text

وصف الخدمة المرئي للمستخدم

يتيح هذا الحقل استخدام النص العادي والتنسيقات المشابهة لتنسيق HTML. على عكس أقسام النص العادي، يمكن إنشاء تخطيطات مخصصة هنا باستخدام العناوين والفقرات والقوائم وبعض علامات العبارات. يُرجى قراءة التعليمات والملاحظات التالية بعناية لضمان تقديم أفضل تجربة للمستخدم.

علامات التنسيق المتوافقة التي تشبه HTML:

علامات العناوين: <h1> و<h2> و<h3> و<h4> و<h5> و<h6>
يمكن استخدام علامات العناوين لعرض العناوين والعناوين الفرعية. على سبيل المثال، <h1>برنامج الرحلة</h1> سيتم عرض النص المضمّن على أنه العنوان الأكثر أهمية في القسم. يُرجى العِلم أنّه سيتم تجاهل أي علامات أو أنماط أو سمات HTML داخلية. على سبيل المثال، <h1 style=".."> سيتم التعامل معهما مثل <h1>. سيتم الاحتفاظ بالنص الخالص فقط.

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

علامات القائمة: <ul>، <ol>، <li>
<ul> يمكن استخدامها مع <li> لعرض القوائم غير المرتبة، وعلامة <ol> يمكن استخدامها مع <li> لعرض القوائم المرتبة. وهذه طريقة جيدة لعرض قوائم التحقّق أو الجداول الزمنية أو أي قوائم أخرى تناسب حالات الاستخدام.
مثال: لعرض قائمة بميزات رحلة بحرية:
<ol>
<li>إطلالة رائعة على المحيط وفرص للعب مع الحيوانات البرية.</li>
<li>ترتيبات السفر والخدمات المصمّمة بعناية.</li>
<li>أدنى سعر مضمون.</li>
</ol>
يُرجى العِلم أنّه لن يتم تحويل سوى علامات <li> ضمن علامتَي <ul> أو <ol>. وسيتم إسقاط كل الأطفال الآخرين. سيتم أيضًا تجاهل أي علامات وسمات وأنماط داخلية، وسنحتفظ فقط بمحتوى النص الخالص.

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

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

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

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

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

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

Price

سعر الخدمة.

PriceInterpretation

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

SchedulingRules

قواعد حجز/إلغاء موعد

PrepaymentType

ما إذا كان الدفع المُسبَق مطلوبًا أو اختياريًا أو غير متاح

PrepaymentTerms

أحكام حول وقت اكتمال الدفعة المدفوعة مسبقًا

ServiceIntakeForm

تمّ الإيقاف. يُرجى استخدام intake_form وper_ticket_intake_form.

ServiceIntakeForm

نموذج يطلب معلومات إضافية من المستخدم عند حجز هذه الخدمة (اختياري)

ServiceIntakeForm

نموذج يطلب معلومات إضافية من المستخدم عند حجز هذه الخدمة يجب ملء هذا النموذج مرة واحدة لكل تذكرة يحجزها المستخدم. (اختياري)

TaxRate

معدّل الضريبة على الخدمة. في حال توفّر هذا الحقل، يلغي هذا الحقل أي معدّل ضريبي تم ضبطه على مستوى التاجر. ستؤدي الرسالة الفارغة (على سبيل المثال: tax_rate { }) إلى إعادة ضبط معدل الضريبة المطبَّق على صفر.

string

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

Deposit

يحدد كيف يمكن تحصيل مبلغ الإيداع من المستخدم. لإلغاء إيداع الخدمة في حال تحديد واحد. يؤدي ضبط هذا الخيار على رسالة إيداع فارغة إلى إزالة أي إيداع على مستوى الخدمة. (اختياري)

NoShowFee

لتحديد رسوم عدم الحضور التي يمكن تحصيلها من المستخدم. يؤدي هذا الإجراء إلى إلغاء رسوم عدم العرض للخدمة في حال تحديد أحدها. ويؤدي ضبط هذه السياسة على رسالة NoShowFee فارغة إلى إزالة أي رسوم عدم عرض على مستوى الخدمة. (اختياري)

RequireCreditCard

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

ActionLink

رابط إجراء مرتبط بهذه الخدمة في حال توفّر رابط الإجراء، يجب ضبط النوع (انظر أدناه) في "الخدمة".

ServiceType

نوع هذه الخدمة المحدَّد مسبقًا. (اختياري)

TicketType

أنواع التذاكر التي يمكن حجزها أو شراؤها لهذه الخدمة، في حال توفّر التذاكر (اختياري)

RelatedMedia

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

ServiceAttributeValueId

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

WaitlistRules

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

TicketingVerticalSpecificData

معلومات إضافية فريدة لقطاع بيع تذاكر الفعاليات (اختياري)

IntegrationType

عمق التكامل الذي ندعمه مع هذه الخدمة. (اختياري) لا علاقة له بالشركاء الذين يدمجون روابط لإجراءات التفعيل. سيتم دائمًا إيقاف الإعلانات الشاملة لدى هؤلاء الشركاء.

PerOrderFee

رسوم على مستوى الطلب لشراء هذه الخدمة (اختياري)

ToursAndActivitiesContent

حقول المحتوى الخاصة بالجولات والأنشطة.

Location

المواقع الجغرافية ذات الصلة بهذه الخدمة. ملاحظات مهمة: إذا كانت هناك مواقع جغرافية مُزارَة متعددة مرتبطة بهذه الخدمة، أو كان START_LOCATION مختلفًا عن VISITED_LOCATION، يجب تحديد START_LOCATION. مثال: - جولة بالدراجة مصحوبة بمرشد تنتقل إلى ثلاثة أماكن، ويجب تحديد مكان البداية. - اجتماع جولة بالحافلة في قاعة انتظار الفندق ثم التوجّه إلى المكان الذي سيتم زيارته يجب تحديد مكان الاجتماع.

Rating

تقييم المستخدمين لهذه الخدمة كمقياس مجمّع في جميع المراجعات.

HomeServiceData

معلومات إضافية فريدة لقطاع الخدمات المنزلية (اختياري)

VirtualSession

اختياريّ. معلومات عن الجلسة الافتراضية. وهو مطلوب لتفعيل الخدمات الافتراضية.

DirectMerchantPayment

اختياريّ. معلومات إضافية يجب إضافتها إذا كانت الخدمة تتطلب من المستخدم الدفع مباشرةً للتاجر ملاحظة مهمة: لن تشارك RwG في هذه المعاملة. تكون هذه السمة مطلوبة إذا تم تحديد default_session ولم تكن الخدمة مجانية أو لم يتم ضبط prepayment_type على "REQUIRED".

UriTemplate

اختياريّ. نموذج اختياري يحدّد كيفية إنشاء Google لعناوين URL تؤدي إلى موقع إلكتروني خارجي

ChargeTiming

وقت تحصيل الرسوم نسبةً إلى وقت الشراء

int64

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

string

معرّف يعرّف بشكل فريد سمة الخدمة هذه من بين سمات أخرى للتاجر نفسه، مثل: "نوع الحساب".

string

اسم مرئي للمستخدم لهذه السمة، مثال: "نوع الحساب".

Value

جميع القيم الممكنة لسمة الخدمة هذه.

string

معرّف يعرّف هذه القيمة بشكل فريد من بين قيم أخرى لسمة الخدمة هذه، مثل: "شخصي".

string

اسم مرئي للمستخدم للقيمة، على سبيل المثال: "شخصية".

string

معرّف سمة كما هو محدّد في سمة Merchant.service_مثل: "service-type" (نوع الخدمة).

string

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

string

اسم مورد الخدمة المطلوب تطبيق هذا عليه. بتنسيق partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Timestamp

وفي حال توفيرهما، سنعتبر كيانات مدى التوفّر المقدَّمة نبذة كاملة من [start_time_restrict وend_time_restrict). ويعني ذلك أنّه سيتم حذف جميع بيانات مدى التوفّر الحالية في حال استيفاء الشرط التالي:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

في حال ضبط رسالة مدة، يتم فرض قيود إضافية على الشرط:

  availability.duration == duration_restrict

في حال ضبط رسالة resources_restrict، سيتم تقييد الشرط بشكل أكبر:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

تُستخدَم هذه الحقول عادةً لتقديم معلومات كاملة عن مدى التوفّر في نطاق زمني معيّن.

يتم تفسير ضبط start_time_restrict أثناء ترك end_time_restrict على تفسير جميع الأوقات بدءًا من start_time_restrict.

Timestamp

إذا تم ضبط end_time_restrict مع ترك start_time_restrict بدون ضبط، يتم تفسير ذلك على أنّه كل الوقت حتى end_time_restrict.

Duration

يؤدي ضبط المدة إلى حصر نطاق التعديل في مدى التوفّر فقط مع المدة المطابقة.

Resources

يؤدي ضبط resources_restrict إلى تقييد نطاق التحديث على هذه المجموعة من الموارد فقط. يجب أن تتطابق جميع حقول أرقام التعريف للموارد تمامًا.

Availability

قائمة مدى التوفّر الجديدة.

ServiceIntakeFormField

الحقول التي ستظهر للمستخدم

bool

إذا كانت القيمة صحيحة، سيتم عرض هذا النموذج للعملاء لأول مرة. تمّ الإيقاف. لا تتوفّر هذه الوظيفة للنماذج المخصّصة لتلقّي الطلبات.

bool

في حال اختيار القيمة، سيتم عرض هذا النموذج للعملاء المتكرّرين. تمّ الإيقاف. لا تتوفّر هذه الوظيفة للنماذج المخصّصة لتلقّي الطلبات.

string

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

FieldType

نوع هذا الحقل.

string

النص المعروض للمستخدم في هذا الحقل. تم إيقاف هذه السمة نهائيًا، يُرجى استخدام localized_label بدلاً منها.

Text

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

string

يجب تعيينها فقط إذا كان نوع الحقل هو LOCATION_SEARCH. يُرجى استخدام "location_id" فِي "الموقع الجغرافي" لتحديد قيمة الموقع.

Text

يمكنك ضبط هذا الإعداد فقط إذا كان نوع الحقل MULTIPLE_CHOICE أو CHECKBOXES أو DROPDOWN. يُستخدَم لتعداد الخيارات المحتملة.

bool

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

bool

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

Text

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

string

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

Text

نص التلميح للإدخال، والذي يظهر كعنصر نائب للنص. لا ينطبق ذلك إلا عندما يكون نوع الحقل SHORT_ANSWER أو PARAGRAPH. (اختياري)

int32

يشير ذلك المصطلح إلى معدّل الضريبة بأجزاء من واحد بالمائة، وهو ما يعني دقة 6 أرقام عشرية. على سبيل المثال، إذا كان معدّل الضريبة هو 7.253%، يجب ضبط هذا الحقل على 7253000.

في حال ترك هذا الحقل بدون ضبط أو ضبطه على 0، يكون السعر الإجمالي الذي يتم تحصيله من المستخدم مقابل أي خدمة يقدّمها هذا التاجر هو السعر المحدّد الذي تحدّده Service.price. يُفترض أن يكون سعر الخدمة معفى من الضرائب السارية أو شاملًا لها. لن تظهر الضرائب للمستخدم كعنصر منفصل.

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

string

عنوان URL الخاص بالبنود والشروط اختياريًا.

string

النص الذي سيتم عرضه للمستخدم. استخدِم localized_text أدناه لعمليات الدمج الجديدة.

Text

النص المترجَم الذي سيتم عرضه للمستخدم.

string

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

LocalizedString

القيم النصية حسب اللغة اختياريّ.

string

يُستخدَم معرّف طلب الدعم للتمييز بين أنواع طلبات الدعم المختلفة للخدمة نفسها، ومن المتوقّع أن يكون فريدًا ضمن الخدمة فقط.

string

وصف موجز لنوع التذكرة هذا

ويمكن أن يكون هذا مرئيًا للمستخدم، على سبيل المثال "الأشخاص البالغون" و"الطفل" و"المحاربين القدامى" و"الصف J" وغير ذلك. مطلوبة، يجب أن يكون لكل نوع تذكرة وصف لكي يكون المستخدم مرئيًا. تم إيقاف هذه السمة نهائيًا، لذا استخدِم localized_short_description بدلاً منها.

Text

وصف مختصر لنوع التذكرة هذا مع إتاحة ميزة i18n

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

Price

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

PerTicketFee

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

PriceDisplayType

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

string

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

Text

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

تكون الخيارات الإضافية مفيدة عندما يمثل نوع التذكرة أبعادًا متعددة.

المثال 1: تذكرة دخول بأنواع مختلفة "بالغ" و"طفل" واللغة كخيار إضافي، ستكون قائمة TicketType المتوقّعة على النحو التالي: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } }

المثال 2: تأجير قارب كاياك لعدة ساعات مع إضافة اختيارية للأكياس المجففة، ويمكن أن يكون الوصف Short_description "3 ساعات" ويمكن أن تكون قيمة الخيار option_description إما "مع حقيبة جافة" أو "بدون حقيبة جافة": - { tickets_type_id: "ticket_type_1" localized_short_description { value: &quot;2 hours&quot; } localized_option_description { value: &quot;english&quot; } } - { ticket_type_id: &quot;ticket_type_2&quot; localized_short_description { value: &quot;2 hours&quot; } localized_option_description { value: "spanish" } } - { Ticket_type_id: "ticket_type_3" localized_short_description { value: "3 ساعات" } localized_option_description { value: &quot;english&quot; } } - { ticket_type_id: &quot;ticket_type_4&quot; localized_short_description { value: "3 ساعات" } localized_option_description { value: "spanish" } }

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

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

InventoryType

اختياريّ. نوع المستودع الإعلاني المحدّد مسبقًا لتذكرة واحدة من هذا النوع.

EventCategory

فئة الحدث. لا يتم ضبطها إلا عندما يندرج الحدث ضمن إحدى الفئات المحدّدة مسبقًا. (اختياري)

string

عنوان URL للفعالية على الموقع الإلكتروني للشريك (اختياري)

Entity

قائمة بالكيانات ذات الصلة بالحدث (اختياري)

AttendanceMode

مطلوب. نوع حضور الفعالية.

string

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

Text

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

string

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

OrganizerType

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

string

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

EventState

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

Text

اختياريّ. اسم العلامة التجارية المترجَم

EventCreator

اختياريّ. معلومات عن منشئ الحدث.

string

المعرّف الفريد للكيان في قاعدة بيانات الشريك (اختياري)

string

اسم الجهة. (معلومات مطلوبة)

string

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

EntityType

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

EntityRole

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

PublicIdentificationData

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

string

اختياريّ. اسم منشئ الحدث. ما مِن قيود على عدد الأحرف.

string

عنوان URL عام لأي صفحة ويب مخصصة للموضوع فقط. ويمكن أن يشمل ذلك المواقع الإلكترونية الرسمية أو Discogs أو منصات وسائل التواصل الاجتماعي أو صفحات Wikipedia أو IMDb، مثل https://www.discogs.com/artist/1124645-Taylor-Swift وhttps://www.wikidata.org/wiki/Q19320959 وhttps://twitter.com/acmilan. (اختياري)

string

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

Timestamp

الحد الأدنى للنطاق الزمني.

Timestamp

الحدّ الأقصى للنطاق الزمني.

map<string, string>

سيتضمّن إعداد ترميز الرموز عادةً مَعلمة tokenization_parameter واحدة يكون مفتاحها هو "gateway" وتكون قيمتها هي اسم المعالج.

تعتمد بقية المَعلمات على المعالج. اطّلِع على مستندات Google Pay للحصول على مزيد من المعلومات.

مثال على Braintree: مَعلمة_التشفير { المفتاح: "gateway" القيمة: "braintree" } مَعلمة_التشفير { المفتاح: "braintree:apiVersion" القيمة: "v1" } مَعلمة_التشفير { المفتاح: "braintree:sdkVersion" القيمة: "2.30.0" } مَعلمة_التشفير { المفتاح: "braintree:merchantId" القيمة: "abcdef" } مَعلمة_التشفير { المفتاح: "braintree:clientKey" القيمة: "production_xxx_yyy" }

مثال على Stripe: Tokenization_parameter { key: "gateway" القيمة: "stripe" } tokenization_parameter { key: &quot;stripe:version&quot; القيمة: "2018-02-28" } tokenization_parameter { key: &quot;stripe:publishableKey&quot; القيمة: "pk_1234" }

مثال على Adyen: iconization_parameter { key: "gateway" القيمة: "adyen" } tokenization_parameter { key: &quot;gatewayMerchantId&quot; القيمة: "yourId" }

BillingInformationFormat

يجب تضمين معلومات الفوترة الخاصة بالمستخدم في الرمز المميّز للدفع كما هو موضّح في Google Pay باستخدام طريقة الدفع الأساسية (انظر أعلاه). ويؤدي ترك الحقل فارغًا إلى تحديد MIN.