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

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

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

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

الفئات ومساحات العرض المتوافقة

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

الحالة	فئة المحتوى أو حالة الاستخدام	مساحات العرض المتوافقة
متاحة (مؤهَّلة على جميع مساحات العرض)	جميع تطبيقات السفر والمعلومات المحلية (باستثناء الفئات الفرعية غير المتوافقة المُدرَجة في هذا الجدول) الفعاليات (جميع الفئات الفرعية) نشاط الحيوانات الأليفة ومراقبتها ومجالستها وتمشيتها	المجموعات علامة تبويب "التطبيقات" في "متجر Google Play" علامة التبويب "أنت" في "متجر Google Play" صفحة بطاقة بيانات المتجر على "متجر Google Play"
غير متاح	برامج تتبع رحلات الطيران

مهارات Android

العرض على GitHub

دمج حزمة Engage SDK

استخدِم مهارة Android في حزمة Engage SDK لدمج حزمة SDK وتصحيح الأخطاء وحلّ مشاكل التنفيذ.

لتثبيت المهارة من Android CLI، شغِّل:

android skills add engage-sdk-integration

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

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

المصطلحات

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

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

يمكن أن يتّخذ محتوى الحجز البنية التالية:
- ‫RestaurantReservationEntity: يمثّل RestaurantReservationEntity حجزًا في مطعم أو مقهى ويساعد المستخدمين في تتبُّع حجوزات المطاعم القادمة أو الحالية.
  
  الشكل 6. واجهة مستخدم تعرض RestaurantReservationEntity واحدًا ضمن مجموعة حجز
- ‫EventReservationEntity: يمثّل EventReservationEntity حجزًا لفعالية ويساعد المستخدمين في تتبُّع حجوزات الفعاليات القادمة أو الجارية. يمكن أن تشمل الأحداث، على سبيل المثال لا الحصر، ما يلي:
  - الفعاليات الرياضية، مثل حجز مباراة كرة قدم
  - فعاليات الألعاب، مثل حجز مكان في الرياضات الإلكترونية
  - الفعاليات الترفيهية، مثل حجز تذاكر لمشاهدة فيلم في السينما أو حضور حفلة موسيقية أو عرض مسرحي أو حفل توقيع كتاب
  - حجوزات السفر أو الأماكن المهمة، مثل الجولات الإرشادية وتذاكر المتاحف
  - حجوزات الفعاليات الاجتماعية والندوات والمؤتمرات
  - حجوزات جلسات التعليم / التدريب
  الشكل 7: واجهة مستخدم تعرض EventReservationEntity واحدًا ضمن مجموعة حجز.
- ‫LodgingReservationEntity: يمثّل LodgingEntityReservation حجزًا لمكان إقامة سياحي ويساعد المستخدمين في تتبُّع الحجوزات القادمة أو الحالية في الفنادق أو أماكن الاستئجار.
  
  الشكل 8 واجهة مستخدم تعرض LodgingReservationEntity واحدًا ضمن مجموعة حجز
- ‫TransportationReservationEntity: يمثّل هذا الكيان حجزًا لوسيلة نقل من أي نوع، ويساعد المستخدمين في تتبُّع الحجوزات لرحلات قادمة أو جارية على متن طائرة أو عبّارة أو قطار أو حافلة أو سفينة سياحية أو لخدمات طلب سيارة أجرة على الإنترنت.
  
  الشكل 9: واجهة مستخدم تعرض TransportationReservationEntity واحدًا ضمن مجموعة حجز.
- VehicleRentalReservationEntity: يمثّل VehicleRentalReservationEntity حجز تأجير المركبات ويساعد المستخدمين في تتبُّع حجوزات تأجير المركبات القادمة أو الجارية.
  
  الشكل 10: واجهة مستخدم تعرض VehicleRentalReservationEntity واحدة ضمن مجموعة حجز.
تعرض مجموعة المحتوى المميّز مجموعة مختارة من العناصر من عدة شركاء مطوّرين في مجموعة واحدة في واجهة المستخدم. ستكون هناك مجموعة واحدة مميّزة تظهر بالقرب من أعلى واجهة المستخدم مع موضع ذي أولوية فوق جميع مجموعات الاقتراحات. سيُسمح لكل شريك مطوّر ببث ما يصل إلى 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.6.0'
}

