דף זה תורגם על ידי Cloud Translation API.

פעולות במשחקים

סקירה כללית

במסמך הזה מוסבר על התכונה 'פעולות במשחקים' ב-Play למשחקי וידאו, מפורטים בו דרישות הסכימה ומתואר תהליך ההצטרפות לשימוש בתכונה.

מבוא לפעולות במשחקים ב-Play

תמונה של פעולות ב-Play Games במכשיר נייד

התכונה 'פעולות הפעלה של משחקים' מאפשרת למשתמשים לשחק במשחק ישירות מדף תוצאות החיפוש (SRP) במחשב או בנייד. כשמשתמשים מחפשים משחק שיש לו לפחות פעולה אחת שמשויכת ל-Play Games, מוצגת להם פעולה של Play Games בכרטיסייה 'סקירה כללית' של דף תוצאות החיפוש המאורגן (OSRP) או בכרטיס המידע. האפשרות הזו פועלת בגרסאות הדגמה או בגרסאות מלאות של משחקים שזמינים בחינם, דרך מינוי או דרך רכישה לפי דרישה, ואפשר להזרים אותם מהענן במחשב או בנייד, או להוריד אותם דרך אפליקציות לקוח מקומיות במחשב או בקונסולה.

הפעולות במשחקי 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 (Work) הוא ישות VideoGame ברמה העליונה:

‫exampleOfWork הוא מאפיין של VideoGame (Work) ומציין מופע אחד או יותר של VideoGame (Edition).
צריך להיות לפחות 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 קנונית תקינה ש-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 Games על תוכן, Google משתמשת בקישור העומק של התוכן כדי להעביר את המשתמש ישירות לתוכן באפליקציה או בפלטפורמה שלכם. חשוב לזכור:

קישורי עומק צריכים לפתוח את התוכן שאליו הם מפנים בכל הפלטפורמות שצוינו. בפלטפורמות שונות יכולים להיות קישורי עומק שונים. לדוגמה, קישור העומק שפועל באתר במחשב יכול להיות שונה מקישור העומק שפועל באתר בנייד. לכל משחק, בודקים אם יש לו קישורי עומק שונים בהתאם לפלטפורמה.
קישורי עומק יכולים לכלול פרמטרים (&) או תגי עוגן (#).
כדי לוודא שהתוכן שלכם זמין בפלטפורמות השונות של Google (חיפוש Google,‏ Assistant ו-Android TV), אתם צריכים להשתמש בקישור עמוק.

מכיוון שערך url של ישות עומד בכל הדרישות של מזהה (כלומר, הוא ייחודי באופן גלובלי, סטטי ובפורמט של URI), מומלץ להשתמש בערך 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 (בודקים את ההגדרה של עורך הקבצים).
אם קובץ הפיד גדול מ-1GB כשהוא לא דחוס, צריך לפצל אותו לכמה קבצים.
- כל עוד גודל הקובץ קטן מ-1GB, אין הגבלה על מספר הישויות שאפשר לכלול בקובץ יחיד או על מספר הקבצים שאפשר לשלוח ל-Google כחלק משליחת הפיד.
חשוב לוודא שהקובץ מקודד בלי BOM, בהתאם למפרט JSON. כדי לאמת את זה במערכת הפעלה Linux, ‏ hexdump file.json | head -n 1 לא יכול להתחיל עם BBEF בכתובת 0x00.

עמידה בדרישות לגבי תוכן הפיד

עליכם לעמוד בדרישות התוכן הבאות:

הפיד לא יכול להכיל ישויות לא עדכניות. ישות לא פעילה היא ישות שבה הערך של availabilityEnds בקישור העמוק מוגדר לתאריך שכבר חלף, או ישות שכבר לא זמינה באתר.
כל קישורי העומק, כמו urlTemplate, וכל כתובות ה-URL, כמו url, שאתם כוללים בפיד צריכים להיות כתובות URL של סביבת ייצור. אל תשתמשו בכתובות URL של QA, פיתוח או כל סוג אחר של כתובות 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 Game Actions כדי לבדוק את קובץ הפיד.

שליחת הפיד לבדיקה

אחרי שהקובץ של הפיד מתארח, צריך לפנות לאיש הקשר שהוקצה לכם בנושא פעולות במשחקי Play כדי להתחיל את תהליך הבדיקה של הפיד. חשוב לכלול את הפרטים הבאים בהודעה הזו:

סקירה כללית/תיאור: צריך לציין אם אתם משתפים פיד לדוגמה או פיד מלא של נתוני ייצור. אם אתם משתפים פיד לדוגמה, כדאי לציין את תאריך ההגעה המשוער של פיד הייצור, אם אפשר.
מיקום המארח: כתובת ה-URL של קובץ הפיד.
אימות המארח: אם רלוונטי, צריך לכלול את פרטי האימות כדי לאפשר ל-Google לאחזר את קובץ הפיד מהמארח. מידע נוסף זמין במאמר בנושא אירוח הפיד.
חשבון בדיקה: חשבון בדיקה שמאפשר לצוות של Play Game Actions לגשת לקישורי העומק באפליקציה או בפלטפורמה שלכם לצורך בדיקה. אם הפיד מכיל ישויות בכמה פלטפורמות, צריך לספק חשבון בדיקה לכל פלטפורמה.
Icons: צריך לשלוח את חמשת הסמלים הבאים. הסמלים האלה מופיעים לצד הפעולות במשחק Play בחיפוש Google.

קטגוריה	מידות (פיקסלים)	גודל הקובץ	הנחיות
הפעלת פעולות במשחקים בחיפוש Google, ב-Cast ובמקומות אחרים
	‫16x16	גודל הקובץ של כל הסמלים, למעט הסמל בגודל 112x112 פיקסלים, לא יכול להיות גדול מ-1KB. גודל הקובץ של הסמל בגודל 112x112 פיקסלים לא יכול להיות גדול מ-3KB.	חובה לציין את כל חמשת המאפיינים של הסמל. התמונות צריכות לעמוד בדרישות הבאות: פורמט קובץ PNG. צורה עגולה. רקע שקוף. חשוב לוודא שהתמונות לא מפוקסלות או מעוותות, ושהן עברו החלקה למניעת פיקסול.
	‎20 x 20
	40x40
	44x44
	112x112

דוגמה

איך פועל אימות הפיד

יש שני שלבים לאימות הפיד:

אימות המבנה:
- זהו השלב הראשון של בדיקות האימות.
- ‫Google מספקת משוב שקשור למבנה של קובצי ה-JSON. האם קובץ ה-JSON בפורמט תקין? האם הפיד מכיל את כל מאפייני החובה והמאפיינים המומלצים? האם קישורי העומק שסופקו מתאימים לדרישות שלנו לגבי פידים?
- בשלב הזה מתנהלים כמה דיונים עם Google, והוא נמשך עד שכל המשוב מטופל.
התאמת מטא-נתונים:
- התהליך הזה מתחיל רק אחרי שהפיד עובר את שלב אימות המבנה, ואז Google מתחילה בתהליך ההתאמה עם Knowledge Graph של Google.
- בשלב הזה אנחנו מספקים משוב על המטא-נתונים שכלולים בפיד. כדי שההשקה תתבצע בהצלחה, צריך לפתור את כל הבעיות. לדוגמה, בשלב הזה יכול להיות שתקבלו משוב עם בקשה לתקן את שם המשחק או את תאריך הפרסום שלו.
- בשלב הזה מתנהלים גם כמה דיונים עם Google, והוא נמשך עד שכל המשוב מטופל.

קריטריונים לקבלת פיד

פיד נחשב מתאים להשקה אם כל הבעיות שמונעות את ההשקה נפתרו ואיכות המטא-נתונים עומדת בדרישות של Google להשקה.

עדכון הפיד לפי הצורך

מומלץ לעדכן את הפיד מדי יום, אבל זה תלוי בתדירות שבה הקטלוג שלכם משתנה. חשוב לשים לב לתנאים ולטיפים הבאים:

חיפוש Google לא תומך בעדכונים בזמן אמת.
חיפוש Google מאחזר את הפיד שלכם פעם ביום, ובדרך כלל מוסיף את התוכן לאינדקס תוך יומיים (כשמשיקים את התכונה).
אם צפוי שינוי בזמינות של קישורי עומק, צריך להשתמש בתגיות availabilityStarts ו-availabilityEnds כדי להגדיר את התאריכים המדויקים.
אם הישות כבר לא זמינה בקטלוג, צריך להסיר אותה לגמרי מהפיד.

חומרי עזר

סקירה כללית על מבנה הפיד

פיד הפעולות במשחקי Play בנוי באופן הבא:

מעטפת של פיד נתונים

מעטפת פיד הנתונים היא האובייקט ברמה העליונה בפיד הפעולות במשחקי Play. האובייקט מכיל מערך של אובייקטים של תגי תוכן (ישויות VideoGame (Work)) שמייצגים את כל משחקי הווידאו בקטלוג שלכם.

נכס	סוג צפוי	תיאור
`@context`	כתובת URL	נדרש. ההגדרה היא `http://schema.org`
`@type`	טקסט	נדרש. ההגדרה היא `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(מהדורה). ל-VideoGame(Edition) הזה יכול להיות מערך של אובייקטים של תגי Action, שמאפשרים לשייך את התוכן למספר אובייקטים של תגי Action. לדוגמה, יכול להיות שלתוכן יהיה אובייקט שונה של תגי עיצוב של פעולה לכל אזור.

אובייקטים של תגי עיצוב של פעולות

אובייקט של תגי עיצוב של פעולה מתאר את קישור העומק שמעביר את המשתמשים למשחק ואת רמת הגישה שנדרשת למשחק. האובייקט הוא מאפיין (potentialAction) של אובייקט של תגי עיצוב לתוכן. כדי להגדיר פעולות במשחקי Play, צריך להשתמש באובייקט של הגדרת גישה לפעולה כדי לציין את הגבלות הגישה.

נכס	סוג צפוי	תיאור
`@type`	טקסט	נדרש. הערך תמיד יהיה `PlayGameAction`.
`gameAvailabilityType`	‫GameAvailabilityEnumeration או Text	נדרש. מציין את סוג הזמינות של תוכן המשחק שמשויך לפעולה הזו, למשל אם מדובר בגרסה מלאה או בהדגמה. הערכים הקבילים כוללים `DEMO` ו-`FULL`.
`additionalType`	טקסט	נדרש. מציין את סוג פעולת ההפעלה שמשויכת למשחק הזה. הערכים הקבילים כוללים: ‫`StreamingPlayAction` – מציין שאפשר להפעיל את המשחק בסטרימינג באינטרנט ‫`DownloadPlayAction` – מציין שמשחק זמין להורדה
`target`	EntryPoint	נדרש. אובייקט יעד שמספק את המיפוי של קישורי עומק לפלטפורמות שונות של Google.
`target.@type`	טקסט	נדרש. הערך תמיד יהיה `EntryPoint`.
`target.urlTemplate`	כתובת URL	נדרש. קישור עומק שמעביר את המשתמשים לאפליקציה או לפלטפורמה שלכם ומתחיל את הפעלת המשחק.
`target.inLanguage`	טקסט	אופציונלי. שפת המקור של הסדרה בפורמט BCP 47.
`target.actionPlatform`	טקסט	נדרש. הפלטפורמות שממופות ל-`urlTemplate`. יש תמיכה בערכים הבאים של פעולות במשחק: 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) של אובייקט Action markup. המאפיין 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 markup.

דוגמה ליעד עם שני קישורי עומק

"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, של אובייקט של תג עיצוב של פעולה.

נכס	סוג צפוי	תיאור
`actionAccessibilityRequirement.@type`	טקסט	נדרש. הערך תמיד יהיה `ActionAccessSpecification`.
`actionAccessibilityRequirement.category`	טקסט	נדרש. דרישת גישה לתוכן. מידע נוסף על הערכים הקבילים זמין במאמר סוג חומת תשלום. אם ישות מייצגת קבוצת תוכן, צריך להגדיר את הקטגוריה לדרישת הגישה הכי פחות מגבילה של התוכן שלה. לדוגמה, אם יש משחק שאפשר לגשת אליו בחינם באמצעות `nologinrequired` וגם באמצעות מינוי, צריך להגדיר את הקטגוריה כ-`nologinrequired`.
`actionAccessibilityRequirement.availabilityStarts`	‫תאריך	נדרש. התאריך שאחריו הפעולה זמינה, בפורמט ISO 8601 (כולל אזור זמן). אפשר להגדיר תאריך עתידי. הערך חייב להיות שווה ל-72 שעות אחרי `availabilityStarts` או גדול ממנו. אם התוכן תמיד זמין אחרי שהוא מתפרסם, צריך להגדיר את התאריך הזה ל-20 שנה מהתאריך הנוכחי. אנחנו דורשים לספק את הישות המתאימה בפיד לפחות שבעה ימים לפני תאריך `availabilityStarts` שלה. כך גדלים הסיכויים שהמשחק יוצג בפלטפורמות של Google בזמן.
`actionAccessibilityRequirement.availabilityEnds`	‫תאריך	נדרש. התאריך שאחריו הפעולה לא זמינה יותר, בפורמט ISO 8601 (כולל אזור זמן). אפשר להגדיר תאריך עתידי. הערך חייב להיות שווה ל-72 שעות אחרי `availabilityStarts` או גדול ממנו. אם התוכן תמיד זמין אחרי שהוא מתפרסם, צריך להגדיר את התאריך הזה ל-20 שנה מהתאריך הנוכחי. אנחנו דורשים שכל עדכון של התאריך `availabilityEnds` יתבצע בפיד לפחות שבעה ימים לפני התאריך `availabilityEnds`. כך גדל הסיכוי שהמשחק לא יופיע יותר בפלטפורמות של Google החל מהתאריך `availabilityEnds`.
`actionAccessibilityRequirement.eligibleRegion`	מדינה, עיר, מדינה, GeoShape או טקסט	נדרש. האזורים שבהם התוכן זמין. אם התוכן זמין בכל העולם, צריך להשתמש במחרוזת המיוחדת `EARTH`. מידע נוסף על מאפייני GeoShape
`actionAccessibilityRequirement.ineligibleRegion`	מדינה, עיר, מדינה, GeoShape או טקסט	חובה אם רלוונטי. אזורים שבהם התוכן מוגבל. אם התוכן זמין בכל מקום ב-`eligibleRegion`, לא צריך לציין את המאפיין הזה. מידע נוסף על מאפייני GeoShape
`actionAccessibilityRequirement.requiresSubscription`	MediaSubscription	חובה אם רלוונטי. פרטי המינוי שנדרשים למשתמשים כדי לגשת לתוכן. פרטים נוספים זמינים במאמר בנושא מאפיינים של מינוי לתוכן מדיה. צריך לציין את המאפיין הזה אם הערך של `category` הוא `subscription`.
`actionAccessibilityRequirement.expectsAcceptanceOf`	מבצע	חובה אם התוכן דורש רכישה. פרטי המבצע שמשויך לתוכן. צריך לספק את פרטי המחיר במקרים הבאים: תוכן לרכישה חד-פעמית (`rental` או `purchase`) תוכן שמבוסס על מינוי ודורש רכישה נוספת מהמנויים (`subscription`) אם המחיר הוא 0.00, צריך להסיר לגמרי את אובייקט המוצר ולהגדיר את `actionAccessibilityRequirement.category` כ-`free`. פרטים נוספים זמינים במאמר בנושא מאפייני מבצעים.

המפרט של מינוי לתוכן מדיה

אובייקט של מינוי למדיה מתאר את פרטי המינוי שנדרש כדי לצפות בתוכן. האובייקט הוא מאפיין, requiresSubscription, של אובייקט של מפרט גישה לפעולה.

חשוב: חובה להשתמש בפרמטר הזה אם הערך של actionAccessibilityRequirement.category הוא subscription והמינוי כולל כמה חבילות או רמות, או אם הוא תומך בתוספים. אל תציינו את המאפיין הזה אם המינוי שלכם הוא ברמה אחת ומאפשר גישה לכל התוכן בקטלוג.

נכס	סוג צפוי	תיאור
`requiresSubscription.@type`	טקסט	נדרש. הערך תמיד יהיה `MediaSubscription`.
`requiresSubscription.@id`	כתובת URL	נדרש. המזהה הייחודי של המינוי. אם אפשר לגשת לתוכן באמצעות מינויים שונים, לכל מינוי צריך להיות מזהה ייחודי.
`requiresSubscription.name`	טקסט	נדרש. שם המינוי. חשוב לשים לב: אם אפשר לגשת לתוכן באמצעות מינויים שונים, השם הזה צריך להיות זהה לשם במערכת אימות המשתמשים שלכם. לדוגמה, אם למשתמש יש גישה לתוכן על סמך מינוי שנקרא Package 1, אבל מערכת האימות משתמשת בשם PKG1, צריך להשתמש ב-PKG1.
`requiresSubscription.sameAs`	כתובת URL	אופציונלי. הדף שמתאר את המינוי.
`requiresSubscription.identifier`	טקסט	חובה אם הערך של `category` הוא `subscription` והערך של `commonTier` הוא false. מחרוזת ייחודית למינוי הזה שמייצגת גישה לקבוצת תוכן בקטלוג המדיה שלכם. ‫Google ממליצה להשתמש בתחביר הבא עבור `identifier`:שם הדומיין + נקודתיים (:) + רמת הגישה לתוכן, דוגמאות : `example.com`:basic, `example.com:premium`, `example.com:sports`
`requiresSubscription.commonTier`	בוליאני	חובה אם הקטגוריה מוגדרת כמינוי. מידע נוסף על `commonTier` זמין במסמכי התיעוד בנושא הדרישות המשותפות לכל הרמות.

מאפייני המבצע

אובייקט של מבצע מתאר את המחיר שמשויך לתוכן. האובייקט הוא מאפיין (expectsAcceptanceOf) של אובייקט הגדרת הגישה לפעולה. אפשר להשתמש בו לשתי מטרות:

לספק את פרטי הרכישה של המשחק. בתרחיש השימוש הזה, צריך להגדיר את actionAccessibilityRequirement.category ל-purchase.
לספק את פרטי הרכישה של המשחק כשהוא במבצע. במקרה השימוש הזה, הערך של actionAccessibilityRequirement.category צריך להיות purchase, וצריך לספק שתי הצעות לכל פעולה – אחת לציון פרטי מחיר המחירון ואחת לציון פרטי מחיר המבצע.

נכס	סוג צפוי	תיאור
`expectsAcceptanceOf.@type`	טקסט	חובה – תמיד מוגדר ל-`Offer`.
`expectsAcceptanceOf.name`	טקסט	Optional - The name of the offer.
`expectsAcceptanceOf.priceSpecification`	PriceSpecification	חובה – פרטי התמחור שמשויכים למשחק.
`expectsAcceptanceOf.priceSpecification.@type`	טקסט	חובה – תמיד מוגדר ל-`UnitPriceSpecification`.
`expectsAcceptanceOf.priceSpecification.price`	מספר	חובה – מחיר הרכישה של התוכן. המחיר חייב להיות ערך חיובי שונה מאפס. למשחקים עם מחיר של 0.00, צריך להגדיר את הערך `actionAccessibilityRequirement.category` ל-`free`.
`expectsAcceptanceOf.priceSpecification.priceCurrency`	טקסט	חובה – המטבע של המחיר בפורמט ISO 4217 בן 3 אותיות.
`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 של דף אינטרנט שמזהה את המוכר, למשל דף הבית של המוכר.

לכל אחד מסוגי חומות התשלום הנתמכים, מופיעה דוגמה שמסבירה איך צריך ליצור את התג 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"}]`. הערך `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 תווים. משתמשים במערך כדי לתייג את התיאור בכמה שפות. פרטים נוספים זמינים בדוגמה Multiple regions and languages.
`genre`	טקסט	רשימה מסודרת של כל הז'אנרים הרלוונטיים. לדוגמה: `["Action", "Role playing"]`
`image`	ImageObject	מומלץ מאוד. התמונות שקשורות למשחק. פרטים נוספים על המאפיינים הנדרשים והאופציונליים שצריך לכלול עם `image` זמינים במאמר מאפייני תמונה.
`applicationCategory`	טקסט	אופציונלי. סוג אפליקציית התוכנה. הגדרת הערך כ-`Game`.
`exampleOfWork`	VideoGame	חובה. מהדורת `VideoGame`. היישות `VideoGame` (מהדורה) הזו כוללת גם את פרטי קישור העומק. פרטים נוספים זמינים בטבלת המפרט של VideoGame (מהדורה).
`playMode`	טקסט או GamePlayMode	אופציונלי. מציין אם המשחק הזה הוא משחק מרובה משתתפים, משחק שיתופי או משחק לשחקן יחיד. אפשר לסמן את המשחק כמשחק מרובה משתתפים, כמשחק שיתופי וכמשחק לשחקן יחיד בו-זמנית. הערכים הקבילים: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`

טבלת מפרט של משחק וידאו (מהדורה)

נכס	סוג צפוי	תיאור
`@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 תווים. משתמשים במערך כדי לתייג את התיאור בכמה שפות. פרטים נוספים זמינים בדוגמה Multiple regions and languages.
`genre`	טקסט	רשימה מסודרת של כל הז'אנרים הרלוונטיים. לדוגמה: `["Action", "Role playing"]`
`image`	ImageObject	מומלץ מאוד. התמונות שקשורות למשחק. פרטים נוספים על המאפיינים הנדרשים והאופציונליים שצריך לכלול עם `image` זמינים במאמר מאפייני תמונה.
`applicationCategory`	טקסט	אופציונלי. סוג אפליקציית התוכנה. הגדרת הערך כ-`Game`.
`playMode`	טקסט או GamePlayMode	אופציונלי. מציין אם המשחק הזה הוא משחק מרובה משתתפים, משחק שיתופי או משחק לשחקן יחיד. אפשר לסמן את המשחק כמשחק מרובה משתתפים, כמשחק שיתופי וכמשחק לשחקן יחיד בו-זמנית. הערכים הקבילים: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`
`potentialAction`	PlayGameAction	חובה אם רלוונטי. אובייקט של תגי עיצוב של פעולה שמספק את פרטי הפעולה. כדי לציין קישורי עומק שונים במספר אזורים, משתמשים במערך. מידע נוסף זמין בדוגמה Multiple regions and languages.
`gameEdition`	טקסט	נדרש. המהדורה של המשחק הזה. לדוגמה, המשחק הפופולרי Shadow of the Tomb Raider מוצע בארבע מהדורות: Croft Edition,‏ Standard Edition,‏ Digital Deluxe Edition ו-Ultimate Edition.
`gamePlatform`	טקסט	נדרש. פלטפורמה או מערכת אלקטרונית שמשמשות להפעלת משחק הווידאו.
`releasedEvent`	PublicationEvent	מומלץ מאוד. תג `PublicationEvent` משמש לציון התוכן המקורי (גלובלי או מקומי) שפורסם על ידי בעל התוכן הדיגיטלי.
`releasedEvent.@type`	טקסט	נדרש. חשוב להקפיד להגדיר את המאפיין הזה תמיד לערך `PublicationEvent`.
`releasedEvent.Location`	מדינה	נדרש. האזורים שמשויכים לאירוע ההשקה הזה. צריך להשתמש בקודי ISO 3166 למדינות. כדי לציין את כל המקומות בעולם, מגדירים את הערך `EARTH`.
`releasedEvent.startDate`	תאריך או שעה	מומלץ. נדרש עבור `ExclusiveEvent`. תאריך ההתחלה של פרסום הישות.
`releasedEvent.endDate`	תאריך או שעה	אופציונלי. התאריך שבו הזכויות על התוכן פוקעות.
`releasedEvent.publishedBy`	ארגון או אדם	אופציונלי. הארגון או האדם שפרסמו את הישות הזו.
`contentRating`	טקסט	חובה במשחקים למבוגרים, מומלץ מאוד במשחקים אחרים. סיווג התוכן הכולל. אם סיווג התוכן ניתן בצורה של מחרוזת טקסט, המערכת מקבלת שתי וריאציות: סוכנות הדירוג הוסיפה את הדירוג לפני הדירוג עם רווח ביניהם. לדוגמה, סיווג Mature (לגיל 17 ומעלה) של הסוכנות Entertainment Software Rating Board בארה"ב צריך להיות מתואר כ-`Entertainment Software Rating Board Mature`. ערך של `RATING NOT KNOWN` (לא תלוי באותיות רישיות) כדי לציין שאתם לא יודעים מה הסיווג של המשחק.
`publisher`	ארגון או אדם	אופציונלי. הארגון או האדם שפרסמו את הישות הזו.
`contributor`	ארגון או אדם	אופציונלי. תורם משני לישות הזו.

טבלת מפרט התמונות

הפעולות של Play Games משתמשות בסכימת Media Actions כדי לתעד את הדרישות לגבי התמונות. מידע נוסף זמין במפרט סכימת התמונות.

ריכזנו כאן עוד דרישות שכדאי לזכור.

יחס גובה-רוחב ו`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, רקע אייקוני [מומלץ] או תמונה סטטית של סצנה	‫600x800

הדרישות בנוגע לפורמט

אלה דרישות הפורמט שבהן אתם צריכים לעמוד בנוגע לגודל התמונה, האיכות וכו':

מוסיפים את הפוסטרים ברזולוציה הגבוהה ביותר ואת sceneStills שיש לכם עבור המשחק.
התמונה צריכה להיות בפורמט JPG,‏ PNG או WebP.
כתובת ה-URL של התמונה צריכה להיות ניתנת לסריקה וניתנת להוספה לאינדקס.
גודל הקובץ לא יכול להיות גדול מ-20 MB.
אנחנו מעדיפים תמונות שמתאימות גם ל-smallFormat וגם ל-largeFormat.
אסור שהתמונה תכיל:
- תמונה מטושטשת, מפוקסלת, מסובבת או באיכות נמוכה.
- תמונות ממאגרי תמונות או תמונות ללא רישיון.
- עירום.
- תוכן לא חוקי.
אפשר לכלול גדלים של תמונות בנוסף לאלה שמפורטים בטבלה שלמעלה.

דוגמאות

בקטעים הבאים יש דוגמאות לפידים שמתאימים לתרחישים שונים.

פיד לדוגמה עם ישות אחת מסוג VideoGame

הנה דוגמה לישות VideoGame שמייצגת את המשחק Space Wars Made Up Game. חשוב לזכור שהישות הזו צריכה להיות כלולה במעטפת של פיד הנתונים בקובץ 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

שנתחיל?

לפני שמתחילים

הסבר על השימוש במונחים 'יצירות' ו'מהדורות' במסמך הזה

כתובת URL קנונית (url)

מזהה (@id)

הבנה וזיהוי של הדרישות לקישור עומק

סוגים של חומות תשלום

יצירת הפיד

עמידה בדרישות לגבי גודל הקובץ, הכמות והפורמט של הפיד

עמידה בדרישות לגבי תוכן הפיד

אירוח הפיד

שליחת הפיד לבדיקה

דוגמה

איך פועל אימות הפיד

קריטריונים לקבלת פיד

עדכון הפיד לפי הצורך

חומרי עזר

סקירה כללית על מבנה הפיד

מעטפת של פיד נתונים

תבנית

אובייקטים של תגי עיצוב לתוכן

אובייקטים של תגי עיצוב של פעולות

תבנית

יעד

דוגמה

מפרט גישה לפעולה

דוגמה ליעד עם שני קישורי עומק

מפרט גישה לפעולה

המפרט של מינוי לתוכן מדיה

מאפייני המבצע

ללא תשלום (לא נדרשת התחברות)

בחינם (לא נדרשת כניסה לחשבון) עם תקופת ניסיון של שעה אחת בלבד

בחינם (נדרשת התחברות)

רכישה חד-פעמית עם מבצע

רכישה חד-פעמית

מינויים עם רמה אחת, כמה רמות או חבילות

מינויים וחבילות ברמות שונות

תבנית כללית של ישות

תבנית

הגדרות של סוגי נתונים מובְנים

טבלת המפרט של VideoGame (Work)‎

טבלת מפרט של משחק וידאו (מהדורה)

טבלת מפרט התמונות

הדרישות בנוגע לפורמט

דוגמאות

פיד לדוגמה עם ישות אחת מסוג VideoGame

ייצוג של תמונה לדוגמה עם שתי דמויות במשחק

התמודדות עם כמה אזורים ושפות (בינלאומיות)