این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

بازی اقدامات بازی

نمای کلی

این سند Play Game Actions را برای بازی‌های ویدیویی معرفی می‌کند، الزامات طرح را فهرست می‌کند، و جزئیات فرآیند ورود برای راه‌اندازی در این ویژگی را شرح می‌دهد.

مقدمه ای بر Play Game Actions

Play Game Actions برای بازی‌های ویدیویی به کاربران امکان می‌دهد یک بازی را مستقیماً از صفحه نتایج جستجو (SRP) روی دسک‌تاپ یا تلفن همراه انجام دهند. هنگامی که کاربران به دنبال بازی ای می گردند که حداقل یک اکشن Play Game مرتبط با آن داشته باشد، در برگه نمای کلی صفحه نتیجه جستجوی سازمان یافته (OSRP) یا در پانل دانش، یک اکشن بازی Play نمایش داده می شود. این برای نسخه‌های آزمایشی یا کامل بازی‌ها که به‌صورت رایگان، از طریق اشتراک یا خرید بدون کارت در دسترس هستند و از طریق ابر روی دسک‌تاپ یا موبایل قابل پخش هستند، یا از طریق برنامه‌های مشتری محلی روی دسک‌تاپ یا کنسول قابل دانلود هستند، کار می‌کند.

Play Game Actions توسط یک فید پشتیبانی می‌شود که حاوی جزئیات کاتالوگ بازی شما است. فید یک شی JSON است که شامل مجموعه‌ای از موجودیت‌ها است. یک موجودیت یک شی schema.org است که بازی را در کاتالوگ شما و پیوند عمیق مرتبط با آن برای پخش جریانی بازی (دمو، آزمایشی فوری یا نسخه کامل) نشان می‌دهد.

برای اینکه Google فید شما را به دست آورد، باید فید را در یک فایل ذخیره کنید و فایل را در مکانی میزبانی کنید که Google بتواند به آن دسترسی داشته باشد. برای اطمینان از به روز بودن محتوای شما، Google به طور مرتب فایل فید را از میزبان شما واکشی می کند.

در بخش های بعدی به جزئیات هر یک از این الزامات می پردازیم.

شروع کنید

همانطور که در بخش قبل بیان شد، مسئولیت های شما به عنوان یک ارائه دهنده شامل موارد زیر است:

اطلاعاتی را که برای ایجاد فید نیاز دارید، درک کنید. منابع و در دسترس بودن آن، و همچنین نحوه پایان آن در فید.
یک فید ایجاد کنید که حاوی جزئیات مورد نیاز هر موجودیت بازی در کاتالوگ شما باشد.
فید را روی یک سرور یا یک سرویس ذخیره سازی ابری میزبانی کنید و به Google اجازه دهید به طور منظم فید را واکشی کند.
به مشکلات مطرح شده توسط گوگل پاسخ دهید و آنها را برطرف کنید. اینها می تواند مربوط به کیفیت یا مسائل مربوط به ساختار خود فایل های JSON باشد.
با تکامل کاتالوگ خود، فید را به روز نگه دارید.
اطمینان حاصل کنید که کیفیت خوراک پس از راه اندازی حفظ می شود.

بیایید اینها را با جزئیات درک کنیم.

قبل از شروع

قبل از شروع به ایجاد فید، به شما پیشنهاد می کنیم زمانی را صرف درک الزامات فراداده Play Game Actions کنید و همه اطلاعات لازم را در یک مکان جمع آوری کنید. ما قبل از شروع به ایجاد فید موارد زیر را به شما توصیه می کنیم:

الزامات فراداده را برای موجودیت VideoGame مرور کنید.
ابرداده ها را جمع آوری کنید.
- به خواص مورد نیاز و بسیار توصیه شده نگاهی دقیق بیندازید. Google از این ویژگی‌ها برای تطبیق محتوای شما در فید با محتوای پایگاه‌های داده Google استفاده می‌کند. هرچه ابرداده های بیشتری برای محتوای خود ارائه دهید، گوگل بهتر می تواند محتوا را مطابقت دهد.

استفاده از Works و Editions را در این مستندات درک کنید

اثر : مفهوم انتزاعی یک بازی ویدیویی. به طور خاص، ابرداده ها مانند عنوان، توسعه دهنده، توضیحات بازی و ناشر ویژگی های یک اثر هستند.
نسخه : یک نسخه واقعی از بازی ویدیویی. به طور خاص، ابرداده‌ها مانند سال انتشار، نام پلتفرم و پیوندهای عمیق ویژگی‌های نسخه هستند.

برای مثال، Shadow of the Tomb Raider یک اثر است، اما هر نسخه ای که می آید یک نسخه است. در این صورت، اثر Shadow of the Tomb Raider ممکن است یک نسخه برای Stadia، یک نسخه برای PlayStation، یک نسخه برای Early Access در Stadia و غیره داشته باشد.

این تمایز به ویژه در خوراکی که ممکن است فوراً آشکار نباشد، مهم است. دو موجودیت VideoGame وجود دارد:

VideoGame (Work) موجودیت VideoGame "سطح بالا" است:

exampleOfWork یکی از ویژگی های VideoGame (Work) است و یک یا چند نمونه از VideoGame (Edition) را مشخص می کند.
برای هر VideoGame (Work) باید حداقل یک exampleOfWork VideoGame (Edition) وجود داشته باشد.

VideoGame (نسخه) موجودیت VideoGame "سطح پایین تر" است.

به یاد داشته باشید که ممکن است چندین نسخه از یک اثر وجود داشته باشد. توصیه می کنیم تا حد امکان این نسخه ها را با هم گروه بندی کنید. این به سیستم‌های Google کمک می‌کند تا از تمام اطلاعات مرتبط در مورد یک بازی ویدیویی استفاده کند و آن را در جستجو نشان دهد.

دو ویژگی کلیدی و الزامات آنها را درک کنید. در حین حرکت به سمت ایجاد خوراک، که گام بعدی است، درست کردن این موارد بسیار مهم است.

URL متعارف (url)

یک URL متعارف ( url ) به Google کمک می کند تا محتوای موجود در کاتالوگ شما را با محتوای موجود در پایگاه داده Google به طور دقیق تطبیق دهد.

"یک URL متعارف نشانی اینترنتی صفحه ای است که گوگل فکر می کند از مجموعه ای از صفحات تکراری در سایت شما نشان دهنده ترین است. برای مثال، اگر URL هایی برای همان صفحه دارید (به عنوان مثال: example.com?dress=1234 و example.com/dresses/1234)، گوگل یکی را به عنوان متعارف انتخاب می کند." (منبع: ادغام 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 موجودیت همه الزامات را به عنوان یک شناسه برآورده می کند (یعنی در سطح جهانی منحصر به فرد، ایستا و به شکل URI)، توصیه می کنیم در مواردی که منطقی است، از url موجودیت به عنوان @id استفاده کنید.

درک و شناسایی الزامات پیوند عمیق

وقتی کاربر Play Game Actions را روی محتوا شروع می‌کند، Google از پیوند عمیق محتوا استفاده می‌کند تا کاربر را مستقیماً به محتوای برنامه یا پلتفرم شما برساند. موارد زیر را در نظر داشته باشید:

پیوندهای عمیق باید محتوای مورد نظر خود را در تمام پلتفرم های مشخص شده باز کنند. پلتفرم های مختلف می توانند لینک های عمیق متفاوتی داشته باشند. به عنوان مثال، پیوند عمیقی که در وب دسکتاپ کار می کند می تواند با پیوند عمیقی که در وب تلفن همراه کار می کند متفاوت باشد. برای هر بازی، بررسی کنید که آیا پیوندهای عمیق متفاوتی بر اساس پلتفرم دارد یا خیر.
پیوندهای عمیق می توانند شامل پارامترهای (&) یا تگ های لنگر (#) باشند.
برای اطمینان از اینکه محتوای شما در پلتفرم‌های چندگانه Google (جستجو، دستیار و Android TV) در دسترس است، یک پیوند عمیق الزامی است.

پلت فرم	توضیحات
http://schema.org/DesktopWebPlatform	پلت فرم جستجو در مرورگر وب دسکتاپ.
http://schema.org/MobileWebPlatform	پلت فرم جستجو در مرورگر وب تلفن همراه.
http://schema.org/AndroidPlatform	پلتفرم جستجو در برنامه اندروید.
http://schema.org/AndroidTVPlatform	پلت فرم Android TV در برنامه Android TV.
http://schema.org/IOSPlatform	پلت فرم جستجو در برنامه iOS.

الزامات دسترسی برای بازی‌ها را در کاتالوگ خود شناسایی کنید: سؤالات زیر را از خود بپرسید و مطمئن شوید که راهی برای شناسایی پاسخ‌های آنها از طریق فراداده در فید وجود دارد.

آیا کاربران برای دسترسی به محتوا نیاز به ورود به برنامه یا پلتفرم شما دارند؟
آیا کاربران نیاز به اشتراک دارند؟
آیا کاربران برای اجرای بازی نیاز به خرید دارند؟
آیا الزامات دسترسی در طول زمان تغییر می کند؟
آیا نیاز دسترسی به مکان دستگاه بستگی دارد؟

اگر بیش از یک بسته اشتراک را ارائه می‌دهید که کاربران شما می‌توانند آن را خریداری کنند، درک کنید که commonTier چیست و چگونه در ادغام شما با Google اعمال می‌شود.

انواع پی وال

Play Game Actions امروز فقط از انواع دیوار پرداخت زیر پشتیبانی می کند:

ارزش دسته	نوع Paywall
`nologinrequired`	نیازی به خرید یا ورود به سیستم نیست.
`free`	کاربر باید وارد سیستم شده باشد، اما نیازی به اشتراک پولی ندارد.
`subscription` توجه: نشانه گذاری لایه مشترک مورد نیاز است.	کاربر باید اشتراک فعال داشته باشد. دسترسی مستقل از ردیف اشتراک است.
`subscription` توجه: مجموعه ای از شناسه های حق مورد نیاز برای دسترسی به این محتوا را با `MediaSubscription.identifier` مشخص کنید. برای اطلاعات بیشتر، به شناسه حق مراجعه کنید. ممکن است به نشانه گذاری لایه مشترک نیاز باشد.	کاربر باید اشتراک فعال داشته باشد. دسترسی مستقل از ردیف اشتراک است.
`purchase`	محتوا پس از خرید برای مدت نامحدودی در دسترس است.
`rental`	محتوا پس از خرید برای مدت زمان محدودی در دسترس است.

این مقادیر دسته بعداً هنگام ایجاد فید مورد استفاده قرار می گیرند. همچنین، در نظر بگیرید که طبقه بندی rental در جدول قبل، امروز کاملاً اختیاری است و ممکن است در بهبود محصول آینده پشتیبانی شود. در حال حاضر، فقط ارزش‌های free ، nologinrequired ، subscription و دسته purchase توسط محصول از فید استفاده می‌شود.

در نهایت، به سرعت به فید نمونه نگاهی بیندازید تا ایده ای از آنچه می خواهیم به آن برسیم.

درک موارد فوق و اطمینان از وجود ابرداده برای نشان دادن پاسخ (به این سؤالات)، که برای حرکت به مرحله ایجاد خوراک کافی است.

فید خود را ایجاد کنید

فید Play Game Actions یک شی JSON است که شامل مجموعه‌ای از موجودیت‌ها است که بازی‌های ویدیویی را در کاتالوگ شما نشان می‌دهند. شما باید یک فید را به صورت فایل یا چندین فایل ارائه دهید و آن را روی سرور یا سرویس ذخیره‌سازی ابری میزبانی کنید تا Google مرتباً آن را واکشی کند.

به اندازه، مقدار و قالب فایل فید پایبند باشید

شما باید به الزامات زیر پایبند باشید:

همه فایل های فید باید از پسوند نام فایل .json استفاده کنند.
اطمینان حاصل کنید که نام فایل ها حاوی فاصله نیست.
فایل فید خود را رمزگذاری نکنید.
فایل فید خود را در UTF-8 رمزگذاری کنید (تنظیمات ویرایشگر فایل خود را بررسی کنید).
اگر فایل فید شما بزرگتر از 1 گیگابایت غیرفشرده است، فایل را به چند فایل تقسیم کنید.
- تا زمانی که حجم فایل کمتر از 1 گیگابایت باشد، هیچ محدودیتی در مورد تعداد موجودی که می‌توانید در یک فایل قرار دهید یا تعداد فایل‌هایی که در نهایت به عنوان بخشی از ارسال فید خود به Google ارسال می‌کنید، وجود ندارد.
مطمئن شوید که فایل مطابق با مشخصات JSON بدون BOM کدگذاری شده است. برای تأیید این مورد در سیستم عامل لینوکس، hexdump file.json | head -n 1 نباید با BBEF در آدرس 0x00 شروع شود.

به الزامات محتوای فید پایبند باشید

شما باید به الزامات محتوای زیر پایبند باشید:

خوراک نباید دارای موجودات قدیمی باشد. موجودیت‌های کهنه، موجودیت‌هایی هستند که در آن availabilityEnds پیوند عمیق به پایان می‌رسد روی تاریخی که گذشته است یا موجودیت‌هایی که دیگر در سایت شما در دسترس نیستند.
همه پیوندهای عمیق، مانند urlTemplate ، و همه نشانی‌های اینترنتی، مانند url ، که در فید خود قرار می‌دهید، باید URL تولیدی باشند. از QA، توسعه یا هر نوع URL غیر تولیدی دیگری استفاده نکنید.
همانطور که در بخش قبل ذکر شد، همه URL ها، مانند url ، باید متعارف باشند.
هر موجودی در فید شما باید ویژگی های زیر را مشخص کند:
- یک شناسه منحصر به فرد: @id
- یک URL منحصر به فرد: url
- یک پیوند عمیق منحصر به فرد: urlTemplate

هنگام ایجاد فید، توصیه‌های زیر را برای شما داریم:

نحوه ساختار فید را با جزئیات درک کنید.
با یک خوراک نمونه شروع کنید.
- حداکثر پنج نهاد نماینده را از کاتالوگ خود انتخاب کنید. موجودیت هایی با ساختار نسبتاً پیچیده، اما همچنان برای یک موجودیت در کاتالوگ معمولی انتخاب کنید، و فید را برای آن ایجاد کنید.
برای تأیید سریع، آن را به نماینده Google اختصاص داده شده خود ارسال کنید.
بعد از اینکه همه خطاهای موجود در فید نمونه خود را برطرف کردید، فید را گسترش دهید تا همه موجودات موجود در کاتالوگ خود را شامل شود.
- برای تأیید اینکه فید شما شامل همه موجودات موجود در کاتالوگ شما است، تعداد موجودات موجود در فید خود را با تعداد موارد موجود در کاتالوگ خود مقایسه کنید.

فید خود را میزبانی کنید

پس از آماده شدن فایل فید، آن را در مکانی امن میزبانی کنید. سپس Google به طور منظم فید را واکشی می کند تا مطمئن شود که محتوای شما به روز است. ما از روش های میزبانی زیر پشتیبانی می کنیم:

روش هاستینگ	پشتیبانی از احراز هویت
Google Cloud Storage	اعطای مجوز Storage Object Viewer به `088794101-100000002-account@partnercontent.gserviceaccount.com`
HTTPS	از شما می خواهد که نام کاربری + رمز عبور یا گواهی های سرویس گیرنده HTTP را به اشتراک بگذارید.
SFTP	شما را ملزم به اشتراک گذاری رمز عبور، کلید + عبارت یا هر دو می کند.
AWS S3	از شما می خواهد که شناسه کلید + کلید دسترسی را برای سطل AWS S3 به اشتراک بگذارید.

پس از آپلود فایل فید خود در یک سیستم میزبان، با تیم Play Game Actions تماس بگیرید تا فایل فید شما را بررسی کند.

فید خود را برای بررسی ارسال کنید

پس از میزبانی فایل فید، با مخاطب اختصاص داده شده Play Game Actions خود تماس بگیرید تا فرآیند بررسی فید را آغاز کنید. حتما اطلاعات زیر را در این ارتباط به اشتراک بگذارید:

نمای کلی/توضیحات : اگر یک فید نمونه یا یک فید تولید کامل را به اشتراک می‌گذارید، به ما اطلاع دهید. در صورت اشتراک گذاری فید نمونه، در صورت امکان، ETA خوراک تولید را به ما اطلاع دهید.
مکان میزبان : URL فایل فید شما.
احراز هویت میزبان : اعتبارنامه احراز هویت را اضافه کنید تا به Google اجازه دهید فایل فید را در صورت وجود از میزبان شما بازیابی کند. برای اطلاعات بیشتر، به میزبانی فید خود مراجعه کنید.
حساب آزمایشی : یک حساب آزمایشی که به تیم Play Game Actions اجازه می‌دهد برای آزمایش به پیوندهای عمیق برنامه یا پلتفرم شما دسترسی داشته باشد. اگر فید شما دارای نهادهایی در چندین پلتفرم است، یک حساب آزمایشی برای هر پلتفرم ارائه دهید.
نمادها : پنج نماد زیر را ارسال کنید. این نمادها در کنار Play Game Actions در جستجو استفاده می شوند.

دسته بندی	ابعاد (px)	اندازه فایل	رهنمودها
Play Actions Game on Search/Cast/Others
	16*16	اندازه فایل برای همه نمادها، به جز 112x112 پیکسل، نمی تواند بیشتر از 1 کیلوبایت باشد. اندازه فایل برای نماد 112x112 پیکسل نمی تواند بیشتر از 3 کیلوبایت باشد.	هر پنج بعد نماد مورد نیاز است. تصاویر باید به موارد زیر پایبند باشند: یک فرمت فایل PNG یک شکل گرد. پس زمینه شفاف مطمئن شوید که تصاویر ضد مستعار هستند و تحریف یا پیکسلی ندارند.
	20*20
	40*40
	44x44
	112x112

نمونه

اعتبار سنجی فید چگونه کار می کند

دو مرحله اعتبار سنجی خوراک وجود دارد:

اعتبار سنجی ساختار:
- این اولین مرحله از بررسی های اعتبار سنجی است.
- گوگل بازخورد مربوط به ساختار فایل های JSON را ارائه می دهد. آیا JSON به خوبی شکل گرفته است؟ آیا ما همه خواص مورد نیاز و خواص بسیار توصیه شده را در خوراک داریم؟ آیا پیوندهای عمیق مطابق با نیازهای فید ما ارائه و حاشیه نویسی می شوند؟
- این مرحله نیاز به چندین بحث پشت سر هم با گوگل دارد و تا زمانی که تمام بازخوردها بررسی شود ادامه می یابد.
تطبیق فراداده:
- این تنها پس از عبور فید از مرحله اعتبار سنجی ساختار آغاز می شود و این زمانی است که Google فرآیند تطبیق را با نمودار دانش Google آغاز می کند.
- در این مرحله، ما بازخوردی را در مورد فراداده موجود در فید ارائه می دهیم. برای راه اندازی موفقیت آمیز باید به همه مسائل رسیدگی شود. به عنوان مثال، بازخورد در این مرحله می تواند از شما بخواهد که عنوان یک بازی یا تاریخ انتشار آن را اصلاح کنید.
- این مرحله همچنین مستلزم چندین بحث رفت و برگشت با Google است و تا زمانی که تمام بازخوردها بررسی شود ادامه می یابد.

معیارهای پذیرش خوراک

زمانی که تمام مشکلات مسدود کردن برطرف شود و Google کیفیت فراداده را در نوار راه‌اندازی تأیید کرده باشد، فید برای راه‌اندازی قابل قبول در نظر گرفته می‌شود.

در صورت نیاز فید خود را به روز کنید

توصیه می‌کنیم روزانه فید خود را به‌روزرسانی کنید، اما این در نهایت به تعداد دفعات تغییر کاتالوگ شما بستگی دارد. از شرایط و نکات زیر آگاه باشید:

جستجوی Google از به‌روزرسانی‌های هم‌زمان پشتیبانی نمی‌کند.
جستجوی Google یک بار در روز فید شما را دریافت می‌کند و معمولاً محتوا را ظرف دو روز (هنگامی که راه‌اندازی می‌شود) ایندکس می‌کند.
اگر تغییر قابل پیش‌بینی در دسترسی پیوندهای عمیق وجود دارد، از availabilityStarts و availabilityEnds برای تعیین تاریخ‌های دقیق استفاده کنید.
اگر موجودیت دیگر در کاتالوگ شما موجود نیست، آن را به طور کامل از فید حذف کنید.

مرجع

نمای کلی ساختار خوراک

فید Play Game Actions ساختار زیر را دارد:

پاکت خوراک داده

پاکت فید داده، شی سطح بالایی در فید Play Game Actions است. شی شامل آرایه‌ای از اشیاء نشانه‌گذاری محتوا (موجودات VideoGame (Work)) است که همه بازی‌های ویدیویی موجود در کاتالوگ شما را نشان می‌دهد.

اموال	نوع مورد انتظار	توضیحات
`@context`	URL	مورد نیاز . روی `http://schema.org` تنظیم کنید
`@type`	متن	مورد نیاز . روی `DataFeed` تنظیم کنید.
`dateModified`	تاریخ زمان	مورد نیاز . آخرین تاریخ و زمان اصلاح شده فید، در قالب ISO 8601 (شامل منطقه زمانی).
`dataFeedElement`	چیز	مورد نیاز . موجودیت های کاتالوگ بازی شما.

الگو

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

اشیاء نشانه گذاری محتوا

یک شی نشانه گذاری محتوا یک موجودیت واحد را در کاتالوگ شما نشان می دهد: VideoGame (Work). شی شامل شناسه محتوا و URL متعارف است و به توصیف محتوا از طریق ابرداده کمک می کند. شی نشانه گذاری محتوا برای VideoGame (Work) دارای خاصیتی به نام exampleOfWork است تا آن را به شی VideoGame(Edition) پیوند دهد. این VideoGame (نسخه) می‌تواند آرایه‌ای از اشیاء نشانه‌گذاری Action داشته باشد، که به محتوا اجازه می‌دهد با چندین شی نشانه‌گذاری Action مرتبط شود. به عنوان مثال، محتوا می تواند یک شی نشانه گذاری Action متفاوت برای هر منطقه داشته باشد.

اشیاء نشانه گذاری عمل

یک شی نشانه گذاری Action پیوند عمیقی را که کاربران را به بازی می برد و سطح دسترسی مورد نیاز برای بازی را توصیف می کند. شی یک ویژگی ( potentialAction ) از یک شی نشانه گذاری محتوا است. برای Play Game Actions، از یک شیء مشخصات دسترسی Action برای تعیین محدودیت‌های دسترسی استفاده کنید.

اموال	نوع مورد انتظار	توضیحات
`@type`	متن	مورد نیاز . همیشه روی `PlayGameAction` تنظیم شود.
`gameAvailabilityType`	GameAvailabilityEnumeration یا Text	مورد نیاز . نوع در دسترس بودن محتوای بازی مرتبط با این عملکرد را نشان می‌دهد، مانند نسخه کامل یا نسخه نمایشی. مقادیر پذیرفته شده عبارتند از `DEMO` و `FULL` .
`additionalType`	متن	مورد نیاز . نوع بازی مربوط به این بازی را نشان می دهد. مقادیر پذیرفته شده عبارتند از: `StreamingPlayAction` - نشان می دهد که یک بازی برای پخش آنلاین در دسترس است `DownloadPlayAction` - نشان می دهد که یک بازی برای دانلود در دسترس است
`target`	EntryPoint	مورد نیاز . یک شی هدف که نگاشت پیوندهای عمیق به پلتفرم های مختلف گوگل را فراهم می کند.
`target.@type`	متن	مورد نیاز . همیشه روی `EntryPoint` تنظیم شود.
`target.urlTemplate`	URL	مورد نیاز . یک پیوند عمیق که کاربران را به برنامه یا پلتفرم شما می برد و پخش بازی را آغاز می کند.
`target.inLanguage`	متن	اختیاری زبان اصلی سریال در قالب BCP 47 .
`target.actionPlatform`	متن	مورد نیاز . پلتفرم هایی که به `urlTemplate` نگاشت شده اند. Play Game Actions از مقادیر زیر پشتیبانی می کند: http://schema.org/DesktopWebPlatform http://schema.org/MobileWebPlatform http://schema.org/AndroidPlatform http://schema.org/AndroidTVPlatform http://schema.org/IOSPlatform برای شرایط مورد نیاز، انواع پلت فرم را ببینید.
`actionAccessibilityRequirement`	ActionAccessSpecification	مورد نیاز . یک شیء مشخصات دسترسی Action که نیاز دسترسی به محتوا را توصیف می کند. برای جزئیات، به ویژگی‌های Action Access Specification مراجعه کنید.

الگو

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

هدف

یک شی هدف، نگاشت یک پیوند عمیق به پلتفرم های مختلف گوگل را فراهم می کند. شی یک ویژگی ( target ) از یک شی نشانه گذاری Action است. ویژگی 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"
    ]
  }
]

مشخصات دسترسی اقدام

یک شیء مشخصات دسترسی Action، نیاز دسترسی به محتوا را بر اساس منطقه و دوره زمانی توصیف می‌کند. شی یک ویژگی، 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.@type`	متن	مورد نیاز . همیشه روی `ActionAccessSpecification` تنظیم شود.
`actionAccessibilityRequirement.category`	متن	مورد نیاز . یک نیاز دسترسی به محتوا. برای مقادیر پذیرفته شده و اطلاعات بیشتر، نوع Paywall را ببینید. اگر موجودیتی گروهی از محتوا را نشان می‌دهد، باید دسته را روی حداقل نیاز دسترسی محدود به محتوای آن تنظیم کنید. به عنوان مثال، اگر یک بازی با استفاده از `nologinrequired` و از طریق اشتراک، بدون هزینه در دسترس است، دسته را روی `nologinrequired` تنظیم کنید.
`actionAccessibilityRequirement.availabilityStarts`	تاریخ	مورد نیاز . تاریخی که پس از آن اقدام در دسترس است، در قالب ISO 8601 (شامل منطقه زمانی). تاریخ را می توان در آینده تعیین کرد. باید مساوی یا بیشتر از 72 ساعت پس از `availabilityStarts` باشد. اگر محتوا پس از انتشار همیشه در دسترس است، این تاریخ را 20 سال از تاریخ فعلی تنظیم کنید. ما نیاز داریم که نهاد مربوطه حداقل هفت روز قبل از تاریخ `availabilityStarts` در فید ارائه شود. این شانس نمایش به موقع بازی در سطوح گوگل را افزایش می دهد.
`actionAccessibilityRequirement.availabilityEnds`	تاریخ	مورد نیاز . تاریخی که پس از آن اقدام دیگر در قالب ISO 8601 (از جمله منطقه زمانی) در دسترس نیست. تاریخ را می توان در آینده تعیین کرد. باید مساوی یا بیشتر از 72 ساعت پس از `availabilityStarts` باشد. اگر محتوا پس از انتشار همیشه در دسترس است، این تاریخ را 20 سال از تاریخ فعلی تنظیم کنید. ما نیاز داریم که هرگونه به‌روزرسانی در تاریخ `availabilityEnds` حداقل هفت روز قبل از تاریخ `availabilityEnds` در فید انجام شود. این احتمال را افزایش می‌دهد که بازی در تاریخ پایان `availabilityEnds` در سطوح Google ظاهر نشود.
`actionAccessibilityRequirement.eligibleRegion`	کشور ، شهر ، ایالت ، ژئوشکل یا متن	مورد نیاز . مناطقی که محتوا در آن موجود است. اگر محتوا به صورت جهانی در دسترس است، از رشته ویژه `EARTH` استفاده کنید. برای درک آنچه مورد نیاز است، ویژگی های GeoShape را ببینید.
`actionAccessibilityRequirement.ineligibleRegion`	کشور ، شهر ، ایالت ، ژئوشکل یا متن	در صورت وجود الزامی است . مناطقی که محتوا محدود است. اگر محتوا در همه جا در `eligibleRegion` در دسترس باشد، نیازی به ارائه این ویژگی ندارید. برای درک آنچه مورد نیاز است، ویژگی های GeoShape را ببینید.
`actionAccessibilityRequirement.requiresSubscription`	اشتراک رسانه	در صورت وجود الزامی است . جزئیات اشتراکی که کاربران برای دسترسی به محتوا نیاز دارند. برای جزئیات، به ویژگی های اشتراک رسانه مراجعه کنید. اگر `category` `subscription` است، این ویژگی را ارائه دهید.
`actionAccessibilityRequirement.expectsAcceptanceOf`	پیشنهاد	اگر محتوا نیاز به خرید داشته باشد، الزامی است . جزئیات پیشنهاد مرتبط با محتوا. اطلاعات قیمت را برای موارد زیر ارائه دهید: محتوای خرید یکبار مصرف ( `rental` یا `purchase` ) محتوای مبتنی بر اشتراک که نیاز به خرید اضافی از مشترکین دارد ( `subscription` ) اگر قیمت 0.00 است، شی Offer را به طور کامل حذف کنید و `actionAccessibilityRequirement.category` را روی `free` قرار دهید. برای جزئیات بیشتر، ویژگی های پیشنهاد را ببینید.

مشخصات اشتراک رسانه

یک شیء اشتراک رسانه جزئیات اشتراک مورد نیاز برای محتوا را توصیف می کند. شیء یک ویژگی، requiresSubscription ، از یک شیء مشخصات دسترسی Action است.

مهم: در صورتی که actionAccessibilityRequirement.category subscription باشد و پیشنهاد اشتراک شما شامل چندین بسته یا سطوح باشد یا دارای پشتیبانی اضافی باشد، این مورد ضروری است. اگر اشتراک شما یک لایه است و امکان دسترسی به تمام محتوای کاتالوگ شما را فراهم می کند، این را حذف کنید.

اموال	نوع مورد انتظار	توضیحات
`requiresSubscription.@type`	متن	مورد نیاز . همیشه روی `MediaSubscription` تنظیم شود.
`requiresSubscription.@id`	URL	مورد نیاز . شناسه منحصر به فرد برای اشتراک. اگر محتوا با اشتراک های مختلف قابل دسترسی است، هر اشتراک باید یک شناسه منحصر به فرد داشته باشد.
`requiresSubscription.name`	متن	مورد نیاز . نام اشتراک. به موارد زیر توجه کنید: اگر محتوا با اشتراک های مختلف قابل دسترسی است، این نام باید با نام موجود در سیستم احراز هویت کاربر شما مطابقت داشته باشد. به عنوان مثال، اگر کاربر می تواند بر اساس اشتراکی به نام بسته 1 به محتوا دسترسی پیدا کند، اما سیستم احراز هویت از نام PKG1 استفاده می کند، از PKG1 استفاده کنید.
`requiresSubscription.sameAs`	URL	اختیاری صفحه ای که اشتراک را توضیح می دهد.
`requiresSubscription.identifier`	متن	اگر `category` `subscription` باشد و `commonTier` نادرست باشد، الزامی است. یک رشته منحصر به فرد برای این اشتراک که نشان دهنده دسترسی به گروهی از محتوا در کاتالوگ رسانه شما است. گوگل توصیه می کند که از دستور زیر برای `identifier` : نام دامنه + دو نقطه (:) + سطح دسترسی به محتوا، Examples: `example.com` ، `example.com:premium` ، `example.com:sports` استفاده کنید.
`requiresSubscription.commonTier`	بولی	اگر دسته روی اشتراک تنظیم شده باشد، الزامی است. اطلاعات بیشتر در مورد `commonTier` در اسناد الزامات ردیف مشترک بخوانید.

املاک را ارائه دهید

یک شیء پیشنهاد قیمت مرتبط با محتوا را توصیف می کند. شی یک ویژگی ( expectsAcceptanceOf ) از شیء مشخصات دسترسی Action است. می توان از آن برای دو منظور استفاده کرد:

برای ارائه جزئیات خرید بازی. actionAccessibilityRequirement.category باید برای purchase این مورد تنظیم شود.
برای ارائه جزئیات خرید بازی در زمان فروش. actionAccessibilityRequirement.category باید برای purchase برای این مورد استفاده تنظیم شود و دو پیشنهاد برای هر اقدام ارائه شود - یکی برای ارائه جزئیات لیست قیمت و دیگری برای جزئیات قیمت فروش.

اموال	نوع مورد انتظار	توضیحات
`expectsAcceptanceOf.@type`	متن	مورد نیاز - همیشه روی `Offer` تنظیم شود.
`expectsAcceptanceOf.name`	متن	اختیاری - نام پیشنهاد.
`expectsAcceptanceOf.priceSpecification`	مشخصات قیمت	مورد نیاز - جزئیات قیمت مرتبط با بازی.
`expectsAcceptanceOf.priceSpecification.@type`	متن	مورد نیاز - همیشه روی `UnitPriceSpecification` تنظیم شود.
`expectsAcceptanceOf.priceSpecification.price`	شماره	مورد نیاز - قیمت خرید محتوا. قیمت باید یک مقدار مثبت غیر صفر باشد. برای بازی‌های با قیمت 0.00، لطفاً دسته `actionAccessibilityRequirement.category` را روی «رایگان» تنظیم کنید.
`expectsAcceptanceOf.priceSpecification.priceCurrency`	متن	مورد نیاز - واحد پول قیمت در قالب 3 حرف ایزو 4217 .
`expectsAcceptanceOf.priceSpecification.priceType`	PriceTypeEnumeration یا Text	در صورت وجود الزامی است - نوع قیمت ارائه شده در پیشنهاد. هنگامی که `actionAccessibilityRequirement.category` روی `purchase` تنظیم شده است، این یک ویژگی ضروری است و فقط 2 مقدار را می‌پذیرد: `https://schema.org/ListPrice` - نشان دهنده لیست قیمت یک بازی است. `https://schema.org/SalePrice` - نشان دهنده قیمت فروش (معمولاً برای مدت محدودی فعال) یک بازی است. هر دو `https://schema.org/ListPrice` و `https://schema.org/SalePrice` هنگام ارائه جزئیات قیمت فروش مورد نیاز هستند.
`expectsAcceptanceOf.seller`	سازمان	سازمانی که خرید محتوا را ارائه می دهد.
`expectsAcceptanceOf.seller.@type`	متن	همیشه روی `Organization` تنظیم شود.
`expectsAcceptanceOf.seller.name`	متن	نام فروشنده.
`expectsAcceptanceOf.seller.sameAs`	URL	URL یک صفحه وب که فروشنده را مشخص می کند. به عنوان مثال، صفحه اصلی فروشنده.

