מאפייני סימון תוכן של סרטים

בקטע הזה מפורטים המאפיינים של רכיבי ה-Markup של התוכן לסוג הישות Movie.

טבלת מפרט

נכס הסוג הנדרש תיאור
@context טקסט חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}]
  • כאשר 'xx' מייצג את שפת המחרוזות בפיד. לכל הקשר של ישות ברמה הבסיסית צריך להגדיר את השדה @language לקוד השפה המתאים בפורמט BCP 47. לדוגמה, אם השפה מוגדרת לספרדית, ההנחה היא שהשמות יהיו בספרדית גם אם שפת הכתוביות או הדיבוב היא אנגלית.
@type טקסט חובה – תמיד מוגדר ל-Movie עבור סרטים.
@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 טקסט חובה – שם הסרט.
  • משתמשים במערך כדי לרשום את השמות בשפות שונות. ראו את הדוגמה מספר אזורים ושפות.
  • שימו לב: יש תמיכה רק בשם אחד לכל אזור (צמד שפה-מדינה).
titleEIDR טקסט מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג, ברמה הכללית או המופשטת ביותר, יצירה של סרט או טלוויזיה.

לדוגמה, השדה titleEIDR של הסרט 'Ghostbusters' הוא '10.5240/7EC7-228A-510A-053E-CBB8-J'.
editEIDR טקסט מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג גרסה ספציפית של עריכה או מהדורה של סרט או תוכנית טלוויזיה.

לדוגמה, לסרט הקולנוע שנקרא 'Ghostbusters' (שוברי האגדות) שמספר ה-titleEIDR שלו הוא '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 חובה אם רלוונטי – אובייקט של רכיב עיצוב של פעולה שמספק את הפרטים של הפעולה.
  • אם התוכן זמין ב-Video on Demand‏ (VoD), צריך לציין את המאפיין הזה. אובייקט ה-Action markup צריך לספק את הקישור העמוק של התוכן.
  • אם התוכן זמין בערוץ LiveTV, המאפיין הזה הוא אופציונלי. הישות המשויכת BroadcastService מספקת במקום זאת את הקישור המעמיק של הערוץ.
  • Movie יכול להיות זמין גם ב-VoD וגם ב-LiveTV.
שימוש במערך כדי לציין קישורי עומק שונים במספר אזורים. ראו את הדוגמה מספר אזורים ושפות.
sameAs כתובת URL מומלץ מאוד למה? כתובת URL לדף אינטרנט של מקור מידע שיכול לזהות את הסרט. לדוגמה, הדף של הסרט בוויקיפדיה. השם הזה צריך להיות שונה מהשם של המאפיין url.
inLanguage טקסט שפת המקור של הסרט בפורמט BCP 47.
genre טקסט רשימה מסודרת של כל הז'אנרים הרלוונטיים. לדוגמה : ["פעולה", "אופנה", "סביבה", "כדורגל"]
keywords טקסט מילות מפתח או תגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך של מילות מפתח. לדוגמה, ["feature, biography"] יכול להיות מערך של מילות מפתח לתיאור התוכן.
releasedEvent PublicationEvent,‏ FeaturedEvent או ExclusiveEvent מומלץ מאוד למה? - הקוד PublicationEvent משמש לציון תאריך הפרסום המקורי (הגלובלי או המקומי) של תוכן על ידי בעל התוכן הדיגיטלי, למשל תאריך הפרסום המקורי של סרט בבתי הקולנוע.

בנוסף, אפשר להשתמש בקוד FeaturedEvent כדי לציין שהשירות שלכם משווקת את התוכן הזה כתוכן מקורי, כתוכן מוצג, כתוכן מיוחד וכו'.

ExclusiveEvent מציין שלשירות יש זכויות הפצה בלעדיות, וכוללים את המיקום והתאריך.

פרטים ודוגמאות מופיעים בקטע הדוגמאות.
releasedEvent.@type טקסט חובה – חשוב תמיד להגדיר את המאפיין הזה לאחת מהאפשרויות הבאות:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location מדינה חובה – האזורים שמשויכים לאירוע הזה.

באירוע מסוג PublicationEvent, זהו האזור שבו התוכן פורסם.

באירועים מסוג FeaturedEvent ו-ExclusiveEvent, זהו האזור שבו התוכן מוצג או זמין באופן בלעדי.

צריך להשתמש בקודים של מדינות לפי תקן ISO 3166. כדי לציין את כל העולם, מגדירים את הערך EARTH.
releasedEvent.startDate תאריך או DateTime מומלץ – חובה עבור ExclusiveEvent – תאריך ההתחלה של פרסום הישות.

ב-PublicationEvent, התאריך הזה מציין את תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לאקרנים בפעם הראשונה.

ב-ExclusiveEvent וב-FeaturedEvent, התאריך הזה מייצג את תאריך ההתחלה שבו הישות היא בלעדית או מוצגת.
releasedEvent.endDate תאריך או 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 טקסט או דירוג חובה לתוכן למבוגרים, מומלץ מאוד במקרים אחרים למה? - סיווג התוכן הכולל. אם סיווג התוכן מצוין כמחרוזת טקסט, אפשר להשתמש בשתי וריאציות:
  • סוכנות הדירוג הוסיפה את השם שלה לפני הדירוג עם רווח באמצע. לדוגמה, סיווג PG-13 מהסוכנות MPAA בארה"ב צריך להיות מתואר כ-MPAA PG-13. רשימת הסוכנויות
  • הערך 'RATING NOT KNOWN' (ללא תלות באותיות רישיות) כדי לציין שאתם לא יודעים מה הסיווג של הסרט.
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 לאחת מהאפשרויות הבאות:
  • Home Release: גרסה שנמכרת או מושכרת לצפייה ביתית.
  • Theatrical Release: גרסה שפורסמה בבתי הקולנוע.
  • International Release: גרסה שערכתם להפצה בינלאומית.
  • Remastered: גרסה שבה התמונות, האודיו או שניהם משופרים בהתאם לסטנדרט עדכני יותר.
  • Unrated: גרסה שלא נבדקה על ידי MPAA או על ידי סוכנות דומה.
  • Director Cut: גרסה שמייצגת את העריכה שאושרה על ידי הבמאי.
  • Extended Cut: גרסה ארוכה יותר מהגרסה ששוחררה לקולנוע.
workExample סרט מציין את הווריאציות של הסרט. צריך לכלול את הנכס הזה בישות Movie הראשית, ולא בישויות Movie של גרסאות הווריאנטים.
workExample.@id כתובת URL לגבי וריאנטים של Movie, המאפיין הזה מספק את @id של הישות Movie שהיא וריאנט שלה.
workExample.@type טקסט חובה – תמיד מוגדר ל-Movie. אפשר לייצג את זה כמערך של Movie עם כמה וריאציות.
workExample.@id כתובת URL חובה – השדה @id של הווריאנט Movie.
workExample.name טקסט חובה – השם של הווריאנט Movie.
workExample.category טקסט חובה – הסוג של וריאנט הסרט של גרסה מסוימת. מגדירים את הקטגוריה לאחת מהאפשרויות הבאות:
  • Home Release: גרסה שנמכרת או מושכרת לצפייה ביתית.
  • Theatrical Release: גרסה שפורסמה בבתי הקולנוע.
  • International Release: גרסה שערכתם להפצה בינלאומית.
  • Remastered: גרסה שבה התמונות, האודיו או שניהם משופרים בהתאם לסטנדרט עדכני יותר.
  • Unrated: גרסה שלא נבדקה על ידי MPAA או על ידי סוכנות דומה.
  • Director Cut: גרסה שמייצגת את העריכה שאושרה על ידי הבמאי.
  • Extended Cut: גרסה ארוכה יותר מהגרסה ששוחררה לקולנוע.

דוגמה

הסרט הראשי

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

{
  "@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"
}

בדפים הבאים מפורטים נושאים שקשורים לנכסים האלה: