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

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

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

المصطلحات

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

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

    • يمكن أن تتألف مجموعة الاقتراحات من بطاقات بيانات ArticleEntity أو EventEntity أو LodgingEntity أو PointOfInterestEntity أو StoreEntity، ولكنها لا يمكن أن تتألف من مزيج من أنواع مختلفة من الكيانات.

    تأخذ توصياتك البنية التالية:

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

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

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

        الشكل 1: واجهة مستخدم تعرض كيانًا واحدًا للمقالات ضمن مجموعة "الاقتراحات".

      • EventEntity: يمثل EventEntity حدثًا يجري في المستقبل. يعد وقت بدء الحدث جزءًا مهمًا من المعلومات التي يجب نقلها إلى المستخدمين.

        الشكل 2: واجهة مستخدم تعرض كيانًا واحدًا (EventEntity) ضمن مجموعة "الاقتراحات".

      • LodgingEntity: يمثل LodgingEntity مكان إقامة، مثل فندق أو شقة أو منزل عطلات للإيجار لفترة قصيرة أو طويلة.

        الشكل 3: واجهة مستخدم تعرض كيانًا واحدًا سكنيًا ضمن مجموعة "الاقتراحات".

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

        الشكل 4: واجهة مستخدم تعرض عنصر StoreEntity واحدًا ضمن مجموعة "الاقتراحات".

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

        الشكل 5: واجهة مستخدم تعرض نقطة PointOfinterestEntity واحدة ضمن مجموعة "الاقتراحات"

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

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

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

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

    • RestaurantحجزEntity: يمثل RestaurantRestaurantEntity حجزًا لمطعم أو مقهى، كما يساعد المستخدمين على تتبع حجوزات المطاعم القادمة أو المستمرة.

      الشكل 7. واجهة مستخدم تعرض كيانًا واحدًا لمطعم Restaurantالحجوزات ضمن مجموعة متابعة.

    • EventحجزEntity: يمثل EventحجزEntity حجزًا لحدث ويساعد المستخدمين على تتبع حجوزات الأحداث القادمة أو المستمرة. يمكن أن تتضمن الأحداث، على سبيل المثال لا الحصر، ما يلي:

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

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

      الشكل 9. واجهة مستخدم تعرض كيانًا واحدًا لـ LodgingحجزEntity ضمن مجموعة متابعة.

    • TransportationحجزEntity: تمثِّل شركة Transferعمليات حجز وسائل النقل بأي وسيلة نقل، كما تساعد المستخدمين على تتبُّع حجوزات الرحلات الجوية القادمة أو الجارية أو العبّارات أو القطارات أو الحافلة أو طلبات التنقّل أو الرحلات البحرية.

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

    • VehicleRentalحجزEntity: تمثِّل شركة AutomotiveRentalEntity حجز تأجير السيارات وتساعد المستخدمين على تتبُّع حجوزات استئجار المركبات القادمة أو الجارية.

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

  • مجموعة المميّزة هي عرض واجهة مستخدم تُظهر الصورة الرئيسية GenericFeaturedEntity التي تم اختيارها من بين العديد من شركاء المطوّرين في مجموعة واحدة لواجهة المستخدم. هناك مجموعة "مميزة" واحدة تظهر بالقرب من أعلى واجهة المستخدم، مع وضع أولوية أعلى من كل مجموعات الاقتراحات. يُسمح لكل شريك مطوّر ببث كيان واحد من نوع متوافق في "المحتوى المميّز"، مع العديد من الكيانات (التي يُحتمَل أن تكون من أنواع مختلفة) من مطوّري تطبيقات متعددين في المجموعة "المميزة".

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

      الشكل 12: واجهة مستخدم تعرض مجموعة مميّزة مع قائمة عامة تتضمّن محتوى مميّزًا عامًا

ما قبل العمل

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

إضافة مكتبة com.google.android.play:engage إلى تطبيقك:

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

الملخّص

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

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

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

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

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

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

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

GenericFeaturedEntity

السمة المتطلب الوصف التنسيق
يوري أدنيش مطلوبة

رابط لصفحة معيّنة في تطبيق مقدّم الخدمة

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

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

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

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

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

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

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

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

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

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

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

ما يصل إلى 3 ترجمات، كل عنوان فرعي، سطر واحد من النص.

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

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

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

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

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

  • على سبيل المثال: "تحديث مباشر"
  • على سبيل المثال: مدة قراءة المقالة
شارة - نص اختياري

عنوان الشارة

ملاحظة: يجب إضافة نص أو صورة إلى الشارة.

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

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

صورة صغيرة

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

ملاحظة: يجب إضافة نص أو صورة إلى الشارة.

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

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

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

ArticleEntity

السمة المتطلب الوصف التنسيق
يوري أدنيش مطلوبة

رابط لصفحة معيّنة في تطبيق مقدّم الخدمة

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

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

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

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

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

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

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

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

حجم النص المقترَح: أقل من 25 حرفًا
المصدر - الصور اختياري صورة للمصدر، مثل المؤلف أو المؤسسة أو المراسل الصحفي يمكنك الاطّلاع على مواصفات الصور للحصول على إرشادات.
الوصف اختياري

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

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

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

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

ما يصل إلى 3 ترجمات، كل عنوان فرعي، سطر واحد من النص.

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

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

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

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

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

  • على سبيل المثال: "تحديث مباشر"
  • على سبيل المثال: مدة قراءة المقالة
شارة - نص اختياري

عنوان الشارة

ملاحظة: يجب إضافة نص أو صورة إلى الشارة.

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

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

صورة صغيرة

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

ملاحظة: يجب إضافة نص أو صورة إلى الشارة.

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

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

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

 الطابع الزمني للفترة بالمللي ثانية
النسبة المئوية لمستوى التقدُّم مطلوب بشروط

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

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

 قيمة عدد صحيح تتراوح من 0 إلى 100 ضمنًا.
فئات المحتوى اختياري يُرجى وصف فئة المحتوى في الكيان.

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

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

EventEntity

السمة المتطلب الوصف التنسيق
يوري أدنيش مطلوبة

رابط لصفحة معيّنة في تطبيق مقدّم الخدمة

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

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

سلسلة

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

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

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

 الطابع الزمني للفترة بالمللي ثانية
وضع الحدث مطلوبة

حقل للإشارة إلى ما إذا كانت الفعالية افتراضية أو بالحضور الشخصي أو كليهما.

 التعداد: 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 حرفًا كحد أقصى
الشارة - صورة اختياري

صورة صغيرة

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

ملاحظة: يجب إضافة نص أو صورة إلى الشارة.

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

السعر الحالي للتذكرة أو التذكرة الخاصة بالفعالية.

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

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

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

حجم النص المقترَح: أقل من 45 حرفًا (قد يعرض النص الطويل جدًا علامات حذف)
فئات المحتوى اختياري يُرجى وصف فئة المحتوى في الكيان.

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

  • TYPE_VIDEOS_AND_TV_SHOWS (مثل السينما)
  • TYPE_numericAL_GAMES (مثل الرياضة الإلكترونية)
  • TYPE_MUSIC (مثل حفلة موسيقية)
  • TYPE_TRAVEL_AND_LOCAL (مثل جولة أو مهرجان)
  • TYPE_HEALTH_AND_FITENESS (مثل فصل اليوغا)
  • TYPE_EDUCATION (مثل صف)
  • TYPE_SPORTS (مثل مباراة كرة القدم)
  • TYPE_DAING (مثل لقاء)

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

LodgingEntity

السمة المتطلب الوصف التنسيق
يوري أدنيش مطلوبة

رابط لصفحة معيّنة في تطبيق مقدّم الخدمة

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

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

سلسلة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عنوان الشارة

ملاحظة: يجب إضافة نص أو صورة إلى الشارة.

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

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

صورة صغيرة

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

ملاحظة: يجب إضافة نص أو صورة إلى الشارة.

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

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

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

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

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

ما يصل إلى 3 ترجمات، كل عنوان فرعي، سطر واحد من النص.

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

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

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

تمثّل هذه السمة القيمة القصوى لمقياس التقييم.

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

 الرقم >= 0.0
التقييم - القيمة الحالية اختياري

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

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

 الرقم >= 0.0
التقييم - العدد اختياري

تمثّل هذه السمة عدد تقييمات المكان المخصّص للاستئجار.

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

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

تمثّل هذه السمة عدد تقييمات المكان المخصّص للاستئجار.

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

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

تمثّل هذه السمة السعر الحالي للإقامة.

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

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

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

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

StoreEntity

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

السمة المتطلب الوصف التنسيق
صور الملصق مطلوبة يجب تقديم صورة واحدة على الأقل. يمكنك الاطّلاع على مواصفات الصور للحصول على إرشادات.
يوري أدنيش مطلوبة

رابط لصفحة معيّنة في تطبيق مقدّم الخدمة

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

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

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

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

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

حجم النص المقترَح: أقل من 45 حرفًا (قد يعرض النص الطويل جدًا علامات حذف)
وسيلة الشرح اختياري وسيلة شرح لعرض عرض ترويجي أو حدث أو تحديث للمتجر، في حال توفّرها.

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

حجم النص المقترَح: أقل من 45 حرفًا (قد يعرض النص الطويل جدًا علامات حذف)
النص المكتوب كوسائل شرح اختياري النص المطبوع الدقيق لوسيلة الشرح.

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

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

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

حجم النص المقترَح: أقل من 90 حرفًا (قد يعرض النص الطويل جدًا علامات حذف)
التقييم - الحدّ الأقصى للقيمة اختياري

تمثّل هذه السمة القيمة القصوى لمقياس التقييم.

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

 الرقم >= 0.0
التقييم - القيمة الحالية اختياري

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

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

 الرقم >= 0.0
التقييم - العدد اختياري

تمثّل هذه السمة عدد تقييمات المكان المخصّص للاستئجار.

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

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

تمثّل هذه السمة عدد تقييمات المكان المخصّص للاستئجار.

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

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

PointOfInterestEntity

السمة المتطلب الوصف التنسيق
يوري أدنيش مطلوبة

رابط لصفحة معيّنة في تطبيق مقدّم الخدمة

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

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

سلسلة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

حجم النص المقترَح: 20 حرفًا تقريبًا
availabilityWindow - وقت البدء اختياري الطابع الزمني للحقبة بالمللي ثانية عندما يكون من المتوقّع أن تكون نقطة الاهتمام مفتوحة/متاحة الطابع الزمني للفترة بالمللي ثانية
availabilityWindow - وقت الانتهاء اختياري الطابع الزمني للفترة بالمللي ثانية والذي يُتوقّع أن تكون فيه نقطة الاهتمام مفتوحة/متاحة الطابع الزمني للفترة بالمللي ثانية
الشارات اختياري

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

عنوان الشارة

ملاحظة: يجب إضافة نص أو صورة إلى الشارة.

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

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

صورة صغيرة

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

ملاحظة: يجب إضافة نص أو صورة إلى الشارة.

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

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

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

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

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

ما يصل إلى 3 ترجمات، كل عنوان فرعي، سطر واحد من النص.

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

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

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

تمثّل هذه السمة القيمة القصوى لمقياس التقييم.

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

 الرقم >= 0.0
التقييم - القيمة الحالية اختياري

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

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

 الرقم >= 0.0
التقييم - العدد اختياري

تمثّل هذه السمة عدد التقييمات لنقطة الاهتمام.

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

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

تمثّل هذه السمة عدد التقييمات لنقطة الاهتمام.

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

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

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

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

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

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

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

فئات المحتوى اختياري يُرجى وصف فئة المحتوى في الكيان.

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

  • النوع
  • TYPE_VIDEOS_AND_TV_SHOWS (مثل المسرح)
  • TYPE_MEDical (مثل مستشفى)
  • TYPE_EDUCATION (على سبيل المثال، مدرسة)
  • TYPE_SPORTS (مثل الاستاد)

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

RestaurantReservationEntity

السمة المتطلب الوصف التنسيق
يوري أدنيش مطلوبة

رابط لصفحة معيّنة في تطبيق مقدّم الخدمة

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

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

سلسلة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ما يصل إلى 3 ترجمات، كل عنوان فرعي، سطر واحد من النص.

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

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

حجم النص المقترَح لكل عنوان فرعي: 50 حرفًا كحدّ أقصى
مقاس الطاولة اختياري عدد الأشخاص في مجموعة الحجز عدد صحيح > 0

EventReservationEntity

السمة المتطلب الوصف التنسيق
يوري أدنيش مطلوبة

رابط لصفحة معيّنة في تطبيق مقدّم الخدمة

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

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

سلسلة

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

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

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

 الطابع الزمني للفترة بالمللي ثانية
وضع الحدث مطلوبة

حقل للإشارة إلى ما إذا كانت الفعالية افتراضية أو بالحضور الشخصي أو كليهما.

 التعداد: VIRTUAL أو IN_PERSON أو HYBRID
الموقع - البلد مطلوب بشروط

البلد الذي ستقام فيه الفعالية.

ملاحظة: هذا الإجراء مطلوب للأحداث التي تحمل IN_PERSON أو HYBRID.

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

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

المدينة التي ينعقد فيها الحدث

ملاحظة: هذا الإجراء مطلوب للأحداث التي تحمل IN_PERSON أو HYBRID.

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

حجم النص المقترَح: 20 حرفًا تقريبًا
الموقع - العنوان المعروض مطلوب بشروط

تمثّل هذه السمة العنوان أو اسم المكان الذي ستقام فيه الفعالية والذي يجب عرضه للمستخدم.

ملاحظة: هذا الإجراء مطلوب للأحداث التي تحمل IN_PERSON أو HYBRID.

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

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

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

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

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

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

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

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

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

حجم النص المقترَح: 20 حرفًا تقريبًا
صور الملصق اختياري

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

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

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

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

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

 الطابع الزمني للفترة بالمللي ثانية
مقدِّم الخدمة - الاسم اختياري

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

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

نص حُرّ على سبيل المثال، اسم منظم الفعالية/جولة
مقدم الخدمة - صورة اختياري

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

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

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

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

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

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

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

ما يصل إلى 3 ترجمات، كل عنوان فرعي، سطر واحد من النص.

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

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

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

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

عنوان الشارة

ملاحظة: يجب إضافة نص أو صورة إلى الشارة.

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

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

صورة صغيرة

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

ملاحظة: يجب إضافة نص أو صورة إلى الشارة.

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

السعر الحالي للتذكرة أو التذكرة الخاصة بالفعالية.

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

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

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

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

تمثّل هذه السمة القيمة القصوى لمقياس التقييم.

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

 الرقم >= 0.0
التقييم - القيمة الحالية اختياري

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

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

 الرقم >= 0.0
التقييم - العدد اختياري

تمثّل هذه السمة عدد تقييمات الفعالية.

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

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

تمثّل هذه السمة عدد تقييمات الفعالية.

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

 الصيغة الطويلة
فئات المحتوى اختياري يُرجى وصف فئة المحتوى في الكيان.

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

  • TYPE_VIDEOS_AND_TV_SHOWS (مثل السينما)
  • TYPE_numericAL_GAMES (مثل الرياضة الإلكترونية)
  • TYPE_MUSIC (مثل حفلة موسيقية)
  • TYPE_TRAVEL_AND_LOCAL (مثل جولة أو مهرجان)
  • TYPE_HEALTH_AND_FITENESS (مثل فصل اليوغا)
  • TYPE_EDUCATION (مثل صف)
  • TYPE_SPORTS (مثل مباراة كرة القدم)
  • TYPE_DAING (مثل لقاء)

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

LodgingReservationEntity

السمة المتطلب الوصف التنسيق
يوري أدنيش مطلوبة

رابط لصفحة معيّنة في تطبيق مقدّم الخدمة

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

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

نص حُرّ مثلاً "إقامة اعتبارًا من 12 كانون الأول (ديسمبر)"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

حجم النص المقترَح: 20 حرفًا تقريبًا
صور الملصق اختياري

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

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

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

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

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

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

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

ما يصل إلى 3 ترجمات، كل عنوان فرعي، سطر واحد من النص.

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

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

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

تمثّل هذه السمة القيمة القصوى لمقياس التقييم.

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

 الرقم >= 0.0
التقييم - القيمة الحالية اختياري

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

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

 الرقم >= 0.0
التقييم - العدد اختياري

تمثّل هذه السمة عدد تقييمات المكان المخصّص للاستئجار.

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

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

تمثّل هذه السمة عدد تقييمات المكان المخصّص للاستئجار.

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

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

تمثّل هذه السمة السعر الحالي للإقامة.

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

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

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

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

TransportationReservationEntity

السمة المتطلب الوصف التنسيق
يوري أدنيش مطلوبة

رابط لصفحة معيّنة في تطبيق مقدّم الخدمة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

حجم النص المقترَح: 20 حرفًا تقريبًا
موقع الوصول - البلد اختياري بلد الوصول

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

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

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

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

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

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

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

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

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

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

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

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

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

حجم النص المقترَح: 20 حرفًا تقريبًا
مقدِّم الخدمة - الاسم اختياري

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

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

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

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

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

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

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

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

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

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

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

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

ما يصل إلى 3 ترجمات، كل عنوان فرعي، سطر واحد من النص.

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

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

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

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

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

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

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

حجم النص المقترَح: أقل من 45 حرفًا (قد يعرض النص الطويل جدًا علامات حذف)
رقم وسيلة النقل عنصر مطلوب رقم الرحلة الجوية أو رقم الحافلة أو رقم القطار أو رقم العبّارة/الرحلة البحرية. حقل التعبئة النصّية الحرّة
وقت الصعود على متن الطائرة عنصر مطلوب الطابع الزمني للفترة الذي يمثّل وقت صعود الطائرة إلى الحجز (إذا كان ذلك منطبقًا) الطابع الزمني للفترة بالمللي ثانية

VehicleRentalReservationEntity

السمة المتطلب الوصف التنسيق
يوري أدنيش مطلوبة

رابط لصفحة معيّنة في تطبيق مقدّم الخدمة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

حجم النص المقترَح: 20 حرفًا تقريبًا
عنوان الإرجاع - العنوان المعروض اختياري الموقع الجغرافي للإرجاع الذي سيتم عرضه للمستخدم

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

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

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

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

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

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

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

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

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

حجم النص المقترَح: 20 حرفًا تقريبًا
مقدِّم الخدمة - الاسم اختياري

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

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

نص حُرّ على سبيل المثال: "Avis Car Rental"
مقدم الخدمة - صورة اختياري

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

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

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

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

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

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

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

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

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

ما يصل إلى 3 ترجمات، كل عنوان فرعي، سطر واحد من النص.

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

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

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

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

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

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

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

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

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

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

نسبة العرض إلى الارتفاع الحدّ الأدنى لوحدات البكسل وحدات البكسل التي ننصح بها

مربّع (1x1)

الخيار المفضّل

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

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

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

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

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

5120 كيلوبايت

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

  • المساحة الآمنة للصور: ضَع المحتوى المهم في الوسط بحيث يشغل 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 وEventحجزEntity وPointOfinterestEntity، فإن مجموعة فرعية فقط من هذه الفئات مؤهَّلة. تحقق من قائمة الفئات المؤهلة لنوع كيان قبل تعبئة القائمة.

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

    • TYPE_VIDEOS_AND_TV_SHOWS - يمكنك الاطّلاع على الكيانات في مشاهدة دليل الدمج قبل استخدام العناصر العامة.
    • TYPE_DOCUMENT - راجع EbookEntity قبل استخدام العناصر العامة.
    • TYPE_AUDIO Books - راجِع AudiobookEntity قبل استخدام الكيانات العامة.
    • TYPE_SHOPPING: يُرجى مراجعة ShoppingEntity قبل استخدام الكيانات العامة.
    • TYPE_FOOD_AND_DRINK - يمكنك الاطّلاع على الكيانات في دليل دمج الطعام قبل استخدام الكيانات العامة.

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

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

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

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

publishUserAccountManagementRequest

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

تشكّل البيانات الوصفية التالية جزءًا من بطاقة تسجيل الدخول -

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

الصورة التي تظهر على البطاقة

صور بنسبة عرض إلى ارتفاع تبلغ 16x9 بدقة 1264x712
العنوان اختياري - إذا لم يتم توفير الصورة، يجب تقديم الصورة العنوان على البطاقة
نص الإجراء اختياري النص الذي يظهر في عبارة الحث على اتخاذ إجراء (أي تسجيل الدخول)
العنوان الفرعي اختياري عنوان فرعي اختياري على البطاقة

Kotlin


var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Java


SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

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

  • تمت إزالة بيانات UserAccountManagementCluster الحالية من شريك المطوّرين.
  • ويتم تحليل البيانات من الطلب وتخزينها في مجموعة UserAccountManagementCluster المحدَّثة.

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

updatePublishStatus

إذا لم يتم نشر أي من المجموعات لأي سبب داخلي من الأسباب التجارية، ننصحك بشدة بتعديل حالة النشر باستخدام واجهة برمجة التطبيقات updatePublishStatus. وهذا أمر مهم للأسباب التالية :

  • إنّ تقديم الحالة في جميع السيناريوهات، حتى عند نشر المحتوى (الحالة == منشور) أمر بالغ الأهمية لتعبئة لوحات البيانات التي تستخدم هذه الحالة الفاضحة للتعبير عن سلامة عملية الدمج والمقاييس الأخرى.
  • إذا لم يتم نشر أي محتوى ولكن حالة الدمج غير معطّلة (STATUS == 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.

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 مع تضمين السبب كرمز خطأ.

رمز الخطأ ملاحظة
SERVICE_NOT_FOUND لا تتوفر الخدمة على الجهاز المحدد.
SERVICE_NOT_AVAILABLE الخدمة متاحة على الجهاز المحدّد، ولكنّها غير متاحة في وقت المكالمة (على سبيل المثال، تكون غير مفعّلة بشكل صريح).
SERVICE_CALL_EXECUTION_FAILURE تعذّر تنفيذ المهمة بسبب مشاكل في سلاسل المحادثات. وفي هذه الحالة، يمكن إعادة المحاولة.
SERVICE_CALL_PERMISSION_DENIED غير مسموح للمتصل بإجراء مكالمة الخدمة.
SERVICE_CALL_INVALID_ARGUMENT يحتوي الطلب على بيانات غير صالحة (على سبيل المثال، أكثر من عدد المجموعات المسموح به).
SERVICE_CALL_INTERNAL هناك خطأ في جانب الخدمة.
SERVICE_CALL_RESOURCE_EXHAUSTED يتم الاتصال بالخدمة بشكل متكرر جدًا.

الخطوة 3: التعامل مع أهداف البث

بالإضافة إلى إجراء طلبات خاصة بواجهة النشر للمحتوى من خلال المهمة، يجب أيضًا إعداد BroadcastReceiver لتلقّي طلب نشر المحتوى.

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

يجب إعداد 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 عند تلقّي هذا الهدف.

سير عمل عملية الدمج

للحصول على دليل مفصّل حول التحقّق من عملية الدمج بعد اكتمالها، يُرجى الاطّلاع على خطوات دمج المطوّرين المرتبطة بالتفاعل.

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

اطّلِع على الأسئلة الشائعة حول التفاعل مع حزمة تطوير البرامج (SDK) للحصول على الأسئلة الشائعة.

Contact

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

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

بعد إتمام عملية الدمج هذه، ستكون خطواتك التالية على النحو التالي:

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