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

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

טבלת מפרטים

נכס	הסוג הנדרש	תיאור
@context	טקסט	חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}] הקטע 'xx' מייצג את השפה של המחרוזות בפיד. בכל הקשר של ישות ברמה הבסיסית צריך להגדיר את השפה באמצעות קוד השפה המתאים בפורמט 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 חייב להכיל כתובת URL קנונית תקינה ש-Google יכולה לסרוק. כדי לראות את קישור העומק להפעלה, צריך לעיין במאפיין urlTemplate של אובייקט היעד.
name	טקסט	חובה – שם הסרט. משתמשים במערך כדי לפרט את השמות בשפות שונות. אפשר לעיין בדוגמה Multiple regions and languages. שימו לב: אפשר להזין רק שם אחד לכל לוקאל (שילוב של שפה ומדינה).
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	חובה אם רלוונטי – אובייקט של תג עיצוב של פעולה שמספק את הפרטים של הפעולה. אם התוכן זמין ב'סרטון על פי דרישה' (VoD), צריך לציין את המאפיין הזה. אובייקט התיוג של הפעולה צריך לספק את הקישור העמוק של התוכן. אם התוכן זמין בערוץ LiveTV, המאפיין הזה הוא אופציונלי. במקומו, הישות המשויכת BroadcastService מספקת את הקישור העמוק של הערוץ. תוכן Movie יכול להיות זמין גם ב-VoD וגם בשידור חי בטלוויזיה. כדי לציין קישורי עומק שונים בכמה אזורים, משתמשים במערך. אפשר לעיין בדוגמה Multiple regions and languages.
sameAs	כתובת URL	מומלץ מאוד למה? כתובת URL לדף אינטרנט שמשמש כהפניה ויכול לזהות את הסרט. לדוגמה, דף ויקיפדיה של הסרט. הערך הזה צריך להיות שונה מהערך של המאפיין url.
inLanguage	טקסט	מומלץ מאוד: שפת המקור של הסרט בפורמט BCP 47.
genre	טקסט	רשימה מסודרת של כל הז'אנרים הרלוונטיים. לדוגמה : [‎"Action", "Fashion", "Environment", "Football"‎]
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	‫Date או DateTime	מומלץ – חובה לExclusiveEvent – תאריך ההתחלה של פרסום הישות. במקרה של PublicationEvent, זהו תאריך ההפצה הראשוני של הישות, למשל התאריך שבו סרט יצא לאקרנים. במקרה של ExclusiveEvent וFeaturedEvent, זהו תאריך ההתחלה של תקופת הבלעדיות או ההצגה של הישות.
releasedEvent.endDate	‫Date או DateTime	מומלץ – חובה לExclusiveEvent – המאפיין הזה רלוונטי רק לסוגים ExclusiveEvent ו-FeaturedEvent. בסוג ExclusiveEvent, המאפיין הזה מייצג את התאריך שבו מסתיימות הזכויות על התוכן. בסוג FeaturedEvent, המאפיין הזה מייצג את התאריך האחרון שבו הספק מציג את הישות. אם התוכן הוא בלעדי או מוצג באופן קבוע, צריך להגדיר את endDate ל-20 שנה מהתאריך הנוכחי.
releasedEvent.publishedBy	ארגון או אדם	אופציונלי – הארגון או האדם שפרסמו את הישות הזו.
description	טקסט	מומלץ מאוד למה? תקציר של הסרט. עדיף להשתמש בתקצירים של העלילה ולא בסיכומים עובדתיים. מגבלה של 300 תווים. משתמשים במערך כדי לתייג את התיאור בכמה שפות. אפשר לעיין בדוגמה Multiple regions and languages.
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	טקסט או דירוג	חובה לתוכן למבוגרים, מומלץ מאוד גם לתוכן אחר למה? – סיווג התוכן הכולל. אם סיווג התוכן ניתן בצורה של מחרוזת טקסט, המערכת מקבלת שתי וריאציות: סוכנות הדירוג מופיעה לפני הדירוג עם רווח ביניהם. לדוגמה, סיווג 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 = Dialogue (דיאלוג),‏ FV = Fantasy Violence (אלימות פנטזיה),‏ L = Language (שפה),‏ S = Sexual Content (תוכן מיני),‏ V = Violence (אלימות).
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"
}

דפים קשורים

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

• זיהוי סוגי הישויות בתוכן
• איסוף המזהה, כתובת ה-URL והשם של התוכן
• איסוף המטא-נתונים של התוכן