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

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

تفاصيل الدمج

المصطلحات

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

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

    • يمكن إنشاء مجموعة اقتراحات من بيانات ArticleEntity أو EventEntity أو LodgingEntity أو PointOfInterestEntity أو StoreEntity، ولكن ليس من خلال مزيج من أنواع عناصر مختلفة.

    تتّبع اقتراحاتك البنية التالية:

    • مجموعة الاقتراحات: عرض واجهة مستخدم يحتوي على مجموعة من الاقتراحات من شريك المطوّر نفسه.

    • الكيان: كائن يمثّل عنصرًا واحدًا في مجموعة. يوفّر هذا التكامل بعض الكيانات التي سيتم عرضها باستخدام ميزة "مجموعة الاقتراحات":

      • ArticleEntity: يمثّل ArticleEntity اقتراحًا لمحتوى مستند إلى النص حول السفر والفعاليات. ويمكن استخدامه في المقالات ومشاركات المدونات والمحتوى التسويقي ومقتطفات الأخبار وما إلى ذلك.

        الشكل 1: واجهة مستخدِم تعرض عنصر ArticleEntity واحدًا ضمن مجموعة الاقتراحات
      • EventEntity: يمثّل EventEntity حدثًا سيحدث في المستقبل. وقت بدء الحدث هو معلومة مهمة يجب إعلام المستخدمين بها.

        الشكل 2: واجهة مستخدِم تعرِض عنصر حدث واحدًا ضمن مجموعة الاقتراحات
      • 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: يمثّل TransportationReservationEntity حجزًا لاستخدام أي وسيلة نقل، ويساعد المستخدمين في متابعة حجوزات الرحلات الجوية أو العبارات أو القطارات أو الحافلات أو المركبات التي يتم استدعاؤها أو الرحلات البحرية القادمة أو الجارية.

      الشكل 9. واجهة مستخدم تعرض عنصرًا واحدًا TransportationReservationEntity ضمن مجموعة حجوزات
    • VehicleRentalReservationEntity: يمثّل VehicleRentalReservationEntity حجز استئجار المركبة ويساعد المستخدمين في تتبُّع حجوزات استئجار المركبات القادمة أو الجارية.

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

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

      الشكل 11: واجهة مستخدم تعرض مجموعة مميّزة تتضمّن قائمة بعناصر 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'
}

ملخّص

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

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

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

الخطوة 1: تقديم بيانات العنصر

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

  1. GenericFeaturedEntity
  2. ArticleEntity
  3. EventEntity
  4. LodgingEntity
  5. StoreEntity
  6. PointOfInterestEntity
  7. RestaurantReservationEntity
  8. EventReservationEntity
  9. LodgingReservationEntity
  10. TransportationReservationEntity
  11. VehicleRentalReservationEntity

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

GenericFeaturedEntity

السمة المتطلب الوصف التنسيق
معرّف الموارد المنتظم (URI) للإجراء مطلوبة

رابط لصفحة في التطبيق ينقل إلى الكيان

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

معرّف موارد منتظم (URI)
صور الملصقات مطلوبة

سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9

ملاحظة: في حال تقديم شارة، تأكَّد من توفير مساحة آمنة تبلغ 24 نقطة في البوصة في أعلى وأسفل الصورة.

اطّلِع على مواصفات الصور للحصول على إرشادات.
العنوان اختياري عنوان الكيان

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 50 حرفًا

الوصف اختياري

فقرة واحدة من النص لوصف الكيان

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 180 حرفًا

قائمة الترجمة اختياري

ما يصل إلى 3 ترجمات مصاحبة، يكون كلّ منها سطرًا واحدًا من النص

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح لكل ترجمة: 50 حرفًا بحدٍ أقصى

الشارات اختياري

كل شارة هي إما نص حر (15 حرفًا بحد أقصى) أو صورة صغيرة.

معالجة خاصة لتجربة المستخدم على سطح الصورة أو الفيديو، على سبيل المثال، كشارة فوق الصورة

  • "تعديل مباشر"
  • مدّة قراءة المقالة
الشارة - النص اختياري

عنوان الشارة

ملاحظة: يجب إدخال نص أو صورة للشارة.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 15 حرفًا بحد أقصى

الشارة - صورة اختياري

صورة صغيرة

معالجة خاصة لتجربة المستخدم، مثل وضع شارة على الصورة المصغّرة للصورة/الفيديو

ملاحظة: يجب إدخال نص أو صورة للشارة.

اطّلِع على مواصفات الصور للحصول على إرشادات.
فئات المحتوى اختياري يصف هذا الحقل فئة المحتوى في العنصر.

قائمة عمليات التعداد

اطّلِع على قسم "فئة المحتوى" للحصول على إرشادات.

ArticleEntity

السمة المتطلب الوصف التنسيق
معرّف الموارد المنتظم (URI) للإجراء مطلوبة

رابط لصفحة في التطبيق ينقل إلى الكيان

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

معرّف موارد منتظم (URI)
العنوان مطلوبة عنوان الكيان

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 50 حرفًا بحد أقصى

صور الملصقات اختياري

سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9

ملاحظة: ننصح بشدة باستخدام صورة. إذا تم استخدام شارة، يجب ترك مساحة آمنة تبلغ 24 بكسل في الثانية في أعلى وأسفل الصورة.

اطّلِع على مواصفات الصور للحصول على إرشادات.
المصدر - العنوان اختياري اسم المؤلف أو المؤسسة أو المُخبر

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 25 حرفًا

المصدر: صورة اختياري صورة للمصدر، مثل المؤلف أو المؤسسة أو المُخبر اطّلِع على مواصفات الصور للحصول على إرشادات.
الوصف اختياري

فقرة واحدة من النص لوصف الكيان

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 180 حرفًا

قائمة الترجمة اختياري

ما يصل إلى 3 ترجمات مصاحبة، يكون كلّ منها سطرًا واحدًا من النص

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح لكل ترجمة: 50 حرفًا بحدٍ أقصى

الشارات اختياري

كل شارة هي إما نص حر (15 حرفًا بحد أقصى) أو صورة صغيرة.

معالجة خاصة لتجربة المستخدم على سطح الصورة أو الفيديو، على سبيل المثال، كشارة فوق الصورة

  • "تعديل مباشر"
  • مدّة قراءة المقالة
الشارة - النص اختياري

عنوان الشارة

ملاحظة: يجب إدخال نص أو صورة للشارة.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 15 حرفًا بحد أقصى

الشارة - صورة اختياري

صورة صغيرة

معالجة خاصة لتجربة المستخدم، مثل وضع شارة على الصورة المصغّرة للصورة/الفيديو

ملاحظة: يجب إدخال نص أو صورة للشارة.

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

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

ملاحظة: يكون هذا الحقل مطلوبًا إذا كان هذا الكيان جزءًا من مجموعة الحجز.

الطابع الزمني لحقبة Unix بالملي ثانية
النسبة المئوية للتقدّم مطلوبة بشكل مشروط

النسبة المئوية للمحتوى الكامل الذي استهلكه المستخدم حتى اليوم

ملاحظة: يكون هذا الحقل مطلوبًا إذا كان هذا الكيان جزءًا من مجموعة الحجز.

قيمة عدد صحيح تتراوح بين 0 و100.
فئات المحتوى اختياري يصف هذا الحقل فئة المحتوى في العنصر.

قائمة عمليات التعداد

اطّلِع على قسم "فئة المحتوى" للحصول على إرشادات.

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 حرفًا بحد أقصى

وقت الانتهاء اختياري

الطابع الزمني لبدء حساب الفترة الزمنية الذي يُتوقّع فيه انتهاء الحدث

ملاحظة: سيتم تمثيل ذلك بالملي ثانية.

الطابع الزمني لحقبة Unix بالملي ثانية
الوصف اختياري

فقرة واحدة من النص لوصف الكيان

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 180 حرفًا

قائمة الترجمة اختياري

ما يصل إلى 3 ترجمات مصاحبة، يكون كلّ منها سطرًا واحدًا من النص

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح لكل ترجمة: 50 حرفًا بحدٍ أقصى

الشارات اختياري

كل شارة هي إما نص حر (15 حرفًا بحد أقصى) أو صورة صغيرة.

الشارة - النص اختياري

عنوان الشارة

ملاحظة: يجب إدخال نص أو صورة للشارة.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 15 حرفًا بحد أقصى

الشارة - صورة اختياري

صورة صغيرة

معالجة خاصة لتجربة المستخدم، مثل وضع شارة على الصورة المصغّرة للصورة/الفيديو

ملاحظة: يجب إدخال نص أو صورة للشارة.

اطّلِع على مواصفات الصور للحصول على إرشادات.
السعر - CurrentPrice مطلوبة بشكل مشروط

السعر الحالي للتذكرة أو البطاقة للحدث.

يجب تقديمها إذا تم تقديم سعر مشطوب.

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

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 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 (مثال: لقاء)

اطّلِع على قسم "فئة المحتوى" للحصول على إرشادات.

LodgingEntity

السمة المتطلب الوصف التنسيق
معرّف الموارد المنتظم (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 - 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، لكي لا يتم اقتطاعه على أحجام الشاشة الأصغر.

سلسلة
التقييم - قيمة العدد اختياري

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

ملاحظة: قدِّم هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا كانت كلّ من السمتَين "العدد" و"قيمة العدد" متوفرتين، سنستخدم السمة "العدد" لعرضها للمستخدمين.

الصيغة الطويلة
السعر - CurrentPrice مطلوبة بشكل مشروط

السعر الحالي للإقامة

يجب تقديمه إذا تم تقديم سعر مشطوب.

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

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

StoreEntity

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

السمة المتطلب الوصف التنسيق
صور الملصقات مطلوبة يجب تقديم صورة واحدة على الأقل. اطّلِع على مواصفات الصور للحصول على إرشادات.
معرّف الموارد المنتظم (URI) للإجراء مطلوبة

رابط لصفحة في التطبيق ينقل إلى الكيان

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

معرّف موارد منتظم (URI)
العنوان اختياري اسم المتجر

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

الموقع الجغرافي اختياري الموقع الجغرافي للمتجر

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

وسيلة الشرح اختياري وسيلة شرح لعرض عرض ترويجي أو حدث أو تعديل للمتجر، إذا كان ذلك ممكنًا

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

أحكام العرض الخاصة بوسائل الشرح اختياري نص الأحكام الدقيقة لوسيلة الشرح

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

الوصف اختياري وصف للمتجر

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 90 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

الفئة اختياري

فئة المتجر، في سياق أماكن تناول الطعام، يمكن أن تكون المأكولات مثل "فرنسية" أو "أمريكية جديدة" أو "رامن" أو "مطعم فاخر".

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

التقييم - الحد الأقصى للقيمة اختياري

الحد الأقصى لقيمة مقياس التقييم.

يجب تقديمها إذا تم تقديم القيمة الحالية للتقييم أيضًا.

عدد أكبر من أو يساوي 0.0
التقييم - القيمة الحالية اختياري

القيمة الحالية لمقياس التقييم.

يجب تقديمها إذا تم تقديم الحد الأقصى لقيمة التقييم أيضًا.

عدد أكبر من أو يساوي 0.0
التقييم - العدد اختياري

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

ملاحظة: قدِّم هذا الحقل إذا كان تطبيقك يريد التحكّم في طريقة عرض هذا المحتوى للمستخدمين. قدِّم السلسلة المختصرة التي يمكن عرضها للمستخدم. على سبيل المثال، إذا كان العدد هو 1,000,000، ننصحك باستخدام اختصارات مثل 1M، لكي لا يتم اقتطاعه على أحجام الشاشة الأصغر.

سلسلة
التقييم - قيمة العدد اختياري

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

ملاحظة: قدِّم هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا كانت كلّ من السمتَين "العدد" و"قيمة العدد" متوفرتين، سنستخدم السمة "العدد" لعرضها للمستخدمين.

الصيغة الطويلة

PointOfInterestEntity

السمة المتطلب الوصف التنسيق
معرّف الموارد المنتظم (URI) للإجراء مطلوبة

رابط لصفحة في التطبيق ينقل إلى الكيان

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

معرّف موارد منتظم (URI)
العنوان مطلوبة عنوان الكيان

سلسلة

حجم النص المقترَح: 50 حرفًا بحد أقصى

صور الملصقات مطلوبة

سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9

ملاحظة: ننصح بشدة باستخدام صورة. إذا تم استخدام شارة، يجب ترك مساحة آمنة تبلغ 24 بكسل في الثانية في أعلى وأسفل الصورة.

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

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي - المدينة مطلوبة المدينة التي تقع فيها نقطة الاهتمام

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

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

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي: عنوان الشارع اختياري عنوان الشارع (إن أمكن) لنقطة الاهتمام

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 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، لكي لا يتم اقتطاعه على أحجام الشاشة الأصغر.

سلسلة
التقييم - قيمة العدد اختياري

عدد التقييمات لنقطة الاهتمام

ملاحظة: قدِّم هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا كانت كلّ من السمتَين "العدد" و"قيمة العدد" متوفرتين، سنستخدم السمة "العدد" لعرضها للمستخدمين.

الصيغة الطويلة
السعر - CurrentPrice مطلوبة بشكل مشروط

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

يجب تقديمها إذا تم تقديم سعر مشطوب.

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

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 45 حرفًا (قد يؤدي النص الطويل جدًا إلى عرض علامات حذف)

فئات المحتوى اختياري يصف هذا الحقل فئة المحتوى في العنصر.

قائمة التعدادات المؤهّلة

  • TYPE_TRAVEL_AND_LOCAL
  • TYPE_MOVIES_AND_TV_SHOWS (مثال: مسرح)
  • TYPE_MEDICAL (مثال: مستشفى)
  • ‫TYPE_EDUCATION (مثال: مدرسة)
  • ‫TYPE_SPORTS (مثال: ملعب)

اطّلِع على قسم "فئة المحتوى" للحصول على إرشادات.

RestaurantReservationEntity

السمة المتطلب الوصف التنسيق
معرّف الموارد المنتظم (URI) للإجراء مطلوبة

رابط لصفحة في التطبيق ينقل إلى الكيان

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

معرّف موارد منتظم (URI)
العنوان مطلوبة عنوان الكيان

سلسلة

حجم النص المقترَح: 50 حرفًا بحد أقصى

وقت بدء الحجز المترجَم - الطابع الزمني مطلوبة الطابع الزمني لبدء الفترة التي يُتوقّع أن يبدأ فيها الحجز. Joda-Time Instant
وقت بدء الحجز المترجَم - المنطقة الزمنية مطلوبة المنطقة الزمنية التي من المتوقّع أن يبدأ فيها الحجز Joda-Time DateTimeZone
الموقع الجغرافي - البلد مطلوبة البلد الذي يقع فيه المطعم

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي - المدينة مطلوبة المدينة التي يقع فيها المطعم

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي: عنوان العرض مطلوبة عنوان المطعم الذي سيتم عرضه للمستخدم

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي: عنوان الشارع اختياري عنوان الشارع للمطعم (إن أمكن)

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي - الولاية اختياري الولاية أو المقاطعة (إن أمكن) التي يقع فيها المطعم

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي - الرمز البريدي اختياري الرمز البريدي للمطعم (إن أمكن)

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي: الحي اختياري الحي الذي يقع فيه المطعم (إن أمكن)

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

صور الملصقات اختياري سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 اطّلِع على مواصفات الصور للحصول على إرشادات.
الوصف اختياري

فقرة واحدة من النص لوصف الكيان

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 180 حرفًا

قائمة الترجمة اختياري

ما يصل إلى 3 ترجمات مصاحبة، يكون كلّ منها سطرًا واحدًا من النص

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح لكل ترجمة: 50 حرفًا بحدٍ أقصى

حجم الجدول اختياري عدد الأشخاص في مجموعة الحجز عدد صحيح أكبر من 0

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 حرفًا بحد أقصى

الشارة - صورة اختياري

صورة صغيرة

معالجة خاصة لتجربة المستخدم، مثل وضع شارة على الصورة المصغّرة للصورة/الفيديو

ملاحظة: يجب إدخال نص أو صورة للشارة.

اطّلِع على مواصفات الصور للحصول على إرشادات.
رقم تعريف الحجز اختياري رقم تعريف حجز الحدث. حقل التعبئة النصّية الحرّة
السعر - CurrentPrice مطلوبة بشكل مشروط

السعر الحالي للتذكرة أو البطاقة للحدث.

يجب تقديمها إذا تم تقديم سعر مشطوب.

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

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

التقييم - الحد الأقصى للقيمة اختياري

الحد الأقصى لقيمة مقياس التقييم.

يجب تقديمها إذا تم تقديم القيمة الحالية للتقييم أيضًا.

عدد أكبر من أو يساوي 0.0
التقييم - القيمة الحالية اختياري

القيمة الحالية لمقياس التقييم.

يجب تقديمها إذا تم تقديم الحد الأقصى لقيمة التقييم أيضًا.

عدد أكبر من أو يساوي 0.0
التقييم - العدد اختياري

عدد التقييمات للحدث

ملاحظة: قدِّم هذا الحقل إذا كان تطبيقك يريد التحكّم في طريقة عرض هذا المحتوى للمستخدمين. قدِّم السلسلة المختصرة التي يمكن عرضها للمستخدم. على سبيل المثال، إذا كان العدد هو 1,000,000، ننصحك باستخدام اختصارات مثل 1M، لكي لا يتم اقتطاعه على أحجام الشاشة الأصغر.

سلسلة
التقييم - قيمة العدد اختياري

عدد التقييمات للحدث

ملاحظة: قدِّم هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا كانت كلّ من السمتَين "العدد" و"قيمة العدد" متوفرتين، سنستخدم السمة "العدد" لعرضها للمستخدمين.

الصيغة الطويلة
فئات المحتوى اختياري يصف هذا الحقل فئة المحتوى في العنصر.

قائمة التعدادات المؤهّلة

  • ‫TYPE_MOVIES_AND_TV_SHOWS (مثال: سينما)
  • ‫TYPE_DIGITAL_GAMES (مثال: ألعاب الفيديو الإلكترونية)
  • TYPE_MUSIC (مثال: حفل موسيقي)
  • ‫TYPE_TRAVEL_AND_LOCAL (مثال: جولة أو مهرجان)
  • TYPE_HEALTH_AND_FITENESS (مثال: صف يوغا)
  • ‫TYPE_EDUCATION (مثال: فئة)
  • ‫TYPE_SPORTS (مثال: لعبة كرة قدم)
  • TYPE_DATING (مثال: لقاء)

اطّلِع على قسم "فئة المحتوى" للحصول على إرشادات.

LodgingReservationEntity

السمة المتطلب الوصف التنسيق
معرّف الموارد المنتظم (URI) للإجراء مطلوبة

رابط لصفحة في التطبيق ينقل إلى الكيان

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

معرّف موارد منتظم (URI)
العنوان مطلوبة عنوان الكيان

نص حر على سبيل المثال، "إقامتك من 12 كانون الأول (ديسمبر)"

حجم النص المقترَح: 50 حرفًا بحد أقصى

وقت الوصول المترجَم - الطابع الزمني مطلوبة الطابع الزمني لبدء حساب الفترة الذي يمثّل وقت تسجيل الوصول للحجز Joda-Time Instant
وقت تسجيل الوصول المترجَم - المنطقة الزمنية مطلوبة المنطقة الزمنية التي يقع فيها وقت تسجيل الوصول للحجز Joda-Time Instant
وقت المغادرة المترجَم - الطابع الزمني مطلوبة الطابع الزمني لبدء حساب الفترة الذي يمثّل وقت المغادرة للحجز Joda-Time Instant
وقت المغادرة المترجَم - المنطقة الزمنية مطلوبة المنطقة الزمنية التي يتوفّر فيها وقت المغادرة للحجز Joda-Time DateTimeZone
الموقع الجغرافي - البلد مطلوبة البلد الذي يقع فيه مكان الإقامة

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي - المدينة مطلوبة المدينة التي يقع فيها مكان الإقامة

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي: عنوان العرض مطلوبة عنوان مكان الإقامة الذي سيتم عرضه للمستخدم

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي: عنوان الشارع اختياري عنوان الشارع (إن أمكن) للمكان المخصّص للإقامة

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي - الولاية اختياري الولاية أو المقاطعة (إن أمكن) التي يقع فيها مكان الإقامة

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي - الرمز البريدي اختياري الرمز البريدي (إن أمكن) للمكان المخصّص للإقامة

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

الموقع الجغرافي: الحي اختياري الحي (إن أمكن) الذي يقع فيه مكان الإقامة

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 20 حرفًا بحد أقصى

صور الملصقات اختياري

سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9

ملاحظة: في حال توفّر شارة، يجب توفير مساحة آمنة تبلغ 24 بكسل في الثانية في أعلى وأسفل الصورة.

اطّلِع على مواصفات الصور للحصول على إرشادات.
الوصف اختياري

فقرة واحدة من النص لوصف الكيان

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 180 حرفًا

قائمة الترجمة اختياري

ما يصل إلى 3 ترجمات مصاحبة، يكون كلّ منها سطرًا واحدًا من النص

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح لكل ترجمة: 50 حرفًا بحدٍ أقصى

رقم تعريف الحجز اختياري معرّف الحجز لمكان الإقامة حقل التعبئة النصّية الحرّة
التقييم - الحد الأقصى للقيمة اختياري

الحد الأقصى لقيمة مقياس التقييم.

يجب تقديمها إذا تم تقديم القيمة الحالية للتقييم أيضًا.

عدد أكبر من أو يساوي 0.0
التقييم - القيمة الحالية اختياري

القيمة الحالية لمقياس التقييم.

يجب تقديمها إذا تم تقديم الحد الأقصى لقيمة التقييم أيضًا.

عدد أكبر من أو يساوي 0.0
التقييم - العدد اختياري

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

ملاحظة: قدِّم هذا الحقل إذا كان تطبيقك يريد التحكّم في طريقة عرض هذا المحتوى للمستخدمين. قدِّم السلسلة المختصرة التي يمكن عرضها للمستخدم. على سبيل المثال، إذا كان العدد هو 1,000,000، ننصحك باستخدام اختصارات مثل 1M، لكي لا يتم اقتطاعه على أحجام الشاشة الأصغر.

سلسلة
التقييم - قيمة العدد اختياري

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

ملاحظة: قدِّم هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا كانت كلّ من السمتَين "العدد" و"قيمة العدد" متوفرتين، سنستخدم السمة "العدد" لعرضها للمستخدمين.

الصيغة الطويلة
السعر - CurrentPrice مطلوبة بشكل مشروط

السعر الحالي للإقامة

يجب تقديمه إذا تم تقديم سعر مشطوب.

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

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

TransportationReservationEntity

السمة المتطلب الوصف التنسيق
معرّف الموارد المنتظم (URI) للإجراء مطلوبة

رابط لصفحة في التطبيق ينقل إلى الكيان

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

معرّف موارد منتظم (URI)
العنوان مطلوبة عنوان الكيان

نص حر على سبيل المثال، "SFO إلى SAN"

حجم النص المقترَح: 50 حرفًا بحد أقصى

نوع النقل مطلوبة وسيلة/نوع النقل للحجز قيم التعداد: FLIGHT أو TRAIN أو BUS أو FERRY
وقت المغادرة المترجَم - الطابع الزمني مطلوبة الطابع الزمني لبدء حساب الفترة الذي يمثّل وقت المغادرة 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 حرفًا بحد أقصى

مقدّم الخدمة - الاسم اختياري

اسم مقدّم الخدمة

ملاحظة: يجب إدخال نص أو صورة لمقدّم الخدمة.

نص حر على سبيل المثال، اسم شركة الخطوط الجوية
مقدّم الخدمة - صورة اختياري

شعار/صورة مقدّم الخدمة

ملاحظة: يجب تقديم نص أو صورة لمقدّم الخدمة.

اطّلِع على مواصفات الصور للحصول على إرشادات.
صور الملصقات اختياري

سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9

اطّلِع على مواصفات الصور للحصول على إرشادات.
الوصف اختياري

فقرة واحدة من النص لوصف الكيان

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 180 حرفًا

قائمة الترجمة اختياري

ما يصل إلى 3 ترجمات مصاحبة، يكون كلّ منها سطرًا واحدًا من النص

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح لكل ترجمة: 50 حرفًا بحدٍ أقصى

رقم تعريف الحجز اختياري معرّف حجز وسائل النقل حقل التعبئة النصّية الحرّة
السعر - CurrentPrice مطلوبة بشكل مشروط

السعر الحالي للحجز.

يجب تقديمه إذا تم تقديم سعر مشطوب.

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

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

رقم النقل مطلوب رقم الرحلة الجوية أو رقم الحافلة أو رقم القطار أو رقم العبارة/الرحلة البحرية حقل التعبئة النصّية الحرّة
وقت الصعود المترجَم - الطابع الزمني مطلوب الطابع الزمني لبدء حساب الفترة الزمنية الذي يمثّل وقت الصعود إلى الطائرة للحجز (إن وُجد) Joda-Time Instant
وقت الصعود المترجَم - المنطقة الزمنية مطلوب المنطقة الزمنية لوقت الصعود إلى الطائرة للحجز (إن وُجد) Joda-Time DateTimeZone

VehicleRentalReservationEntity

السمة المتطلب الوصف التنسيق
معرّف الموارد المنتظم (URI) للإجراء مطلوبة

رابط لصفحة في التطبيق ينقل إلى الكيان

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

معرّف موارد منتظم (URI)
العنوان مطلوبة عنوان الكيان

نص حر على سبيل المثال، "Avis Union Square SF"

حجم النص المقترَح: 50 حرفًا بحد أقصى

وقت الاستلام المترجَم - الطابع الزمني مطلوبة الطابع الزمني لبدء حساب الفترة الذي يمثّل وقت استلام الحجز 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 Car Rental"
مقدّم الخدمة - صورة اختياري

شعار/صورة مقدّم الخدمة

ملاحظة: يجب تقديم نص أو صورة لمقدّم الخدمة.

اطّلِع على مواصفات الصور للحصول على إرشادات.
صور الملصقات اختياري

سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9

اطّلِع على مواصفات الصور للحصول على إرشادات.
الوصف اختياري

فقرة واحدة من النص لوصف الكيان

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: 180 حرفًا

قائمة الترجمة اختياري

ما يصل إلى 3 ترجمات مصاحبة، يكون كلّ منها سطرًا واحدًا من النص

ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.

حقل التعبئة النصّية الحرّة

حجم النص المقترَح لكل ترجمة: 50 حرفًا بحدٍ أقصى

رقم تعريف التأكيد اختياري معرّف تأكيد حجز المركبة للإيجار حقل التعبئة النصّية الحرّة
السعر - CurrentPrice مطلوبة بشكل مشروط

السعر الحالي للحجز.

يجب تقديمه إذا تم تقديم سعر مشطوب.

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

حقل التعبئة النصّية الحرّة

حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

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

في هذا الجدول، يمكنك الاطّلاع على المواصفات المطلوبة لمواد عرض الصور:

نسبة العرض إلى الارتفاع الحدّ الأدنى لعدد وحدات البكسل وحدات البكسل المقترَحة

مربّع (1×1)

مفضّل

‫300 × 300 1200 × 1200
أفقية (1.91x1) ‫600 × 314 ‫1200×628
عمودي (4×5) ‫480×600 ‫960x1200

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

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

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

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

5,120 كيلوبايت

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

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

فئة المحتوى

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

  • 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 من الوصول إليها.

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

  1. إنّ بعض الكيانات، مثل ArticleEntity وGenericFeaturedEntity، مؤهَّلة لاستخدام أيّ من فئات المحتوى. بالنسبة إلى الكيانات الأخرى، مثل EventEntity وEventReservationEntity وPointOfInterestEntity، تكون فقط مجموعة فرعية من هذه الفئات مؤهَّلة. راجِع قائمة الفئات المؤهَّلة لنوع عنصر معيّن قبل تعبئة القائمة.
  2. استخدِم نوع العنصر المحدّد لبعض فئات المحتوى بدلاً من تركيبة من العناصر العامة وContentCategory:

    • ‫TYPE_MOVIES_AND_TV_SHOWS: اطّلِع على الكيانات من دليل دمج Watch قبل استخدام الكيانات العامة.
    • ‫TYPE_BOOKS: اطّلِع على EbookEntity قبل استخدام الكيانات العامة.
    • ‫TYPE_AUDIOBOOKS: اطّلِع على AudiobookEntity قبل استخدام الكيانات العامة.
    • ‫TYPE_SHOPPING: اطّلِع على ShoppingEntity قبل استخدام الكيانات العامة.
    • ‫TYPE_FOOD_AND_DRINK: اطّلِع على الكيانات من دليل دمج البيانات الغذائية قبل استخدام الكيانات العامة.
  3. حقل ContentCategory اختياري ويجب تركه فارغًا إذا كان المحتوى لا ينتمي إلى أي من الفئات المذكورة سابقًا.

  4. في حال تقديم فئات محتوى متعددة، يجب تقديمها بترتيب تصاعدي تبعًا لمدى صلة كل فئة بالمحتوى، مع وضع فئة المحتوى الأكثر صلة أولاً في القائمة.

الخطوة 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 الحالية من حساب شريك المطوّر.
  • يتم تحليل البيانات الواردة من الطلب وتخزينها في Recommendation Cluster المعدَّلة.

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

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

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

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

السمة المتطلب الوصف
معرّف الموارد المنتظم (URI) للإجراء مطلوب رابط لصفحة في التطبيق (أي الانتقال إلى صفحة تسجيل الدخول إلى التطبيق)
صورة اختيارية - يجب تقديم العنوان في حال عدم تقديمه

الصورة المعروضة على البطاقة

صور بنسبة عرض إلى ارتفاع 16×9 بدرجة دقة 1264×712

العنوان اختيارية - يجب تقديم صورة في حال عدم توفّرها العنوان الوارد على البطاقة
نص الإجراء اختياري النص المعروض على عبارة الحثّ على اتّخاذ إجراء (مثل "تسجيل الدخول")
العنوان الفرعي اختياري ترجمة اختيارية على البطاقة

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 الحالية من المطوِّر الشريك.
  • يتم تحليل البيانات الواردة من الطلب وتخزينها في ملف تعريف clustered 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 Cluster.

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

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

يجب إعداد 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
}

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

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))
}

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
}

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));

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));

}
  • حدِّد التنفيذ بشكل ثابت باستخدام علامة <receiver> في ملف AndroidManifest.xml. يتيح ذلك للتطبيق تلقّي طلبات البث عندما لا يكون قيد التشغيل، كما يتيح للتطبيق نشر المحتوى.
<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      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>
   </receiver>
</application>

تُرسِل ال خدمةالأهداف التالية:

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION يُنصح ببدء مكالمة publishRecommendationClusters عند تلقّي هذه النية.
  • com.google.android.engage.action.PUBLISH_FEATURED ننصح ببدء مكالمة publishFeaturedCluster عند تلقّي هذا الطلب.

سير عمل الدمج

للحصول على دليل مفصّل حول التحقّق من عملية الدمج بعد اكتمالها، يُرجى الاطّلاع على Engage developer integration workflow (سير عمل دمج المطوّرين).

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

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

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

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

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

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

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