ملخّص

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

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

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

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

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

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

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

`GenericFeaturedEntity`

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

`ArticleEntity`

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

`EventEntity`

السمة	المتطلبات	الوصف	التنسيق
معرّف الموارد المنتظم (URI) للإجراء	مطلوبة	رابط عميق للكيان في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط العميقة لتحديد المصدر. يُرجى الرجوع إلى هذه الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	عنوان الكيان	سلسلة حجم النص المقترَح: 50 حرفًا كحدّ أقصى
وقت البدء المترجَم - الطابع الزمني	مطلوبة	الطابع الزمني للحقبة الذي من المتوقّع أن يبدأ فيه الحدث	Joda-Time Instant
وقت البدء المترجَم - المنطقة الزمنية	مطلوبة	المنطقة الزمنية التي من المتوقّع أن يبدأ فيها الحدث	Joda-Time DateTimeZone يُرجى الاطّلاع على مواصفات المنطقة الزمنية للحصول على إرشادات.
وضع الحدث	مطلوبة	حقل لتوضيح ما إذا كانت الفعالية افتراضية أو بالحضور الشخصي أو كليهما	قيم التعداد: VIRTUAL أو IN_PERSON أو HYBRID
صور الملصقات	مطلوبة	سنعرض صورة واحدة فقط في حال تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: ننصح بشدة بإضافة صورة. إذا تم تقديم شارة، تأكَّد من توفير مساحة آمنة تبلغ 24 وحدة بكسل مستقلة الكثافة في كل من أعلى الصورة وأسفلها	يُرجى الاطّلاع على مواصفات الصور للحصول على إرشادات.
الموقع الجغرافي - البلد	مطلوب بشروط	البلد الذي تتم فيه الفعالية ملاحظة: هذا الحقل مطلوب للفعاليات التي تكون IN_PERSON أو HYBRID	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - المدينة	مطلوب بشروط	المدينة التي ستقام فيها الفعالية ملاحظة: هذا الحقل مطلوب للفعاليات التي تكون IN_PERSON أو HYBRID	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - العنوان المعروض	مطلوب بشروط	تمثّل هذه السمة العنوان أو اسم المكان الذي ستقام فيه الفعالية والذي يجب عرضه للمستخدم. ملاحظة: هذا الحقل مطلوب للفعاليات التي تكون IN_PERSON أو HYBRID	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عنوان الشارع	اختياري	تمثّل هذه السمة عنوان الشارع (إذا كان ذلك منطبقًا) للمكان الذي تتم فيه استضافة الفعالية.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الولاية	اختياري	الولاية أو المقاطعة (إذا كان ذلك منطبقًا) التي تتم استضافة الفعالية فيها	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	تمثّل هذه السمة الرمز البريدي (إذا كان منطبقًا) للموقع الجغرافي الذي تتم فيه استضافة الفعالية.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الحي	اختياري	تمثّل هذه السمة الحيّ (إن أمكن) الذي تتم فيه استضافة الفعالية.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
وقت الانتهاء	اختياري	الطابع الزمني للحقبة عند توقُّع انتهاء الحدث ملاحظة: سيتم تمثيل ذلك بالملي ثانية.	الطابع الزمني للحقبة بالملي ثانية
الوصف	اختياري	فقرة نصية واحدة لوصف الكيان ملاحظة: سيتم عرض الوصف أو قائمة العناوين الفرعية للمستخدم، وليس كليهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمات	اختياري	ما يصل إلى 3 عناوين فرعية، يتألف كل منها من سطر واحد من النص ملاحظة: سيتم عرض الوصف أو قائمة العناوين الفرعية للمستخدم، وليس كليهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل ترجمة: 50 حرفًا كحدّ أقصى
الشارات	اختياري	تكون كل شارة إما نصًا حرًا (بحد أقصى 15 حرفًا) أو صورة صغيرة.
شارة - نص	اختياري	عنوان الشارة ملاحظة: يجب إدخال نص أو صورة للشارة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 15 حرفًا كحدّ أقصى
شارة - صورة	اختياري	صورة صغيرة معالجة خاصة لتجربة المستخدم، على سبيل المثال، كشارة تظهر على الصورة المصغّرة للصورة أو الفيديو ملاحظة: يجب إدخال نص أو صورة للشارة	يُرجى الاطّلاع على مواصفات الصور للحصول على إرشادات.
Price - CurrentPrice	مطلوب بشروط	السعر الحالي للتذكرة/البطاقة الخاصة بالفعالية يجب تقديم هذه السمة في حال تقديم السعر الأصلي المشطوب.	حقل التعبئة النصّية الحرّة
Price - 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 (مثال: meetup) يُرجى الاطّلاع على قسم "فئة المحتوى" للحصول على إرشادات.
‫DisplayTimeWindow (اختيارية): لضبط نافذة زمنية لعرض المحتوى على مساحة العرض
الطابع الزمني للبدء	اختياري	الطابع الزمني الذي يمثّل الوقت الذي يجب بعده عرض المحتوى على مساحة العرض. وفي حال عدم ضبطها، يكون المحتوى مؤهلاً للظهور على مساحة العرض.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني الذي يشير إلى الوقت الذي لن يظهر فيه المحتوى على مساحة العرض. وفي حال عدم ضبطها، يكون المحتوى مؤهلاً للظهور على مساحة العرض.	الطابع الزمني للحقبة بالملي ثانية

`LodgingEntity`

السمة	المتطلبات	الوصف	التنسيق
معرّف الموارد المنتظم (URI) للإجراء	مطلوبة	رابط عميق للكيان في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط العميقة لتحديد المصدر. يُرجى الرجوع إلى هذه الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	عنوان الكيان	سلسلة حجم النص المقترَح: 50 حرفًا كحدّ أقصى
صور الملصقات	مطلوبة	سنعرض صورة واحدة فقط في حال تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: في حال توفير شارة، تأكَّد من توفير مساحة آمنة تبلغ 24 بكسل مستقل الكثافة في كلّ من أعلى الصورة وأسفلها.	يُرجى الاطّلاع على مواصفات الصور للحصول على إرشادات.
الموقع الجغرافي - البلد	مطلوبة	البلد الذي يقع فيه مكان الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - المدينة	مطلوبة	المدينة التي يقع فيها مكان الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - العنوان المعروض	مطلوبة	العنوان الذي سيتم عرضه للمستخدم ننصح بتضمين اسم المدينة، وربما الولاية أو البلد، في معظم حالات الاستخدام. لا تدرِج عنوان الشارع أو الحي إلا إذا كان المستخدم قريبًا من الموقع الجغرافي أو على دراية به أو إذا كانت المدينة مدرَجة في عنوان المجموعة. إذا أدرجت عنوان الشارع، قدِّم عنوانًا موجزًا باستخدام الاختصارات حيثما أمكن (على سبيل المثال، "St" بدلاً من "Street" و"Ave" بدلاً من "Avenue").	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - عنوان الشارع	اختياري	عنوان الشارع (إذا كان ذلك منطبقًا) لمكان الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الولاية	اختياري	الولاية أو المقاطعة (إذا كان ذلك منطبقًا) التي يقع فيها مكان الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	الرمز البريدي (إن وُجد) لمكان الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الحي	اختياري	تمثّل هذه السمة الحيّ (إذا كان ذلك منطبقًا) الذي يقع فيه مكان الإقامة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الشارات	اختياري	تكون كل شارة إما نصًا حرًا (بحد أقصى 15 حرفًا) أو صورة صغيرة.
شارة - نص	اختياري	عنوان الشارة ملاحظة: يجب إدخال نص أو صورة للشارة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 15 حرفًا كحدّ أقصى
شارة - صورة	اختياري	صورة صغيرة معالجة خاصة لتجربة المستخدم، على سبيل المثال، كشارة تظهر على الصورة المصغّرة للصورة أو الفيديو ملاحظة: يجب إدخال نص أو صورة للشارة	يُرجى الاطّلاع على مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة نصية واحدة لوصف الكيان ملاحظة: سيتم عرض الوصف أو قائمة العناوين الفرعية للمستخدم، وليس كليهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمات	اختياري	ما يصل إلى 3 عناوين فرعية، يتألف كل منها من سطر واحد من النص ملاحظة: سيتم عرض الوصف أو قائمة العناوين الفرعية للمستخدم، وليس كليهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل ترجمة: 50 حرفًا كحدّ أقصى
AvailabilityTimeWindow - Localized Start Time - Timestamp	اختياري	الطابع الزمني للحقبة الذي يُتوقّع أن يكون مكان الإقامة فيه مفتوحًا/متاحًا	Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone	اختياري	المنطقة الزمنية التي من المتوقّع أن يكون مكان الإقامة مفتوحًا/متاحًا فيها	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، ننصحك باستخدام اختصارات مثل 1M، حتى لا يتم اقتطاعه على أحجام الشاشات الأصغر.	سلسلة
التقييم - قيمة العدد	اختياري	عدد تقييمات مكان الإقامة ملاحظة: يجب تقديم هذا الحقل إذا كنت لا تريد معالجة منطق اختصار العرض بنفسك. في حال توفّر كل من Count وCount Value، سنستخدم Count لعرضها للمستخدمين.	الصيغة الطويلة
Price - CurrentPrice	مطلوب بشروط	السعر الحالي لمكان الإقامة يجب تقديمها في حال تقديم السعر الأصلي المشطوب.	حقل التعبئة النصّية الحرّة
Price - StrikethroughPrice	اختياري	السعر الأصلي لمكان الإقامة، والذي سيظهر مشطوبًا في واجهة المستخدم	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	إضافة وسيلة شرح للسعر من أجل إبراز عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد يظهر النص الطويل جدًا بعلامات حذف)
‫DisplayTimeWindow (اختيارية): لضبط نافذة زمنية لعرض المحتوى على مساحة العرض
الطابع الزمني للبدء	اختياري	الطابع الزمني الذي يمثّل الوقت الذي يجب بعده عرض المحتوى على مساحة العرض. وفي حال عدم ضبطها، يكون المحتوى مؤهلاً للظهور على مساحة العرض.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني الذي يشير إلى الوقت الذي لن يظهر فيه المحتوى على مساحة العرض. وفي حال عدم ضبطها، يكون المحتوى مؤهلاً للظهور على مساحة العرض.	الطابع الزمني للحقبة بالملي ثانية

`StoreEntity`

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

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

`PointOfInterestEntity`

السمة	المتطلبات	الوصف	التنسيق
معرّف الموارد المنتظم (URI) للإجراء	مطلوبة	رابط عميق للكيان في تطبيق مقدّم الخدمة ملاحظة: يمكنك استخدام الروابط العميقة لتحديد المصدر. يُرجى الرجوع إلى هذه الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	عنوان الكيان	سلسلة حجم النص المقترَح: 50 حرفًا كحدّ أقصى
صور الملصقات	مطلوب بشروط	سنعرض صورة واحدة فقط في حال تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: الصورة مطلوبة إذا كان الكيان جزءًا من مجموعة اقتراحات. إذا تم توفير شارة، تأكَّد من توفير مساحة آمنة تبلغ 24 وحدة بكسل مستقلة الكثافة في كل من أعلى الصورة وأسفلها	يُرجى الاطّلاع على مواصفات الصور للحصول على إرشادات.
وقت آخر تفاعل	مطلوب بشروط	الطابع الزمني للحقبة عندما تفاعل المستخدم آخر مرة مع هذا الكيان. ملاحظة: هذا الحقل مطلوب إذا كان الكيان جزءًا من مجموعة "مواصلة البحث".	Joda-Time Instant
الموقع الجغرافي - البلد	مطلوب بشروط	البلد الذي تقع فيه نقطة الاهتمام ملاحظة: هذا الحقل مطلوب إذا كان الكيان جزءًا من مجموعة اقتراحات.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - المدينة	مطلوب بشروط	المدينة التي تقع فيها نقطة الاهتمام ملاحظة: هذا الحقل مطلوب إذا كان الكيان جزءًا من مجموعة اقتراحات.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - العنوان المعروض	مطلوب بشروط	العنوان الذي سيتم عرضه للمستخدم أدخِل عنوانًا مختصرًا باستخدام الاختصارات حيثما أمكن (على سبيل المثال، "St" بدلاً من "Street" و"Ave" بدلاً من "Avenue"). قد يتم اقتطاع هذه السلسلة حسب جهاز المستخدم وإعداداته. أدرِج اسم المدينة لتحديد الموقع الجغرافي بوضوح. ملاحظة: هذا الحقل مطلوب إذا كان الكيان جزءًا من مجموعة اقتراحات.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 35 حرفًا كحدّ أقصى
الموقع الجغرافي - عنوان الشارع	اختياري	عنوان الشارع (إن توفّر) لنقطة الاهتمام	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الولاية	اختياري	الولاية أو المقاطعة (إذا كان ذلك منطبقًا) التي يقع فيها المكان المثير للاهتمام	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	الرمز البريدي (إن توفّر) لنقطة الاهتمام	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
الموقع الجغرافي - الحي	اختياري	تمثّل هذه السمة الحي (إذا كان ذلك منطبقًا) الذي تقع فيه نقطة الاهتمام.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا كحدّ أقصى
AvailabilityTimeWindow - Localized Start Time - Timestamp	اختياري	الطابع الزمني للحقبة الذي يُتوقّع أن يكون فيه المكان المهم مفتوحًا/متاحًا	Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone	اختياري	المنطقة الزمنية التي من المتوقّع أن يكون فيها المكان المثير للاهتمام مفتوحًا/متاحًا	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، ننصحك باستخدام اختصارات مثل 1M، حتى لا يتم اقتطاعه على أحجام الشاشات الأصغر.	سلسلة
التقييم - قيمة العدد	اختياري	عدد التقييمات لنقطة الاهتمام ملاحظة: يجب تقديم هذا الحقل إذا كنت لا تريد معالجة منطق اختصار العرض بنفسك. في حال توفّر كل من Count وCount Value، سنستخدم Count لعرضها للمستخدمين.	الصيغة الطويلة
Price - CurrentPrice	مطلوب بشروط	السعر الحالي للتذاكر أو بطاقات الدخول إلى المعلم السياحي يجب تقديم هذه السمة في حال تقديم السعر الأصلي المشطوب.	حقل التعبئة النصّية الحرّة
Price - StrikethroughPrice	اختياري	السعر الأصلي للتذاكر أو بطاقات الدخول إلى المعلم السياحي	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	إضافة وسيلة شرح للسعر من أجل إبراز عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد يظهر النص الطويل جدًا على شكل علامات حذف)
فئات المحتوى	اختياري	يصف فئة المحتوى في الكيان.	قائمة التعدادات المؤهَّلة TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (مثال: مسرح) ‫TYPE_MEDICAL (مثال: مستشفى) TYPE_EDUCATION (مثال: مدرسة) TYPE_SPORTS (مثال: ملعب) يُرجى الاطّلاع على قسم "فئة المحتوى" للحصول على إرشادات.
‫DisplayTimeWindow (اختيارية): لضبط نافذة زمنية لعرض المحتوى على مساحة العرض
الطابع الزمني للبدء	اختياري	الطابع الزمني الذي يمثّل الوقت الذي يجب بعده عرض المحتوى على مساحة العرض. وفي حال عدم ضبطها، يكون المحتوى مؤهلاً للظهور على مساحة العرض.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني الذي يشير إلى الوقت الذي لن يظهر فيه المحتوى على مساحة العرض. وفي حال عدم ضبطها، يكون المحتوى مؤهلاً للظهور على مساحة العرض.	الطابع الزمني للحقبة بالملي ثانية

`RestaurantReservationEntity`

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

`EventReservationEntity`

السمة	المتطلبات	الوصف	التنسيق
معرّف الموارد المنتظم (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 وحدة بكسل مستقلة الكثافة في كل من أعلى الصورة وأسفلها	يُرجى الاطّلاع على مواصفات الصور للحصول على إرشادات.
وقت الانتهاء المترجَم - الطابع الزمني	اختياري	الطابع الزمني للحقبة عند توقُّع انتهاء الحدث	Joda-Time Instant
وقت الانتهاء المترجَم - المنطقة الزمنية	اختياري	المنطقة الزمنية التي من المتوقّع أن ينتهي فيها الحدث	Joda-Time DateTimeZone يُرجى الاطّلاع على مواصفات المنطقة الزمنية للحصول على إرشادات.
مقدّم الخدمة - الاسم	اختياري	اسم مقدّم الخدمة ملاحظة:يجب توفير نص أو صورة لمقدّم الخدمة.	نص حر على سبيل المثال، اسم منظّم الفعالية أو الجولة
مقدّم الخدمة - صورة	اختياري	شعار/صورة مقدّم الخدمة ملاحظة:يجب توفير نص أو صورة لمقدّم الخدمة.	يُرجى الاطّلاع على مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة نصية واحدة لوصف الكيان ملاحظة: سيتم عرض الوصف أو قائمة العناوين الفرعية للمستخدم، وليس كليهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمات	اختياري	ما يصل إلى 3 عناوين فرعية، يتألف كل منها من سطر واحد من النص ملاحظة: سيتم عرض الوصف أو قائمة العناوين الفرعية للمستخدم، وليس كليهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل ترجمة: 50 حرفًا كحدّ أقصى
الشارات	اختياري	تكون كل شارة إما نصًا حرًا (بحد أقصى 15 حرفًا) أو صورة صغيرة.
شارة - نص	اختياري	عنوان الشارة ملاحظة: يجب إدخال نص أو صورة للشارة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 15 حرفًا كحدّ أقصى
شارة - صورة	اختياري	صورة صغيرة معالجة خاصة لتجربة المستخدم، على سبيل المثال، كشارة تظهر على الصورة المصغّرة للصورة أو الفيديو ملاحظة: يجب إدخال نص أو صورة للشارة	يُرجى الاطّلاع على مواصفات الصور للحصول على إرشادات.
رقم تعريف الحجز	اختياري	رقم تعريف الحجز الخاص بالحدث	حقل التعبئة النصّية الحرّة
Price - CurrentPrice	مطلوب بشروط	السعر الحالي للتذكرة/البطاقة الخاصة بالفعالية يجب تقديم هذه السمة في حال تقديم السعر الأصلي المشطوب.	حقل التعبئة النصّية الحرّة
Price - StrikethroughPrice	اختياري	السعر الأصلي للتذكرة/البطاقة لحضور الفعالية	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	إضافة وسيلة شرح للسعر من أجل إبراز عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد يظهر النص الطويل جدًا بعلامات حذف)
التقييم - الحدّ الأقصى للقيمة	اختياري	الحد الأقصى لقيمة مقياس التقييم يجب تقديم هذه السمة في حال تقديم القيمة الحالية للتقييم أيضًا.	رقم >= 0.0
التقييم - القيمة الحالية	اختياري	القيمة الحالية لمقياس التقييم يجب تقديم هذه السمة في حال تقديم القيمة القصوى للتقييم أيضًا.	رقم >= 0.0
التقييم - العدد	اختياري	عدد التقييمات للحدث ملاحظة: يجب تقديم هذا الحقل إذا كان تطبيقك يريد التحكّم في كيفية عرض ذلك للمستخدمين. يُرجى تقديم سلسلة موجزة يمكن عرضها للمستخدم. على سبيل المثال، إذا كان العدد 1,000,000، ننصحك باستخدام اختصارات مثل 1M، حتى لا يتم اقتطاعه على أحجام الشاشات الأصغر.	سلسلة
التقييم - قيمة العدد	اختياري	عدد التقييمات للحدث ملاحظة: يجب تقديم هذا الحقل إذا كنت لا تريد معالجة منطق اختصار العرض بنفسك. في حال توفّر كل من Count وCount Value، سنستخدم Count لعرضها للمستخدمين.	الصيغة الطويلة
فئات المحتوى	اختياري	يصف فئة المحتوى في الكيان.	قائمة التعدادات المؤهَّلة ‫TYPE_MOVIES_AND_TV_SHOWS (مثال: سينما) TYPE_DIGITAL_GAMES (مثال: الرياضات الإلكترونية) TYPE_MUSIC (مثال: حفلة موسيقية) TYPE_TRAVEL_AND_LOCAL (مثال: جولة، مهرجان) ‫TYPE_HEALTH_AND_FITENESS (مثال: صف يوغا) TYPE_EDUCATION (مثال: صف) TYPE_SPORTS (مثال: مباراة كرة قدم) TYPE_DATING (مثال: meetup) يُرجى الاطّلاع على قسم "فئة المحتوى" للحصول على إرشادات.
‫DisplayTimeWindow (اختيارية): لضبط نافذة زمنية لعرض المحتوى على مساحة العرض
الطابع الزمني للبدء	اختياري	الطابع الزمني الذي يمثّل الوقت الذي يجب بعده عرض المحتوى على مساحة العرض. وفي حال عدم ضبطها، يكون المحتوى مؤهلاً للظهور على مساحة العرض.	الطابع الزمني للحقبة بالملي ثانية
الطابع الزمني للنهاية	اختياري	الطابع الزمني الذي يشير إلى الوقت الذي لن يظهر فيه المحتوى على مساحة العرض. وفي حال عدم ضبطها، يكون المحتوى مؤهلاً للظهور على مساحة العرض.	الطابع الزمني للحقبة بالملي ثانية

`LodgingReservationEntity`

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

`TransportationReservationEntity`

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

`VehicleRentalReservationEntity`

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

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

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

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

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

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

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

مربّعة (1 × 1)

المفضّلة

‫300 × 300

‫1200 × 1200

أفقية (1.91x1)

600 × 314

‫1200 × 628

عمودية (4x5)

‫480×600

‫960 × 1200

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

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

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

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

‫5,120 كيلوبايت

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

المنطقة الآمنة للصور: ضَع المحتوى المهم في الوسط بحيث يشغل% 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`

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

بالنسبة إلى الإصدار 1.6.0 من Engage SDK والإصدارات الأحدث (يُنصح به)

مهارات Android

العرض على GitHub

دمج حزمة Engage SDK

لتثبيت المهارة من Android CLI، شغِّل:

android skills add engage-sdk-integration

إذا كان فريقك يستخدم أدوات الترميز المستندة إلى الذكاء الاصطناعي (مثل Gemini في "استوديو Android")، يمكنك برمجة عملية نقل البيانات هذه من خلال توجيه طلب إلى مساعدك المستنِد إلى الذكاء الاصطناعي:

Use the engage-sdk-integration skill to use Engage SDK 1.6.0 and refactor isServiceAvailable to pass ServiceAvailabilityRequest for publishing all cluster types.

يمكنك التحقّق من توفّر الخدمة لكل نوع مجموعة تريد نشرها. تقبل واجهة برمجة التطبيقات isServiceAvailable عنصر طلب، ServiceAvailabilityRequest، يحتوي على أنواع المجموعات التي يجب التحقّق من توفّر الخدمة لها. يمكنك العثور على قيم التعداد ClusterType المطلوبة لـ ServiceAvailabilityRequest من الجدول التالي.

نوع المجموعة	ثابت نوع المجموعة	قيمة العدد الصحيح
غير معروف	`TYPE_UNKNOWN`	0
مجموعة الاقتراحات	`TYPE_RECOMMENDATION`	1
مجموعة "المحتوى المميّز"	`TYPE_FEATURED`	2
مجموعة المتابعة	`TYPE_CONTINUATION`	3
مجموعة إدارة المستخدمين	`TYPE_ENGAGEMENT`	8
مجموعة الاشتراكات	`TYPE_SUBSCRIPTION`	12
مواصلة البحث في المجموعة	`TYPE_CONTINUE_SEARCH`	13
مجموعة الحجوزات	`TYPE_RESERVATION`	14

Kotlin

val request = ServiceAvailabilityRequest.Builder()
    .addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
    .addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
    .build()

client.isServiceAvailable(request).addOnCompleteListener { task ->
    if (task.isSuccessful) {
        val availabilityMap = task.result
        if (availabilityMap[ClusterType.TYPE_CONTINUATION] == true) {
            // Proceed with publishing continuation content
        }
        if (availabilityMap[ClusterType.TYPE_RECOMMENDATION] == true) {
            // Proceed with publishing recommendation content
        }
    } else {
        // The IPC call itself fails, proceed with error handling logic here,
        // such as retry.
    }
}

Java

ServiceAvailabilityRequest request =
    new ServiceAvailabilityRequest.Builder()
        .addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
        .addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
        .build();

client.isServiceAvailable(request).addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        Map<Integer, Boolean> availabilityMap = task.getResult();
        if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_CONTINUATION))) {
            // Proceed with publishing continuation content
        }
        if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_RECOMMENDATION))) {
            // Proceed with publishing recommendation content
        }
    } else {
        // The IPC call itself fails, proceed with error handling logic here,
        // such as retry.
    }
});

ميزة "توفّر الخدمة المشروط"

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

اعتبارًا من الإصدار 1.6.0، تتيح حزمة Engage SDK التحقّق من مدى توفّر أنواع معيّنة من المجموعات. إذا كان تطبيقك يستخدم ميزة "الاستيعاب المتقطّع":

تظل مجموعات المتابعة (مثل "الحجز" و"مواصلة البحث") مفعَّلة تلقائيًا على جميع الأجهزة المتوافقة.
يتم تفعيل أنواع المجموعات الأخرى (مثل الاقتراحات) وإيقافها بشكل متقطّع.

إذا لم تكن هذه الإعدادات التلقائية مناسبة لاحتياجاتك، يُرجى التواصل مع engage-developers@google.com.

بالنسبة إلى إصدارات حزمة تطوير البرامج (SDK) الأقدم من 1.6.0 (تم إيقافها نهائيًا)

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 PublishFeaturedClusterRequest.Builder()
                .setFeaturedCluster(
                    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 الحالية من الشريك المطوّر.
يتم تحليل البيانات من الطلب وتخزينها في مجموعة الحجوزات المعدَّلة.

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

`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`

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

البيانات الوصفية التالية هي جزء من بطاقة تسجيل الدخول:

السمة	المتطلبات	الوصف
معرّف الموارد المنتظم (URI) للإجراء	مطلوب	رابط لصفحة معيّنة يؤدي إلى إجراء (أي ينقل المستخدم إلى صفحة تسجيل الدخول إلى التطبيق)
صورة	اختيارية: إذا لم يتم تقديمها، يجب تقديم سمة "العنوان" (Title)	الصورة المعروضة على البطاقة صور بنسبة عرض إلى ارتفاع 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());

`deleteRecommendationsClusters`

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

Kotlin

client.deleteRecommendationsClusters()

Java

client.deleteRecommendationsClusters();

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

`deleteFeaturedCluster`

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

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

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

`deleteReservationCluster`

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

Kotlin

client.deleteReservationCluster()

Java

client.deleteReservationCluster();

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

`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 لتلقّي طلب نشر المحتوى.

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

يجب إعداد 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 المعدَّلة على "متجر Google Play"، قد يتم نشر مجموعات الاقتراحات والمحتوى المميّز والحجوزات ومواصلة البحث وإظهارها للمستخدمين.

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

الفئات ومساحات العرض المتوافقة

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

المصطلحات

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

ملخّص

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

GenericFeaturedEntity

ArticleEntity

EventEntity

LodgingEntity

StoreEntity

PointOfInterestEntity

RestaurantReservationEntity

EventReservationEntity

LodgingReservationEntity

TransportationReservationEntity

VehicleRentalReservationEntity

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

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

فئة المحتوى

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

isServiceAvailable

بالنسبة إلى الإصدار 1.6.0 من Engage SDK والإصدارات الأحدث (يُنصح به)

Kotlin

Java

ميزة "توفّر الخدمة المشروط"

بالنسبة إلى إصدارات حزمة تطوير البرامج (SDK) الأقدم من 1.6.0 (تم إيقافها نهائيًا)

Kotlin

Java

publishRecommendationClusters

Kotlin

Java

publishFeaturedCluster

Kotlin

Java

publishReservationCluster

Kotlin

Java

publishContinueSearchCluster

Kotlin

Java

publishUserAccountManagementRequest

Kotlin

Java

updatePublishStatus

Kotlin

Java

deleteRecommendationsClusters

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`

`deleteRecommendationsClusters`

`deleteFeaturedCluster`

`deleteReservationCluster`

`deleteUserManagementCluster`

`deleteContinueSearchCluster`

`deleteClusters`