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

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

    يمكن أن يتّخذ محتوى المتابعة الهيكل التالي:

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

      الشكل 6. واجهة مستخدم تعرض عنصر ArticleEntity واحدًا ضمن مجموعة Continuation

    • ‫RestaurantReservationEntity: يمثّل RestaurantReservationEntity حجزًا لمطعم أو مقهى ويساعد المستخدمين في تتبُّع حجوزات المطاعم القادمة أو الحالية.

      الشكل 7. واجهة مستخدم تعرض عنصرًا واحدًا RestaurantReservationEntity ضمن مجموعة Continuation

    • ‫EventReservationEntity: يمثّل EventReservationEntity حجزًا لحدث ويساعد المستخدمين في تتبُّع الحجوزات القادمة أو الجارية للأحداث. يمكن أن تشمل الأحداث، على سبيل المثال لا الحصر، ما يلي:

      • الفعاليات الرياضية، مثل حجز مباراة كرة قدم
      • أحداث الألعاب، مثل حجز أماكن لفعاليات الرياضات الإلكترونية
      • الفعاليات الترفيهية، مثل حجز تذاكر لحضور أفلام في السينما أو حفلة موسيقية أو مسرح أو توقيع كتاب
      • حجوزات السفر أو نقاط الاهتمام، مثل الجولات الإرشادية وتذاكر المتاحف
      • حجوزات الفعاليات الاجتماعية / الندوات / المؤتمرات
      • حجوزات الدورات التدريبية أو التعليمية
      الشكل 8. واجهة مستخدم تعرض أداة EventBookEntity واحدة ضمن مجموعة متابعة.

    • ‫LodgingReservationEntity: يمثّل LodgingEntityReservation حجزًا لمكان إقامة أثناء السفر ويساعد المستخدمين في تتبُّع الحجوزات القادمة أو الحجوزات الجارية للفنادق أو أماكن الاستئجار.

      الشكل 9. واجهة مستخدم تعرض عنصرًا واحدًا من LodgingReservationEntity ضمن مجموعة Continuation

    • TransportationserveEntity: يمثل موقع TransferNetworkEntity حجز وسائل النقل بأي وسيلة نقل ويساعد المستخدمين في تتبُّع الحجوزات لرحلات الطيران المقبلة أو الجارية أو العبّارات أو القطار أو الحافلات أو طلبات النقل أو الرحلات البحرية.

      الشكل 10. واجهة مستخدم تعرض كيان نقل بيانات واحد ضمن مجموعة مواصلة.

    • ‫VehicleRentalReservationEntity: يمثّل VehicleRentalReservationEntity حجزًا لتأجير مركبة ويساعد المستخدمين في تتبُّع حجوزات تأجير المركبات القادمة أو الجارية.

      الشكل 11. واجهة مستخدم تعرض نقطة بيع مركبة RentalEntity واحدة ضمن مجموعة متابعة.

  • مجموعة التطبيقات المميّزة هي عرض لواجهة المستخدم يعرض التطبيق المميّز 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'
}

ملخّص

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

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

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

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

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

  1. GenericFeaturedEntity
  2. ArticleEntity
  3. EventEntity
  4. LodgingEntity
  5. StoreEntity
  6. PointOfInterestEntity
  7. PersonEntity
  8. RestaurantReservationEntity
  9. EventReservationEntity
  10. LodgingReservationEntity
  11. TransportationReservationEntity
  12. 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 حرفًا تقريبًا
وقت الانتهاء اختياري

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

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

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

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

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

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

حجم النص المقترَح: 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 - وقت الانتهاء اختياري الطابع الزمني لبدء حساب الفترة بالملي ثانية إلى أن يُتوقّع أن يكون مكان الإقامة مفتوحًا أو متاحًا. الطابع الزمني لحقبة 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، لكي لا يتم اقتطاعه على أحجام الشاشة الأصغر.

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

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

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

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

PointOfInterestEntity

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

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

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

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

سلسلة

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

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

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

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

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - المدينة مطلوبة المدينة التي تقع فيها نقطة الاهتمام

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع - العنوان المعروض مطلوبة عنوان نقطة الاهتمام التي سيتم عرضها للمستخدم.

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - عنوان الشارع اختياري عنوان الشارع (إن أمكن) لنقطة الاهتمام

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - الولاية اختياري الولاية أو المقاطعة (إن أمكن) التي يقع فيها نقطة الاهتمام

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - الرمز البريدي اختياري الرمز البريدي لنقطة الاهتمام (إن أمكن)

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - حي اختياري الحي (إن أمكن) الذي تقع فيه نقطة الاهتمام

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
AvailabilityTimeWindow - Start Time اختياري الطابع الزمني لبدء الحقبة بالملي ثانية عندما يكون من المفترض أن تكون نقطة الاهتمام متاحة. الطابع الزمني لحقبة Unix بالملي ثانية
availabilityTimeWindow - وقت الانتهاء اختياري الطابع الزمني لبدء الحقبة بالمللي ثانية إلى أن يُتوقّع أن تكون نقطة الاهتمام متاحة. الطابع الزمني للحقبة بالمللي ثانية
الشارات اختياري

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

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

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

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

 الصيغة الطويلة
الموقع الجغرافي - البلد اختياري البلد الذي يقيم فيه الشخص أو يخدمه.

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - المدينة اختياري المدينة التي يقيم فيها الشخص أو يعمل فيها

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي: عنوان العرض اختياري سيتم عرض العنوان الذي يقيم فيه الشخص أو يقدّم فيه الخدمة للمستخدم.

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - عنوان الشارع اختياري عنوان الشارع (إن وُجد) الذي يقيم فيه الشخص أو يعمل فيه

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - الولاية اختياري الولاية (إن أمكن) التي يقيم فيها الشخص أو يعمل فيها

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

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

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

حجم النص المقترَح: 20 حرفًا بحد أقصى
الموقع الجغرافي - حي اختياري الحي (إن وُجد) الذي يقع فيه الشخص أو يقدم خدماته.

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

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

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

عنوان الشارة

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

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

حجم النص المقترَح: 15 حرفًا بحد أقصى
الشارة - صورة اختياري

صورة صغيرة

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

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

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

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

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

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

حجم النص المقترَح: 180 حرفًا
قائمة الترجمة اختياري

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

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

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

حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحدّ أقصى
فئات المحتوى اختياري يصف هذا الحقل فئة المحتوى في العنصر.

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

  • TYPE_HEALTH_AND_FITENESS (مثال: مدرّب يوغا/لياقة بدنية)
  • TYPE_home_AND_auto (مثال - سباك)
  • ‫TYPE_SPORTS (مثال: لاعب)
  • الكتابة

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

RestaurantReservationEntity

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

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

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

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

سلسلة

حجم النص المقترَح: 50 حرفًا بحد أقصى
وقت بدء الحجز مطلوبة تشير هذه السمة إلى الطابع الزمني للحقبة بالملي ثانية التي كان من المتوقّع أن يبدأ الحجز خلالها. الطابع الزمني للحقبة بالمللي ثانية
الموقع الجغرافي - البلد مطلوب البلد الذي يقع فيه المطعم

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

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

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

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

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

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

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

  • ‫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 حرفًا بحد أقصى
وقت الوصول مطلوبة الطابع الزمني لبدء الحقبة بالمللي ثانية الذي يمثّل وقت تسجيل المغادرة للحجز الطابع الزمني للحقبة بالمللي ثانية
وقت المغادرة مطلوبة تشير هذه السمة إلى الطابع الزمني للحقبة بالمللي ثانية والتي تمثّل وقت إتمام الدفع الخاص بالحجز. الطابع الزمني للحقبة بالمللي ثانية
الموقع الجغرافي - البلد مطلوب تمثّل هذه السمة البلد الذي يقع فيه مكان الإقامة.

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

حجم النص المقترَح: 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
وقت المغادرة مطلوب الطابع الزمني لبدء الحقبة بالملي ثانية الذي يمثّل وقت المغادرة الطابع الزمني لحقبة 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 حرفًا (قد تظهر علامات حذف في النص الطويل جدًا)

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

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

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

مربّع (1x1)

مفضّل

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

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

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

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

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

5,120 كيلوبايت

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

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

فئة المحتوى

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

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

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

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

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

  2. استخدم نوع الكيان المحدد لبعض فئات المحتوى على مجموعة من الكيانات العامة وContentCategory:

    • ‫TYPE_MOVIES_AND_TV_SHOWS: اطّلِع على الكيانات من دليل دمج Watch قبل استخدام الكيانات العامة.
    • ‫TYPE_BOOKS: اطّلِع على EbookEntity قبل استخدام الكيانات العامة.
    • TYPE_AUDIOBOOKS - راجع AudiobookEntity قبل استخدام الكيانات العامة.
    • ‫TYPE_SHOPPING: اطّلِع على ShoppingEntity قبل استخدام الكيانات العامة.
    • TYPE_FOOD_AND_DRINK - يُرجى الاطّلاع على الكيانات من Food Integration guide قبل استخدام العناصر العامة.

  3. حقل ContentCategory اختياري ويجب تركه فارغًا إذا كان المحتوى لا ينتمي إلى أي من الفئات المذكورة سابقًا.

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

الخطوة 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 == 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 API التي تحتوي على رمز الحالة NOT_MANAGEED_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.

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: معالجة نوايا البث

بالإضافة إلى إجراء طلبات البيانات من واجهة برمجة التطبيقات Publishing API من خلال المهام، يجب أيضًا إعداد 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، قد يتم نشر مجموعات الاقتراحات والمحتوى المميّز والمحتوى الذي يتابعه المستخدمون وتصبح مرئية للمستخدمين.