בקטע הזה מפורטים מאפייני התוכן של תגי העיצוב עבור סוג הישות 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 כתובת ה-URL צריכה לעמוד בדרישות הבאות:
urlTemplate של אובייקט היעד. |
name |
טקסט | חובה – שם הסרט.
|
titleEIDR |
טקסט | מומלץ מאוד למה? – מזהה EIDR (Entertainment Identifier Registry) שמייצג ברמה הכללית או המופשטת ביותר יצירה קולנועית או טלוויזיונית. לדוגמה, מזהה EIDR של הכותרת לסרט הקולנוע 'מכסחי השדים' הוא 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 | חובה אם רלוונטי – אובייקט של תג Action שמספק את הפרטים של הפעולה.
|
sameAs |
כתובת URL | מומלץ מאוד למה? כתובת URL לדף אינטרנט שמשמש כהפניה ויכול לזהות את הסרט. לדוגמה, דף ויקיפדיה של הסרט. הערך הזה צריך להיות שונה מהערך של המאפיין url. |
inLanguage |
טקסט | מומלץ מאוד לציין את שפת המקור של הסרט בפורמט BCP 47. |
genre |
טקסט | רשימה מסודרת של כל הז'אנרים הרלוונטיים. לדוגמה : ['פעולה', 'אופנה', 'סביבה', 'כדורגל'] |
keywords |
טקסט | מילות מפתח או תגים שמשמשים לתיאור התוכן הזה. אפשר גם להשתמש במערך של מילות מפתח. לדוגמה, ["feature, biography"] יכול להיות מערך של מילות מפתח לתיאור התוכן. |
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 |
Person | מומלץ מאוד למה? הבמאי או הבמאים של הסרט. |
actor |
Person | מומלץ מאוד למה? השחקנים בסרט. |
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 = Dialogue (דיאלוג), FV = Fantasy Violence (אלימות דמיונית), L = Language (שפה), S = Sexual Content (תוכן מיני), V = Violence (אלימות). |
popularityScore |
PopularityScoreSpecification | מומלץ מאוד למה? ציון ש-Google משתמשת בו, בנוסף לאותות אחרים, כדי לקבוע אילו מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, סולם הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מוגדר כ-0. |
popularityScore.@type |
טקסט | הערך תמיד יהיה PopularityScoreSpecification. |
popularityScore.value |
Number | ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ציון גבוה יותר מציין פופולריות גבוהה יותר. |
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"
}
דפים קשורים
במאמרים הבאים מפורטים נושאים שקשורים לנכסים האלה: