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

إجراءات "ألعاب Play"

نظرة عامة

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

مقدمة عن "إجراءات ألعاب Play"

الإصدار المتوافق مع الأجهزة الجوّالة من "إجراءات ألعاب Play"

صورة "إجراءات ألعاب Play" على جهاز جوّال

إصدار سطح المكتب من "إجراءات ألعاب Play"

صورة لـ "إجراءات ألعاب Play" على كمبيوتر

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

تستند "إجراءات ألعاب Play" إلى خلاصة تحتوي على تفاصيل حول كتالوج الألعاب. الخلاصة هي عنصر JSON يحتوي على مجموعة من الكيانات. الكيان هو schema.org كائن يمثّل اللعبة في الكتالوج الخاص بك والرابط لصفحة معيّنة في التطبيق المرتبط بها لبث اللعبة (إصدار تجريبي أو تجربة فورية أو إصدار كامل).

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

نتناول في الأقسام التالية تفاصيل كلّ من هذه المتطلبات.

البدء

كما هو موضّح في القسم السابق، تشمل مسؤولياتك كمقدّم خدمة ما يلي:

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

لنتعرّف على هذه الميزات بالتفصيل.

قبل البدء

قبل البدء في إنشاء الخلاصة، ننصحك بتخصيص بعض الوقت لفهم متطلبات بيانات التعريف الخاصة بـ "إجراءات ألعاب Play" وجمع كل المعلومات الضرورية في مكان واحد. ننصحك باتّخاذ الإجراءات التالية قبل البدء في إنشاء خلاصة:

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

فهم استخدام "الأعمال" و"الإصدارات" في هذه المستندات

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

على سبيل المثال، "Shadow of the Tomb Raider" هو عمل، ولكن كل نسخة مختلفة منه تسمى إصدارًا. في هذه الحالة، قد يشتمل العمل "Shadow of the Tomb Raider" على إصدار لمنصة Stadia وإصدار لجهاز PlayStation وإصدار للوصول المبكر على Stadia وما إلى ذلك.

يُعتبر هذا الفرق مهمًا في الخلاصة للغاية، لأنّه قد لا يكون واضحًا على الفور. هناك كيانان من نوع VideoGame:

‫VideoGame (عمل) هو كيان VideoGame ذو "المستوى الأعلى":

‫exampleOfWork هي سمة من VideoGame (عمل) وتحدّد حالة واحدة أو أكثر من VideoGame (إصدار).
يجب توفير سمة exampleOfWork VideoGame (Edition) واحدة على الأقل لكل VideoGame (Work).

‫VideoGame (Edition) هو الكيان ذو "المستوى الأدنى" في VideoGame.

من المفيد الانتباه إلى أنّ العمل الواحد قد يتضمّن عدة إصدارات. وننصحك بتجميع هذه الإصدارات معًا قدر الإمكان. ويساعد هذا الإجراء أنظمة Google في الاستفادة من جميع المعلومات ذات الصلة بلعبة فيديو معيّنة وعرضها في "بحث Google".

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

عنوان URL الأساسي (url)

يساعد عنوان URL الأساسي (url) محرّك بحث Google في التوفيق بدقة بين المحتوى في الكتالوج الخاص بك والمحتوى في قواعد بيانات Google.

"عنوان URL الأساسي هو عنوان URL للصفحة التي يرى محرك بحث Google أنّها الأكثر دقةً من بين مجموعة من الصفحات المكرّرة على موقعك الإلكتروني. على سبيل المثال، إذا كان لديك عناوين URL للصفحة نفسها (مثل: example.com?dress=1234 وexample.com/dresses/1234)، سيختار محرك البحث Google عنوان URL واحدًا فقط بصفته أساسيًا. (المصدر: دمج عناوين URL المكرّرة)

في ما يلي متطلبات عنوان URL الأساسي:

يجب أن يكون url معرّفًا فريدًا على مستوى العالم.
يجب أن يحتوي url على عنوان URL أساسي صالح يمكن أن يزحف إليه Google.

المعرّف (@id)

يجب أن يستوفي المعرّف (@id) المتطلبات التالية:

معرّف فريد عالميًا في جميع أنحاء الكتالوج:
- على سبيل المثال، لا تستخدِم @id نفسه للعبة فيديو مختلفة.
ثابت:
- لا يمكنك تغيير @id لاحقًا.
في شكل معرّف موارد موحّد (URI):
- إذا لم يكن المعرّف المحلي (ID) للمحتوى بتنسيق URI، أضِف نطاقك إلى المعرّف لتلبية هذا الشرط، مثلاً، إذا كان معرّف المحتوى هو 1234abc وكان نطاقك هو https://example.com، يمكن أن يكون @id هو https://example.com/1234abc.
- لا يُشترط أن يكون @id عنوان URL صالحًا، بل يجب أن يكون بتنسيق معرّف الموارد الموحّد (URI) فقط.
- يجب أن يكون النطاق المستخدَم في @id (مثل https://example.com) مملوكًا لمؤسستك.

بما أنّ url الخاص بالكيان يستوفي جميع المتطلبات كمعرّف (أي أنّه فريد على مستوى العالم وثابت وبشكل معرّف موارد موحّد)، ننصحك باستخدام url الخاص بالكيان كـ @id في الحالات التي يكون فيها ذلك منطقيًا.

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

عندما يبدأ المستخدم إجراءات "ألعاب Play" على المحتوى، تستخدم Google الرابط لصفحة معيّنة خاصة بالمحتوى لنقل المستخدم مباشرةً إلى المحتوى في تطبيقك أو منصتك. يُرجى وضع ما يلي في الاعتبار:

يجب أن تفتح الروابط لصفحات في التطبيق المحتوى الذي تستهدفه على جميع المنصات المحدّدة. يمكن أن تتضمّن المنصات المختلفة روابط مختلفة لصفحات في التطبيق. على سبيل المثال، قد يختلف الرابط لصفحة في التطبيق الذي يعمل على الويب على الكمبيوتر المكتبي عن الرابط الذي يعمل على الويب على الأجهزة الجوّالة. بالنسبة إلى كل لعبة، تحقَّق مما إذا كانت تتضمّن روابط لصفحات في التطبيق مختلفة استنادًا إلى النظام الأساسي.
يمكن أن تتضمّن الروابط لصفحات معيّنة مَعلمات (&) أو علامات ربط (#).
لضمان توفّر المحتوى الخاص بك على منصات Google المتعددة (بحث Google و"مساعد Google" وAndroid TV)، يجب توفير رابط لصفحة معيّنة.

بما أنّ url الخاص بالكيان يستوفي جميع المتطلبات كمعرّف (أي أنّه فريد على مستوى العالم وثابت ويتّخذ شكل معرّف موارد موحّد)، ننصحك باستخدام url الخاص بالكيان كـ @id في الحالات التي يكون فيها ذلك منطقيًا.

النظام الأساسي	الوصف
http://schema.org/DesktopWebPlatform	منصة البحث على متصفّح الويب على الكمبيوتر المكتبي
http://schema.org/MobileWebPlatform	منصة البحث على متصفّح الويب على الأجهزة الجوّالة
http://schema.org/AndroidPlatform	منصة البحث على تطبيق Android
http://schema.org/AndroidTVPlatform	منصة Android TV على تطبيق Android TV
http://schema.org/IOSPlatform	ابحث عن النظام الأساسي على تطبيق iOS.

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

هل يحتاج المستخدمون إلى تسجيل الدخول إلى تطبيقك أو منصتك للوصول إلى المحتوى؟
هل يحتاج المستخدمون إلى اشتراك؟
هل على المستخدمين إجراء عملية شراء للعب اللعبة؟
هل تتغير متطلبات الوصول إلى المحتوى بمرور الوقت؟
هل يعتمد شرط الوصول إلى الموقع الجغرافي على موقع الجهاز؟

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

أنواع جدران الدفع

لا تتوافق "إجراءات ألعاب Play" حاليًا إلا مع أنواع جدران الدفع التالية:

قيمة الفئة	نوع جدار الدفع
`nologinrequired`	لا يلزم إجراء أي عملية شراء أو تسجيل الدخول.
`free`	يجب أن يكون المستخدم مسجّلاً الدخول، ولكن لا يحتاج إلى اشتراك مدفوع.
`subscription` ملاحظة: يجب استخدام ترميز فئة مشتركة.	يجب أن يكون لدى المستخدم اشتراك نشط. ولا تعتمد إمكانية الوصول إلى هذه الميزة على فئة الاشتراك.
`subscription` ملاحظة: حدِّد مجموعة معرّفات الأهلية المطلوبة للوصول إلى هذا المحتوى باستخدام `MediaSubscription.identifier`. لمزيد من المعلومات، يُرجى الاطّلاع على معرّف حق الاستخدام. قد يكون من الضروري إضافة ترميز فئة شائعة.	يجب أن يكون لدى المستخدم اشتراك نشط. ولا تعتمد إمكانية الوصول إلى هذه الميزة على فئة الاشتراك.
`purchase`	يكون المحتوى متاحًا لفترة زمنية غير محدودة بعد الشراء.
`rental`	يمكن الوصول إلى المحتوى لمدة زمنية محدودة بعد الشراء.

يتم استخدام قيم الفئات هذه لاحقًا عند إنشاء الخلاصة. يُرجى أيضًا العِلم أنّ فئة rental في الجدول السابق اختيارية تمامًا اليوم وقد تصبح متاحة في تحسين مستقبلي للمنتج. في الوقت الحالي، يستفيد المنتج من قيم الفئات free وnologinrequired وsubscription وpurchase فقط من الخلاصة.

أخيرًا، ألقِ نظرة سريعة على خلاصة العيّنات للحصول على فكرة عمّا نريد الوصول إليه.

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

إنشاء الخلاصة

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

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

عليك الالتزام بالمتطلبات التالية:

يجب أن تستخدم جميع ملفات الخلاصات الإضافة .json في اسم الملف.
تأكَّد من أنّ أسماء الملفات لا تحتوي على مسافة.
لا ترمِّز ملف خلاصتك.
ترميز ملف خلاصتك باستخدام UTF-8 (تحقَّق من إعدادات محرّر الملفات)
إذا كان حجم ملف الخلاصة غير المضغوط أكبر من 1 غيغابايت، قسِّم الملف إلى عدة ملفات.
- طالما أنّ حجم الملف أقل من 1 غيغابايت، لا يوجد حدّ لعدد العناصر التي يمكنك تضمينها في ملف واحد أو عدد الملفات التي يمكنك إرسالها إلى Google كجزء من عملية إرسال خلاصتك.
تأكَّد من أنّ الملف مشفّر بدون BOM، وفقًا لمواصفات JSON. للتحقّق من ذلك على نظام التشغيل Linux، يجب ألا يبدأ hexdump file.json | head -n 1 بـ BBEF على العنوان 0x00.

الالتزام بمتطلبات محتوى الخلاصة

يجب الالتزام بمتطلبات المحتوى التالية:

يجب ألا تتضمّن الخلاصة كيانات قديمة. الكيانات القديمة هي كيانات تم ضبط السمة availabilityEnds الخاصة بالرابط لصفحة معيّنة فيها على تاريخ في الماضي أو كيانات لم تعُد متاحة على موقعك الإلكتروني.
إنّ كل الروابط لمواضع معيّنة، مثل urlTemplate، وجميع عناوين URL، مثل url التي تُدرجها في خلاصتك يجب أن تكون عناوين URL إنتاجية. ولا تستخدم عناوين تأكيد الجودة أو التطوير أو أي نوع آخر من عناوين URL غير الإنتاجية.
يجب أن تكون جميع عناوين URL، مثل url، عناوين أساسية، كما هو موضّح في القسم السابق.
يجب أن يحدّد كل كيان في خلاصتك السمات التالية:
- معرّف فريد: @id
- عنوان URL فريد: url
- رابط لصفحة معيّنة فريدة: urlTemplate

ننصحك بما يلي عند إنشاء الخلاصة:

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

استضافة الخلاصة

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

طريقة الاستضافة	خدمة المصادقة
Google Cloud Storage	منح إذن "عارض عنصر التخزين" إلى `088794101-100000002-account@partnercontent.gserviceaccount.com`
HTTPS	يتطلّب مشاركة اسم المستخدم وكلمة المرور أو شهادات HTTP الخاصة بالعميل.
بروتوكول النقل الآمن للملفات (SFTP)	يجب مشاركة كلمة المرور أو المفتاح والعبارة أو كلاهما.
AWS S3	يتطلّب ذلك مشاركة معرّف المفتاح ومفتاح الوصول لحزمة AWS S3.

بعد تحميل ملف الخلاصة إلى نظام مضيف، تواصَل مع فريق "إجراءات ألعاب Play" لمراجعة ملف الخلاصة.

إرسال خلاصتك للمراجعة

بعد استضافة ملف الخلاصة، تواصَل مع جهة الاتصال المخصّصة لك في "إجراءات ألعاب Play" لبدء عملية مراجعة الخلاصة. يُرجى الحرص على مشاركة المعلومات التالية في هذه المراسلة:

نظرة عامة/الوصف: يُرجى إعلامنا إذا كنت ستشارك خلاصة نموذجية أو خلاصة إنتاج كاملة. في حال مشاركة نموذج خلاصة، يُرجى إعلامنا بالوقت المقدّر لوصول خلاصة الإنتاج، إذا أمكن ذلك.
موقع المضيف: عنوان URL لملف الخلاصة.
مصادقة المضيف: أدرِج بيانات اعتماد المصادقة للسماح لمحرّك بحث Google باسترداد ملف الخلاصة من المضيف، إذا كان ذلك منطبقًا. لمزيد من المعلومات، يُرجى الاطّلاع على استضافة خلاصتك.
حساب الاختبار: هو حساب اختبار يتيح لفريق "إجراءات ألعاب Play" الوصول إلى الروابط لصفحات معيّنة في تطبيقك أو منصتك بغرض الاختبار. إذا كانت خلاصتك تتضمّن كيانات على منصات متعددة، قدِّم حسابًا تجريبيًا لكل منصة.
Icons: يُرجى إرسال الرموز الخمسة التالية. تُستخدَم هذه الرموز بجانب "إجراءات ألعاب Play على "بحث Google".

الفئة	السمات (بكسل)	حجم الملف	الإرشادات
تشغيل "مهام الألعاب" على "بحث Google" أو "البث" أو غير ذلك
	16x16	يجب ألّا يتجاوز حجم ملف جميع الرموز، باستثناء الرمز بحجم 112×112 بكسل، 1 كيلوبايت. يجب ألا يتجاوز حجم ملف الرمز 3 كيلوبايت عند استخدام حجم 112×112 بكسل.	يجب توفير جميع أبعاد الرموز الخمسة. يجب أن تستوفي الصور ما يلي: تنسيق ملف PNG شكل دائري خلفية شفافة تأكَّد من أنّ الصور لا تحتوي على تمويه أو تشويش أو تشوّه.
	20x20
	40‏x‏40
	44x44
	112x112

عيّنة

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

هناك مرحلتان للتحقّق من صحة الخلاصة:

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

معايير قبول الخلاصة

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

تعديل الخلاصة حسب الحاجة

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

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

مراجع

نظرة عامة على بنية الخلاصة

تتضمّن خلاصة "إجراءات ألعاب Play" البنية التالية:

حزمة خلاصة البيانات

غلاف خلاصة البيانات هو العنصر الأعلى مستوى في خلاصة "إجراءات ألعاب Play". يحتوي العنصر على مصفوفة من عناصر ترميز المحتوى (كيانات VideoGame (Work)) التي تمثّل جميع ألعاب الفيديو في الكتالوج.

الموقع	النوع المتوقع	الوصف
`@context`	URL	مَعلمة مطلوبة. ضبط على `http://schema.org`
`@type`	Text	مَعلمة مطلوبة. اضبط السمة على `DataFeed`.
`dateModified`	DateTime	مَعلمة مطلوبة. تمثّل هذه السمة تاريخ ووقت آخر تعديل أُجري على الخلاصة بتنسيق ISO 8601 (بما في ذلك المنطقة الزمنية).
`dataFeedElement`	Thing	مَعلمة مطلوبة. كيانات كتالوج الألعاب

نموذج

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {  },
    {  },
    {  },
    ...
  ]
}