برای هر یک از انواع Paywall پشتیبانی شده، یک مثال زیر بینشی در مورد چگونگی ایجاد 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 (Work).

اموال	نوع مورد انتظار	توضیحات
`@context`	متن	مورد نیاز . همیشه روی `["http://schema.org", {"@language": "xx"}]` تنظیم شود. مقدار Where `xx` نشان دهنده زبان رشته ها در فید است. هر زمینه موجودیت ریشه باید `@language` خود را روی کد زبان مناسب در قالب BCP 47 تنظیم کند. به عنوان مثال، اگر زبان روی اسپانیایی تنظیم شده باشد، نام ها به زبان اسپانیایی فرض می شود، حتی اگر زبان زیرنویس/دوبله انگلیسی باشد.
`@type`	متن	مورد نیاز . همیشه روی `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` شی مورد نظر را ببینید.
`name`	متن	نام بازی. از یک آرایه برای فهرست کردن نام ها به زبان های مختلف استفاده کنید. برای جزئیات بیشتر، به مثال چندین منطقه و زبان مراجعه کنید. توجه داشته باشید که تنها یک نام در هر منطقه (جفت زبان-کشور) پشتیبانی می شود.
`description`	متن	بسیار توصیه می شود. خلاصه ای از بازی. محدودیت 300 کاراکتر از یک آرایه برای علامت گذاری توضیحات در چندین زبان استفاده کنید. برای جزئیات بیشتر، به مثال چندین منطقه و زبان مراجعه کنید.
`genre`	متن	فهرستی مرتب شده از همه ژانرهای مرتبط. به عنوان مثال: `["Action", "Role playing"]`
`image`	ImageObject	بسیار توصیه می شود. تصاویر مربوط به بازی برای جزئیات بیشتر در مورد ویژگی های مورد نیاز و اختیاری برای گنجاندن با `image` ، به ویژگی های تصویر مراجعه کنید.
`applicationCategory`	متن	اختیاری. نوع نرم افزار کاربردی مقدار را روی `Game` تنظیم کنید.
`exampleOfWork`	بازی ویدیویی	مورد نیاز نسخه `VideoGame` . این موجودیت `VideoGame` (نسخه) جزئیات پیوند عمیق را نیز به همراه دارد. برای جزئیات بیشتر، جدول مشخصات VideoGame (Edition) را ببینید.
`playMode`	متن یا حالت بازی	اختیاری نشان می دهد که این بازی چند نفره، کوآپ یا تک نفره است. بازی را می توان همزمان به صورت چند نفره، کوآپ و تک نفره مشخص کرد. مقادیر زیر را می پذیرد: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`

جدول مشخصات VideoGame (Edition).

اموال	نوع مورد انتظار	توضیحات
`@type`	متن	مورد نیاز . همیشه روی `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` شی مورد نظر را ببینید.
`name`	متن	نام بازی. از یک آرایه برای فهرست کردن نام ها به زبان های مختلف استفاده کنید. برای جزئیات بیشتر، به مثال چندین منطقه و زبان مراجعه کنید. توجه داشته باشید که تنها یک نام در هر منطقه (جفت زبان-کشور) پشتیبانی می شود.
`description`	متن	بسیار توصیه می شود. خلاصه ای از بازی. محدودیت 300 کاراکتر از یک آرایه برای علامت گذاری توضیحات در چندین زبان استفاده کنید. برای جزئیات بیشتر، به مثال چندین منطقه و زبان مراجعه کنید.
`genre`	متن	فهرستی مرتب شده از همه ژانرهای مرتبط. به عنوان مثال: `["Action", "Role playing"]`
`image`	ImageObject	بسیار توصیه می شود. تصاویر مربوط به بازی برای جزئیات بیشتر در مورد ویژگی های مورد نیاز و اختیاری برای گنجاندن با `image` ، به ویژگی های تصویر مراجعه کنید.
`applicationCategory`	متن	اختیاری. نوع نرم افزار کاربردی مقدار را روی `Game` تنظیم کنید.
`playMode`	متن یا حالت بازی	اختیاری نشان می دهد که این بازی چند نفره، کوآپ یا تک نفره است. بازی را می توان همزمان به صورت چند نفره، کوآپ و تک نفره مشخص کرد. مقادیر زیر را می پذیرد: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`
`potentialAction`	PlayGameAction	در صورت وجود الزامی است . یک شی نشانه گذاری Action که جزئیات عمل را ارائه می دهد. از یک آرایه برای تعیین پیوندهای عمیق مختلف در چندین منطقه استفاده کنید. برای اطلاعات بیشتر، به مثال چندین منطقه و زبان مراجعه کنید.
`gameEdition`	متن	مورد نیاز . نسخه این بازی. به عنوان نمونه ، بازی محبوب "Shadow of the Tomb Raider" در چهار نسخه ارائه می شود: "نسخه Croft" ، "نسخه استاندارد" ، "نسخه دیجیتال لوکس" و "نسخه نهایی".
`gamePlatform`	متن	مورد نیاز . سیستم عامل یا سیستم الکترونیکی برای بازی ویدیویی استفاده می شود.
`releasedEvent`	انتشار	بسیار توصیه می شود . از `PublicationEvent` برای مشخص کردن انتشار محتوای اصلی (جهانی یا محلی) توسط یک ناشر استفاده می شود.
`releasedEvent.@type`	متن	مورد نیاز . حتماً همیشه این ملک را بر روی `PublicationEvent` قرار دهید.
`releasedEvent.Location`	کشور	مورد نیاز . مناطقی که با این رویداد پرتاب همراه هستند. از کدهای ISO 3166 برای کشورها استفاده کنید. برای نشان دادن در همه جای جهان ، روی `EARTH` تنظیم شده است.
`releasedEvent.startDate`	تاریخ یا زمان	توصیه می شود . مورد نیاز برای `ExclusiveEvent` . تاریخ شروع انتشار نهاد.
`releasedEvent.endDate`	تاریخ یا زمان	اختیاری این نشان دهنده تاریخ انقضاء حقوق محتوا است.
`releasedEvent.publishedBy`	سازمان یا شخص	اختیاری سازمان یا شخصی که این نهاد را منتشر کرده است.
`contentRating`	متن	مورد نیاز برای بازی های بزرگسالان ، در غیر این صورت بسیار توصیه می شود . رتبه کلی محتوای. اگر رتبه بندی محتوا به شکل یک رشته متن داده شود ، دو تغییر پذیرفته شده است: آژانس رتبه بندی با یک فضای سفید در بین رتبه بندی به رتبه رسیده است. به عنوان مثال ، رتبه بندی "بالغ" از آژانس "هیئت رتبه بندی نرم افزار سرگرمی" در ایالات متحده باید به عنوان `Entertainment Software Rating Board Mature` توصیف شود. مقدار `RATING NOT KNOWN` (مورد غیر حساس) برای نشان دادن اینکه شما رتبه بازی را نمی دانید.
`publisher`	سازمان یا شخص	اختیاری سازمان یا شخصی که این نهاد را منتشر کرده است.
`contributor`	سازمان یا شخص	اختیاری یک کمک کننده ثانویه در این نهاد.

جدول مشخصات تصویر

اقدامات بازی بازی با استفاده مجدد از طرح رسانه های رسانه ای برای ضبط نیازهای تصویر استفاده می کند. برای اطلاعات بیشتر ، به مشخصات Schema Image مراجعه کنید.

در اینجا برخی از الزامات دیگر برای به خاطر سپردن وجود دارد.

نسبت ابعاد و `contentAttributes`	حداقل وضوح (در پیکسل)
16: 9 ، پوستر نمادین	3840x2160
2: 3 ، پوستر نمادین	1000x1500
4: 3 ، پوستر نمادین	800x600
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 که نمایانگر بازی "جنگ فضایی ساخته شده" است. به خاطر داشته باشید که این نهاد باید در پاکت داده داده در پرونده 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 Game Actions

شروع کنید

قبل از شروع

استفاده از Works و Editions را در این مستندات درک کنید

URL متعارف (url)

شناسه (@id)

درک و شناسایی الزامات پیوند عمیق

انواع پی وال

فید خود را ایجاد کنید

به اندازه، مقدار و قالب فایل فید پایبند باشید

به الزامات محتوای فید پایبند باشید

فید خود را میزبانی کنید

فید خود را برای بررسی ارسال کنید

نمونه

اعتبار سنجی فید چگونه کار می کند

معیارهای پذیرش خوراک

در صورت نیاز فید خود را به روز کنید

مرجع

نمای کلی ساختار خوراک

پاکت خوراک داده

الگو

اشیاء نشانه گذاری محتوا

اشیاء نشانه گذاری عمل

الگو

هدف

مثال

مشخصات دسترسی اقدام

نمونه هدف با دو پیوند عمیق

مشخصات دسترسی اقدام

مشخصات اشتراک رسانه

املاک را ارائه دهید

رایگان (بدون نیاز به ورود)

رایگان (بدون نیاز به ورود) فقط با یک ساعت آزمایشی

رایگان (لازم است وارد شوید)

خرید یکباره با فروش

خرید یکباره

اشتراک های تک لایه/چند لایه/افزودنی

اشتراک های سطحی و افزونه ها

الگوی کلی یک موجودیت

الگو

تعاریف نوع داده های ساخت یافته

جدول مشخصات VideoGame (Work).

جدول مشخصات VideoGame (Edition).

جدول مشخصات تصویر

الزامات قالب

نمونه ها

نمونه فید با یک موجودیت بازی ویدیویی

نمایش یک تصویر نمونه با دو شخصیت بازی

برخورد با چندین منطقه و زبان (بین المللی سازی)