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

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

טבלת מפרט

מאפיין (property) הסוג הנדרש תיאור
@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 חייב להכיל כתובת אתר קנונית תקינה ש-Google יכולה לסרוק.
לקישור עומק של הפעלה, ראו במקום זאת את מאפיין היעד של urlTemplate.
name טקסט חובה – שם הסרט.
  • אפשר להשתמש במערך כדי לרשום את השמות בשפות שונות. ניתן לעיין בדוגמה מספר אזורים ושפות.
  • לתשומת ליבך, רק שם אחד נתמך בכל לוקאל (צמד שפה-מדינה).
titleEIDR טקסט מומלץ מאוד למה? - מזהה של EIDR (משרד הבידור)

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

לדוגמה, לסרטון התנועה שנקרא "Ghostbusters" והכותרת שלו EIDR היא "10.5240/7EC7-228A-510A-053E-CBB8-J", יש לו מספר עריכות לדוגמה: "124-46090400444

titleEIDR יש לציין חובה בעת עריכת EE.
potentialAction WatchAction חובה אם רלוונטי – אובייקט תגי עיצוב של פעולה שמספק את הפרטים של הפעולה.
  • אם התוכן זמין ב'סרטון על פי דרישה' (VoD), הנכס הזה נדרש. אובייקט תגי העיצוב של הפעולה צריך לספק את הקישור העמוק של התוכן.
  • אם התוכן זמין בערוץ LiveTV, הנכס הזה הוא אופציונלי; הישות המשויכת ב-BroadcastService מספקת במקום זאת את קישור העומק של הערוץ.
  • מכשיר Movie זמין לצפייה גם ב-VOD וגם ב-LiveTV.
מומלץ להשתמש במערך כדי לציין קישורי עומק שונים באזורים מרובים. ניתן לעיין בדוגמה מספר אזורים ושפות.
sameAs כתובת URL מומלץ מאוד למה? כתובת URL של דף אינטרנט שבו אפשר לזהות את הסרט. לדוגמה, דף הוויקיפדיה של הסרט. חייב להיות שונה מהנכס url.
inLanguage טקסט השפה המקורית של הסרט בפורמט BCP 47.
genre טקסט רשימה ממוינת של כל הז'אנרים הרלוונטיים. לדוגמה : ["Action", "Fashion", "Environment", "Football"]
keywords טקסט מילות המפתח או התגים שמשמשים לתיאור התוכן הזה. יש להפריד בין ערכים באמצעות פסיקים. לדוגמה, "מופיעה, הביוגרפיה&ציטוט; יכולה להיות מילת מפתח לתיאור התוכן.
releasedEvent PublicationEvent, FeaturedEvent או ExclusiveEvent מומלץ מאוד למה? - PublicationEvent משמש לציון הפצת התוכן המקורית (הגלובלית או המקומית) של בעל תוכן דיגיטלי, כמו תאריך ההנפקה המקורי של סרט.

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

ExclusiveEvent מציין עבור השירות דוגמאות ואיפה.

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

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

באזור FeaturedEvent שבו התוכן מוצג או בלעדי.

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

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

בנתונים של ExclusiveEvent ו-FeaturedEvent, תאריך ההתחלה שבו הישות בלעדית או מוצגת.
releasedEvent.endDate תאריך או תאריך ושעה מומלץ – חובה עבור ExclusiveEvent – ההגדרה הזו חלה רק על הסוגים ExclusiveEvent ו-FeaturedEvent.

ב-ExclusiveEvent, זהו התאריך שבו הזכויות על התוכן פגות.

עבור FeaturedEvent, המאפיין הזה מייצג את התאריך האחרון שבו הספק מציג את הישות.

אם התוכן בלעדי או מוצג באופן קבוע, צריך להגדיר את endDate כ-20 שנים מהתאריך הנוכחי.
releasedEvent.publishedBy ארגון או אדם אופציונלי – הארגון או האדם שפרסמו את הישות הזו.
description טקסט מומלץ מאוד למה? תקציר של הסרט. תקצירי סיפורים מועדפים לסיכומים עובדתיים. מגבלה של 300 תווים.
duration משך הקורס זמן הריצה של הסרט בפורמט ISO 8601. צריך להשתמש בפורמט "PT00H00M"
director אדם מומלץ מאוד למה? במאי הסרט.
actor אדם מומלץ מאוד למה? צוות השחקנים בסרט.
producer ארגון או אדם מומלץ מאוד למה? מפיקי הסרט.
image אובייקט תמונה חובה עבור Google TV – התמונות הקשורות לסרט. לקבלת פרטים נוספים על המאפיינים הנדרשים והאופציונליים שיש לכלול ב-image, אפשר לעיין במאמר מאפייני תמונה.
trailer.description טקסט תיאור הטריילר. עיינו בדוגמה בנושא טריילר.
trailer.inLanguage טקסט שפת הטריילר בפורמט BCP 47.
trailer.url כתובת URL כתובת URL של טריילר שמתארח באופן ציבורי ומועלה על ידי אולפני הפקה מתאימים או מקורות מורשים.
trailer.regionsAllowed מקום האזורים שבהם המדיה מותרת. אם לא צוין, ההנחה היא שמותרת בכל מקום. יש לציין את המדינות בפורמט ISO 3166.
identifier נכס Value מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר המאפשר זיהוי חד-משמעי של ישות זו. מותר להשתמש בכמה מזהים. פרטים נוספים זמינים בקטע מאפיינים של מזהים.
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 = אלימות פנטזיה , L = שפה, S = תוכן מיני, V = אלימות.
popularityScore מפרט פופולרי מומלץ מאוד למה? ציון שמשמש את 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"
}

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