تعمل Google على إنشاء مساحة عرض على الجهاز تنظّم تطبيقات المستخدمين حسب المجالات، وتوفّر تجربة تفاعلية جديدة للاستهلاك المخصّص لمحتوى التطبيقات واستكشافه. توفّر هذه التجربة الكاملة في الشاشة لشركاء المطوّرين فرصة لعرض أفضل المحتوى الغني في قناة مخصّصة خارج تطبيقاتهم. يتضمّن هذا الدليل تعليمات لشركاء المطوّرين بغرض دمج محتوى السفر والفعاليات باستخدام حزمة SDK لميزة "التفاعل" لتعبئة هذه المساحة الجديدة.
تفاصيل الدمج
المصطلحات
يتضمّن هذا الدمج أنواع المجموعات التالية: اقتراح، مميّز، حجز ومتابعة البحث.
تعرض مجموعات الاقتراحات اقتراحات مخصّصة حول السفر والفعاليات من مطوّر فردي شريك. يمكن أن تكون هذه الاقتراحات مخصّصة للمستخدم أو عامة (مثل العناصر الرائجة). استخدِم هذه الاقتراحات لعرض مقالات أو أحداث أو أماكن إقامة أو أماكن تهمّك.
- يمكن إنشاء مجموعة اقتراحات من بيانات
ArticleEntity
أوEventEntity
أوLodgingEntity
أوPointOfInterestEntity
أوStoreEntity
، ولكن ليس من خلال مزيج من أنواع عناصر مختلفة.
تتّبع اقتراحاتك البنية التالية:
مجموعة الاقتراحات: عرض واجهة مستخدم يحتوي على مجموعة من الاقتراحات من شريك المطوّر نفسه.
الكيان: كائن يمثّل عنصرًا واحدًا في مجموعة. يوفّر هذا التكامل بعض الكيانات التي سيتم عرضها باستخدام ميزة "مجموعة الاقتراحات":
ArticleEntity: يمثّل ArticleEntity اقتراحًا لمحتوى مستند إلى النص حول السفر والفعاليات. ويمكن استخدامه في المقالات ومشاركات المدونات والمحتوى التسويقي ومقتطفات الأخبار وما إلى ذلك.
EventEntity: يمثّل EventEntity حدثًا سيحدث في المستقبل. وقت بدء الحدث هو معلومة مهمة يجب إعلام المستخدمين بها.
LodgingEntity: يمثّل LodgingEntity مكان إقامة، مثل فندق أو شقة أو منزل عطلات للإيجار على المدى القصير والقصير المدى.
StoreEntity: يمثّل StoreEntity متجرًا أو مطعمًا أو مقهى وغيرها. ويسلّط الضوء على المحتوى الذي يتضمن معلومات مهمة عن مكان تناول الطعام أو المتجر، ويجب إطلاع المستخدمين عليها.
PointOfInterestEntity: يمثّل PointOfInterestEntity مكانًا مثيراً للاهتمام، مثل محطة وقود أو مكان لإقامة فعاليات أو مدينة ملاهٍ أو متحف أو موقع سياحي أو مسار للمشي لمسافات طويلة وما إلى ذلك. ويُبرز هذا العنصر المحتوى الذي يتضمن معلومات مهمة عن الموقع الجغرافي ويجب إبلاغ المستخدمين بها. يجب ألا يتم استخدامه كمكان إقامة أو متجر أو مطعم.
- يمكن إنشاء مجموعة اقتراحات من بيانات
تعرِض مجموعة الحجز المحتوى الذي تفاعل معه المستخدمون مؤخرًا من شركاء مطوّرين متعدّدين في مجموعة واحدة لواجهة المستخدم. سيتم السماح لكل شريك مطوّر ببث 10 كيانات كحد أقصى في مجموعات الحجز.
يمكن أن يتّخذ محتوى الحجز البنية التالية:
RestaurantReservationEntity: يمثّل RestaurantReservationEntity حجزًا لمطعم أو مقهى ويساعد المستخدمين في تتبُّع حجوزات المطاعم القادمة أو الحالية.
EventReservationEntity: يمثّل EventReservationEntity حجزًا لحدث ويساعد المستخدمين في تتبُّع الحجوزات القادمة أو الجارية للأحداث. يمكن أن تشمل الأحداث، على سبيل المثال لا الحصر، ما يلي:
- الأحداث الرياضية، مثل حجز تذكرة لمباراة كرة قدم
- أحداث الألعاب، مثل حجز أماكن لفعاليات الرياضات الإلكترونية
- الفعاليات الترفيهية، مثل حجز تذاكر لحضور أفلام في السينما أو حفلة موسيقية أو مسرح أو توقيع كتاب
- حجوزات السفر أو حجوزات الإقامة في الفنادق أو حجوزات الفعاليات، مثل الجولات الإرشادية وتذكرة دخول المتحف
- حجوزات الفعاليات الاجتماعية / الندوات / المؤتمرات
- حجوزات الجلسات التعليمية أو التدريبية
LodgingReservationEntity: يمثّل LodgingEntityReservation حجزًا للإقامة أثناء السفر ويساعد المستخدمين في تتبُّع الحجوزات القادمة أو الحجوزات الجارية للفنادق أو أماكن الاستئجار.
TransportationReservationEntity: يمثّل TransportationReservationEntity حجزًا لاستخدام أي وسيلة نقل، ويساعد المستخدمين في متابعة حجوزات الرحلات الجوية أو العبارات أو القطارات أو الحافلات أو المركبات التي يتم استدعاؤها أو الرحلات البحرية القادمة أو الجارية.
VehicleRentalReservationEntity: يمثّل VehicleRentalReservationEntity حجز استئجار المركبة ويساعد المستخدمين في تتبُّع حجوزات استئجار المركبات القادمة أو الجارية.
تعرض مجموعة التطبيقات المميّزة مجموعة من التطبيقات من عدة شركاء مطوّرين في مجموعة واحدة من واجهة المستخدم. ستكون هناك مجموعة واحدة مميّزة ، يتم عرضها بالقرب من أعلى واجهة المستخدم مع موضع أولوية فوق جميع مجموعات الاقتراحات. سيتم السماح لكل شريك مطوّر ببث ما يصل إلى 10 كيانات في المجموعة المميّزة.
GenericFeaturedEntity: يختلف 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) كيانات مختلفة لتمثيل كل نوع من أنواع السلع. نوفّر الكيانات التالية لفئة "سفر وفعاليات":
GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
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 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا) |
فئات المحتوى | اختياري | يصف هذا الحقل فئة المحتوى في العنصر. | قائمة التعدادات المؤهّلة
اطّلِع على قسم "فئة المحتوى" للحصول على إرشادات. |
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 حرفًا (قد يؤدي النص الطويل جدًا إلى عرض علامات حذف) |
فئات المحتوى | اختياري | يصف هذا الحقل فئة المحتوى في العنصر. | قائمة التعدادات المؤهّلة
اطّلِع على قسم "فئة المحتوى" للحصول على إرشادات. |
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، لكي لا يتم اقتطاعه على أحجام الشاشة الأصغر. |
سلسلة |
التقييم - قيمة العدد | اختياري | عدد التقييمات للحدث ملاحظة: قدِّم هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا كانت كلّ من السمتَين "العدد" و"قيمة العدد" متوفرتين، سنستخدم السمة "العدد" لعرضها للمستخدمين. |
الصيغة الطويلة |
فئات المحتوى | اختياري | يصف هذا الحقل فئة المحتوى في العنصر. | قائمة التعدادات المؤهّلة
اطّلِع على قسم "فئة المحتوى" للحصول على إرشادات. |
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 من الوصول إليها.
إرشادات لاستخدام فئات المحتوى
- إنّ بعض الكيانات، مثل ArticleEntity وGenericFeaturedEntity، مؤهَّلة لاستخدام أيّ من فئات المحتوى. بالنسبة إلى الكيانات الأخرى، مثل EventEntity وEventReservationEntity وPointOfInterestEntity، تكون فقط مجموعة فرعية من هذه الفئات مؤهَّلة. راجِع قائمة الفئات المؤهَّلة لنوع عنصر معيّن قبل تعبئة القائمة.
استخدِم نوع العنصر المحدّد لبعض فئات المحتوى بدلاً من تركيبة من العناصر العامة وContentCategory:
- TYPE_MOVIES_AND_TV_SHOWS: اطّلِع على الكيانات من دليل دمج Watch قبل استخدام الكيانات العامة.
- TYPE_BOOKS: اطّلِع على EbookEntity قبل استخدام الكيانات العامة.
- TYPE_AUDIOBOOKS: اطّلِع على AudiobookEntity قبل استخدام الكيانات العامة.
- TYPE_SHOPPING: اطّلِع على ShoppingEntity قبل استخدام الكيانات العامة.
- TYPE_FOOD_AND_DRINK: اطّلِع على الكيانات من دليل دمج البيانات الغذائية قبل استخدام الكيانات العامة.
حقل ContentCategory اختياري ويجب تركه فارغًا إذا كان المحتوى لا ينتمي إلى أي من الفئات المذكورة سابقًا.
في حال تقديم فئات محتوى متعددة، يجب تقديمها بترتيب تصاعدي تبعًا لمدى صلة كل فئة بالمحتوى، مع وضع فئة المحتوى الأكثر صلة أولاً في القائمة.
الخطوة 2: تقديم بيانات المجموعة
ننصحك بتنفيذ مهمة نشر المحتوى في الخلفية (على سبيل المثال، باستخدام WorkManager) وجدولتها بانتظام أو استنادًا إلى حدث (على سبيل المثال، في كل مرة يفتح فيها المستخدم التطبيق أو عندما يضيف مستخدم عنصرًا إلى سلة التسوّق).
تتحمّل "AppEngageTravelClient
" مسؤولية نشر المجموعات.
تتوفّر واجهات برمجة التطبيقات التالية لنشر المجموعات في العميل:
isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishReservationCluster
publishContinueSearchCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteReservationCluster
deleteContinueSearchCluster
deleteUserManagementCluster
deleteClusters
isServiceAvailable
تُستخدَم واجهة برمجة التطبيقات هذه للتحقّق مما إذا كانت الخدمة متاحة للدمج وما إذا كان يمكن عرض المحتوى على الجهاز.
Kotlin
client.isServiceAvailable.addOnCompleteListener { task -> if (task.isSuccessful) { // Handle IPC call success if(task.result) { // Service is available on the device, proceed with content publish // calls. } else { // Service is not available, no further action is needed. } } else { // The IPC call itself fails, proceed with error handling logic here, // such as retry. } }
Java
client.isServiceAvailable().addOnCompleteListener(task - > { if (task.isSuccessful()) { // Handle success if(task.getResult()) { // Service is available on the device, proceed with content publish // calls. } else { // Service is not available, no further action is needed. } } else { // The IPC call itself fails, proceed with error handling logic here, // such as retry. } });
publishRecommendationClusters
تُستخدَم واجهة برمجة التطبيقات هذه لنشر قائمة بعناصر RecommendationCluster
.
Kotlin
client.publishRecommendationClusters( PublishRecommendationClustersRequest.Builder() .addRecommendationCluster( RecommendationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .setTitle("Top Picks For You") .build() ) .build() )
Java
client.publishRecommendationClusters( new PublishRecommendationClustersRequest.Builder() .addRecommendationCluster( new RecommendationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .setTitle("Top Picks For You") .build()) .build());
عندما تتلقّى الخدمة الطلب، يتم تنفيذ الإجراءات التالية في معاملة واحدة:
- تتم إزالة بيانات
RecommendationCluster
الحالية من حساب شريك المطوّر. - يتم تحليل البيانات الواردة من الطلب وتخزينها في 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"، قد يتم نشر مجموعات الاقتراحات والتطبيقات المميّزة والتطبيقات المحجوزة و مواصلة البحث وعرضها للمستخدمين.