عناصر ترميز المحتوى

يمثّل عنصر ترميز المحتوى كيانًا واحدًا في قائمة أعمالك: VideoGame (Work). يحتوي العنصر على معرّف المحتوى وعنوان URL الأساسي، ويساعد في وصف المحتوى من خلال البيانات الوصفية. يحتوي عنصر ترميز المحتوى الخاص بـ VideoGame (العمل) على سمة باسم exampleOfWork لربطه بعنصر VideoGame(Edition). يمكن أن يتضمّن هذا النوع VideoGame(Edition) مصفوفة من عناصر الترميز Action، ما يتيح ربط المحتوى بعناصر ترميز Action متعددة. على سبيل المثال، يمكن أن يتضمّن المحتوى عنصر ترميز Action مختلفًا لكل منطقة.

عناصر ترميز الإجراءات

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

الموقع	النوع المتوقع	الوصف
`@type`	Text	مَعلمة مطلوبة. يجب ضبطها دائمًا على `PlayGameAction`.
`gameAvailabilityType`	GameAvailabilityEnumeration أو Text	مَعلمة مطلوبة. تحدّد هذه السمة نوع توفّر محتوى اللعبة المرتبط بهذا الإجراء، مثل ما إذا كان إصدارًا كاملاً أو عرضًا توضيحيًا. تشمل القيم المقبولة `DEMO` و`FULL`.
`additionalType`	Text	مَعلمة مطلوبة. تشير هذه السمة إلى نوع إجراء التشغيل المرتبط بهذه اللعبة. تشمل القيم المقبولة ما يلي: ‫`StreamingPlayAction`: يشير إلى أنّ إحدى الألعاب متاحة للبث على الإنترنت ‫`DownloadPlayAction`: يشير إلى أنّ إحدى الألعاب متاحة للتنزيل
`target`	EntryPoint	مَعلمة مطلوبة. عنصر مستهدف يوفّر عملية ربط الروابط لصفحات في التطبيق بمختلف منصات Google
`target.@type`	Text	مَعلمة مطلوبة. يجب ضبطها دائمًا على `EntryPoint`.
`target.urlTemplate`	URL	مَعلمة مطلوبة. رابط لصفحة معيّنة ينقل المستخدمين إلى تطبيقك أو منصتك ويبدأ تشغيل اللعبة
`target.inLanguage`	Text	Optional. تمثّل هذه السمة اللغة الأصلية للمسلسل بتنسيق BCP 47.
`target.actionPlatform`	Text	مَعلمة مطلوبة. المنصات التي تم ربطها بـ `urlTemplate` تتيح "إجراءات ألعاب Play" استخدام القيم التالية: http://schema.org/DesktopWebPlatform http://schema.org/MobileWebPlatform http://schema.org/AndroidPlatform http://schema.org/AndroidTVPlatform http://schema.org/IOSPlatform لمعرفة المتطلبات، يُرجى الاطّلاع على أنواع الأنظمة الأساسية.
`actionAccessibilityRequirement`	ActionAccessSpecification	مَعلمة مطلوبة. تمثّل هذه السمة كائنًا يحدّد متطلبات الوصول إلى الإجراء، ويصف متطلبات الوصول إلى المحتوى. لمعرفة التفاصيل، يُرجى الاطّلاع على خصائص تحديد إذن الوصول إلى الإجراء.

نموذج

"potentialAction": {
  "@type": "PlayGameAction",
  "target": [
    {  },
    {  }
  ],
  "actionAccessibilityRequirement": [
    {  },
    {  }
  ]
}

الهدف

يوفّر العنصر المستهدَف عملية ربط رابط لصفحة في التطبيق بمختلف منصات Google. العنصر هو سمة (target) لكائن ترميز الإجراء. تسجّل السمة urlTemplate الرابط لصفحة في التطبيق، بينما تسجّل السمة actionPlatform الأنظمة الأساسية التي تتوافق مع الرابط لصفحة في التطبيق.

مثال

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/MobileWebPlatform"
    ]
  }
]

مواصفات إذن الوصول إلى الإجراء

يصف عنصر مواصفات الوصول إلى الإجراء متطلبات الوصول إلى المحتوى استنادًا إلى المنطقة والفترة الزمنية. العنصر هو سمة، actionAccessibilityRequirement، خاصة بعنصر ترميز Action.

مثال على هدف يتضمّن رابطَين لصفحات معيّنة

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/MobileWebPlatform"
    ]
  }
]

مواصفات إذن الوصول إلى الإجراء

يصف عنصر مواصفات الوصول إلى الإجراء متطلبات الوصول إلى المحتوى استنادًا إلى المنطقة والفترة الزمنية. العنصر هو سمة، actionAccessibilityRequirement، خاصة بكائن ترميز Action.

الموقع	النوع المتوقع	الوصف
`actionAccessibilityRequirement.@type`	Text	مَعلمة مطلوبة. يجب ضبطها دائمًا على `ActionAccessSpecification`.
`actionAccessibilityRequirement.category`	Text	مَعلمة مطلوبة. متطلّبات الوصول إلى المحتوى للاطّلاع على القيم المقبولة والمزيد من المعلومات، يُرجى الاطّلاع على نوع جدار الدفع. إذا كان العنصر يمثّل مجموعة من المحتوى، عليك ضبط الفئة على أقل متطلبات الوصول تقييدًا للمحتوى. على سبيل المثال، إذا كانت إحدى الألعاب تتيح الوصول إليها بدون أي رسوم باستخدام `nologinrequired` ومن خلال اشتراك، اضبط الفئة على `nologinrequired`.
`actionAccessibilityRequirement.availabilityStarts`	التاريخ	مَعلمة مطلوبة. تمثّل هذه السمة التاريخ الذي يصبح الإجراء متاحًا بعده، بالتنسيق ISO 8601 (بما في ذلك المنطقة الزمنية). يمكن ضبط التاريخ على تاريخ في المستقبل. يجب أن تكون المدة مساوية أو أكبر من 72 ساعة بعد `availabilityStarts`. إذا كان المحتوى متاحًا دائمًا بعد نشره، اضبط هذا التاريخ على 20 عامًا من التاريخ الحالي. يجب توفير العنصر ذي الصلة في الخلاصة قبل سبعة أيام على الأقل من تاريخ `availabilityStarts`. ويزيد ذلك من فرص ظهور اللعبة على مساحات عرض Google في الوقت المناسب.
`actionAccessibilityRequirement.availabilityEnds`	التاريخ	مَعلمة مطلوبة. تمثّل هذه السمة التاريخ الذي لن يعود الإجراء متاحًا بعده، وهو بالتنسيق ISO 8601 (بما في ذلك المنطقة الزمنية). يمكن ضبط التاريخ على تاريخ في المستقبل. يجب أن تكون المدة مساوية أو أكبر من 72 ساعة بعد `availabilityStarts`. إذا كان المحتوى متاحًا دائمًا بعد نشره، اضبط هذا التاريخ على 20 عامًا من التاريخ الحالي. نشترط إجراء أي تعديلات على تاريخ `availabilityEnds` في الخلاصة قبل سبعة أيام على الأقل من تاريخ `availabilityEnds`. ويزيد ذلك من فرص توقّف اللعبة عن الظهور على مساحات عرض Google في تاريخ `availabilityEnds`.
`actionAccessibilityRequirement.eligibleRegion`	‫Country أو City أو State أو GeoShape أو Text	مَعلمة مطلوبة. المناطق التي يتوفّر فيها المحتوى إذا كان المحتوى متاحًا على مستوى العالم، استخدِم السلسلة الخاصة `EARTH`. لمعرفة المعلومات المطلوبة، اطّلِع على سمات GeoShape.
`actionAccessibilityRequirement.ineligibleRegion`	‫Country أو City أو State أو GeoShape أو Text	مطلوبة إذا كانت منطبقة المناطق التي يتم فيها حظر المحتوى لست بحاجة إلى تقديم هذه السمة إذا كان المحتوى متاحًا في كل مكان ضمن `eligibleRegion`. لمعرفة المعلومات المطلوبة، اطّلِع على سمات GeoShape.
`actionAccessibilityRequirement.requiresSubscription`	MediaSubscription	مطلوبة إذا كانت منطبقة تمثّل هذه السمة تفاصيل الاشتراك الذي يحتاج إليه المستخدمون للوصول إلى المحتوى. لمزيد من التفاصيل، يُرجى الاطّلاع على خصائص اشتراك الوسائط. يجب تقديم هذه السمة إذا كانت قيمة `category` هي `subscription`.
`actionAccessibilityRequirement.expectsAcceptanceOf`	العرض الترويجي	مطلوبة إذا كان المحتوى يتطلّب الشراء تمثّل هذه السمة تفاصيل العرض المرتبط بالمحتوى. قدِّم معلومات الأسعار في الحالات التالية: المحتوى الذي يتم تحصيل سعره مرة واحدة (`rental` أو `purchase`) المحتوى المستند إلى الاشتراك والذي يتطلّب من المشتركين إجراء عملية شراء إضافية (`subscription`) إذا كان السعر 0.00، عليك إزالة عنصر Offer بالكامل وضبط `actionAccessibilityRequirement.category` على `free`. لمزيد من التفاصيل، اطّلِع على سمات العروض.

مواصفات "اشتراك في وسائط"

يصف عنصر اشتراك في وسائط تفاصيل الاشتراك المطلوب للوصول إلى المحتوى. العنصر هو سمة، requiresSubscription، لكائن مواصفات الوصول إلى الإجراء.

ملاحظة مهمة: هذا الحقل مطلوب إذا كانت قيمة actionAccessibilityRequirement.category هي subscription وكان عرض اشتراكك يتضمّن حِزمًا أو فئات متعددة، أو إذا كان يتوافق مع الإضافات. لا تُدرِج هذه السمة إذا كان اشتراكك يتضمّن مستوى واحدًا ويتيح الوصول إلى كل المحتوى في الكتالوج.

الموقع	النوع المتوقع	الوصف
`requiresSubscription.@type`	Text	مَعلمة مطلوبة. يجب ضبطها دائمًا على `MediaSubscription`.
`requiresSubscription.@id`	URL	مَعلمة مطلوبة. المعرّف الفريد للاشتراك. إذا كان المحتوى متاحًا من خلال اشتراكات مختلفة، يجب أن يكون لكل اشتراك معرّف فريد.
`requiresSubscription.name`	Text	مَعلمة مطلوبة. تمثّل هذه السمة اسم الاشتراك. يُرجى ملاحظة ما يلي: إذا كان المحتوى متاحًا من خلال اشتراكات مختلفة، يجب أن يتطابق هذا الاسم مع الاسم في نظام مصادقة المستخدم. على سبيل المثال، إذا كان بإمكان المستخدم الوصول إلى المحتوى استنادًا إلى الاشتراك المسمّى "الحزمة 1"، ولكن نظام المصادقة يستخدم الاسم PKG1، استخدِم PKG1.
`requiresSubscription.sameAs`	URL	Optional. تمثّل هذه السمة الصفحة التي تصف الاشتراك.
`requiresSubscription.identifier`	Text	مطلوبة إذا كانت قيمة `category` هي `subscription` وكانت قيمة `commonTier` هي "خطأ". سلسلة فريدة لهذا الاشتراك تمثّل إمكانية الوصول إلى مجموعة من المحتوى في كتالوج الوسائط. تنصح Google باستخدام البنية التالية لـ `identifier`:اسم النطاق + نقطتان رأسيتان (:) + مستوى الوصول إلى المحتوى، مثل : `example.com`:basic أو `example.com:premium` أو `example.com:sports`
`requiresSubscription.commonTier`	قيمة منطقية	يجب ملء هذا الحقل إذا تم ضبط الفئة على "اشتراك". يمكنك الاطّلاع على مزيد من المعلومات حول `commonTier` في مستندات متطلبات الفئة الشائعة.

سمات العرض

يصف عنصر العرض السعر المرتبط بالمحتوى. العنصر هو سمة (expectsAcceptanceOf) من عنصر مواصفات الوصول إلى الإجراء. يمكن استخدامها لغرضَين:

لتقديم تفاصيل عملية شراء اللعبة يجب ضبط قيمة actionAccessibilityRequirement.category على purchase في حالة الاستخدام هذه.
لتقديم تفاصيل شراء اللعبة عندما تكون معروضة للبيع يجب ضبط actionAccessibilityRequirement.category على purchase لحالة الاستخدام هذه، ويجب تقديم عرضَين لكل إجراء، أحدهما لتقديم تفاصيل السعر من المصنع والآخر لتقديم تفاصيل السعر المخفَّض.

الموقع	النوع المتوقع	الوصف
`expectsAcceptanceOf.@type`	Text	مطلوبة - يجب ضبطها دائمًا على `Offer`.
`expectsAcceptanceOf.name`	Text	اختياري: اسم العرض الترويجيّ.
`expectsAcceptanceOf.priceSpecification`	PriceSpecification	مطلوبة: تفاصيل الأسعار المرتبطة باللعبة.
`expectsAcceptanceOf.priceSpecification.@type`	Text	مطلوبة - يجب ضبطها دائمًا على `UnitPriceSpecification`.
`expectsAcceptanceOf.priceSpecification.price`	Number	مطلوبة: تشير إلى سعر شراء المحتوى. يجب أن يكون السعر قيمة موجبة غير صفرية. بالنسبة إلى الألعاب التي يبلغ سعرها 0.00، يُرجى ضبط `actionAccessibilityRequirement.category` على `free`.
`expectsAcceptanceOf.priceSpecification.priceCurrency`	Text	مطلوبة: تمثّل هذه السمة العملة المستخدمة للسعر بتنسيق ISO 4217 المكوّن من ثلاثة أحرف.
`expectsAcceptanceOf.priceSpecification.priceType`	PriceTypeEnumeration أو Text	مطلوبة إذا كان ذلك منطبقًا: تشير إلى نوع السعر المقدَّم في العرض. عند ضبط `actionAccessibilityRequirement.category` على `purchase`، تصبح هذه السمة إلزامية ويمكنها قبول قيمتَين فقط: ‫`https://schema.org/ListPrice`: يمثّل السعر المحدَّد في قائمة الأسعار للعبة. ‫`https://schema.org/SalePrice`: يمثّل سعرًا مخفَّضًا (يكون ساريًا عادةً لفترة محدودة) لإحدى الألعاب. يجب توفير كل من `https://schema.org/ListPrice` و`https://schema.org/SalePrice` عند تقديم تفاصيل السعر المخفَّض.
`expectsAcceptanceOf.seller`	المؤسسة	تمثّل هذه السمة المؤسسة التي تتيح شراء المحتوى.
`expectsAcceptanceOf.seller.@type`	Text	يجب ضبطها دائمًا على `Organization`.
`expectsAcceptanceOf.seller.name`	Text	تمثّل هذه السمة اسم البائع.
`expectsAcceptanceOf.seller.sameAs`	URL	تمثّل هذه السمة عنوان URL لصفحة ويب تعرّف البائع، مثل الصفحة الرئيسية للبائع.

بالنسبة إلى كل أنواع جدران الدفع المتوافقة، يقدّم المثال أدناه فكرة عن كيفية إنشاء actionAccessibilityObject:

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "nologinrequired",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

مجاني (لا يلزم تسجيل الدخول) مع فترة تجريبية لمدة ساعة واحدة فقط

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "nologinrequired",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "eligibleDuration": 60
    }
  }
}

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "free",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

عملية شراء لمرة واحدة مع تخفيض

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": [
      {
        "@type": "Offer",
        "name": "Original Price",
        "priceSpecification": {
          "@type": "UnitPriceSpecification",
          "price": 7.99
          "priceCurrency": "USD"
          "priceType": "https://schema.org/ListPrice"
        },
        "seller": {
          "@type": "Organization",
          "name": "Example",
          "sameAs": "http://www.example.com/"
          }
        },
        {
          "@type": "Offer",
          "name": "Sale Price",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "price": 4.99
            "priceCurrency": "USD"
            "priceType": "https://schema.org/SalePrice"
          },
          "seller": {
          "@type": "Organization",
          "name": "Example",
          "sameAs": "http://www.example.com/"
        }
      }
    ]
  }
}

عملية شراء لمرة واحدة

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "Example",
        "sameAs": "http://www.example.com/"
      }
    }
  }
}

الاشتراكات ذات الفئة الواحدة أو الفئات المتعددة أو الإضافات

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "subscription",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
    },
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

الاشتراكات والميزات الإضافية حسب الفئة

في ما يلي توضيح لطريقة تطبيق الاشتراكات المتدرّجة والمنتجات الإضافية:

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

النموذج العام لعنصر

في ما يلي مثال على النموذج العام لكيان:

نموذج

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {  },
    {
       "@context": ["http://schema.org", {"@language": "en"}],
       "@type": "VideoGame",
       "@id": "http://www.example.com/game007",
       "url": "http://www.example.com/game007",
       "name": "Games Bond 007",
       "exampleOfWork": [
        {  },
        {
           "@type": "VideoGame",
            "@id": "http://www.example.com/game007Stadia",
            "url": "http://www.example.com/game007Stadia",
            "name": "Games Bond 007",
            // Other properties
           "potentialAction": [
              {  },
              {
                  "@type": "PlayGameAction",
                  "target": [
                  {  },
                  {  }
                  ],
                 "actionAccessibilityRequirement": [
                 {  },
                 {  }
                 ]
              }
          ],
    ...
    }
  ]
}

تعريفات أنواع البيانات المنظّمة

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

جدول مواصفات VideoGame (عمل)

الموقع	النوع المتوقع	الوصف
`@context`	Text	مَعلمة مطلوبة. يجب ضبطها دائمًا على `["http://schema.org", {"@language": "xx"}]`. تمثّل القيمة Where `xx` لغة السلاسل في الخلاصة. يجب ضبط قيمة `@language` لكل سياق كيان أساسي على رمز اللغة المناسب بتنسيق BCP 47. على سبيل المثال، إذا تم ضبط اللغة على الإسبانية، سيتم افتراض أنّ الأسماء مكتوبة بالإسبانية، حتى لو كانت لغة الترجمة والشرح بالإنجليزية.
`@type`	Text	مَعلمة مطلوبة. يجب ضبطها دائمًا على `VideoGame`.
`@id`	URL	مَعلمة مطلوبة. معرّف المحتوى بتنسيق URI، على سبيل المثال، يجب أن يستوفي `https://example.com/1234abc. @id` المتطلبات التالية: معرّف فريد عالميًا في الكتالوج ثابت ويجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت، حتى إذا تغيّرت السمة `url` الخاصة باللعبة. ويتم التعامل معه كسلسلة مبهمة ولا يُشترط أن يكون رابطًا منشورًا. يكون بتنسيق معرّف الموارد الموحّد (URI). يجب أن يكون النطاق المستخدَم للقيمة ‎ @id مملوكًا من مؤسستك. بما أنّ `url` الكيان يستوفي جميع متطلبات المعرّف، ننصحك باستخدام `url` الكيان كـ `@id`. لمزيد من التفاصيل، راجِع القسم المعرّف.
`url`	URL	مَعلمة مطلوبة. عنوان URL الأساسي الخاص بالمحتوى، والذي يستخدمه Google لمطابقة المحتوى في خلاصتك مع المحتوى في قواعد بيانات Google يجب أن تستوفي `url` المتطلبات التالية: يجب أن يكون `url` معرّفًا فريدًا على مستوى العالم. يجب أن يحتوي `url` على عنوان URL أساسي صالح يمكن أن يزحف إليه Google. بالنسبة إلى الرابط لصفحة معيّنة الخاص بعملية تشغيل، اطّلِع على السمة `urlTemplate` الخاصة بالعنصر target بدلاً من ذلك.
`name`	Text	تمثّل هذه السمة اسم المباراة. استخدِم مصفوفة لإدراج الأسماء بلغات مختلفة. لمزيد من التفاصيل، راجِع مثال المناطق واللغات المتعددة. يُرجى العِلم أنّه يمكن استخدام اسم واحد فقط لكل لغة (زوج اللغة والبلد).
`description`	Text	ننصح بشدة بتنفيذ هذه الخطوة. ملخّص المباراة الحد الأقصى المسموح به هو 300 حرف. استخدِم مصفوفة لترميز الوصف بلغات متعددة. لمزيد من التفاصيل، يُرجى الاطّلاع على مثال مناطق ولغات متعددة.
`genre`	Text	قائمة مرتّبة بجميع الأنواع ذات الصلة مثلاً: `["Action", "Role playing"]`
`image`	ImageObject	ننصح بشدة بتنفيذ هذه الخطوة. الصور المرتبطة باللعبة للحصول على مزيد من التفاصيل حول السمات المطلوبة والاختيارية التي يجب تضمينها مع `image`، راجِع سمات الصور.
`applicationCategory`	Text	اختياري. نوع تطبيق البرنامج اضبط القيمة على `Game`.
`exampleOfWork`	VideoGame	مطلوبة تمثّل هذه السمة إصدار `VideoGame`. يحمل عنصر `VideoGame` (الإصدار) هذا تفاصيل الرابط لصفحة في التطبيق أيضًا. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول مواصفات VideoGame (الإصدار).
`playMode`	Text أو GamePlayMode	Optional. توضّح ما إذا كانت هذه اللعبة متعددة اللاعبين أو تعاونية أو فردية. يمكن وضع علامة على اللعبة للإشارة إلى أنّها متعدّدة اللاعبين وتتيح اللعب التعاوني واللعب الفردي في الوقت نفسه. يقبل القيم التالية: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`

جدول مواصفات VideoGame (الإصدار)

الموقع	النوع المتوقع	الوصف
`@type`	Text	مَعلمة مطلوبة. يجب ضبطها دائمًا على `VideoGame`.
`@id`	URL	مَعلمة مطلوبة. معرّف المحتوى بتنسيق URI، على سبيل المثال، يجب أن يستوفي `https://example.com/1234abc.@id` المتطلبات التالية: معرّف فريد عالميًا في الكتالوج ثابت ويجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت، حتى إذا تغيّرت السمة `url` الخاصة باللعبة. ويتم التعامل معه كسلسلة مبهمة ولا يُشترط أن يكون رابطًا منشورًا. يكون بتنسيق معرّف الموارد الموحّد (URI). يجب أن يكون النطاق المستخدَم للقيمة ‎ @id مملوكًا من مؤسستك. بما أنّ `url` الكيان يستوفي جميع متطلبات المعرّف، ننصحك باستخدام `url` الكيان كـ `@id`. لمزيد من التفاصيل، راجِع القسم المعرّف.
`url`	URL	مَعلمة مطلوبة. عنوان URL الأساسي الخاص بالمحتوى، والذي يستخدمه Google لمطابقة المحتوى في خلاصتك مع المحتوى في قواعد بيانات Google يجب أن تستوفي `url` المتطلبات التالية: يجب أن يكون `url` معرّفًا فريدًا على مستوى العالم. يجب أن يحتوي `url` على عنوان URL أساسي صالح يمكن أن يزحف إليه Google. بالنسبة إلى الرابط لصفحة معيّنة الخاص بعملية تشغيل، اطّلِع على السمة `urlTemplate` الخاصة بالعنصر target بدلاً من ذلك.
`name`	Text	تمثّل هذه السمة اسم المباراة. استخدِم مصفوفة لإدراج الأسماء بلغات مختلفة. لمزيد من التفاصيل، راجِع مثال المناطق واللغات المتعددة. يُرجى العِلم أنّه يمكن استخدام اسم واحد فقط لكل لغة (زوج اللغة والبلد).
`description`	Text	ننصح بشدة بتنفيذ هذه الخطوة. ملخّص المباراة الحد الأقصى المسموح به هو 300 حرف. استخدِم مصفوفة لترميز الوصف بلغات متعددة. لمزيد من التفاصيل، يُرجى الاطّلاع على مثال مناطق ولغات متعددة.
`genre`	Text	قائمة مرتّبة بجميع الأنواع ذات الصلة مثلاً: `["Action", "Role playing"]`
`image`	ImageObject	ننصح بشدة بتنفيذ هذه الخطوة. الصور المرتبطة باللعبة للحصول على مزيد من التفاصيل حول السمات المطلوبة والاختيارية التي يجب تضمينها مع `image`، راجِع سمات الصور.
`applicationCategory`	Text	اختياري. نوع تطبيق البرنامج اضبط القيمة على `Game`.
`playMode`	Text أو GamePlayMode	Optional. توضّح ما إذا كانت هذه اللعبة متعددة اللاعبين أو تعاونية أو فردية. يمكن وضع علامة على اللعبة للإشارة إلى أنّها متعدّدة اللاعبين وتتيح اللعب التعاوني واللعب الفردي في الوقت نفسه. يقبل القيم التالية: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`
`potentialAction`	PlayGameAction	مطلوبة إذا كانت منطبقة يمثّل هذا النوع عنصرًا من ترميز الإجراء يوفّر تفاصيل الإجراء. استخدِم مصفوفة لتحديد روابط مختلفة لصفحات معيّنة في مناطق متعدّدة. لمزيد من المعلومات، يُرجى الاطّلاع على مثال المناطق واللغات المتعددة.
`gameEdition`	Text	مَعلمة مطلوبة. تمثّل هذه السمة إصدار هذه اللعبة. على سبيل المثال، تتوفّر لعبة "Shadow of the Tomb Raider" الشهيرة بأربع إصدارات، وهي: "إصدار Croft" و"الإصدار العادي" و"الإصدار الرقمي الفاخر" و"الإصدار النهائي".
`gamePlatform`	Text	مَعلمة مطلوبة. النظام الأساسي أو النظام الإلكتروني المستخدَم لتشغيل لعبة الفيديو
`releasedEvent`	PublicationEvent	يُنصح به بشدة. يُستخدم `PublicationEvent` لتحديد تاريخ الإصدار الأصلي (العالمي أو المحلي) للمحتوى من قِبل الناشر.
`releasedEvent.@type`	Text	مَعلمة مطلوبة. احرص على ضبط هذه السمة دائمًا على `PublicationEvent`.
`releasedEvent.Location`	البلد	مَعلمة مطلوبة. المناطق المرتبطة بحدث الإطلاق هذا. استخدِم رموز البلدان وفقًا لمعيار ISO 3166. للإشارة إلى كل مكان في العالم، اضبط القيمة على `EARTH`.
`releasedEvent.startDate`	التاريخ أو الوقت	يُنصح به مطلوب لـ `ExclusiveEvent` تمثّل هذه السمة تاريخ بدء نشر المحتوى الخاص بالكيان.
`releasedEvent.endDate`	التاريخ أو الوقت	Optional. يمثّل هذا الحقل تاريخ انتهاء صلاحية حقوق المحتوى.
`releasedEvent.publishedBy`	Organization أو Person	Optional. تمثّل هذه السمة المؤسسة أو الشخص الذي نشر هذا العنصر.
`contentRating`	Text	مطلوب للألعاب المخصّصة للبالغين، ويُنصح به بشدة في الحالات الأخرى. تقييم المحتوى العام إذا تم تقديم التقييم حسب الفئة العمرية في شكل سلسلة نصية، سيتم قبول أحد الشكلَين التاليَين: وكالة التقييم التي تمّت إضافتها قبل التقييم مع مسافة بيضاء بينهما على سبيل المثال، يجب وصف التقييم "للكبار فقط" الصادر عن وكالة "مجلس تقييم برامج الترفيه" في الولايات المتحدة على النحو التالي: `Entertainment Software Rating Board Mature`. القيمة `RATING NOT KNOWN` (غير حساسة لحالة الأحرف) للإشارة إلى أنّك لا تعرف التقييم الخاص باللعبة
`publisher`	Organization أو Person	Optional. تمثّل هذه السمة المؤسسة أو الشخص الذي نشر هذا العنصر.
`contributor`	Organization أو Person	Optional. مساهم ثانوي في هذا الكيان

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

تستخدِم "إجراءات ألعاب Play" مخطط "مهام الوسائط" لتحديد متطلبات الصور. لمزيد من المعلومات، يُرجى الاطّلاع على مواصفات مخطط الصور.

في ما يلي بعض المتطلبات الأخرى التي يجب أخذها في الاعتبار.

نسبة العرض إلى الارتفاع و`contentAttributes`	الحد الأدنى للدقة (بالبكسل)
‫16:9، ملصق بارز	‫3840x2160
2:3، ملصق بارز	1000x1500
4:3، ملصق مميّز	800×600
ملصق شهير بنسبة عرض إلى ارتفاع 1:1	600x600
3:4، ملصق مميّز	‫600x800
‫16:9، خلفية بارزة [يُفضّل] أو sceneStill	‫3840x2160
‫2:3، خلفية مميزة [يُفضّل] أو sceneStill	1000x1500
‫3:4، خلفية مميزة [يُفضّل] أو sceneStill	‫600x800

متطلبات التنسيق

في ما يلي متطلبات التنسيق التي يجب الالتزام بها بشأن حجم الصورة وجودتها وما إلى ذلك:

أدرِج الملصقات وsceneStills الأعلى دقة المتوفرة لديك للعبة.
يجب أن تكون الصورة بتنسيق JPG أو PNG أو WebP.
يجب أن يكون عنوان URL الخاص بالصورة قابلاً للزحف والفهرسة.
يجب ألا يتجاوز حجم الملفات 20 ميغابايت.
نحن نفضل الصور التي تعمل مع كل من smallFormat وlargeFormat.
يجب ألّا تحتوي الصورة على ما يلي:
- صورة مموَّهة أو متقطّعة أو تم تدويرها أو جودتها رديئة
- الصور الفوتوغرافية الجاهزة للاستخدام أو غير المرخّصة
- العُري
- محتوى غير قانوني
يمكنك تضمين أحجام الصور بالإضافة إلى تلك المُدرَجة في الجدول السابق.

أمثلة

تحتوي الأقسام التالية على أمثلة لخلاصات نموذجية لسيناريوهات مختلفة.

نموذج خلاصة يتضمّن كيان VideoGame واحدًا

في ما يلي مثال على عنصر VideoGame يمثّل لعبة "حرب الفضاء" الخيالية. يُرجى العِلم أنّه يجب تضمين هذا العنصر في غلاف خلاصة البيانات في ملف JSON ليكون مرئيًا على Google.

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type":"DataFeed",
   "dateModified":"2021-07-20T00:44:51Z",
   "dataFeedElement":[
      {
         "@context": ["http://schema.org", {"@language": "en"}],
         "@id":"https://www.examplegame.com/VideoGame007",
         "@type":"VideoGame",
         "url":"https://www.examplegame.com/games/VideoGame007",
         "name":"Space Wars Made Up Game",
         "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.",
         "genre":[
            "Role playing"
         ],
         "applicationCategory":"Game",
         "publisher":{
            "name":"Made Up Media",
            "@id":"https://www.examplegame.com/uniuqe-id-org",
            "@type":"Organization"
         },
         "contributor":[
            {
               "roleName":"developer",
               "name":"Alpha Labs Man Made Studio",
               "@id":"https://www.studionice.com/uniuqe-id-alpha",
               "@type":"Organization"
            }
         ],
         "playMode":[
           "SINGLE_PLAYER", "LOCAL_MULTI_PLAYER", "ONLINE_MULTI_PLAYER", "LOCAL_COOP", "ONLINE_COOP"
         ],
         "image":[
            {
               "@context":"http://schema.org",
               "@type":"ImageObject",
               "name":"keyart_1X1_3X",
               "contentUrl":"https://lh3.googleusercontent.com/ept4",
               "copyrightHolder":{
                  "@type":"Organization",
                  "name":"Studio Nice"
               },
               "additionalProperty":[
                  {
                     "@type":"PropertyValue",
                     "name":"contentAttributes",
                     "value":[
                         "SMALLFORMAT", "LARGEFORMAT", "SCENESTILL", "CENTERED", "NOTITLE", "NOLOGO"
                     ]
                  }
               ]
            }
         ],
         "exampleOfWork":{
            "@id":"https://www.examplegame.com/VideoGame007/version/v3",
            "name":"Space Wars Made Up Game",
            "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.",
            "gameEdition":"Early Access",
            "url":"https://www.examplegame.com/VideoGame007/version/v3/stream",
            "contentRating":[
               "Entertainment Software Rating Board Mature",
               "Pan European Game Information 12",
               "Unterhaltungssoftware Selbstkontrolle Video Game Rating System USK 12"
            ],
            "applicationCategory":"Game",
            "releasedEvent":[
               {
                  "@type":"PublicationEvent",
                  "startDate":"2020-11-30",
                  "location":{
                     "@type":"Country",
                     "name":"US"
                  }
               }
            ],
            "potentialAction":{
               "@type":"PlayGameAction",
               "gameAvailabilityType":"DEMO",
               "target":[
                  {
                     "@type":"EntryPoint",
                     "urlTemplate":"https://www.examplegame.com/VideoGame007/play",
                     "actionPlatform":[
                        "http://schema.org/DesktopWebPlatform",
                        "http://schema.org/MobileWebPlatform",
                        "http://schema.org/AndroidPlatform",
                        "http://schema.org/AndroidTVPlatform",
                        "http://schema.org/IOSPlatform"
                     ]
                  }
               ],
               "actionAccessibilityRequirement":[
                  {
                     "@type":"ActionAccessSpecification",
                     "availabilityStarts": "2015-01-01T00:00Z",
                     "availabilityEnds": "2015-12-31T00:00Z",
                     "eligibleRegion":{
                        "@type":"Country",
                        "name":[
                           "US"
                        ]
                     },
                     "category":"subscription",
                     "requiresSubscription":{
                        "@type":"MediaSubscription",
                        "name":"",
                        "@id":""
                     }
                  }
               ],
            },
            "gamePlatform": "Google Stadia",
            "publisher":{
               "name":"Made Up Media",
               "@id":"https://www.examplegame.com/uniuqe-id-org",
               "@type":"Organization"
            },
            "contributor":[
               {
                  "roleName":"developer",
                  "name":"Alpha Labs Man Made Studio",
                  "@id":"https://www.studionice.com/uniuqe-id-alpha",
                  "@type":"Organization"
               }
            ]
         }
      }
   ]
}

تمثيل صورة نموذجية لشخصيتَين من شخصيات الألعاب

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "VideoGame",
  "@id": "http://www.examplegame.com/videoGame1",
  "url": "http://www.examplegame.com/videoGame1",

  ...,

  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mauren and Lord Wingflap!",
    "Keywords": "Mauren, Lord Wingflap the Destroyer",
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "character": [
      { "@type": "Person", "name": "Mauren" },
      { "@type": "Person", "name": "Lord Wingflap the Destoyer" }
    ],
    "copyrightHolder": {
      "@type": "Organization",
      "name": " ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": {
        "@type": "Audience",
        "geographicArea": [{"@type": "Country", "name": "US"},
                           {"@type": "Country", "name": "GB"}]
    },
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
                   "noCopyright", "noMatte", "smallFormat", "largeFormat"]
      }
    ]
  }
}

التعامل مع مناطق ولغات متعددة (التدويل)

يمكن أن يتوفّر VideoGame عنصر في مناطق متعددة وبلغات متعددة.

ملاحظة: يشير الرمز @language إلى اللغة المستخدَمة في @value، ولا يعني توفّر المحتوى بهذه اللغة أو في تلك المنطقة. على سبيل المثال، لا يعني الرمز pt-br في @language أنّ المحتوى متاح باللغة البرتغالية في البرازيل، بل يشير إلى أنّ اللغة المستخدَمة في @value هي البرتغالية البرازيلية. استخدِم السمة eligibleRegion لتحديد مكان توفّر المحتوى.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "VideoGame",
  "@id": "http://www.example.com/my_favorite_game",
  "url": "http://www.example.com/my_favorite_game",
  "name": [
    {
      "@language": "en-us",
      "@value": "My Favorite Game"
    },
    {
      "@language": "es-mx",
      "@value": "mi juego favorito"
    },
    {
      "@language": "ja-jp",
      "@value": "私のfavourite game"
    }
  ],
  "description": [
    {
      "@language": "en-us",
      "@value": "Jenny meets Paul."
    },
    {
      "@language": "es-mx",
      "@value": "Jenny conoce a paul."
    },
    {
      "@language": "ja-jp",
      "@value": "PaulとJennyが会う。"
    }
  ],
  "potentialAction": [
    {
      "@type": "PlayGameAction",
      "gameAvailabilityType": "DEMO",
      "additionalType": "DownloadPlayAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_game?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform"
        ]
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "purchase",
        "availabilityStarts": "2021-06-24T11:00:00Z",
        "availabilityEnds": "2041-06-24T11:00:00Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "MX"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "en",
            "es"
          ]
        }
      ],
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "priceSpecification": [
          {
            "@type": "UnitPriceSpecification",
            "price": 19.99,
            "priceCurrency": "USD",
            "priceType": "https://schema.org/ListPrice"
          },
          {
            "@type": "UnitPriceSpecification",
            "price": 360.00,
            "priceCurrency": "MXN",
            "priceType": "https://schema.org/ListPrice"
          }
        ],
        "seller": {
          "@type": "Organization",
          "name": "My Favorite Game Publisher"
        }
      }
    },
    {
      "@type": "PlayGameAction",
      "gameAvailabilityType": "DEMO",
      "additionalType": "DownloadPlayAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/jp/my_favorite_game?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform"
        ]
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "purchase",
        "availabilityStarts": "2021-07-24T11:00:00Z",
        "availabilityEnds": "2041-07-24T11:00:00Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "JP"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "ja"
          ]
        }
      ],
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "priceSpecification": [
          {
            "@type": "UnitPriceSpecification",
            "price": 2189,
            "priceCurrency": "JPY",
            "priceType": "https://schema.org/ListPrice"
          }
        ],
        "seller": {
          "@type": "Organization",
          "name": "My Favorite Game Publisher"
        }
      }
    }
  ],
  // Other properties...
}

إجراءات "ألعاب Play"

نظرة عامة

مقدمة عن "إجراءات ألعاب Play"

البدء

قبل البدء

فهم استخدام "الأعمال" و"الإصدارات" في هذه المستندات

عنوان URL الأساسي (url)

المعرّف (@id)

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

أنواع جدران الدفع

إنشاء الخلاصة

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

الالتزام بمتطلبات محتوى الخلاصة

استضافة الخلاصة

إرسال خلاصتك للمراجعة

عيّنة

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

معايير قبول الخلاصة

تعديل الخلاصة حسب الحاجة

مراجع

نظرة عامة على بنية الخلاصة

حزمة خلاصة البيانات

نموذج

عناصر ترميز المحتوى

عناصر ترميز الإجراءات

نموذج

الهدف

مثال

مواصفات إذن الوصول إلى الإجراء

مثال على هدف يتضمّن رابطَين لصفحات معيّنة

مواصفات إذن الوصول إلى الإجراء

مواصفات "اشتراك في وسائط"

سمات العرض

مجاني (لا يلزم تسجيل الدخول)

مجاني (لا يلزم تسجيل الدخول) مع فترة تجريبية لمدة ساعة واحدة فقط

مجانًا (يجب تسجيل الدخول)

عملية شراء لمرة واحدة مع تخفيض

عملية شراء لمرة واحدة

الاشتراكات ذات الفئة الواحدة أو الفئات المتعددة أو الإضافات

الاشتراكات والميزات الإضافية حسب الفئة

النموذج العام لعنصر

نموذج

تعريفات أنواع البيانات المنظّمة

جدول مواصفات VideoGame (عمل)

جدول مواصفات VideoGame (الإصدار)

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

متطلبات التنسيق

أمثلة

نموذج خلاصة يتضمّن كيان VideoGame واحدًا

تمثيل صورة نموذجية لشخصيتَين من شخصيات الألعاب

التعامل مع مناطق ولغات متعددة (التدويل)