تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Engage SDK Travel: تعليمات الدمج الفني التابعة لجهات خارجية

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

يحتوي هذا الدليل على تعليمات لشركاء المطوّرين حول كيفية عرض محتوى السفر والفعاليات على مساحات عرض Engage.

تفاصيل عملية الدمج

المصطلحات

يتضمّن هذا الدمج أنواع المجموعات التالية: اقتراح ومميّز وحجز ومتابعة البحث.

تعرض مجموعات الاقتراحات اقتراحات مخصّصة حول السفر والفعاليات من أحد شركاء المطوّرين. ويمكن أن تكون هذه الاقتراحات مخصّصة للمستخدم أو عامة (مثل المنتجات الرائجة). يمكنك استخدامها لعرض اقتراحات بشأن المقالات أو الأحداث أو أماكن الإقامة أو الأماكن التي تهمّك.
- يمكن أن تتألف مجموعة الاقتراحات من بيانات ArticleEntity أو EventEntity أو LodgingEntity أو PointOfInterestEntity أو StoreEntity، ولكن ليس من مزيج من أنواع مختلفة من الكيانات.
تتّخذ اقتراحاتك البنية التالية:
- مجموعة الاقتراحات: هي طريقة عرض في واجهة المستخدم تتضمّن مجموعة من الاقتراحات من شريك مطوّر واحد.
- العنصر: هو كائن يمثّل عنصرًا واحدًا في مجموعة. يوفّر هذا التكامل بعض الكيانات التي سيتم عرضها باستخدام "مجموعة الاقتراحات":
  - ArticleEntity: يمثّل ArticleEntity اقتراحًا لمحتوى مستند إلى نص مرتبط بالسفر والفعاليات. ويمكن استخدامها في المقالات ومشاركات المدونات والمحتوى التسويقي ومقتطفات الأخبار وما إلى ذلك.
    
    الشكل 1: واجهة مستخدم تعرض ArticleEntity واحدًا ضمن مجموعة "الاقتراحات".
  - EventEntity: يمثّل EventEntity حدثًا سيقع في المستقبل. يُعدّ وقت بدء الحدث معلومة مهمة يجب إبلاغ المستخدمين بها.
    
    الشكل 2: واجهة مستخدم تعرض EventEntity واحدًا ضمن مجموعة الاقتراحات.
  - LodgingEntity: يمثّل هذا النوع من الكيانات مكان إقامة، مثل فندق أو شقة أو منزل عطلات مخصّص للاستئجار لفترات قصيرة أو طويلة.
    
    الشكل 3: واجهة مستخدم تعرض عنصر LodgingEntity واحدًا ضمن مجموعة "الاقتراحات".
  - StoreEntity: يمثّل StoreEntity متجرًا أو مطعمًا أو مقهى أو غير ذلك، ويسلّط الضوء على المحتوى الذي يمثّل فيه مكان تناول الطعام أو المتجر المعلومات الأساسية التي يجب نقلها إلى المستخدمين.
    
    الشكل 4: واجهة مستخدم تعرض عنصر StoreEntity واحدًا ضمن مجموعة الاقتراحات.
  - PointOfInterestEntity: يمثّل PointOfInterestEntity مكانًا يهمّ المستخدمين، مثل محطة وقود أو مكان إقامة فعالية أو مدينة ملاهٍ أو متحف أو موقع سياحي أو مسار للمشي لمسافات طويلة وما إلى ذلك. ويسلّط الضوء على المحتوى الذي يشكّل فيه الموقع الجغرافي جزءًا مهمًا من المعلومات التي يجب نقلها إلى المستخدمين. ولا يجب استخدامها في أماكن الإقامة أو المتاجر أو أماكن تناول الطعام.
    
    الشكل 5: واجهة مستخدم تعرض كيانًا واحدًا PointOfInterestEntity ضمن مجموعة الاقتراحات.
تعرض مجموعة الحجز المحتوى الذي تفاعل معه المستخدمون مؤخرًا من عدة شركاء مطوّرين في مجموعة واحدة ضمن واجهة المستخدم. سيُسمح لكل شريك مطوّر ببث 10 عناصر بحد أقصى في مجموعة الحجز.

يمكن أن يتّخذ محتوى الحجز البنية التالية:
- RestaurantReservationEntity: يمثّل هذا النوع حجزًا في مطعم أو مقهى ويساعد المستخدمين في تتبُّع حجوزات المطاعم القادمة أو الحالية.
  
  الشكل 6. واجهة مستخدم تعرض RestaurantReservationEntity واحدة ضمن مجموعة Reservation.
- EventReservationEntity: يمثّل EventReservationEntity حجزًا لحدث ويساعد المستخدمين في تتبُّع حجوزات الأحداث القادمة أو الجارية. يمكن أن تشمل الأحداث ما يلي على سبيل المثال لا الحصر:
  - الأحداث الرياضية، مثل حجز تذاكر لمباراة كرة قدم
  - فعاليات ألعاب الفيديو، مثل الحجز لمشاهدة مباريات الرياضات الإلكترونية
  - فعاليات ترفيهية، مثل حجز تذاكر لمشاهدة فيلم في السينما أو لحضور حفل موسيقي أو مسرحي أو توقيع كتاب
  - حجوزات السفر أو الأماكن المهمة، مثل الجولات الإرشادية وتذاكر المتاحف
  - حجوزات اجتماعية / حجوزات في ندوات / حجوزات في مؤتمرات
  - حجوزات جلسات التعليم أو التدريب
  الشكل 7. واجهة مستخدم تعرض EventReservationEntity واحدًا ضمن مجموعة Reservation.
- ‫LodgingReservationEntity: يمثّل LodgingEntityReservation حجزًا في مكان إقامة ويساعد المستخدمين في تتبُّع حجوزات الفنادق أو الأماكن المخصّصة للاستئجار القادمة أو الحالية.
  
  الشكل 8. واجهة مستخدم تعرض LodgingReservationEntity واحدًا ضمن مجموعة Reservation.
- TransportationReservationEntity: يمثّل هذا النوع من الكيانات الحجوزات المتعلقة بوسائل النقل المختلفة، ويساعد المستخدمين في تتبُّع حجوزاتهم لرحلات جوية أو رحلات على متن عبّارات أو قطارات أو حافلات أو رحلات على متن سيارات أجرة أو رحلات بحرية قادمة أو حالية.
  
  الشكل 9. واجهة مستخدم تعرض TransportationReservationEntity واحدة ضمن مجموعة Reservation
- VehicleRentalReservationEntity: يمثّل VehicleRentalReservationEntity حجز سيارة للإيجار ويساعد المستخدمين في تتبُّع حجوزات السيارات القادمة أو الجارية.
  
  الشكل 10. واجهة مستخدم تعرض عنصرًا واحدًا من نوع VehicleRentalReservationEntity ضمن مجموعة Reservation
تعرض المجموعة المميّزة مجموعة من العناصر من عدة شركاء مطوّرين في مجموعة واحدة ضمن واجهة المستخدم. سيكون هناك مجموعة واحدة من "الميزات"، تظهر بالقرب من أعلى واجهة المستخدم في موضع ذي أولوية أعلى من جميع مجموعات "الاقتراحات". سيُسمح لكل شريك مطوّر ببث ما يصل إلى 10 كيانات في المجموعة المميزة.
- ‫GenericFeaturedEntity: يختلف GenericFeaturedEntity عن عنصر الاقتراح في أنّ العنصر المميّز يجب استخدامه لعرض محتوى واحد من أهم المحتويات التي يقدّمها المطوّرون، ويجب أن يمثّل المحتوى الأكثر أهمية الذي سيكون مثيرًا لاهتمام المستخدمين ومناسبًا لهم.
  
  الشكل 11: واجهة مستخدم تعرض FeaturedCluster مع قائمة GenericFeaturedEntity
تساعد حزمة متابعة البحث المستخدمين في استئناف رحلة البحث السابقة عن السفر من خلال عرض قائمة بطلبات البحث التي أجراها المستخدم مؤخرًا في جميع تطبيقات السفر. سيتم تثبيت المجموعة في الموضع الثاني، بعد الحجوزات وقبل المجموعات المميزة ومجموعات الاقتراحات. سيُسمح لكل شريك من المطوّرين ببث ما يصل إلى 3 كيانات في مجموعة "مواصلة البحث".
- PointOfInterestEntity: يمثّل PointOfInterestEntity مكانًا يهمّ المستخدم، مثل محطة وقود أو مكان لإقامة الفعاليات أو مدينة ملاهٍ أو متحف أو موقع سياحي أو مسار للمشي لمسافات طويلة وما إلى ذلك. ويسلّط الضوء على المحتوى الذي بحث عنه المستخدم سابقًا.

العمل التحضيري

الحد الأدنى لمستوى واجهة برمجة التطبيقات: 19

أضِف مكتبة com.google.android.engage:engage-core إلى تطبيقك باتّباع الخطوات التالية:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.2'
}

ملخّص

ويستند التصميم إلى تنفيذ خدمة مرتبطة.

تخضع البيانات التي يمكن للعميل نشرها للحدود التالية لأنواع المجموعات المختلفة:

نوع المجموعة	حدود المجموعات	الحدود الدنيا للكيانات في المجموعة	الحدّ الأقصى لعدد العناصر في مجموعة
مجموعات الاقتراحات	7 على الأكثر	واحد على الأقل	50 على الأكثر (`ArticleEntity` أو `EventEntity` أو `LodgingEntity` أو `StoreEntity` أو `PointOfInterestEntity`)
مجموعة الحجوزات	1 على الأكثر	واحد على الأقل	20 على الأكثر (`RestaurantReservationEntity` أو `EventReservationEntity` أو `LodgingReservationEntity` أو `TransportationReservationEntity` أو `VehicleRentalReservationEntity`)
المجموعة المميزة	1 على الأكثر	واحد على الأقل	20 على الأكثر (`GenericFeaturedEntity`)
مجموعة "مواصلة البحث"	1 على الأكثر	واحد على الأقل	3 على الأكثر (`PointOfInterestEntity`)

الخطوة 1: تقديم بيانات الجهة

حدّدت حزمة تطوير البرامج (SDK) عناصر مختلفة لتمثيل كل نوع من أنواع العناصر. نوفّر الدعم للكيانات التالية ضمن فئة "السفر والفعاليات":

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

توضّح الرسوم البيانية أدناه السمات والمتطلبات المتاحة لكل نوع.

`GenericFeaturedEntity`

السمة	المتطلب	الوصف	التنسيق
Action Uri	مطلوبة	رابط لصفحة معيّنة في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد مصدر الإحالة. يُرجى الرجوع إلى الأسئلة الشائعة	معرّف موارد منتظم (URI)
صور الملصقات	مطلوبة	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: في حال توفير شارة، احرص على توفير مساحة آمنة تبلغ 24 وحدة بكسل مستقلة الكثافة في أعلى الصورة وأسفلها.	راجِع مواصفات الصور للحصول على إرشادات.
العنوان	اختياري	تمثّل هذه السمة عنوان الكيان.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 50 حرفًا
الوصف	اختياري	فقرة نصية واحدة لوصف العنصر ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة والشرح	اختياري	ما يصل إلى 3 عناوين فرعية، كل عنوان فرعي عبارة عن سطر واحد من النص ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحد أقصى
الشارات	اختياري	تكون كل شارة إما نصًا حرًا (15 حرفًا كحد أقصى) أو صورة صغيرة. معاملة خاصة لتجربة المستخدم في أعلى الصورة أو الفيديو، مثلاً، كتراكب شارة على الصورة "تحديث مباشر" مدة قراءة المقالة
شارة - نص	اختياري	عنوان الشارة ملاحظة: يجب إدخال نص أو صورة للشارة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 15 حرفًا كحدّ أقصى
شارة - صورة	اختياري	صورة صغيرة معاملة خاصة لتجربة المستخدم، مثلاً كشارة متراكبة على الصورة المصغّرة للفيديو أو الصورة ملاحظة: يجب إدخال نص أو صورة للشارة.	راجِع مواصفات الصور للحصول على إرشادات.
فئات المحتوى	اختياري	تصف هذه السمة فئة المحتوى في العنصر.	قائمة عمليات التعداد راجِع قسم فئة المحتوى للحصول على إرشادات.
DisplayTimeWindow (اختياري): ضبط فترة زمنية لعرض المحتوى على المساحة
الطابع الزمني للبدء	اختياري	الطابع الزمني الخاص بالحقبة الذي يجب أن يظهر بعده المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني لوقت بدء العصر الذي يتوقف بعده عرض المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية

`ArticleEntity`

السمة	المتطلب	الوصف	التنسيق
Action Uri	مطلوبة	رابط لصفحة معيّنة في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد مصدر الإحالة. يُرجى الرجوع إلى الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	تمثّل هذه السمة عنوان الكيان.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 50 حرفًا كحد أقصى
صور الملصقات	اختياري	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: يُنصح بشدة بإضافة صورة. في حال توفير شارة، تأكَّد من توفير مساحة آمنة تبلغ 24 وحدة بكسل مستقلة الكثافة (dp) في أعلى الصورة وأسفلها.	راجِع مواصفات الصور للحصول على إرشادات.
المصدر - العنوان	اختياري	اسم المؤلف أو المؤسسة أو المراسل	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 25 حرفًا
المصدر - الصورة	اختياري	صورة للمصدر، مثل المؤلف أو المؤسسة أو المراسل	راجِع مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة نصية واحدة لوصف العنصر ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة والشرح	اختياري	ما يصل إلى 3 عناوين فرعية، كل عنوان فرعي عبارة عن سطر واحد من النص ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحد أقصى
الشارات	اختياري	تكون كل شارة إما نصًا حرًا (15 حرفًا كحد أقصى) أو صورة صغيرة. معاملة خاصة لتجربة المستخدم في أعلى الصورة أو الفيديو، مثلاً، كتراكب شارة على الصورة "تحديث مباشر" مدة قراءة المقالة
شارة - نص	اختياري	عنوان الشارة ملاحظة: يجب إدخال نص أو صورة للشارة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 15 حرفًا كحدّ أقصى
شارة - صورة	اختياري	صورة صغيرة معاملة خاصة لتجربة المستخدم، مثلاً كشارة متراكبة على الصورة المصغّرة للفيديو أو الصورة ملاحظة: يجب إدخال نص أو صورة للشارة.	راجِع مواصفات الصور للحصول على إرشادات.
وقت نشر المحتوى	اختياري	هذا هو الطابع الزمني منذ بداية حقبة معيّنة بالملي ثانية لتاريخ نشر المحتوى أو تعديله في التطبيق.	الطابع الزمني للحقبة بالملي ثانية
مدة التفاعل الأخيرة	اختياري	الطابع الزمني للحقبة بالمللي ثانية عندما تفاعل المستخدِم مع هذا العنصر آخر مرة.	الطابع الزمني للحقبة بالملي ثانية
النسبة المئوية للتقدّم	اختياري	النسبة المئوية للمحتوى الكامل الذي استهلكه المستخدم حتى الآن.	قيمة عدد صحيح تتراوح بين 0 و100 ضِمنًا.
فئات المحتوى	اختياري	تصف هذه السمة فئة المحتوى في العنصر.	قائمة عمليات التعداد راجِع قسم فئة المحتوى للحصول على إرشادات.
DisplayTimeWindow (اختياري): ضبط فترة زمنية لعرض المحتوى على المساحة
الطابع الزمني للبدء	اختياري	الطابع الزمني الخاص بالحقبة الذي يجب أن يظهر بعده المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني لوقت بدء العصر الذي يتوقف بعده عرض المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية

`EventEntity`

السمة	المتطلب	الوصف	التنسيق
Action Uri	مطلوبة	رابط لصفحة معيّنة في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد مصدر الإحالة. يُرجى الرجوع إلى الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	تمثّل هذه السمة عنوان الكيان.	سلسلة حجم النص المقترَح: 50 حرفًا كحد أقصى
وقت البدء المعدَّل بما يناسب السوق المحلية - الطابع الزمني	مطلوبة	الطابع الزمني لوقت بدء الحدث المتوقّع.	Joda-Time Instant
وقت البدء المعدَّل بما يناسب السوق المحلية - المنطقة الزمنية	مطلوبة	تمثّل هذه السمة المنطقة الزمنية التي من المتوقّع أن يبدأ فيها الحدث.	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
وضع الحدث	مطلوبة	حقل لتحديد ما إذا كانت الفعالية ستكون افتراضية أو بالحضور الشخصي أو كليهما.	قيمة تعدادية: VIRTUAL أو IN_PERSON أو HYBRID
صور الملصقات	مطلوبة	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: يُنصح بشدة بإضافة صورة. في حال توفير شارة، تأكَّد من توفير مساحة آمنة تبلغ 24 وحدة بكسل مستقلة الكثافة (dp) في أعلى الصورة وأسفلها.	راجِع مواصفات الصور للحصول على إرشادات.
الموقع الجغرافي - البلد	مطلوب بشكل مشروط	البلد الذي سيُقام فيه الحدث ملاحظة: هذا الحقل مطلوب للأحداث التي تكون IN_PERSON أو HYBRID	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - المدينة	مطلوب بشكل مشروط	المدينة التي تقام فيها الفعالية ملاحظة: هذا الحقل مطلوب للأحداث التي تكون IN_PERSON أو HYBRID	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عرض العنوان	مطلوب بشكل مشروط	تمثّل هذه السمة عنوان المكان أو اسم الموقع الجغرافي الذي ستقام فيه الفعالية، ويجب عرضه للمستخدم. ملاحظة: هذا الحقل مطلوب للأحداث التي تكون IN_PERSON أو HYBRID	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عنوان الشارع	اختياري	تمثّل هذه السمة عنوان الشارع (إذا كان ذلك منطبقًا) للموقع الجغرافي الذي تتم فيه استضافة الفعالية.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الولاية	اختياري	تمثّل هذه السمة الولاية أو المقاطعة (إنْ وجدت) التي تستضيف الفعالية.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	تمثّل هذه السمة الرمز البريدي (إن أمكن) للموقع الجغرافي الذي تقام فيه الفعالية.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الحي	اختياري	تمثّل هذه السمة الحي (إن أمكن) الذي يتم فيه استضافة الفعالية.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
وقت الانتهاء	اختياري	الطابع الزمني لوقت بدء الحقبة الذي من المتوقّع أن ينتهي فيه الحدث ملاحظة:سيتم تمثيل ذلك بالملي ثانية.	الطابع الزمني للحقبة بالملي ثانية
الوصف	اختياري	فقرة نصية واحدة لوصف العنصر ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة والشرح	اختياري	ما يصل إلى 3 عناوين فرعية، كل عنوان فرعي عبارة عن سطر واحد من النص ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحد أقصى
الشارات	اختياري	تكون كل شارة إما نصًا حرًا (15 حرفًا كحد أقصى) أو صورة صغيرة.
شارة - نص	اختياري	عنوان الشارة ملاحظة: يجب إدخال نص أو صورة للشارة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 15 حرفًا كحدّ أقصى
شارة - صورة	اختياري	صورة صغيرة معاملة خاصة لتجربة المستخدم، مثلاً كشارة متراكبة على الصورة المصغّرة للفيديو أو الصورة ملاحظة: يجب إدخال نص أو صورة للشارة.	راجِع مواصفات الصور للحصول على إرشادات.
السعر - CurrentPrice	مطلوب بشكل مشروط	تمثّل هذه السمة السعر الحالي للتذكرة أو بطاقة الدخول إلى الحدث. يجب توفيرها إذا تم توفير السعر المشطوب.	حقل التعبئة النصّية الحرّة
السعر - StrikethroughPrice	اختياري	يشير هذا الحقل إلى السعر الأصلي للتذكرة أو البطاقة الخاصة بالفعالية.	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	وسيلة شرح السعر لعرض عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
فئات المحتوى	اختياري	تصف هذه السمة فئة المحتوى في العنصر.	قائمة التعدادات المؤهَّلة ‫TYPE_MOVIES_AND_TV_SHOWS (مثال - سينما) ‫TYPE_DIGITAL_GAMES (مثال: الرياضات الإلكترونية) TYPE_MUSIC (مثال: حفل موسيقي) ‫TYPE_TRAVEL_AND_LOCAL (مثال: جولة، مهرجان) ‫TYPE_HEALTH_AND_FITENESS (مثال: صف يوغا) TYPE_EDUCATION (مثال - صف) ‫TYPE_SPORTS (مثال: مباراة كرة قدم) ‫TYPE_DATING (مثال: لقاء) راجِع قسم فئة المحتوى للحصول على إرشادات.
DisplayTimeWindow (اختياري): ضبط فترة زمنية لعرض المحتوى على المساحة
الطابع الزمني للبدء	اختياري	الطابع الزمني الخاص بالحقبة الذي يجب أن يظهر بعده المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني لوقت بدء العصر الذي يتوقف بعده عرض المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية

`LodgingEntity`

السمة	المتطلب	الوصف	التنسيق
Action Uri	مطلوبة	رابط لصفحة معيّنة في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد مصدر الإحالة. يُرجى الرجوع إلى الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	تمثّل هذه السمة عنوان الكيان.	سلسلة حجم النص المقترَح: 50 حرفًا كحد أقصى
صور الملصقات	مطلوبة	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: في حال توفير شارة، احرص على توفير مساحة آمنة تبلغ 24 وحدة بكسل مستقلة الكثافة في أعلى الصورة وأسفلها.	راجِع مواصفات الصور للحصول على إرشادات.
الموقع الجغرافي - البلد	مطلوبة	البلد الذي يتم فيه الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - المدينة	مطلوبة	تمثّل هذه السمة المدينة التي يقع فيها مكان الإقامة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عرض العنوان	مطلوبة	العنوان الذي سيظهر للمستخدم ننصحك بتضمين اسم المدينة وربما الولاية أو البلد في معظم حالات الاستخدام. لا تضمِّن سوى عنوان الشارع أو الحي إذا كان المستخدم بالقرب من الموقع الجغرافي أو إذا كان المستخدم على دراية بالموقع الجغرافي أو إذا كانت المدينة مضمّنة في عنوان المجموعة. في حال تضمين عنوان الشارع، يجب تقديم عنوان موجز باستخدام الاختصارات حيثما أمكن ذلك (على سبيل المثال، "شارع" بدلاً من "شارع"، و"جادة" بدلاً من "جادة").	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عنوان الشارع	اختياري	تمثّل هذه السمة عنوان الشارع (إذا كان ذلك منطبقًا) للمكان المخصّص للاستئجار.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الولاية	اختياري	تمثّل هذه السمة الولاية أو المقاطعة (إنْ وجدت) التي يقع فيها مكان الإقامة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	تمثّل هذه السمة الرمز البريدي (إن أمكن) للمكان المخصّص للاستئجار.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الحي	اختياري	تمثّل هذه السمة الحي الذي يقع فيه مكان الإقامة (إذا كان ذلك منطبقًا).	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الشارات	اختياري	تكون كل شارة إما نصًا حرًا (15 حرفًا كحد أقصى) أو صورة صغيرة.
شارة - نص	اختياري	عنوان الشارة ملاحظة: يجب إدخال نص أو صورة للشارة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 15 حرفًا كحدّ أقصى
شارة - صورة	اختياري	صورة صغيرة معاملة خاصة لتجربة المستخدم، مثلاً كشارة متراكبة على الصورة المصغّرة للفيديو أو الصورة ملاحظة: يجب إدخال نص أو صورة للشارة.	راجِع مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة نصية واحدة لوصف العنصر ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة والشرح	اختياري	ما يصل إلى 3 عناوين فرعية، كل عنوان فرعي عبارة عن سطر واحد من النص ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحد أقصى
AvailabilityTimeWindow - Localized Start Time - Timestamp	اختياري	تمثّل هذه السمة الطابع الزمني لنظام يونكس عند توقّع فتح/إتاحة مكان الإقامة.	Joda-Time Instant
‫AvailabilityTimeWindow - وقت البدء المترجَم - المنطقة الزمنية	اختياري	تمثّل هذه السمة المنطقة الزمنية التي من المتوقّع أن يكون المكان المخصّص للاستئجار مفتوحًا أو متاحًا فيها.	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
AvailabilityTimeWindow - Localized End Time - Timestamp	اختياري	الطابع الزمني لنظام يونكس الذي يُتوقّع أن يبقى المكان المخصّص للاستئجار مفتوحًا/متاحًا حتى حلوله.	Joda-Time Instant
‫AvailabilityTimeWindow - Localized End Time - Timezone	اختياري	تمثّل هذه السمة المنطقة الزمنية التي من المتوقّع أن يكون المكان المخصّص للاستئجار مفتوحًا أو متاحًا فيها.	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
التقييم - الحد الأقصى للقيمة	اختياري	الحد الأقصى لمقياس التقييم. يجب توفيرها إذا تم توفير القيمة الحالية للتقييم أيضًا.	عدد >= 0.0
التقييم - القيمة الحالية	اختياري	القيمة الحالية لمقياس التقييم يجب توفيرها إذا تم توفير الحد الأقصى للتصنيف أيضًا.	عدد >= 0.0
التقييم - العدد	اختياري	تمثّل هذه السمة عدد التقييمات التي حصل عليها المكان المخصّص للاستئجار. ملاحظة: يجب توفير هذا الحقل إذا كان تطبيقك يريد التحكّم في طريقة عرض هذه المعلومات للمستخدمين. قدِّم السلسلة الموجزة التي يمكن عرضها للمستخدم. على سبيل المثال، إذا كان العدد 1,000,000، ننصحك باستخدام اختصارات مثل 1 مليون، كي لا يتم اقتطاعه على أحجام الشاشات الأصغر.	سلسلة
التقييم - قيمة العدد	اختياري	تمثّل هذه السمة عدد التقييمات التي حصل عليها المكان المخصّص للاستئجار. ملاحظة: يجب توفير هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا توفّرت كل من "العدد" و"قيمة العدد"، سنستخدم "العدد" لعرضه للمستخدمين.	طويل
السعر - CurrentPrice	مطلوب بشكل مشروط	تمثّل هذه السمة السعر الحالي للمكان المخصّص للاستئجار. يجب توفيرها في حال توفير السعر المشطوب.	حقل التعبئة النصّية الحرّة
السعر - StrikethroughPrice	اختياري	تمثّل هذه السمة السعر الأصلي لمكان الإقامة، وسيظهر مشطوبًا في واجهة المستخدم.	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	وسيلة شرح السعر لعرض عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
DisplayTimeWindow (اختياري): ضبط فترة زمنية لعرض المحتوى على المساحة
الطابع الزمني للبدء	اختياري	الطابع الزمني الخاص بالحقبة الذي يجب أن يظهر بعده المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني لوقت بدء العصر الذي يتوقف بعده عرض المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية

`StoreEntity`

يمثّل العنصر StoreEntity متجرًا فرديًا يريد شركاء المطوّرين نشره، مثل مكان لتناول الطعام أو مطعم شهير ذي صلة بتجربة السفر.

السمة	المتطلب	الوصف	التنسيق
صور الملصقات	مطلوبة	يجب تقديم صورة واحدة على الأقل.	راجِع مواصفات الصور للحصول على إرشادات.
Action Uri	مطلوبة	رابط لصفحة معيّنة في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد مصدر الإحالة. يُرجى الرجوع إلى الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	اختياري	تمثّل هذه السمة اسم المتجر.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
الموقع الجغرافي	اختياري	تمثّل هذه السمة الموقع الجغرافي للمتجر.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
وسيلة الشرح	اختياري	عبارة توضيحية لعرض عرض ترويجي أو حدث أو تحديث للمتجر، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
أحكام وسيلة الشرح	اختياري	نص الأحكام والشروط الدقيقة لوسيلة الشرح.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
الوصف	اختياري	تمثّل هذه السمة وصفًا للمتجر.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 90 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
الفئة	اختياري	فئة المتجر، وفي سياق أماكن تناول الطعام، يمكن أن تكون مطبخًا مثل "فرنسي" أو "أمريكي جديد" أو "رامن" أو "مأكولات راقية".	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
التقييم - الحد الأقصى للقيمة	اختياري	الحد الأقصى لمقياس التقييم. يجب توفيرها إذا تم توفير القيمة الحالية للتقييم أيضًا.	عدد >= 0.0
التقييم - القيمة الحالية	اختياري	القيمة الحالية لمقياس التقييم يجب توفيرها إذا تم توفير الحد الأقصى للتصنيف أيضًا.	عدد >= 0.0
التقييم - العدد	اختياري	تمثّل هذه السمة عدد التقييمات التي حصل عليها المكان المخصّص للاستئجار. ملاحظة: يجب توفير هذا الحقل إذا كان تطبيقك يريد التحكّم في طريقة عرض هذه المعلومات للمستخدمين. قدِّم السلسلة الموجزة التي يمكن عرضها للمستخدم. على سبيل المثال، إذا كان العدد 1,000,000، ننصحك باستخدام اختصارات مثل 1 مليون، كي لا يتم اقتطاعه على أحجام الشاشات الأصغر.	سلسلة
التقييم - قيمة العدد	اختياري	تمثّل هذه السمة عدد التقييمات التي حصل عليها المكان المخصّص للاستئجار. ملاحظة: يجب توفير هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا توفّرت كل من "العدد" و"قيمة العدد"، سنستخدم "العدد" لعرضه للمستخدمين.	طويل
DisplayTimeWindow (اختياري): ضبط فترة زمنية لعرض المحتوى على المساحة
الطابع الزمني للبدء	اختياري	الطابع الزمني الخاص بالحقبة الذي يجب أن يظهر بعده المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني لوقت بدء العصر الذي يتوقف بعده عرض المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية

`PointOfInterestEntity`

السمة	المتطلب	الوصف	التنسيق
Action Uri	مطلوبة	رابط لصفحة معيّنة في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد مصدر الإحالة. يُرجى الرجوع إلى الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	تمثّل هذه السمة عنوان الكيان.	سلسلة حجم النص المقترَح: 50 حرفًا كحد أقصى
صور الملصقات	مطلوب بشكل مشروط	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: يجب توفير صورة إذا كان العنصر جزءًا من مجموعة اقتراحات. في حال توفير شارة، تأكَّد من توفير مساحة آمنة تبلغ 24 وحدة بكسل مستقلة الكثافة (dps) في أعلى الصورة وأسفلها.	راجِع مواصفات الصور للحصول على إرشادات.
مدة التفاعل الأخيرة	مطلوب بشكل مشروط	الطابع الزمني للحقبة عند آخر تفاعل للمستخدم مع هذا العنصر. ملاحظة: هذا الحقل مطلوب إذا كان العنصر جزءًا من مجموعة نتائج البحث المتواصل.	Joda-Time Instant
الموقع الجغرافي - البلد	مطلوب بشكل مشروط	تمثّل هذه السمة البلد الذي تقع فيه نقطة الاهتمام. ملاحظة: هذا الحقل مطلوب إذا كان العنصر جزءًا من مجموعة اقتراحات.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - المدينة	مطلوب بشكل مشروط	المدينة التي تجري فيها نقطة الاهتمام ملاحظة: هذا الحقل مطلوب إذا كان العنصر جزءًا من مجموعة اقتراحات.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عرض العنوان	مطلوب بشكل مشروط	العنوان الذي سيظهر للمستخدم قدِّم عنوانًا موجزًا، واستخدِم الاختصارات حيثما أمكن (على سبيل المثال، "ش" بدلاً من "شارع"، و"ج" بدلاً من "جادة"). قد يتم اقتطاع هذه السلسلة حسب جهاز المستخدم وإعداداته. يجب تضمين اسم المدينة لتحديد الموقع الجغرافي بوضوح. ملاحظة: هذا الحقل مطلوب إذا كان العنصر جزءًا من مجموعة اقتراحات.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 35 حرفًا كحدّ أقصى
الموقع الجغرافي - عنوان الشارع	اختياري	تمثّل هذه السمة عنوان الشارع (إذا كان ذلك منطبقًا) لنقطة الاهتمام.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الولاية	اختياري	تمثّل هذه السمة الولاية أو المقاطعة (إنْ وجدت) التي يقع فيها المكان المثير للاهتمام.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	تمثّل هذه السمة الرمز البريدي لنقطة الاهتمام (إذا كان ذلك منطبقًا).	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الحي	اختياري	تمثّل هذه السمة الحي (إذا كان ذلك منطبقًا) الذي تقع فيه نقطة الاهتمام.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
AvailabilityTimeWindow - Localized Start Time - Timestamp	اختياري	الطابع الزمني لوقت بدء توفّر نقطة الاهتمام	Joda-Time Instant
‫AvailabilityTimeWindow - وقت البدء المترجَم - المنطقة الزمنية	اختياري	تمثّل هذه السمة المنطقة الزمنية التي من المتوقّع أن يكون فيها المكان مفتوحًا أو متاحًا.	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
AvailabilityTimeWindow - Localized End Time - Timestamp	اختياري	تمثّل هذه السمة الطابع الزمني لنظام يونكس الذي يُتوقّع أن يكون فيه المكان مفتوحًا أو متاحًا.	Joda-Time Instant
‫AvailabilityTimeWindow - Localized End Time - Timezone	اختياري	تمثّل هذه السمة المنطقة الزمنية التي من المتوقّع أن يكون فيها المكان مفتوحًا أو متاحًا.	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
الشارات	اختياري	تكون كل شارة إما نصًا حرًا (15 حرفًا كحد أقصى) أو صورة صغيرة.
شارة - نص	اختياري	عنوان الشارة ملاحظة: يجب إدخال نص أو صورة للشارة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 15 حرفًا كحدّ أقصى
شارة - صورة	اختياري	صورة صغيرة معاملة خاصة لتجربة المستخدم، مثلاً كشارة متراكبة على الصورة المصغّرة للفيديو أو الصورة ملاحظة: يجب إدخال نص أو صورة للشارة.	راجِع مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة نصية واحدة لوصف العنصر ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة والشرح	اختياري	ما يصل إلى 3 عناوين فرعية، كل عنوان فرعي عبارة عن سطر واحد من النص ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحد أقصى
التقييم - الحد الأقصى للقيمة	اختياري	الحد الأقصى لمقياس التقييم. يجب توفيرها إذا تم توفير القيمة الحالية للتقييم أيضًا.	عدد >= 0.0
التقييم - القيمة الحالية	اختياري	القيمة الحالية لمقياس التقييم يجب توفيرها إذا تم توفير الحد الأقصى للتصنيف أيضًا.	عدد >= 0.0
التقييم - العدد	اختياري	تمثّل هذه السمة عدد التقييمات الخاصة بنقطة الاهتمام. ملاحظة: يجب توفير هذا الحقل إذا كان تطبيقك يريد التحكّم في طريقة عرض هذه المعلومات للمستخدمين. قدِّم السلسلة الموجزة التي يمكن عرضها للمستخدم. على سبيل المثال، إذا كان العدد 1,000,000، ننصحك باستخدام اختصارات مثل 1 مليون، كي لا يتم اقتطاعه على أحجام الشاشات الأصغر.	سلسلة
التقييم - قيمة العدد	اختياري	تمثّل هذه السمة عدد التقييمات الخاصة بنقطة الاهتمام. ملاحظة: يجب توفير هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا توفّرت كل من "العدد" و"قيمة العدد"، سنستخدم "العدد" لعرضه للمستخدمين.	طويل
السعر - CurrentPrice	مطلوب بشكل مشروط	تمثّل هذه السمة السعر الحالي للتذاكر أو بطاقة الدخول إلى نقطة الاهتمام. يجب توفيرها إذا تم توفير السعر المشطوب.	حقل التعبئة النصّية الحرّة
السعر - StrikethroughPrice	اختياري	تمثّل هذه السمة السعر الأصلي للتذاكر أو بطاقة الدخول إلى نقطة الاهتمام.	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	وسيلة شرح السعر لعرض عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد يعرض النص الطويل جدًا علامات حذف)
فئات المحتوى	اختياري	تصف هذه السمة فئة المحتوى في العنصر.	قائمة التعدادات المؤهَّلة TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (مثال: مسرح) ‫TYPE_MEDICAL (مثال: مستشفى) TYPE_EDUCATION (مثال: مدرسة) TYPE_SPORTS (مثال: ملعب) راجِع قسم فئة المحتوى للحصول على إرشادات.
DisplayTimeWindow (اختياري): ضبط فترة زمنية لعرض المحتوى على المساحة
الطابع الزمني للبدء	اختياري	الطابع الزمني الخاص بالحقبة الذي يجب أن يظهر بعده المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني لوقت بدء العصر الذي يتوقف بعده عرض المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية

`RestaurantReservationEntity`

السمة	المتطلب	الوصف	التنسيق
Action Uri	مطلوبة	رابط لصفحة معيّنة في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد مصدر الإحالة. يُرجى الرجوع إلى الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	تمثّل هذه السمة عنوان الكيان.	سلسلة حجم النص المقترَح: 50 حرفًا كحد أقصى
الطابع الزمني لوقت بدء الحجز المعدَّل بما يناسب السوق المحلية	مطلوبة	الطابع الزمني لوقت بدء الحجز المتوقّع.	Joda-Time Instant
وقت بدء الحجز المعدَّل بما يناسب السوق المحلية - المنطقة الزمنية	مطلوبة	المنطقة الزمنية التي من المتوقّع أن يبدأ فيها الحجز	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
الموقع الجغرافي - البلد	مطلوبة	البلد الذي يقع فيه المطعم	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - المدينة	مطلوبة	المدينة التي سيُقام فيها المطعم.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عرض العنوان	مطلوبة	تمثّل هذه السمة عنوان المطعم الذي سيتم عرضه للمستخدم.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عنوان الشارع	اختياري	تمثّل هذه السمة عنوان الشارع (إذا كان ذلك منطبقًا) للمطعم.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الولاية	اختياري	تمثّل هذه السمة الولاية أو المقاطعة (إنْ وجدت) التي يقع فيها المطعم.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	تمثّل هذه السمة الرمز البريدي للمطعم (إن أمكن).	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الحي	اختياري	تمثّل هذه السمة الحي الذي يقع فيه المطعم (إذا كان ذلك منطبقًا).	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
صور الملصقات	اختياري	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9	راجِع مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة نصية واحدة لوصف العنصر ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة والشرح	اختياري	ما يصل إلى 3 عناوين فرعية، كل عنوان فرعي عبارة عن سطر واحد من النص ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحد أقصى
حجم الجدول	اختياري	عدد الأشخاص في مجموعة الحجز	عدد صحيح > 0
DisplayTimeWindow (اختياري): ضبط فترة زمنية لعرض المحتوى على المساحة
الطابع الزمني للبدء	اختياري	الطابع الزمني الخاص بالحقبة الذي يجب أن يظهر بعده المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني لوقت بدء العصر الذي يتوقف بعده عرض المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية

`EventReservationEntity`

السمة	المتطلب	الوصف	التنسيق
Action Uri	مطلوبة	رابط لصفحة معيّنة في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد مصدر الإحالة. يُرجى الرجوع إلى الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	تمثّل هذه السمة عنوان الكيان.	سلسلة حجم النص المقترَح: 50 حرفًا كحد أقصى
وقت البدء المعدَّل بما يناسب السوق المحلية - الطابع الزمني	مطلوبة	الطابع الزمني لوقت بدء الحدث المتوقّع.	Joda-Time Instant
وقت البدء المعدَّل بما يناسب السوق المحلية - المنطقة الزمنية	مطلوبة	تمثّل هذه السمة المنطقة الزمنية التي من المتوقّع أن يبدأ فيها الحدث.	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
وضع الحدث	مطلوبة	حقل لتحديد ما إذا كانت الفعالية ستكون افتراضية أو بالحضور الشخصي أو كليهما.	قيمة تعدادية: VIRTUAL أو IN_PERSON أو HYBRID
الموقع الجغرافي - البلد	مطلوب بشكل مشروط	البلد الذي سيُقام فيه الحدث ملاحظة: هذا الحقل مطلوب للأحداث التي تكون IN_PERSON أو HYBRID	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - المدينة	مطلوب بشكل مشروط	المدينة التي تقام فيها الفعالية ملاحظة: هذا الحقل مطلوب للأحداث التي تكون IN_PERSON أو HYBRID	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عرض العنوان	مطلوب بشكل مشروط	تمثّل هذه السمة عنوان المكان أو اسم الموقع الجغرافي الذي ستقام فيه الفعالية، ويجب عرضه للمستخدم. ملاحظة: هذا الحقل مطلوب للأحداث التي تكون IN_PERSON أو HYBRID	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عنوان الشارع	اختياري	تمثّل هذه السمة عنوان الشارع (إذا كان ذلك منطبقًا) للموقع الجغرافي الذي تتم فيه استضافة الفعالية.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الولاية	اختياري	تمثّل هذه السمة الولاية أو المقاطعة (إنْ وجدت) التي تستضيف الفعالية.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	تمثّل هذه السمة الرمز البريدي (إن أمكن) للموقع الجغرافي الذي تقام فيه الفعالية.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الحي	اختياري	تمثّل هذه السمة الحي (إن أمكن) الذي يتم فيه استضافة الفعالية.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
صور الملصقات	اختياري	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: يُنصح بشدة بإضافة صورة. في حال توفير شارة، تأكَّد من توفير مساحة آمنة تبلغ 24 وحدة بكسل مستقلة الكثافة (dp) في أعلى الصورة وأسفلها.	راجِع مواصفات الصور للحصول على إرشادات.
وقت الانتهاء المعدَّل بما يناسب السوق المحلية - الطابع الزمني	اختياري	الطابع الزمني لوقت بدء الحقبة الذي من المتوقّع أن ينتهي فيه الحدث	Joda-Time Instant
وقت الانتهاء المعدَّل بما يناسب السوق المحلية - المنطقة الزمنية	اختياري	المنطقة الزمنية التي من المتوقّع أن ينتهي فيها الحدث	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
مقدّم الخدمة - الاسم	اختياري	تمثّل هذه السمة اسم مقدّم الخدمة. ملاحظة:يجب توفير نص أو صورة لمقدّم الخدمة.	نص حر على سبيل المثال، اسم منظّم الحدث أو الجولة
مقدّم الخدمة - صورة	اختياري	تمثّل هذه السمة شعار أو صورة مقدّم الخدمة. ملاحظة:يجب توفير نص أو صورة لمقدّم الخدمة.	راجِع مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة نصية واحدة لوصف العنصر ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة والشرح	اختياري	ما يصل إلى 3 عناوين فرعية، كل عنوان فرعي عبارة عن سطر واحد من النص ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحد أقصى
الشارات	اختياري	تكون كل شارة إما نصًا حرًا (15 حرفًا كحد أقصى) أو صورة صغيرة.
شارة - نص	اختياري	عنوان الشارة ملاحظة: يجب إدخال نص أو صورة للشارة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 15 حرفًا كحدّ أقصى
شارة - صورة	اختياري	صورة صغيرة معاملة خاصة لتجربة المستخدم، مثلاً كشارة متراكبة على الصورة المصغّرة للفيديو أو الصورة ملاحظة: يجب إدخال نص أو صورة للشارة.	راجِع مواصفات الصور للحصول على إرشادات.
رقم تعريف الحجز	اختياري	تمثّل هذه السمة رقم تعريف الحجز الخاص بحجز الحدث.	حقل التعبئة النصّية الحرّة
السعر - CurrentPrice	مطلوب بشكل مشروط	تمثّل هذه السمة السعر الحالي للتذكرة أو بطاقة الدخول إلى الحدث. يجب توفيرها إذا تم توفير السعر المشطوب.	حقل التعبئة النصّية الحرّة
السعر - StrikethroughPrice	اختياري	يشير هذا الحقل إلى السعر الأصلي للتذكرة أو البطاقة الخاصة بالفعالية.	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	وسيلة شرح السعر لعرض عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
التقييم - الحد الأقصى للقيمة	اختياري	الحد الأقصى لمقياس التقييم. يجب توفيرها إذا تم توفير القيمة الحالية للتقييم أيضًا.	عدد >= 0.0
التقييم - القيمة الحالية	اختياري	القيمة الحالية لمقياس التقييم يجب توفيرها إذا تم توفير الحد الأقصى للتصنيف أيضًا.	عدد >= 0.0
التقييم - العدد	اختياري	تمثّل هذه السمة عدد التقييمات الخاصة بالحدث. ملاحظة: يجب توفير هذا الحقل إذا كان تطبيقك يريد التحكّم في طريقة عرض هذه المعلومات للمستخدمين. قدِّم السلسلة الموجزة التي يمكن عرضها للمستخدم. على سبيل المثال، إذا كان العدد 1,000,000، ننصحك باستخدام اختصارات مثل 1 مليون، كي لا يتم اقتطاعه على أحجام الشاشات الأصغر.	سلسلة
التقييم - قيمة العدد	اختياري	تمثّل هذه السمة عدد التقييمات الخاصة بالحدث. ملاحظة: يجب توفير هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا توفّرت كل من "العدد" و"قيمة العدد"، سنستخدم "العدد" لعرضه للمستخدمين.	طويل
فئات المحتوى	اختياري	تصف هذه السمة فئة المحتوى في العنصر.	قائمة التعدادات المؤهَّلة ‫TYPE_MOVIES_AND_TV_SHOWS (مثال - سينما) ‫TYPE_DIGITAL_GAMES (مثال: الرياضات الإلكترونية) TYPE_MUSIC (مثال: حفل موسيقي) ‫TYPE_TRAVEL_AND_LOCAL (مثال: جولة، مهرجان) ‫TYPE_HEALTH_AND_FITENESS (مثال: صف يوغا) TYPE_EDUCATION (مثال - صف) ‫TYPE_SPORTS (مثال: مباراة كرة قدم) ‫TYPE_DATING (مثال: لقاء) راجِع قسم فئة المحتوى للحصول على إرشادات.
DisplayTimeWindow (اختياري): ضبط فترة زمنية لعرض المحتوى على المساحة
الطابع الزمني للبدء	اختياري	الطابع الزمني الخاص بالحقبة الذي يجب أن يظهر بعده المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني لوقت بدء العصر الذي يتوقف بعده عرض المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية

`LodgingReservationEntity`

السمة	المتطلب	الوصف	التنسيق
Action Uri	مطلوبة	رابط لصفحة معيّنة في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد مصدر الإحالة. يُرجى الرجوع إلى الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	تمثّل هذه السمة عنوان الكيان.	نص حر على سبيل المثال، "إقامتك من 12 كانون الأول (ديسمبر)" حجم النص المقترَح: 50 حرفًا كحد أقصى
الطابع الزمني لوقت الوصول المعدَّل بما يناسب السوق المحلية	مطلوبة	الطابع الزمني لنظام يونكس الذي يمثّل وقت تسجيل الوصول للحجز.	Joda-Time Instant
وقت الوصول المعدَّل بما يناسب السوق المحلية - المنطقة الزمنية	مطلوبة	المنطقة الزمنية التي يتوفّر فيها وقت تسجيل الوصول للحجز	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
الطابع الزمني لوقت المغادرة المعدَّل بما يناسب السوق المحلية	مطلوبة	الطابع الزمني الخاص بالحقبة الذي يمثّل وقت تسجيل المغادرة للحجز.	Joda-Time Instant
وقت المغادرة المعدَّل بما يناسب السوق المحلية - المنطقة الزمنية	مطلوبة	تمثّل هذه السمة المنطقة الزمنية التي يقع فيها وقت تسجيل المغادرة للحجز.	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
الموقع الجغرافي - البلد	مطلوبة	البلد الذي يقع فيه مكان الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - المدينة	مطلوبة	المدينة التي يقع فيها مكان الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عرض العنوان	مطلوبة	العنوان الذي سيظهر للمستخدم قدِّم عنوانًا موجزًا، واستخدِم الاختصارات حيثما أمكن (على سبيل المثال، "ش" بدلاً من "شارع"، و"ج" بدلاً من "جادة"). قد يتم اقتطاع هذه السلسلة حسب جهاز المستخدم وإعداداته. أدرِج اسم المدينة لتحديدها بوضوح.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 35 حرفًا كحدّ أقصى
الموقع الجغرافي - عنوان الشارع	اختياري	تمثّل هذه السمة عنوان الشارع (إذا كان ذلك منطبقًا) للمكان المخصّص للاستئجار.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الولاية	اختياري	تمثّل هذه السمة الولاية أو المقاطعة (إنْ وجدت) التي يقع فيها مكان الإقامة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	تمثّل هذه السمة الرمز البريدي (إن أمكن) للمكان المخصّص للاستئجار.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الحي	اختياري	تمثّل هذه السمة الحي الذي يقع فيه مكان الإقامة (إذا كان ذلك منطبقًا).	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
صور الملصقات	اختياري	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: في حال توفير شارة، احرص على توفير مساحة آمنة تبلغ 24 وحدة بكسل مستقلة الكثافة في أعلى الصورة وأسفلها.	راجِع مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة نصية واحدة لوصف العنصر ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة والشرح	اختياري	ما يصل إلى 3 عناوين فرعية، كل عنوان فرعي عبارة عن سطر واحد من النص ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحد أقصى
رقم تعريف الحجز	اختياري	تمثّل هذه السمة رقم تعريف الحجز في مكان الإقامة.	حقل التعبئة النصّية الحرّة
التقييم - الحد الأقصى للقيمة	اختياري	الحد الأقصى لمقياس التقييم. يجب توفيرها إذا تم توفير القيمة الحالية للتقييم أيضًا.	عدد >= 0.0
التقييم - القيمة الحالية	اختياري	القيمة الحالية لمقياس التقييم يجب توفيرها إذا تم توفير الحد الأقصى للتصنيف أيضًا.	عدد >= 0.0
التقييم - العدد	اختياري	تمثّل هذه السمة عدد التقييمات التي حصل عليها المكان المخصّص للاستئجار. ملاحظة: يجب توفير هذا الحقل إذا كان تطبيقك يريد التحكّم في طريقة عرض هذه المعلومات للمستخدمين. قدِّم السلسلة الموجزة التي يمكن عرضها للمستخدم. على سبيل المثال، إذا كان العدد 1,000,000، ننصحك باستخدام اختصارات مثل 1 مليون، كي لا يتم اقتطاعه على أحجام الشاشات الأصغر.	سلسلة
التقييم - قيمة العدد	اختياري	تمثّل هذه السمة عدد التقييمات التي حصل عليها المكان المخصّص للاستئجار. ملاحظة: يجب توفير هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا توفّرت كل من "العدد" و"قيمة العدد"، سنستخدم "العدد" لعرضه للمستخدمين.	طويل
السعر - CurrentPrice	مطلوب بشكل مشروط	تمثّل هذه السمة السعر الحالي للمكان المخصّص للاستئجار. يجب توفيرها في حال توفير السعر المشطوب.	حقل التعبئة النصّية الحرّة
السعر - StrikethroughPrice	اختياري	تمثّل هذه السمة السعر الأصلي لمكان الإقامة، وسيظهر مشطوبًا في واجهة المستخدم.	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	وسيلة شرح السعر لعرض عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
DisplayTimeWindow (اختياري): ضبط فترة زمنية لعرض المحتوى على المساحة
الطابع الزمني للبدء	اختياري	الطابع الزمني الخاص بالحقبة الذي يجب أن يظهر بعده المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني لوقت بدء العصر الذي يتوقف بعده عرض المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية

`TransportationReservationEntity`

السمة	المتطلب	الوصف	التنسيق
Action Uri	مطلوبة	رابط لصفحة معيّنة في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد مصدر الإحالة. يُرجى الرجوع إلى الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	تمثّل هذه السمة عنوان الكيان.	نص حر على سبيل المثال، "من سان فرانسيسكو إلى سان دييغو" حجم النص المقترَح: 50 حرفًا كحد أقصى
نوع النقل	مطلوبة	تمثّل هذه السمة وسيلة النقل أو نوعها للحجز.	قيم التعداد: FLIGHT أو TRAIN أو BUS أو FERRY
الطابع الزمني لوقت المغادرة المعدَّل بما يناسب السوق المحلية	مطلوبة	الطابع الزمني لوقت المغادرة	Joda-Time Instant
وقت المغادرة المعدَّل بما يناسب السوق المحلية - المنطقة الزمنية	مطلوبة	المنطقة الزمنية لوقت المغادرة	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
الطابع الزمني لوقت الوصول المعدَّل بما يناسب السوق المحلية	مطلوبة	الطابع الزمني للحقبة الذي يمثّل وقت الوصول.	Joda-Time Instant
وقت الوصول المعدَّل بما يناسب السوق المحلية - المنطقة الزمنية	مطلوبة	تمثّل هذه السمة المنطقة الزمنية لوقت الوصول.	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
رقم النقل	مطلوبة	رقم الرحلة الجوية أو الحافلة أو القطار أو العبّارة/السفينة السياحية	حقل التعبئة النصّية الحرّة
موعد الصعود على متن الطائرة بالتوقيت المحلّي - الطابع الزمني	مطلوبة	الطابع الزمني لنظام التشغيل Unix الذي يمثّل وقت الصعود إلى الطائرة للحجز (إذا كان ذلك منطبقًا)	Joda-Time Instant
موعد الصعود على متن الطائرة بالتوقيت المحلّي - المنطقة الزمنية	مطلوبة	تمثّل هذه السمة المنطقة الزمنية لوقت الصعود إلى الطائرة للحجز (إن وُجد).	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
موقع المغادرة - البلد	اختياري	بلد المغادرة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع المغادرة - المدينة	اختياري	مدينة المغادرة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع المغادرة - عرض العنوان	اختياري	تمثّل هذه السمة موقع المغادرة الذي سيتم عرضه للمستخدم.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع المغادرة - عنوان الشارع	اختياري	تمثّل هذه السمة عنوان الشارع (إذا كان ذلك منطبقًا) لموقع المغادرة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع المغادرة - الولاية	اختياري	تمثّل هذه السمة الولاية أو المقاطعة (إنْ وجدت) لموقع المغادرة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع المغادرة - الرمز البريدي	اختياري	تمثّل هذه السمة الرمز البريدي (إن أمكن) لموقع المغادرة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع المغادرة - المنطقة المجاورة	اختياري	تمثّل هذه السمة الحي (إذا كان ذلك منطبقًا) الذي يقع فيه مكان المغادرة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع الوصول - البلد	اختياري	بلد الوصول	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع الوصول - المدينة	اختياري	مدينة الوصول	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع الوصول - عرض العنوان	اختياري	تمثّل هذه السمة موقع الوصول الذي سيتم عرضه للمستخدم.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع الوصول - عنوان الشارع	اختياري	تمثّل هذه السمة عنوان الشارع (إذا كان ذلك منطبقًا) لموقع الوصول.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع الوصول - الولاية	اختياري	تمثّل هذه السمة الولاية أو المقاطعة (إنْ وجدت) لموقع الوصول.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع الوصول - الرمز البريدي	اختياري	تمثّل هذه السمة الرمز البريدي (إن كان ذلك منطبقًا) لموقع الوصول.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
موقع الوصول - الحي	اختياري	تمثّل هذه السمة الحي (إذا كان ذلك منطبقًا) الذي يقع فيه موقع الوصول.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
مقدّم الخدمة - الاسم	اختياري	تمثّل هذه السمة اسم مقدّم الخدمة. ملاحظة:يجب توفير نص أو صورة لمقدّم الخدمة.	نص حر على سبيل المثال، اسم شركة الطيران
مقدّم الخدمة - صورة	اختياري	تمثّل هذه السمة شعار أو صورة مقدّم الخدمة. ملاحظة:يجب توفير نص أو صورة لمقدّم الخدمة.	راجِع مواصفات الصور للحصول على إرشادات.
صور الملصقات	اختياري	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9	راجِع مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة نصية واحدة لوصف العنصر ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة والشرح	اختياري	ما يصل إلى 3 عناوين فرعية، كل عنوان فرعي عبارة عن سطر واحد من النص ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحد أقصى
رقم تعريف الحجز	اختياري	معرّف الحجز الخاص بحجز وسائل النقل	حقل التعبئة النصّية الحرّة
السعر - CurrentPrice	مطلوب بشكل مشروط	تمثّل هذه السمة السعر الحالي للحجز. يجب توفيرها في حال توفير السعر المشطوب.	حقل التعبئة النصّية الحرّة
السعر - StrikethroughPrice	اختياري	تمثّل هذه السمة السعر الأصلي للحجز، وسيظهر مشطوبًا في واجهة المستخدم.	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	وسيلة شرح السعر لعرض عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
DisplayTimeWindow (اختياري): ضبط فترة زمنية لعرض المحتوى على المساحة
الطابع الزمني للبدء	اختياري	الطابع الزمني الخاص بالحقبة الذي يجب أن يظهر بعده المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني لوقت بدء العصر الذي يتوقف بعده عرض المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية

`VehicleRentalReservationEntity`

السمة	المتطلب	الوصف	التنسيق
Action Uri	مطلوبة	رابط لصفحة معيّنة في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد مصدر الإحالة. يُرجى الرجوع إلى الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	تمثّل هذه السمة عنوان الكيان.	نص حر على سبيل المثال، "Avis Union Square SF" حجم النص المقترَح: 50 حرفًا كحد أقصى
وقت الاستلام المعدَّل بما يناسب السوق المحلية - الطابع الزمني	مطلوبة	الطابع الزمني لنظام التشغيل Unix الذي يمثّل وقت استلام الحجز.	Joda-Time Instant
وقت الاستلام المعدَّل بما يناسب السوق المحلية - المنطقة الزمنية	مطلوبة	المنطقة الزمنية لوقت استلام الحجز	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
وقت الإرجاع المعدَّل بما يناسب السوق المحلية - الطابع الزمني	اختياري	الطابع الزمني للحقبة الذي يمثّل وقت تسجيل المغادرة للحجز.	Joda-Time Instant
وقت الإرجاع المعدَّل بما يناسب السوق المحلية - المنطقة الزمنية	اختياري	المنطقة الزمنية لوقت تسجيل المغادرة للحجز	Joda-Time DateTimeZone راجِع مواصفات المنطقة الزمنية للحصول على إرشادات.
عنوان استلام الطلبات - البلد	اختياري	تمثّل هذه السمة بلد موقع استلام الطلب.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان استلام الطلبات - المدينة	اختياري	تمثّل هذه السمة المدينة التي يقع فيها موقع استلام الطلب.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان استلام الطلبات - عرض العنوان	اختياري	تمثّل هذه السمة موقع الاستلام الذي سيتم عرضه للمستخدم.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان الاستلام - عنوان الشارع	اختياري	تمثّل هذه السمة عنوان الشارع (إذا كان ذلك منطبقًا) لموقع الاستلام.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان استلام الطلبات - الولاية	اختياري	تمثّل هذه السمة الولاية أو المقاطعة (إنْ وُجدت) التي يقع فيها مكان الاستلام.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان الاستلام - الرمز البريدي	اختياري	تمثّل هذه السمة الرمز البريدي (إن أمكن) لموقع الاستلام.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان استلام الطلبات - الحي	اختياري	تمثّل هذه السمة الحي (إذا كان ذلك منطبقًا) الذي يقع فيه مكان الاستلام.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان الإرجاع - البلد	اختياري	تمثّل هذه السمة بلد موقع الإرجاع.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان الإرجاع - المدينة	اختياري	تمثّل هذه السمة المدينة التي يقع فيها موقع إرجاع السلع.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان الإرجاع - عنوان العرض	اختياري	تمثّل هذه السمة موقع الإرجاع الذي سيظهر للمستخدم.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان الإرجاع - عنوان الشارع	اختياري	تمثّل هذه السمة عنوان الشارع (إذا كان ذلك منطبقًا) لموقع الإرجاع.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان الإرجاع - الولاية	اختياري	تمثّل هذه السمة الولاية أو المقاطعة (إنْ وجدت) لموقع الإرجاع.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان الإرجاع - الرمز البريدي	اختياري	تمثّل هذه السمة الرمز البريدي (إن أمكن) لموقع الإرجاع.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
عنوان الإرجاع - الحي	اختياري	تمثّل هذه السمة الحي (إذا كان ذلك منطبقًا) الذي يقع فيه مكان الإرجاع.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
مقدّم الخدمة - الاسم	اختياري	تمثّل هذه السمة اسم مقدّم الخدمة. ملاحظة:يجب توفير نص أو صورة لمقدّم الخدمة.	نص حر على سبيل المثال، "تأجير السيارات من Avis"
مقدّم الخدمة - صورة	اختياري	تمثّل هذه السمة شعار أو صورة مقدّم الخدمة. ملاحظة:يجب توفير نص أو صورة لمقدّم الخدمة.	راجِع مواصفات الصور للحصول على إرشادات.
صور الملصقات	اختياري	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9	راجِع مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة نصية واحدة لوصف العنصر ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة والشرح	اختياري	ما يصل إلى 3 عناوين فرعية، كل عنوان فرعي عبارة عن سطر واحد من النص ملاحظة: سيظهر للمستخدم إما الوصف أو قائمة العناوين الفرعية، وليس كلاهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحد أقصى
رقم تعريف التأكيد	اختياري	معرّف تأكيد حجز المركبة المستأجرة	حقل التعبئة النصّية الحرّة
السعر - CurrentPrice	مطلوب بشكل مشروط	تمثّل هذه السمة السعر الحالي للحجز. يجب توفيرها في حال توفير السعر المشطوب.	حقل التعبئة النصّية الحرّة
السعر - StrikethroughPrice	اختياري	تمثّل هذه السمة السعر الأصلي للحجز، وسيظهر مشطوبًا في واجهة المستخدم.	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	وسيلة شرح السعر لعرض عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)
DisplayTimeWindow (اختياري): ضبط فترة زمنية لعرض المحتوى على المساحة
الطابع الزمني للبدء	اختياري	الطابع الزمني الخاص بالحقبة الذي يجب أن يظهر بعده المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني لوقت بدء العصر الذي يتوقف بعده عرض المحتوى على مساحة العرض. في حال عدم ضبط هذه السياسة، يكون المحتوى مؤهَّلاً للعرض على المساحة.	الطابع الزمني للحقبة بالملي ثانية

مواصفات الصور

يتم إدراج المواصفات المطلوبة لمواد عرض الصور في هذا الجدول:

نسبة العرض إلى الارتفاع	الحدّ الأدنى لعدد وحدات البكسل	وحدات البكسل المقترَحة
مربّعة (1x1) الشبكة المفضّلة	300x300	1200x1200
أفقية (1.91x1)	600x314	1200x628
عمودية (4x5)	‫480x600	960x1200

نسبة العرض إلى الارتفاع

الحدّ الأدنى لعدد وحدات البكسل

وحدات البكسل المقترَحة

مربّعة (1x1)

الشبكة المفضّلة

300x300

1200x1200

أفقية (1.91x1)

600x314

1200x628

عمودية (4x5)

‫480x600

960x1200

يجب استضافة الصور على شبكات توصيل محتوى (CDN) عامة لكي يتمكّن محرّك بحث Google من الوصول إليها.

تنسيقات الملفات

‫PNG أو JPG أو GIF ثابت أو WebP

الحد الأقصى لحجم الملف

5120 كيلوبايت

اقتراحات إضافية

مساحة القسم المهم في الصور: ضَع المحتوى المهم في الوسط ليشغل ‎80% من الصورة.
استخدِم خلفية شفافة حتى يمكن عرض الصورة بشكل صحيح في إعدادات المظهرَين الداكن والفاتح.

مواصفات المنطقة الزمنية

يُفضّل استخدام المعرّف (مثل "America/Los_Angeles") على الإزاحة (مثل "-07:00").

مثال على الاستخدام: DateTimeZone.forID("America/Los_Angeles")

فئة المحتوى

تتيح فئة المحتوى للتطبيقات نشر محتوى ينتمي إلى فئات متعددة. يتم ربط المحتوى ببعض الفئات المحدّدة مسبقًا، وهي:

TYPE_EDUCATION
TYPE_SPORTS
TYPE_MOVIES_AND_TV_SHOWS
TYPE_BOOKS
TYPE_AUDIOBOOKS
TYPE_MUSIC
TYPE_DIGITAL_GAMES
TYPE_TRAVEL_AND_LOCAL
TYPE_HOME_AND_AUTO
TYPE_BUSINESS
TYPE_NEWS
TYPE_FOOD_AND_DRINK
TYPE_SHOPPING
TYPE_HEALTH_AND_FITENESS
TYPE_MEDICAL
TYPE_PARENTING
TYPE_DATING

يجب استضافة الصور على شبكات توصيل محتوى (CDN) عامة لكي يتمكّن محرّك بحث Google من الوصول إليها.

إرشادات استخدام فئات المحتوى

تكون بعض الكيانات، مثل ArticleEntity وGenericFeaturedEntity، مؤهَّلة لاستخدام أي من فئات المحتوى. بالنسبة إلى الكيانات الأخرى، مثل EventEntity وEventReservationEntity وPointOfInterestEntity، فإنّ مجموعة فرعية فقط من هذه الفئات تكون مؤهَّلة. راجِع قائمة الفئات المؤهَّلة لنوع كيان معيّن قبل ملء القائمة.
استخدِم نوع الكيان المحدّد لبعض فئات المحتوى بدلاً من استخدام مجموعة من الكيانات العامة وContentCategory:
- ‫TYPE_MOVIES_AND_TV_SHOWS: اطّلِع على الكيانات من دليل دمج "المشاهدة" قبل استخدام الكيانات العامة.
- ‫TYPE_BOOKS: اطّلِع على EbookEntity قبل استخدام الكيانات العامة.
- ‫TYPE_AUDIOBOOKS - اطّلِع على AudiobookEntity قبل استخدام الكيانات العامة.
- ‫TYPE_SHOPPING - اطّلِع على ShoppingEntity قبل استخدام الكيانات العامة.
- ‫TYPE_FOOD_AND_DRINK: اطّلِع على الكيانات من دليل دمج الطعام قبل استخدام الكيانات العامة.
حقل ContentCategory اختياري ويجب تركه فارغًا إذا كان المحتوى لا ينتمي إلى أي من الفئات المذكورة سابقًا.
في حال تقديم فئات محتوى متعددة، يجب تقديمها بترتيب مدى صلتها بالمحتوى، مع وضع فئة المحتوى الأكثر صلة في بداية القائمة.

الخطوة 2: تقديم بيانات المجموعة

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

تتولّى AppEngageTravelClient مسؤولية نشر المجموعات.

تتوفّر واجهات برمجة التطبيقات التالية لنشر المجموعات في العميل:

isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishReservationCluster
publishContinueSearchCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteReservationCluster
deleteContinueSearchCluster
deleteUserManagementCluster
deleteClusters

`isServiceAvailable`

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

Kotlin

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

Java

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

`publishRecommendationClusters`

تُستخدَم واجهة برمجة التطبيقات هذه لنشر قائمة بعناصر RecommendationCluster.

Kotlin

client.publishRecommendationClusters(
      PublishRecommendationClustersRequest.Builder()
        .addRecommendationCluster(
          RecommendationCluster.Builder()
            .addEntity(entity1)
            .addEntity(entity2)
            .setTitle("Top Picks For You")
            .build()
        )
        .build()
    )

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Top Picks For You")
                        .build())
                .build());

عندما تتلقّى الخدمة الطلب، يتم تنفيذ الإجراءات التالية ضمن معاملة واحدة:

تتم إزالة بيانات RecommendationCluster الحالية من حساب المطوّر الشريك.
يتم تحليل البيانات من الطلب وتخزينها في "مجموعة اقتراحات" المعدَّلة.

في حال حدوث خطأ، يتم رفض الطلب بأكمله ويتم الحفاظ على الحالة الحالية.

`publishFeaturedCluster`

تُستخدَم واجهة برمجة التطبيقات هذه لنشر قائمة بعناصر FeaturedCluster.

Kotlin

client.publishFeaturedCluster(
    PublishFeaturedClusterRequest.Builder()
      .setFeaturedCluster(
        FeaturedCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

عندما تتلقّى الخدمة الطلب، يتم تنفيذ الإجراءات التالية ضمن معاملة واحدة:

تتم إزالة بيانات FeaturedCluster الحالية من حساب المطوّر الشريك.
يتم تحليل البيانات من الطلب وتخزينها في "المجموعة المميّزة" المعدَّلة.

في حال حدوث خطأ، يتم رفض الطلب بأكمله ويتم الحفاظ على الحالة الحالية.

`publishReservationCluster`

يتم استخدام واجهة برمجة التطبيقات هذه لنشر عنصر ReservationCluster.

Kotlin

client.publishReservationCluster(
    PublishReservationClusterRequest.Builder()
      .setReservationCluster(
        ReservationCluster.Builder()
          .addLodgingReservationEntity(lodgingReservationEntity)
          .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
          .addTransportationReservationEntity(transportationReservationEntity)
          .addEventReservationEntity(eventReservationEntity)
          .addRestaurantReservationEntity(restaurantReservationEntity)
          .build())
      .build())

Java

client.publishReservationCluster(
            new PublishReservationClusterRequest.Builder()
                .setReservationCluster(
                    new ReservationCluster.Builder()
                        .addLodgingReservationEntity(lodgingReservationEntity)
                        .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
                        .addTransportationReservationEntity(transportationReservationEntity)
                        .addEventReservationEntity(eventReservationEntity)
                        .addRestaurantReservationEntity(restaurantReservationEntity)
                        .build())
                .build());

عندما تتلقّى الخدمة الطلب، يتم تنفيذ الإجراءات التالية ضمن معاملة واحدة:

تتم إزالة بيانات ReservationCluster الحالية من حساب المطوّر الشريك.
يتم تحليل البيانات من الطلب وتخزينها في Reservation Cluster المعدَّل.

في حال حدوث خطأ، يتم رفض الطلب بأكمله ويتم الحفاظ على الحالة الحالية.

`publishContinueSearchCluster`

تُستخدَم واجهة برمجة التطبيقات هذه لنشر قائمة بعناصر ContinueSearchCluster.

Kotlin

client.publishContinueSearchCluster(
    PublishContinueSearchClusterRequest.Builder()
      .setContinueSearchCluster(
        ContinueSearchCluster.Builder()
          .addPointOfInterestEntity(entity1)
          .addPointOfInterestEntity(entity2)
          .build())
      .build())

Java

client.publishContinueSearchCluster(
            new PublishContinueSearchClusterRequest.Builder()
                .setContinueSearchCluster(
                    new ContinueSearchCluster.Builder()
                        .addPointOfInterestEntity(entity1)
                        .addPointOfInterestEntity(entity2)
                        .build())
                .build());

عندما تتلقّى الخدمة الطلب، يتم تنفيذ الإجراءات التالية ضمن معاملة واحدة:

تتم إزالة بيانات ContinueSearchCluster الحالية من حساب المطوّر الشريك.
يتم تحليل البيانات من الطلب وتخزينها في "مجموعة مواصلة البحث" المعدَّلة.

في حال حدوث خطأ، يتم رفض الطلب بأكمله ويتم الحفاظ على الحالة الحالية.

`publishUserAccountManagementRequest`

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

تشكّل البيانات الوصفية التالية جزءًا من "بطاقة تسجيل الدخول":

السمة	المتطلب	الوصف
Action Uri	مطلوب	رابط لصفحة معيّنة في التطبيق (أي ينتقل إلى صفحة تسجيل الدخول إلى التطبيق)
صورة	اختياري - إذا لم يتم توفير هذا الحقل، يجب توفير حقل "العنوان"	الصورة المعروضة على البطاقة صور بنسبة عرض إلى ارتفاع 16:9 وبدرجة دقة 1264x712
العنوان	اختياري - إذا لم يتم توفيرها، يجب توفير الصورة	الاسم المكتوب على البطاقة
نص الإجراء	اختياري	النص المعروض على عبارة الحثّ على اتّخاذ إجراء (مثل تسجيل الدخول)
العنوان الفرعي	اختياري	عنوان فرعي اختياري على البطاقة

Kotlin

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Java

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

عندما تتلقّى الخدمة الطلب، يتم تنفيذ الإجراءات التالية ضمن معاملة واحدة:

تتم إزالة بيانات UserAccountManagementCluster الحالية من الشريك المطوِّر.
يتم تحليل البيانات من الطلب وتخزينها في مجموعة UserAccountManagementCluster المعدَّلة.

في حال حدوث خطأ، يتم رفض الطلب بأكمله ويتم الحفاظ على الحالة الحالية.

`updatePublishStatus`

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

من الضروري تقديم الحالة في جميع السيناريوهات، حتى عندما يكون المحتوى منشورًا (STATUS == PUBLISHED)، لملء لوحات البيانات التي تستخدم هذه الحالة الواضحة لنقل معلومات حول سلامة عملية الدمج ومقاييس أخرى.
إذا لم يتم نشر أي محتوى ولكن حالة الدمج لم تتوقف (STATUS == NOT_PUBLISHED)، يمكن أن تتجنّب Google إرسال تنبيهات في لوحات بيانات سلامة التطبيق. ويؤكّد هذا الرمز أنّ المحتوى لم يتم نشره بسبب حالة متوقّعة من وجهة نظر مقدّم الخدمة.
ويساعد المطوّرين في تقديم إحصاءات حول وقت نشر البيانات ووقت عدم نشرها.
قد تستخدم Google رموز الحالة لتشجيع المستخدم على اتّخاذ إجراءات معيّنة في التطبيق حتى يتمكّن من الاطّلاع على محتوى التطبيق أو التغلّب على المشكلة.

في ما يلي قائمة برموز حالة النشر المؤهَّلة :

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

إذا لم يتم نشر المحتوى لأنّ المستخدم لم يسجّل الدخول، تنصح Google بنشر "بطاقة تسجيل الدخول". إذا تعذّر على مقدّمي الخدمات نشر بطاقة تسجيل الدخول لأي سبب، ننصحهم باستدعاء واجهة برمجة التطبيقات updatePublishStatus باستخدام رمز الحالة NOT_PUBLISHED_REQUIRES_SIGN_IN.

Kotlin

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

Java

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

`deleteRecommendationClusters`

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

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

عندما تتلقّى الخدمة الطلب، تزيل البيانات الحالية من مجموعات الاقتراحات. في حال حدوث خطأ، يتم رفض الطلب بأكمله والاحتفاظ بالحالة الحالية.

`deleteFeaturedCluster`

يتم استخدام واجهة برمجة التطبيقات هذه لحذف محتوى "المجموعة المميّزة".

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

عندما تتلقّى الخدمة الطلب، تزيل البيانات الحالية من "المجموعة المميزة". في حال حدوث خطأ، يتم رفض الطلب بأكمله ويتم الحفاظ على الحالة الحالية.

`deleteReservationCluster`

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

Kotlin

client.deleteReservationCluster()

Java

client.deleteReservationCluster();

عندما تتلقّى الخدمة الطلب، تزيل البيانات الحالية من مجموعة الحجوزات (Reservation Cluster). في حال حدوث خطأ، يتم رفض الطلب بأكمله والاحتفاظ بالحالة الحالية.

`deleteUserManagementCluster`

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

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

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

`deleteContinueSearchCluster`

تُستخدَم واجهة برمجة التطبيقات هذه لحذف محتوى "مجموعة مواصلة البحث".

Kotlin

client.deleteContinueSearchCluster()

Java

client.deleteContinueSearchCluster();

عندما تتلقّى الخدمة الطلب، تزيل البيانات الحالية من مجموعة "متابعة البحث". في حال حدوث خطأ، يتم رفض الطلب بالكامل، ويتم الحفاظ على الحالة الحالية.

`deleteClusters`

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

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_RESERVATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_RESERVATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
                .build());

عندما تتلقّى الخدمة الطلب، تزيل البيانات الحالية من جميع المجموعات المتطابقة مع أنواع المجموعات المحدّدة. يمكن للعملاء اختيار تمرير نوع واحد أو عدة أنواع من المجموعات. في حال حدوث خطأ، يتم رفض الطلب بأكمله ويتم الحفاظ على الحالة الحالية.

معالجة الأخطاء

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

Kotlin

client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

Java

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

يتم عرض الخطأ كـ AppEngageException مع تضمين السبب كرمز خطأ.

رمز الخطأ	اسم الخطأ	ملاحظة
`1`	`SERVICE_NOT_FOUND`	الخدمة غير متاحة على الجهاز المحدّد.
`2`	`SERVICE_NOT_AVAILABLE`	الخدمة متاحة على الجهاز المحدّد، ولكنّها غير متاحة في وقت المكالمة (على سبيل المثال، تم إيقافها بشكل صريح).
`3`	`SERVICE_CALL_EXECUTION_FAILURE`	تعذّر تنفيذ المهمة بسبب مشاكل في سلاسل التعليمات. في هذه الحالة، يمكن إعادة المحاولة.
`4`	`SERVICE_CALL_PERMISSION_DENIED`	لا يُسمح للمتصل بإجراء مكالمة الخدمة.
`5`	`SERVICE_CALL_INVALID_ARGUMENT`	يحتوي الطلب على بيانات غير صالحة (على سبيل المثال، أكثر من عدد المجموعات المسموح به).
`6`	`SERVICE_CALL_INTERNAL`	حدث خطأ من جهة الخدمة.
`7`	`SERVICE_CALL_RESOURCE_EXHAUSTED`	يتم إجراء طلب الخدمة بشكل متكرّر جدًا.

الخطوة 3: معالجة أغراض البث

بالإضافة إلى إجراء طلبات البيانات من واجهة برمجة التطبيقات لنشر المحتوى من خلال مهمة، يجب أيضًا إعداد BroadcastReceiver لتلقّي طلب نشر المحتوى.

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

يجب إعداد BroadcastReceiver بإحدى الطريقتَين التاليتَين:

تسجيل مثيل لفئة BroadcastReceiver بشكل ديناميكي باستخدام Context.registerReceiver() يتيح ذلك التواصل من التطبيقات التي لا تزال نشطة في الذاكرة.

Kotlin

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
  // Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
  // broadcast is received
  // Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
  // received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Continue Search Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Reservation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)
}

Java

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
// broadcast is received

// Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Continue Search Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Reservation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

}

عليك تعريف عملية التنفيذ بشكل ثابت باستخدام العلامة <receiver> في ملف AndroidManifest.xml. يتيح ذلك للتطبيق تلقّي نوايا البث عندما لا يكون قيد التشغيل، كما يتيح له نشر المحتوى.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:permission="com.google.android.engage.REQUEST_ENGAGE_DATA"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_RESERVATION" />
      </intent-filter>
   </receiver>
</application>

يتم إرسال النوايا التالية من خلال الخدمة:

com.google.android.engage.action.PUBLISH_RECOMMENDATION يُنصح ببدء مكالمة publishRecommendationClusters عند تلقّي هذا الغرض.
com.google.android.engage.action.PUBLISH_FEATURED يُنصح ببدء مكالمة publishFeaturedCluster عند تلقّي هذا الغرض.
com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH يُنصح ببدء مكالمة publishContinueSearchCluster عند تلقّي هذه النية.
com.google.android.engage.action.travel.PUBLISH_RESERVATION يُنصح ببدء مكالمة publishReservationCluster عند تلقّي هذا الغرض.

سير عمل الدمج

للحصول على دليل تفصيلي حول كيفية إثبات صحة عملية الدمج بعد اكتمالها، يُرجى الاطّلاع على سير عمل دمج المطوّرين في Engage.

الأسئلة الشائعة

يمكنك الاطّلاع على الأسئلة الشائعة حول حزمة تطوير البرامج Engage SDK.

معلومات الاتصال

يُرجى التواصل مع engage-developers@google.com إذا كانت لديك أي أسئلة أثناء عملية الدمج.

الخطوات التالية

بعد إكمال عملية الربط هذه، إليك الخطوات التالية:

أرسِل رسالة إلكترونية إلى engage-developers@google.com وأرفِق بها حِزمة APK المدمَجة الجاهزة للاختبار من قِبل Google.
تُجري Google عملية تحقّق ومراجعات داخلية للتأكّد من أنّ عملية الدمج تعمل على النحو المتوقّع. إذا كانت هناك حاجة إلى إجراء تغييرات، ستتواصل معك Google لإعلامك بأي تفاصيل ضرورية.
عند اكتمال الاختبار وعدم الحاجة إلى إجراء أي تغييرات، ستتواصل معك Google لإعلامك بأنّه يمكنك بدء نشر حزمة APK المعدَّلة والمدمجة على "متجر Play".
بعد أن تؤكّد Google أنّه تم نشر حِزمة APK المعدَّلة على متجر Play، قد يتم نشر المجموعات اقتراحات ومميّزة وحجز ومتابعة البحث لتصبح مرئية للمستخدمين.

Engage SDK Travel: تعليمات الدمج الفني التابعة لجهات خارجية تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

تفاصيل عملية الدمج

المصطلحات

العمل التحضيري

ملخّص

الخطوة 1: تقديم بيانات الجهة

GenericFeaturedEntity

ArticleEntity

EventEntity

LodgingEntity

StoreEntity

PointOfInterestEntity

RestaurantReservationEntity

EventReservationEntity

LodgingReservationEntity

TransportationReservationEntity

VehicleRentalReservationEntity

مواصفات الصور

مواصفات المنطقة الزمنية

فئة المحتوى

الخطوة 2: تقديم بيانات المجموعة

isServiceAvailable

Kotlin

Java

publishRecommendationClusters

Kotlin

Java

publishFeaturedCluster

Kotlin

Java

publishReservationCluster

Kotlin

Java

publishContinueSearchCluster

Kotlin

Java

publishUserAccountManagementRequest

Kotlin

Java

updatePublishStatus

Kotlin

Java

deleteRecommendationClusters

Kotlin

Java

deleteFeaturedCluster

Kotlin

Java

deleteReservationCluster

Kotlin

Java

deleteUserManagementCluster

Kotlin

Java

deleteContinueSearchCluster

Kotlin

Java

deleteClusters

Kotlin

Java

معالجة الأخطاء

Kotlin

Java

الخطوة 3: معالجة أغراض البث

Kotlin

Java

سير عمل الدمج

الأسئلة الشائعة

معلومات الاتصال

الخطوات التالية

Engage SDK Travel: تعليمات الدمج الفني التابعة لجهات خارجية

`GenericFeaturedEntity`

`ArticleEntity`

`EventEntity`

`LodgingEntity`

`StoreEntity`

`PointOfInterestEntity`

`RestaurantReservationEntity`

`EventReservationEntity`

`LodgingReservationEntity`

`TransportationReservationEntity`

`VehicleRentalReservationEntity`

`isServiceAvailable`

`publishRecommendationClusters`

`publishFeaturedCluster`

`publishReservationCluster`

`publishContinueSearchCluster`

`publishUserAccountManagementRequest`

`updatePublishStatus`

`deleteRecommendationClusters`

`deleteFeaturedCluster`

`deleteReservationCluster`

`deleteUserManagementCluster`

`deleteContinueSearchCluster`

`deleteClusters`