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

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

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

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

تفاصيل الدمج

المصطلحات

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

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

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

العمل التمهيدي

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

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

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

ملخّص

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

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

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

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

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

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
PersonEntity
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 حرفًا بحد أقصى
وقت البدء	مطلوبة	الطابع الزمني لبدء الفترة الزمنية عندما يُتوقّع بدء الحدث ملاحظة: سيتم تمثيل هذا المقياس بالملي ثانية.	الطابع الزمني لحقبة Unix بالملي ثانية
وضع الحدث	مطلوبة	حقل للإشارة إلى ما إذا كان الحدث سيكون افتراضيًا أو بالحضور الشخصي أو كلاهما	نوع متغير معرّف: 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 - Start Time	اختياري	الطابع الزمني لبدء الحقبة بالملي ثانية عندما يُتوقّع أن يكون مكان الإقامة مفتوحًا/متاحًا	الطابع الزمني لحقبة Unix بالملي ثانية
AvailabilityTimeWindow - End Time	اختياري	الطابع الزمني لبدء حساب الفترة بالملي ثانية إلى أن يُتوقّع أن يكون مكان الإقامة مفتوحًا/متاحًا.	الطابع الزمني لحقبة Unix بالملي ثانية
التقييم - الحد الأقصى للقيمة	اختياري	الحد الأقصى لقيمة مقياس التقييم. يجب تقديمها إذا تم تقديم القيمة الحالية للتقييم أيضًا.	يجب أن يكون الرقم أكبر من أو يساوي 0.0.
التقييم - القيمة الحالية	اختياري	القيمة الحالية لمقياس التقييم يجب تقديمها إذا تم تقديم الحد الأقصى لقيمة التقييم أيضًا.	يجب أن يكون الرقم أكبر من أو يساوي 0.0.
التقييم - العدد	اختياري	عدد تقييمات مكان الإقامة ملاحظة: قدِّم هذا الحقل إذا كان تطبيقك يتحكّم في طريقة عرض العدد للمستخدمين. استخدِم سلسلة موجزة. على سبيل المثال، إذا كان العدد 1,000,000، ننصحك باستخدام اختصار مثل 1M لكي لا يتم اقتطاع العدد على أحجام الشاشة الأصغر.	سلسلة
التقييم - قيمة العدد	اختياري	عدد تقييمات مكان الإقامة ملاحظة: قدِّم هذا الحقل إذا لم تكن تتعامل بنفسك مع منطق الاختصار المعروض. إذا كانت كلّ من السمتَين "العدد" و"قيمة العدد" متوفرتين، يتم عرض السمة "العدد" للمستخدمين.	الصيغة الطويلة
السعر - CurrentPrice	مطلوبة بشروط	السعر الحالي للإقامة. يجب تقديمه إذا تم تقديم سعر مشطوب.	حقل التعبئة النصّية الحرّة
السعر - السعر الأصلي المشطوب	اختياري	السعر الأصلي للإقامة، والذي يتم شطبه في واجهة المستخدِم	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	عبارة توضيحية للسعر لعرض عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

`StoreEntity`

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

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

`PointOfInterestEntity`

السمة	المتطلب	الوصف	التنسيق
معرّف الموارد المنتظم (URI) للإجراء	مطلوبة	رابط لصفحة في التطبيق ينقل إلى الكيان ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد المصدر. يُرجى الرجوع إلى هذه الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	عنوان الكيان	سلسلة حجم النص المقترَح: 50 حرفًا بحد أقصى
صور الملصقات	مطلوبة	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: ننصح بشدة باستخدام صورة. إذا تم استخدام شارة، يجب ترك مساحة آمنة تبلغ 24 بكسل في الثانية في أعلى وأسفل الصورة.	اطّلِع على مواصفات الصور للحصول على إرشادات.
الموقع الجغرافي - البلد	مطلوبة	البلد الذي تحدث فيه نقطة الاهتمام	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - المدينة	مطلوبة	المدينة التي تقع فيها نقطة الاهتمام	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي: عنوان العرض	مطلوبة	عنوان نقطة الاهتمام التي سيتم عرضها للمستخدم	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي: عنوان الشارع	اختياري	عنوان الشارع (إن أمكن) لنقطة الاهتمام	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - الولاية	اختياري	الولاية أو المقاطعة (إن أمكن) التي يقع فيها نقطة الاهتمام	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	الرمز البريدي لنقطة الاهتمام (إن أمكن)	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي: الحي	اختياري	الحي (إن أمكن) الذي تقع فيه نقطة الاهتمام	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
AvailabilityTimeWindow - Start Time	اختياري	الطابع الزمني لبدء الحقبة بالملي ثانية عندما يكون من المفترض أن تكون نقطة الاهتمام متاحة.	الطابع الزمني لحقبة Unix بالملي ثانية
AvailabilityTimeWindow - End Time	اختياري	الطابع الزمني لبدء الحقبة بالمللي ثانية إلى أن يُتوقّع أن تكون نقطة الاهتمام متاحة.	الطابع الزمني لحقبة Unix بالملي ثانية
الشارات	اختياري	كل شارة هي إما نص حر (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 (مثال: ملعب) اطّلِع على قسم "فئة المحتوى" للحصول على إرشادات.

`PersonEntity`

السمة	المتطلب	الوصف	التنسيق
معرّف الموارد المنتظم (URI) للإجراء	مطلوبة	رابط لصفحة في التطبيق ينقل إلى الكيان ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد المصدر. يُرجى الرجوع إلى هذه الأسئلة الشائعة	معرّف موارد منتظم (URI)
الملف الشخصي - الاسم	مطلوبة	اسم الملف الشخصي أو رقم تعريفه أو الاسم المعرِّف، مثل "سعد كمال" أو "‎@TeamPixel" أو غير ذلك	سلسلة حجم النص المقترَح: 50 حرفًا بحد أقصى
الملف الشخصي - الصورة الرمزية	مطلوبة	صورة الملف الشخصي أو الصورة الرمزية للمستخدم ملاحظة: يجب أن تكون الصورة مربّعة بنسبة عرض إلى ارتفاع 1:1.	اطّلِع على مواصفات الصور للحصول على إرشادات.
الملف الشخصي - نص إضافي	اختياري	نص حر مثل الاسم المعرِّف للملف التجاري	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 15 حرفًا بحد أقصى
الملف الشخصي - صورة إضافية	اختياري	صورة صغيرة، مثل شارة إثبات الملكية	اطّلِع على مواصفات الصور للحصول على إرشادات.
صورة العنوان	اختياري	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: ننصح بشدة باستخدام صورة. إذا تم استخدام شارة، يجب ترك مساحة آمنة تبلغ 24 بكسل في الثانية في أعلى وأسفل الصورة.	اطّلِع على مواصفات الصور للحصول على إرشادات.
مدى الرواج - العدد	اختياري	حدِّد عدد المتابعين أو قيمة مدى الرواج، على سبيل المثال: "3.7 مليون". ملاحظة: في حال توفّر كلّ من "العدد" و"قيمة العدد"، سيتم استخدام "العدد".	سلسلة حجم النص المقترَح: 20 حرفًا بحد أقصى للعدد + التصنيف معًا
مدى الرواج - قيمة العدد	اختياري	عدد المتابعين أو قيمة مدى رواج المحتوى ملاحظة: قدِّم قيمة العدد إذا كان تطبيقك لا يريد التعامل مع المنطق الخاص بكيفية تحسين عدد كبير من أجل أحجام شاشات مختلفة. في حال توفير كلّ من "العدد" و"قيمة العدد"، سيتم استخدام "العدد".	الصيغة الطويلة
مدى الرواج - التصنيف	اختياري	حدِّد تصنيف مدى الرواج. على سبيل المثال، "الإعجابات".	سلسلة حجم النص المُقترَح: 20 حرفًا بحد أقصى للعدد + التصنيف معًا
مدى الرواج - المحتوى المرئي	اختياري	حدِّد الغرض من التفاعل. على سبيل المثال، صورة تعرض رموز الإعجاب ورموز الإيموجي يمكن تقديم أكثر من صورة واحدة، ولكن قد لا يتم عرض بعضها على جميع أشكال الأجهزة. ملاحظة: يجب أن تكون الصورة مربّعة بنسبة عرض إلى ارتفاع 1:1.	اطّلِع على مواصفات الصور للحصول على إرشادات.
التقييم - الحد الأقصى للقيمة	مطلوب	الحد الأقصى لقيمة مقياس التقييم. يجب تقديمها إذا تم تقديم القيمة الحالية للتقييم أيضًا.	يجب أن يكون الرقم أكبر من أو يساوي 0.0.
التقييم - القيمة الحالية	مطلوب	القيمة الحالية لمقياس التقييم يجب تقديمها إذا تم تقديم الحد الأقصى لقيمة التقييم أيضًا.	يجب أن يكون الرقم أكبر من أو يساوي 0.0.
التقييم - العدد	اختياري	عدد تقييمات الكيان ملاحظة: قدِّم هذا الحقل إذا كان تطبيقك يريد التحكّم في طريقة عرض هذا المحتوى للمستخدمين. قدِّم السلسلة الموجزة التي يمكن عرضها للمستخدم. على سبيل المثال، إذا كان العدد هو 1,000,000، ننصحك باستخدام اختصارات مثل 1M، لكي لا يتم اقتطاعه على أحجام الشاشة الأصغر.	سلسلة
التقييم - قيمة العدد	اختياري	عدد تقييمات الكيان ملاحظة: قدِّم هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا كانت كلّ من السمتَين Count وCount Value متوفرَتَين، سنستخدم السمة Count لعرضها للمستخدمين.	الصيغة الطويلة
الموقع الجغرافي - البلد	اختياري	البلد الذي يقيم فيه الشخص أو يخدم فيه	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - المدينة	اختياري	المدينة التي يقيم فيها الشخص أو يعمل فيها	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي: عنوان العرض	اختياري	سيتم عرض العنوان الذي يقيم فيه الشخص أو يقدّم فيه الخدمة للمستخدم.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي: عنوان الشارع	اختياري	عنوان الشارع (إن وُجد) الذي يقيم فيه الشخص أو يعمل فيه	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - الولاية	اختياري	الولاية (إن أمكن) التي يقيم فيها الشخص أو يعمل فيها	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	الرمز البريدي (إن أمكن) للمكان الذي يقيم فيه الشخص أو يعمل فيه	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي: الحي	اختياري	الحي (إن وُجد) الذي يقيم فيه الشخص أو يقدّم فيه الخدمة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الشارات	اختياري	كل شارة هي إما نص حر (15 حرفًا بحد أقصى) أو صورة صغيرة.
الشارة - النص	اختياري	عنوان الشارة ملاحظة: يجب إدخال نص أو صورة للشارة.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 15 حرفًا بحد أقصى
الشارة - صورة	اختياري	صورة صغيرة معالجة خاصة لتجربة المستخدم، مثل تراكب الشارة على الصورة/فيديو الصورة المصغّرة ملاحظة: يجب إدخال نص أو صورة للشارة.	اطّلِع على مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة واحدة من النص لوصف العنصر ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة	اختياري	ما يصل إلى 3 ترجمات مصاحبة، يكون كلّ منها سطرًا واحدًا من النص ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل ترجمة: 50 حرفًا بحدٍ أقصى
فئات المحتوى	اختياري	يصف هذا الحقل فئة المحتوى في العنصر.	قائمة التعدادات المؤهَّلة TYPE_HEALTH_AND_FITENESS (مثال: مدرّب يوغا/لياقة بدنية) ‫TYPE_HOME_AND_AUTO (مثال: سباك) ‫TYPE_SPORTS (مثال: لاعب) TYPE_DATING اطّلِع على قسم "فئة المحتوى" للحصول على إرشادات.

`RestaurantReservationEntity`

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

`EventReservationEntity`

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

`LodgingReservationEntity`

السمة	المتطلب	الوصف	التنسيق
معرّف الموارد المنتظم (URI) للإجراء	مطلوبة	رابط لصفحة في التطبيق ينقل إلى الكيان ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد المصدر. يُرجى الرجوع إلى هذه الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	عنوان الكيان	نص حر على سبيل المثال، "إقامتك من 12 كانون الأول (ديسمبر)" حجم النص المقترَح: 50 حرفًا بحد أقصى
وقت تسجيل الوصول	مطلوبة	الطابع الزمني لبدء الحقبة بالمللي ثانية الذي يمثّل وقت تسجيل المغادرة للحجز	الطابع الزمني لحقبة Unix بالملي ثانية
وقت المغادرة	مطلوبة	الطابع الزمني لبدء الحقبة بالمللي ثانية الذي يمثّل وقت المغادرة للحجز	الطابع الزمني لحقبة Unix بالملي ثانية
الموقع الجغرافي - البلد	مطلوبة	البلد الذي يقع فيه مكان الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - المدينة	مطلوبة	المدينة التي يقع فيها مكان الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي: عنوان العرض	مطلوبة	عنوان مكان الإقامة الذي سيتم عرضه للمستخدم	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي: عنوان الشارع	اختياري	عنوان الشارع (إن أمكن) للمكان المخصّص للإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - الولاية	اختياري	الولاية أو المقاطعة (إن أمكن) التي يقع فيها مكان الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - الرمز البريدي	اختياري	الرمز البريدي (إن أمكن) للمكان المخصّص للإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي: الحي	اختياري	الحي (إن أمكن) الذي يقع فيه مكان الإقامة	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 20 حرفًا بحد أقصى
صور الملصقات	اختياري	سنعرض صورة واحدة فقط عند تقديم صور متعددة. نسبة العرض إلى الارتفاع المقترَحة هي 16:9 ملاحظة: في حال تقديم شارة، تأكَّد من توفير مساحة آمنة تبلغ 24 بكسل في الثانية في أعلى وأسفل الصورة.	اطّلِع على مواصفات الصور للحصول على إرشادات.
الوصف	اختياري	فقرة واحدة من النص لوصف العنصر ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 180 حرفًا
قائمة الترجمة	اختياري	ما يصل إلى 3 ترجمات مصاحبة، يكون كلّ منها سطرًا واحدًا من النص ملاحظة: سيتم إما عرض الوصف أو قائمة الترجمة والشرح للمستخدم، وليس كليهما.	حقل التعبئة النصّية الحرّة حجم النص المقترَح لكل ترجمة: 50 حرفًا بحدٍ أقصى
رقم تعريف الحجز	اختياري	معرّف الحجز لحجز الإقامة	حقل التعبئة النصّية الحرّة
التقييم - الحد الأقصى للقيمة	اختياري	الحد الأقصى لقيمة مقياس التقييم. يجب تقديمها إذا تم تقديم القيمة الحالية للتقييم أيضًا.	يجب أن يكون الرقم أكبر من أو يساوي 0.0.
التقييم - القيمة الحالية	اختياري	القيمة الحالية لمقياس التقييم يجب تقديمها إذا تم تقديم الحد الأقصى لقيمة التقييم أيضًا.	يجب أن يكون الرقم أكبر من أو يساوي 0.0.
التقييم - العدد	اختياري	عدد تقييمات مكان الإقامة ملاحظة: قدِّم هذا الحقل إذا كان تطبيقك يريد التحكّم في طريقة عرض هذا المحتوى للمستخدمين. قدِّم السلسلة الموجزة التي يمكن عرضها للمستخدم. على سبيل المثال، إذا كان العدد هو 1,000,000، ننصحك باستخدام اختصارات مثل 1M، لكي لا يتم اقتطاعه على أحجام الشاشة الأصغر.	سلسلة
التقييم - قيمة العدد	اختياري	عدد تقييمات مكان الإقامة ملاحظة: قدِّم هذا الحقل إذا كنت لا تريد التعامل مع منطق الاختصار المعروض بنفسك. إذا كانت كلّ من السمتَين Count وCount Value متوفرَتَين، سنستخدم السمة Count لعرضها للمستخدمين.	الصيغة الطويلة
السعر - CurrentPrice	مطلوبة بشروط	السعر الحالي للإقامة. يجب تقديمه إذا تم تقديم سعر مشطوب.	حقل التعبئة النصّية الحرّة
السعر - السعر الأصلي المشطوب	اختياري	السعر الأصلي للإقامة، والذي يتم شطبه في واجهة المستخدِم	حقل التعبئة النصّية الحرّة
وسيلة شرح السعر	اختياري	عبارة توضيحية للسعر لعرض عرض ترويجي أو حدث أو خصم للمشتركين، إذا كان ذلك متاحًا	حقل التعبئة النصّية الحرّة حجم النص المقترَح: أقل من 45 حرفًا (قد تظهر علامات حذف إذا كان النص طويلاً جدًا)

`TransportationReservationEntity`

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

`VehicleRentalReservationEntity`

السمة	المتطلب	الوصف	التنسيق
معرّف الموارد المنتظم (URI) للإجراء	مطلوبة	رابط لصفحة في التطبيق ينقل إلى الكيان ملاحظة: يمكنك استخدام الروابط لصفحات في التطبيق لتحديد المصدر. يُرجى الرجوع إلى هذه الأسئلة الشائعة	معرّف موارد منتظم (URI)
العنوان	مطلوبة	عنوان الكيان	نص حر على سبيل المثال، "Avis Union Square SF" حجم النص المقترَح: 50 حرفًا بحد أقصى
وقت الاستلام	مطلوبة	الطابع الزمني لبدء حساب الفترة الذي يمثّل وقت استلام الحجز	الطابع الزمني لحقبة Unix بالملي ثانية
وقت العودة	اختياري	الطابع الزمني لبدء حساب الفترة الذي يمثّل وقت المغادرة للحجز	الطابع الزمني لحقبة Unix بالملي ثانية
عنوان الاستلام - البلد	اختياري	بلد الموقع الجغرافي لاستلام الطلب	حقل التعبئة النصّية الحرّة حجم النص المقترَح: 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

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

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

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

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

تتحمّل "AppEngagePublishClient" مسؤولية نشر المجموعات.

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

isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
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 الحالية من حساب شريك المطوّر.
يتم تحليل البيانات الواردة من الطلب وتخزينها في "مجموعة الإعلانات المميّزة" المعدّلة.

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

`publishContinuationCluster`

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

Kotlin

client.publishContinuationCluster(
    PublishContinuationClusterRequest.Builder()
      .setContinuationCluster(
        ContinuationCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishContinuationCluster(
            new PublishContinuationClusterRequest.Builder()
                .setContinuationCluster(
                    new ContinuationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

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

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

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

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

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

`deleteContinuationCluster`

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

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

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

`deleteUserManagementCluster`

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

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

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

`deleteClusters`

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

Kotlin

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

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_CONTINUATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .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
  // Trigger continuation cluster publish when PUBLISH_CONTINUATION 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))

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}

Java

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

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continuation cluster publish when PUBLISH_CONTINUATION 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));

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

}

حدِّد التنفيذ بشكلٍ ثابت باستخدام علامة <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>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
      </intent-filter>
   </receiver>
</application>

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

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

سير عمل الدمج

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

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

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

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

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

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

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

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

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

تفاصيل الدمج

المصطلحات

العمل التمهيدي

ملخّص

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

GenericFeaturedEntity

ArticleEntity

EventEntity

LodgingEntity

StoreEntity

PointOfInterestEntity

PersonEntity

RestaurantReservationEntity

EventReservationEntity

LodgingReservationEntity

TransportationReservationEntity

VehicleRentalReservationEntity

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

فئة المحتوى

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

isServiceAvailable

Kotlin

Java

publishRecommendationClusters

Kotlin

Java

publishFeaturedCluster

Kotlin

Java

publishContinuationCluster

Kotlin

Java

publishUserAccountManagementRequest

Kotlin

Java

updatePublishStatus

Kotlin

Java

deleteRecommendationClusters

Kotlin

Java

deleteFeaturedCluster

Kotlin

Java

deleteContinuationCluster

Kotlin

Java

deleteUserManagementCluster

Kotlin

Java

deleteClusters

Kotlin

Java

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

Kotlin

Java

الخطوة 3: معالجة نوايا البث

Kotlin

Java

سير عمل الدمج

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

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

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

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

`GenericFeaturedEntity`

`ArticleEntity`

`EventEntity`

`LodgingEntity`

`StoreEntity`

`PointOfInterestEntity`

`PersonEntity`

`RestaurantReservationEntity`

`EventReservationEntity`

`LodgingReservationEntity`

`TransportationReservationEntity`

`VehicleRentalReservationEntity`

`isServiceAvailable`

`publishRecommendationClusters`

`publishFeaturedCluster`

`publishContinuationCluster`

`publishUserAccountManagementRequest`

`updatePublishStatus`

`deleteRecommendationClusters`

`deleteFeaturedCluster`

`deleteContinuationCluster`

`deleteUserManagementCluster`

`deleteClusters`