המקטע הזה מספק את הפרטים של מאפייני תגי העיצוב של תוכן עבור סוג הישות Movie.
טבלת מפרט
| נכס | הסוג הצפוי | תיאור |
|---|---|---|
@context |
טקסט | חובה – תמיד מוגדר לערך ["http://schema.org", {"@language": "xx"}]
|
@type |
טקסט | חובה – תמיד מוגדר לערך Movie עבור סרטים. |
@id |
כתובת URL | חובה – מזהה התוכן בפורמט URI; לדוגמה, https://example.com/1234abc.@id חייב לעמוד בדרישות הבאות:
url של ישות עומד בכל הדרישות כמזהה, אנחנו ממליצים להשתמש ב-url של ישות בתור @id. פרטים נוספים זמינים בקטע מזהה. |
url |
כתובת URL | חובה – כתובת ה-URL הקנונית של התוכן, ש-Google משתמשת בה כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google.url חייבת לעמוד בדרישות הבאות:
urlTemplate של אובייקט היעד. |
name |
טקסט | חובה – שם הסרט.
|
titleEIDR |
טקסט | מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג ברמה הכללית/המופשטת ביותר יצירת סרטים או תוכן בטלוויזיה. לדוגמה, titleEIDR של סרט הסרט 'מכסחי רפאים' הוא '10.5240/7EC7-228A-510A-053E-CBB8-J'. |
editEIDR |
טקסט | מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג מהדורה ספציפית של יצירה או סרט טלוויזיה. לדוגמה, הסרט שמכונה "מכסחי השדים" שכותרת EIDR היא "10.5240/7EC7-228A-510A-053E-CBB8-J", וביצעו כמה עריכות, למשל: "10.5240/1F2A-E1C5-680A-14C6-E76B-I" ו-"10.5240/8A35-3BEE-6497-5D12-9E4F-3". titleEIDR הוא מאפיין חובה כשמציינים EditEIDR. |
potentialAction |
WatchAction | חובה אם רלוונטי – אובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה.
|
sameAs |
כתובת URL | מומלץ מאוד למה? כתובת URL של דף אינטרנט שיכול לזהות את הסרט. לדוגמה, דף ויקיפדיה של הסרט. הערך הזה חייב להיות שונה מהמאפיין url. |
inLanguage |
טקסט | השפה המקורית של הסרט בפורמט BCP 47. |
genre |
טקסט | רשימה ממוינת של כל הז'אנרים הרלוונטיים. לדוגמה : ["פעולה", "אופנה", "סביבה", "כדורגל"] |
keywords |
טקסט | מילות המפתח או התגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך מילות מפתח. לדוגמה, המילה ["תכונה, ביוגרפיה"] יכולה להיות מערך של מילות מפתח שמתארות את התוכן. |
releasedEvent |
PublicationEvent, FeaturedEvent או ExclusiveEvent |
מומלץ מאוד למה? - PublicationEvent משמש לציון ההוצאה המקורית (גלובלית או מקומית) של תוכן שמוציא לאור יוצר, למשל תאריך ההפצה המקורי של סרט.בנוסף, צריך להשתמש ב- FeaturedEvent כדי לציין שהשירות משווק את התוכן הזה בתור תוכן מקורי, מוצג, מיוחד וכן הלאה.ExclusiveEvent מציין שלשירות שלך יש זכויות הפצה בלעדיות והוא כולל איפה ומתי.יש פרטים ודוגמאות בקטע לדוגמה. |
releasedEvent.@type |
טקסט | חובה – הקפידו תמיד להגדיר את המאפיין הזה לאחת מהאפשרויות הבאות:
|
releasedEvent.location |
מדינה | חובה – האזורים שמשויכים לאירוע הזה. אם מדובר ב- PublicationEvent, זהו האזור שבו התוכן פורסם.ב FeaturedEvent ובExclusiveEvent, זהו האזור שבו התוכן מוצג או בלעדי.יש להשתמש בקודי ISO 3166 למדינות. כדי לציין בכל מקום בעולם, צריך להגדיר את הערך EARTH. |
releasedEvent.startDate |
Date או DateTime | מומלץ – חובה עבור ExclusiveEvent – תאריך ההתחלה של הפרסום של הישות.ב PublicationEvent, תאריך הפרסום הראשוני של הישות הזו הוא תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לראשונה בבתי קולנוע.עבור ExclusiveEvent ו-FeaturedEvent, תאריך ההתחלה של התאריך שבו הישות הייתה בלעדית או מוצגת. |
releasedEvent.endDate |
Date או DateTime | מומלץ – חובה עבור ExclusiveEvent – רלוונטי רק לסוגים ExclusiveEvent ו-FeaturedEvent.ב ExclusiveEvent, הערך הזה מייצג את התאריך שבו פג התוקף של הזכויות על התוכן.ב- FeaturedEvent, זה מייצג את התאריך האחרון שבו הספק מציג את הישות.אם התוכן מוצג או בלעדי תמיד, צריך להגדיר את endDate ל-20 שנים מהתאריך הנוכחי. |
releasedEvent.publishedBy |
ארגון או אדם | אופציונלי – הארגון או האדם שפרסמו את הישות הזו. |
description |
טקסט | מומלץ מאוד למה? תקציר של הסרט. תקצירי עלילה עדיפים על סיכומים עובדתיים. עד 300 תווים.
|
duration |
משך הקורס | זמן הריצה של הסרט בפורמט ISO 8601. יש להשתמש בפורמט: "PT00H00M". |
director |
אדם | מומלץ מאוד למה? במאי הסרט. |
actor |
אדם | מומלץ מאוד למה? השחקנים בסרט. |
producer |
ארגון או אדם | מומלץ מאוד למה? מפיקי הסרט. |
image |
ImageObject | חובה ב-Google TV – התמונות שקשורות לסרט. למידע נוסף על המאפיינים הנדרשים והאופציונליים שצריך לכלול עם image, ראו מאפייני תמונות. |
trailer.description |
טקסט | תיאור הטריילר. ראו את הדוגמה של הטריילר. |
trailer.inLanguage |
טקסט | השפה של הטריילר בפורמט BCP 47. |
trailer.url |
כתובת URL | כתובת URL של טריילר שמתארח באופן ציבורי והועלה על ידי אולפני ההפקה או מקורות מורשים רלוונטיים. |
trailer.regionsAllowed |
מקום | האזורים שבהם מותר לפרסם מדיה. אם לא מציינים זאת, ההנחה היא שמותר להשתמש בו בכל מקום. יש לציין את המדינות בפורמט ISO 3166. |
identifier |
PropertyValue | מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה באופן חד-משמעי את הישות הזו. אפשר לציין מספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהים. |
review |
ביקורות | דירוגי ביקורות לסרט |
review.reviewRating |
דירוג | חובה אם סופקה בדיקה. משמש לציון הדירוג שניתן בביקורת. |
contentRating |
טקסט או דירוג | חובה עבור תוכן למבוגרים בלבד, מומלץ מאוד אם לא למה? - סיווג כולל של תוכן. אם סיווג התוכן ניתן בפורמט של מחרוזת טקסט, יתקבלו שתי וריאציות:
|
contentRating.author |
ארגון | חובה אם contentRating משתמש בערך Rating – השם של סוכנות הדירוג. |
contentRating.ratingValue |
טקסט | חובה אם contentRating משתמש ב-Rating – ערך הדירוג. |
contentRating.advisoryCode |
טקסט | קוד ההתרעה של התוכן. הערכים הקבילים כוללים: D, FV, L, S ו-V. D = דו-שיח, FV = אלימות בפנטזיה , L = שפה, S = תוכן מיני, V = אלימות. |
popularityScore |
PopularityScoreSpecification | מומלץ מאוד למה? ניקוד שבו Google משתמשת, ובאותות אחרים, כדי לקבוע איזו מדיה להציג למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, סולם הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מסוימת מוגדר כ-0. |
popularityScore.@type |
טקסט | תמיד מוגדר ל-PopularityScoreSpecification. |
popularityScore.value |
מספר | ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ניקוד גבוה יותר פירושו פופולריות גבוהה יותר. |
popularityScore.eligibleRegion |
מדינה | אזורים שבהם רלוונטי דירוג הפופולריות. אם ציון הפופולריות רלוונטי בכל העולם, צריך להגדיר את הערך EARTH. כברירת מחדל, הנכס הזה מוגדר ל-EARTH. Note: פופולריות ספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH) |
category |
טקסט | חובה אם רלוונטי – צריך לאכלס את הנכס הזה אם הישות היא וריאנט של Movie. מגדירים את category לאחת מהאפשרויות הבאות:
|
workExample |
סרט | מציין את הווריאציות של הסרט. צריך לכלול את הנכס הזה בישות הראשית Movie, ולא בישויות Movie של גרסאות הווריאנט. |
workExample.@id |
כתובת URL | לווריאציות של Movie, הנכס הזה מספק את המאפיין @id של הישות Movie שזו וריאציה שלה. |
workExample.@type |
טקסט | חובה – תמיד מוגדר לערך Movie. אפשר לייצג אותו כמערך עבור Movie עם כמה וריאנטים. |
workExample.@id |
כתובת URL | חובה – @id של הווריאנט Movie. |
workExample.name |
טקסט | חובה – השם של הווריאנט Movie. |
workExample.category |
טקסט | חובה – הסוג של וריאציית הסרט בגרסה מסוימת. אפשר להגדיר את הקטגוריה לאחת מהאפשרויות הבאות:
|
דוגמה
הסרט הראשי
סרט עם וריאציית חיתוך מורחבת.
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie",
"url": "http://www.example.com/my_favorite_movie",
"name": "My Favorite Movie",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
"contentRating": "RATING NOT KNOWN",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 78,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description": "This is my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"workExample": {
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut"
"category": "Extended Cut"
}
}
וריאציה של חיתוך מורחב
גרסת החיתוך המורחבת של הסרט הראשי.
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"url": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "http://www.example.com/example_package",
"identifier": "example.com:example_package"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
"contentRating": {
"@type": "Rating",
"author": "MPAA",
"ratingValue": "R",
"advisoryCode": "FV"
},
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"description": "This is the extended cut of my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"exampleOfWork": {
"@id": "http://www.example.com/my_favorite_movie",
}
"category": "Extended Cut"
}
דפים קשורים
בדפים הבאים תוכלו למצוא נושאים שקשורים לנכסים האלה: