מפרט Schema.org של פודקאסטים

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

המפרט של PodcastSeries

PodcastSeries הוא הייצוג של סדרת פודקאסטים, שנקראת גם "תוכנית פודקאסט".

מאפיין (property) עדיפות סוג תיאור
@context נדרש טקסט ההקשר של Schema.org. יש להגדיר תמיד את הערך [http://schema.googleapis.com,{@language}:xx}], כאשר xx צריך להיות בקוד השפה. ההגדרה היא שפת ברירת המחדל של ערכי הטקסט בישות.
@type נדרש טקסט תמיד מוגדר ל-PodcastSeries.
@id נדרש טקסט מזהה ייחודי גלובלי של סדרת הפודקאסטים בפורמט URI. התעודה המזהה צריכה להיות יציבה ולא להשתנות עם הזמן. הוא נחשב למחרוזת אטומה ולא חייב להיות קישור תקין. הדומיין שבו נעשה שימוש בערך @id חייב להיות בבעלות הארגון שלכם.
url נדרש טקסט כתובת ה-URL הקנונית באתר שלכם, שבה מוצגת או מתוארת סדרת הפודקאסט. ייחודית זו חייבת להיות ייחודית בעולם. הקישור הזה עוזר להתאים באופן מדויק את התוכן בפיד שלכם לתוכן שנמצא במסדי הנתונים של Google. לשם ההפעלה, יש להשתמש בtarget.urlTemplate המפורט בקטע ListenAction במסמכי התיעוד.
name נדרש טקסט

השם של סדרת הפודקאסט. יש לכלול שם אחד בלבד לכל שפה.

מומלץ להשתמש במערך כדי לסמן את התיאור בכמה שפות. דוגמה לכמה שפות ואזורים.

description נדרש טקסט

תקציר של סדרת הפודקאסטים.

מומלץ להשתמש במערך כדי לסמן את התיאור בכמה שפות. ניתן לעיין בדוגמה למספר אזורים ושפות.

alternativeHeadline אופציונלי טקסט כתוביות של סדרת הפודקאסטים.
author נדרש

אדם או ארגון

חזרה

האדם או הקבוצה שמפתחים או מציגים את התוכנית. מתייחסת בדרך כלל למארח. דוגמאות ופרטים זמינים במאמר ארגון, אדם (מחבר/מוציא לאור).
publisher אופציונלי

אדם או ארגון

חזרה

הקבוצה או הרשת המקורית שאחראים לפרסום התוכנית. המונח הזה מתייחס בדרך כלל לארגון האחראי על פרסום או הפקה של מספר פודקאסטים. דוגמאות ופרטים זמינים במאמר ארגון, אדם (מחבר/מוציא לאור). מאוד מומלץ להשתמש בשדה הזה כדי להבדיל אותו, ויש לספק אותו בכל מקום שבו הוא רלוונטי.
actor אופציונלי

אדם או ארגון

חזרה

שחקן הפודקאסט. כדי לקבל דוגמאות ופרטים, עיין בסעיף שחקן (מארח/אורח) .
logo אופציונלי

אובייקט תמונה

חזרה

תמונת לוגו של הסדרה. יש לספק את התיאור המלא ImageObject. יש לספק רזולוציה גבוהה ככל האפשר. עדיף להשתמש ב-JPEG או PNG. לפרטים ולדוגמאות, עיינו בקטע ImageObject (לוגו).
image נדרש

אובייקט תמונה

חזרה

תמונה של יצירת האומנות של הסדרה. יש לספק את המידע הזה באופן הבא: ImageObject. יש לספק רזולוציה גבוהה ככל האפשר. עדיף להשתמש ב-JPEG או PNG. לקבלת דוגמאות ודוגמאות, יש לעיין בקטע ImageObject (logo).
isFamilyFriendly נדרש בוליאני מציין אם התוכן מתאים לכל המשפחה (כלומר, אם התוכן מתאים לכל בני המשפחה, כולל ילדים). מוצרי Google עשויים להשתמש ב-isFamilyFriendly כדי לקבוע איזה תוכן להפעיל. הערך צריך להיות true או false.
inLanguage נדרש טקסט השפה של תוכן הפודקאסט בפורמט ISO 639-1. ניתן להשתמש בערך הזה כדי למלא שאילתות של משתמשים שמבקשים תוכן בשפה מסוימת.
genre נדרש

טקסט

חזרה

הקטגוריה או הז'אנר של סדרת הפודקאסטים. לדוגמה, אפשר לעקוב אחר קטגוריות פודקאסט רגילות.
endDate אופציונלי תאריך תאריך ההשקה של פרק הסיום של סדרת הפודקאסט. יש לכלול את השדה הזה רק כאשר הסדרה כבר הסתיימה.
rssFeed נדרש כתובת URL כתובת ה-URL של פיד ה-RSS של סדרת הפודקאסטים.
potentialAction נדרש ListenAction הפעולה שתופעל על ידי המשתמשים כדי להאזין לתוכן. פרטים נוספים זמינים במאמר ListenAction.
popularityScore אופציונלי PopularityScoreSpecification ציון פופולריות שעוזר לקבוע את עדיפות ההצגה כשיש מספר מועמדים. לפרטים ולדוגמאות, היכנסו לקטע PopularityScoreSpecification (popularityScore).
keywords אופציונלי

טקסט

חזרה

רשימה של מילות מפתח המשויכות לסדרת הפודקאסט. ייתכן שמילות המפתח האלה ישמשו להרחבת שאילתות המשתמשים שיכולות להפעיל את סדרת הפודקאסטים. לדוגמה, שמות האורחים, הנושאים המתוארים וכו'.
sameAs אופציונלי כתובת URL כתובת של דף אינטרנט של צד שלישי (לא בדומיין שלך) המציין באופן חד-משמעי את זהות הפריט. דף האינטרנט הזה משמש כדי להבהיר אם יש כמה סדרות דומות. לדוגמה, דף ויקיפדיה או דף הבית של סדרת הפודקאסטים. השדה הזה מומלץ מאוד לצורך הבהרה בנוגע לסדרה.
releasedEvent אופציונלי PublicationEvent, או תת-סוגים ספציפיים יותר – השתתפות באירוע או exclusiveEvent האירוע שמסמן את הפרסום או ההשקה של סדרת הפודקאסט. אירוע פרסום עשוי לציין השקה ראשונית של פודקאסט על ידי בעל תוכן דיגיטלי, וניתן להשתמש בסוגים המיוחדים יותר כדי לציין את בלעדיות או בלעדיות של הפודקאסט. לפרטים ולדוגמאות, כדאי לעיין בקטע publicationEvent, ShowcaseEvent, exclusiveEvent (releasedEvent). שימו לב שסימון סדרה כבלעדית או כפופולרית מרמז על כך שכל הפרקים של התוכנית הם בלעדיים או נבחרים.
countryOfOrigin אופציונלי המדינה המדינה שבה נמצאים משרדי ההנהלה של חברת ההפקה או של האדם שאחראי על הפודקאסט.

מפרט לפודקאסט

PodcastEpisode הוא הייצוג של schema.org של פרק בתוך PodcastSeries.

מאפיין (property) עדיפות סוג תיאור
@context נדרש טקסט ההקשר של Schema.org. תמיד מוגדר ל-[http://schema.googleapis.com,{@language:xx}] כאשר xx הוא קוד השפה. כך מגדירים את שפת ברירת המחדל של התווים בערכי הטקסט בפיד.
@type נדרש טקסט תמיד מוגדר ל-PodcastEpisode.
@id נדרש טקסט מזהה ייחודי וגלובלי של פרק הפודקאסט בפורמט URI. התעודה המזהה צריכה להיות יציבה ולא להשתנות עם הזמן. הוא נחשב למחרוזת אטומה ולא חייב להיות קישור תקין. הארגון שלך חייב להיות הבעלים של הדומיין המשמש עבור הערך @id.
url נדרש טקסט כתובת ה-URL הקנונית של האתר שלכם שבה אתם מציגים או מתארים את פרק הפודקאסט. הערך הזה חייב להיות ייחודי בעולם. הקישור הזה עוזר להתאים בצורה מדויקת את התוכן בפיד שלכם לתוכן שבמאגרי הנתונים של Google. לצורך ההפעלה, ייעשה שימוש בtarget.urlTemplate המפורט בקטע ListenAction של התיעוד.
name נדרש טקסט

שם הפרק בפודקאסט.

לכל שפה צריך להיות שם אחד בלבד. השתמשו במערך לסימון התיאור בכמה שפות. כאן תוכלו לראות כמה דוגמאות לשפות ולאזורים.

description נדרש טקסט תיאור פרק הפודקאסט.
alternativeHeadline נדרש טקסט כתובית של פרק הפודקאסט.
author נדרש

אדם או ארגון

חזרה

האדם או הקבוצה שמפתחים את הפרק או שולחים אותו. לעיתים קרובות הערך הזה מתייחס למארח. אם המחבר זהה לתוכנית, תוכלו להשתמש שוב במידע מהישות PodcastSeries. דוגמאות ופרטים זמינים במאמר Organization, Person (author/publisher) .
publisher נדרש

אדם או ארגון

חזרה

הקבוצה או הרשת המקורית שאחראים לפרסום התוכנית. לעיתים קרובות מדובר בארגון שאחראי על פרסום או הפקה של מספר פודקאסטים. דוגמאות ופרטים זמינים במאמר ארגון, אדם (מחבר/מוציא לאור). מאוד מומלץ להשתמש בשדה הזה כדי להבהיר את העניין, ואנחנו ממליצים להגדיר אותו בכל מקום רלוונטי.
actor נדרש

אדם או ארגון

חזרה

שחקן הפודקאסט. דוגמאות ופרטים מופיעים בקטע Actor (host/guest) .
datePublished נדרש תאריך ושעה התאריך והשעה של פרק הפודקאסט. הערך הזה משמש למיון הרצף וההבחנה.
episodeNumber נדרש מספר שלם מספר הפרק.
partOfSeries נדרש PodcastSeries PodcastSeries שבה נמצא פרק הפודקאסט. פרטים נוספים ודוגמאות זמינים במאמר PodcastSeries(partOfSeries).
partOfSeason אופציונלי PodcastSeason בסדרה של עונות מרובות, הנכס מספק את פרטי העונה, יחד עם מספר העונה ושם העונה. פרטים ודוגמאות זמינים במאמר PodcastSeason(partOfSeason).
timeRequired נדרש משך הסרטון אורך הפרק בפורמט ISO 8601.
image אופציונלי

אובייקט תמונה

חזרה

תמונה של יצירת האומנות של הסדרה. התיאור חייב להיות באורך מלא ImageObject. יש לספק רזולוציה גבוהה ככל האפשר. עדיף להשתמש ב-JPEG או PNG. לקבלת פרטים ודוגמאות, תוכלו לעיין בקטע ImageObject (logo).
isFamilyFriendly נדרש בוליאני מציין אם התוכן מתאים לכל המשפחה (כלומר, אם התוכן מתאים לכל בני המשפחה, כולל ילדים). מוצרי Google עשויים להשתמש ב-isFamilyFriendly כדי לקבוע איזה תוכן להפעיל. הערך צריך להיות true או false.
inLanguage נדרש טקסט שפת התוכן של פרק הפודקאסט בפורמט ISO 639-1. ניתן להשתמש בערך הזה כדי למלא שאילתות של משתמשים שמבקשים תוכן בשפה מסוימת. אם התוכן מופיע בכמה שפות, ציינו רק שפה ראשית אחת.
genre נדרש

טקסט

חזרה

הקטגוריה או הז'אנר של סדרת הפודקאסטים. לדוגמה, אפשר לעקוב אחר קטגוריות פודקאסט רגילות.
associatedMedia אופציונלי AudioObject קובץ האודיו של פרק הפודקאסט. פרטים ודוגמאות מופיעים במאמר AudioObject(AssociatedMedia).
potentialAction נדרש ListenAction הפעולה שתופעל על ידי המשתמשים כדי להאזין לתוכן. פרטים נוספים זמינים בקטע ListenAction.
popularityScore אופציונלי המפרט של ציון האיכות ציון פופולריות לקביעת העדיפות של הצגת המודעות כשיש מספר מועמדים. למידע נוסף ולדוגמאות, עיינו בקטע PopularityScoreSpecification.
keywords אופציונלי

טקסט

חזרה

רשימה של מילות מפתח הקשורות לסדרת הפודקאסט. ייתכן שמילות המפתח האלה ישמשו להרחבת שאילתות המשתמשים שיכולות להפעיל את פרק הפודקאסט. לדוגמה, news, sports או history.
identifier נדרש

ערך נכס

חזרה

עבור PodcastEpisode, יש להשתמש בנכס הזה כדי לספק GUID. ה-GUID צריך להיות מזהה שיכול לזהות באופן גלובלי וייחודי את הפרקים של הפודקאסט. השדה שונה מהשדה @id בפרק.

לדוגמה, תוכלו לעיין בקטע PropertyValue (מזהה).

sameAs אופציונלי כתובת URL כתובת של דף אינטרנט של צד שלישי (לא בדומיין שלך) המציין באופן חד-משמעי את זהות הפריט. Google משתמשת בדף האינטרנט הזה כדי להבהיר אם יש כמה סדרות דומות. לדוגמה, דף בוויקיפדיה או דף הבית של פרקי הפודקאסט. שימו לב שאסור להציג כאן את דף העזר ברמת הסדרה. אנחנו ממליצים מאוד על השדה הזה כדי להבהיר את הפרק.
releasedEvent אופציונלי publicationEvent, או תת-סוגים ספציפיים יותר – FeatureEvent או exclusiveEvent האירוע שמסמן את הפרסום או ההשקה של פרק הפודקאסט. אירוע פרסום עשוי לציין השקה ראשונית של פרק של פודקאסט על ידי בעל התוכן הדיגיטלי, ותת-הסוגים הספציפיים יותר יכולים לציין בלעדיות או בלעדיות של פריט התוכן. לפרטים ולדוגמאות, כדאי לעיין בקטע publicationEvent, FeatureEvent, exclusiveEvent (releasedEvent). שימו לב: כדי לסמן סדרה כבלעדית או כמצוינת למעלה, המשמעות היא שכל הפרקים של התוכנית הם בלעדיים או נבחרים. מומלץ לסמן נכסים כאלה ברמה המפורטת ביותר.
countryOfOrigin אופציונלי המדינה המדינה שבה נמצא המשרד הראשי של חברת ההפקה או האדם שאחראי על הפודקאסט.

PodcastSeries (partOfSeries)

צריך להשתמש בpartOfSeries כדי ליצור את הקשר בין PodcastEpisode לבין ההורה PodcastSeries. מכיוון שהפרטים המלאים של PodcastSeries מתוארים בישות הנפרדת PodcastSeries, אין צורך לספק פרטים מלאים ב-partOfSeries. תצטרכו לספק רק את הנכסים הבאים:

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-PodcastSeries.
@id נדרש כתובת URL המזהה הייחודי הגלובלי של הסדרה בפורמט URI. המזהה חייב להתאים למזהה של הישות PodcastSeries המלאה בפיד.
name נדרש טקסט השם של סדרת הפודקאסטים.

דוגמה 1

"partOfSeries": {
  "@type": "PodcastSeries",
  "@id": "http://www.tjpodcast.org/series?id=1",
  "name": "Radiolab"
},

PodcastSeason (partOfSeason)

PodcastSeason מייצג את המידע על העונה של PodcastEpisode, והכי חשוב, מספר העונה. הנכס הזה נדרש רק כשסדרת הפודקאסט כוללת כמה עונות.

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-PodcastSeason
@id נדרש כתובת URL מזהה ייחודי וגלובלי עבור העונה בפורמט URI. התעודה המזהה צריכה להיות יציבה ולא להשתנות עם הזמן. הוא נחשב למחרוזת אטומה ולא חייב להיות קישור תקין.
seasonNumber נדרש מספר שלם מספר העונה של סדרת הפודקאסט.
name אופציונלי טקסט השם של עונת הפודקאסטים.

דוגמה 1

"partOfSeason": {
  "@type": "PodcastSeason",
  "@id": "http://www.tjpodcast.org/seriesx/season?id=1",
  "seasonNumber": 1,
  "name": "Radiolab Season 1"
},

ארגון, אדם (מחבר או מוציא לאור)

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד יש להגדיר ל-Organization או ל-Person.
@id נדרש כתובת URL מזהה ייחודי וגלובלי עבור הארגון או האדם בפורמט URI. התעודה המזהה צריכה להיות יציבה ולא משתנה עם הזמן. הוא נחשב למחרוזת אטומה ולא חייב להיות קישור תקין.
name נדרש טקסט שם הארגון או האדם.
sameAs אופציונלי כתובת URL כתובת של דף אינטרנט של צד שלישי (לא בדומיין שלך) המציין באופן חד-משמעי את זהות הפריט. Google משתמשת בדף האינטרנט הזה כדי להבהיר אם יש כמה סדרות דומות. לדוגמה, דף ויקיפדיה לארגון או האתר הרשמי של הארגון.

דוגמה 1

"author": {
  "@type": "Organization",
  "@id": "https://www.tjpodcast.org/organization/wnyc",
  "sameAs": "https://en.wikipedia.org/wiki/WNYC",
  "name": "WNYC"
},

דוגמה 2

"author": {
  "@type": "Person",
  "@id": "https://www.tjpodcast.org/person/jad_abumrad",
  "sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad",
  "name": "Jad Abumrad"
},

משתמש (מארח או אורח)

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד יש להגדיר ל-Organization או ל-Person.
@id נדרש כתובת URL מזהה ייחודי וגלובלי עבור הארגון או האדם בפורמט URI. התעודה המזהה צריכה להיות יציבה ולא משתנה עם הזמן. הוא נחשב למחרוזת אטומה ולא חייב להיות קישור תקין.
name נדרש טקסט שם הארגון או האדם.
roleName נדרש טקסט 'מארח' או 'אורח'.
sameAs אופציונלי כתובת URL כתובת של דף אינטרנט של צד שלישי (לא בדומיין שלך) המציין באופן חד-משמעי את זהות הפריט. Google משתמשת בדף האינטרנט הזה כדי להבהיר אם יש כמה סדרות דומות. לדוגמה, דף ויקיפדיה לארגון או האתר הרשמי של הארגון.

דוגמה 1

"actor":[{
  "@type": "PerformanceRole",
  "actor": {
    "@type": "Person",
    "@id": "https://www.tjpodcast.org/person/Roman",
    "name": {
      "@language":"en",
      "@value": "Roman Mars"
    },
    "roleName": "Host"
    "sameAs": "https://en.wikipedia.org/wiki/Roman",
  },
  "actor": {
    "@type": "Person",
    "@id": "https://www.tjpodcast.org/person/guest",
    "name":{
      "@language":"en",
      "@value": "Kurt Kohlstedt"
    },
    "roleName": "Guest"
   },
}]

ImageObject (לוגו או תמונה)

ImageObject משמש כדי לספק את הלוגו או יצירת האומנות עבור התוכן.

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-ImageObject.
height אופציונלי מספר שלם גובה התמונה בפיקסלים.
width אופציונלי מספר שלם רוחב התמונה בפיקסלים.
contentUrl נדרש כתובת URL כתובת URL שבה התמונה יכולה להימצא.
regionsAllowed אופציונלי

המדינה

חזרה

המדינות שבהן המדיה מותרת:

  • אם לא מציינים את התמונה, ההנחה היא שהיא מותרת בכל המקומות.
  • כדי לשלוח תמונות שונות לכל אזור, צריך להוסיף כמה מאפייני ImageObject, שלכל אחד מהם יש קבוצת מדינות שונה וכתובת URL תואמת של תמונה.

מדינה (image.regionAllowed)

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-Country.
name נדרש טקסט קוד המדינה ISO 3166-1 alpha-2. לדוגמה: GB, US.

דוגמה 1

"logo": {
  "@type": "ImageObject",
  "height": "100",
  "width": "800",
  "contentUrl": "http://www.foo.com/img/67890.jpg",
},

דוגמה 2

"logo": [
  {
    "@type": "ImageObject",
    "height": "100",
    "width": "800",
    "contentUrl": "http://www.foo.com/img/67890.jpg",
    "regionsAllowed": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "GB"
      }
    ]
  },
  {
    "@type": "ImageObject",
    "height": "100",
    "width": "800",
    "contentUrl": "http://www.foo.com/img/12345.jpg",
    "regionsAllowed": [
      {
        "@type": "Country",
        "name": "IN"
      },
      {
        "@type": "Country",
        "name": "PK"
      }
    ]
  },
],

PropertyValue (מזהה)

אם יש לכם ממשקי GUID עבור התוכן שלכם, תוכלו לספק את המזהים האלה עם השדה identifier כדי לשפר את ההתאמה של Google לתוכן שלכם. חשוב לשים לב שה-GUID נדרש עבור PodcastEpisode. זה חייב להיות שונה מהשדה @id של הפרק (לא בדומיין שלכם) ועליו לייצג את פרק המקור ברחבי העולם ובאופן ייחודי לאורך זמן בכל המקורות.

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר כ-'PropertyValue'.
propertyID נדרש טקסט תמיד מוגדר ל-GUID.
value נדרש טקסט מזהה ה-GUID של הסדרה או הפרק.

דוגמה 1

"identifier": {
  "@type": "PropertyValue",
  "propertyID": "GUID",
  "value": "50204fe4-bc68-4b34-aae6-e73c700cc5ca"
},

ציון האיכות (popularityScore)

הpopularityScore יכול לעזור למשתמשים להגיע לתוכן המתאים ביותר, בתרחישים שבהם הקריטריונים משאילתת המשתמש תואמים למספר ישויות מהפיד. התוכן עם ציון הפופולריות הגבוה ביותר שזמין לאזור המשתמש מוצג למשתמש כאשר הערך הזה זמין. כברירת מחדל, ציון הפופולריות של כל התוכן ללא השדה הזה הוא 0. השוואת הציונים מתבצעת במסגרת הקטלוג המלא, כך שהדירוג שלכם עקבי בכל הפידים.

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-PopularityScoreSpecification.
value נדרש Numeric ערך מספרי חיובי להשוואה עם ישויות אחרות מהקטלוג שלכם לצורך עדיפות. מספר גדול יותר מייצג פופולריות גבוהה יותר.
eligibleRegion אופציונלי

מדינה או טקסט

חזרה

אזור אחד או רשימה של האזורים שעליהם חל ציון הפופולריות הזה.

אם ציון הפופולריות חל באופן גלובלי, משתמשים בערך earth כערך הטקסט.

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

אם השדה הזה לא ייכלל, ברירת המחדל של eligibleRegion היא earth.

מדינה (popularityScore.eligibilityRegion)

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-Country.
name נדרש טקסט קוד המדינה ISO 3166-1 alpha-2. לדוגמה: GB, US.

דוגמה 1

"popularityScore": {
  "@type": "PopularityScoreSpecification",
  "value": 4.3,
  "eligibleRegion": "Earth"
},

דוגמה 2

"popularityScore": {
  "@type": "PopularityScoreSpecification",
  "value": 2,
  "eligibleRegion": {
    "@type": "Country",
    "name": "US"
  }
},

דוגמה 3

"popularityScore": {
  "@type": "PopularityScoreSpecification",
  "value": 101,
  "eligibleRegion": [
    {
      "@type": "Country",
      "name": "US"
    },
    {
      "@type": "Country",
      "name": "GB"
    }
  ]
},

PublicationEvent, FeatureEvent, exclusiveEvent (releasedEvent)

אתר חדשות
אובייקט זה משמש לייצוג התאריך והמיקום של הפרסום של תוכנית או פרק (נקראים גם 'תאריך הפצה' של סדרה או פרק). בנוסף, השדה publishedBy מציין את הפרסום או ההפצה של סדרת הפודקאסט או הפרק.
אירוע בלעדי
תוכלו להשתמש באובייקט הזה כדי לציין שלספק יש זכויות הפצה בלעדיות לפודקאסט. בלעדיות יכולה להיות ספציפית לאזור ולגבול זמן, וחייבת לכלול את שדה הארגון שמפנה לספק הבלעדי של התוכן.
אירוע נבחר
משתמשים באובייקט הזה כדי לציין שהספק מציג את הפודקאסט לצרכנים (למשל, כ"מקורי").
הגרסה המקורית שונה מתוכניות בלעדיות
המונח "מקורי (מוצג)" לעיתים קרובות מציין זכויות בלעדיות לישות נתונה, שגורמת לעומס יתר על המונח. לכן צריך לפצל את המשמעות הרצויה לשתי הקטגוריות שצוינו למעלה. ישות מקורית יכולה להיות גם לא בלעדית, ובמקרה כזה הreleasedEvent יכול לקחת מערך עם שני סוגי האירועים באותה ישות.

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

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד להגדיר ל-PublicationEvent, ExclusiveEvent או FeaturedEvent.
location נדרש המדינה האזור שבו מתרחש אירוע הפרסום. אפשר להשתמש בתנאי הזה גם כדי לייצג את הגבלות בלעדיות והגבלות ההפצה של הישות. יש להשתמש בקודי ISO 3166 במדינה הרלוונטית. אם צריך להחיל סמנטיקה גלובלית, צריך להגדיר את הערך EARTH. יש להגדיר באופן מפורש את location כ-EARTH, למקרה שהגבלות ספציפיות ללוקאל לא חלות.
startDate מומלץ (חובה לאירוע בלעדי) תאריך או תאריך תאריך ההתחלה של פרסום הישויות. במקרה של PublicationEvent, הפרמטר הזה מציין את תאריך ההשקה הראשוני של הישות הזו. במקרה של ExclusiveEvent או FeaturedEvent, השדה הזה מייצג את תאריך ההתחלה של הישות או בלעדיות התוכן של הישות.
endDate מומלץ (חובה לאירוע בלעדי) תאריך או תאריך תאריך הסיום של פרסום הישויות. במקרה של PublicationEvent, שדה זה מציין את תאריך הפרסום הסופי של הישות הזו. במקרה של ExclusiveEvent או FeaturedEvent, השדה הזה מייצג את תאריך הסיום של בלעדיות או בלעדיות של הישות.
publishedBy נדרש ארגון או אדם הישות Organization או Person שמפרסמת את הישות הזו וחלה על אירוע הפרסום הזה. יש להשתמש באותה סכימה כפי שמתואר בקטע Organization (author/Publisher).

דוגמה 1

"releasedEvent": [ {
  "@type": "PublicationEvent",
  "location": "EARTH",
  "startDate": "2016-04-21T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/wnyc",
    "sameAs": "https://en.wikipedia.org/wiki/WNYC",
    "name": "WNYC"
  },
 }, {
  "@type": "FeaturedEvent",
  "location": "US",
  "startDate": "2020-04-18T20:00",
  "endDate": "2020-04-21T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 },
]

דוגמה 2

"releasedEvent": [ {
  "@type": "FeaturedEvent",
  "location": "US",
  "startDate": "2020-04-18T20:00",
  "endDate": "2020-05-21T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 }, {
  "@type": "ExclusiveEvent",
  "location": "US",
  "startDate": "2020-04-18T20:00",
  "endDate": "2020-04-24T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 }, {
  "@type": "ExclusiveEvent",
  "location": "CA",
  "startDate": "2020-04-21T20:00",
  "endDate": "2020-04-24T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 }
]

AudioObject (AssociatedMedia)

השדה AudioObject משמש כדי לספק את קובץ המדיה הגולמי של פרק הפודקאסט.

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-AudioObject.
contentUrl נדרש כתובת URL כתובת ה-URL של קובץ המדיה.
contentSize נדרש מספר שלם הגודל של קובץ המדיה בבייטים.
encodingFormat נדרש טקסט סוגי המדיה IANA של קובץ המדיה. לדוגמה: audio/mpeg.
duration נדרש משך הסרטון אורך המדיה בפורמט של משך ISO 8601.
transcript אופציונלי טקסט התמליל של הפרק.
bitrate אופציונלי טקסט קצב העברת הנתונים של קובץ המדיה.
name אופציונלי טקסט שם הקובץ של קובץ המדיה.

דוגמה 1

"associatedMedia": {
    "@type": "AudioObject",
    "contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
    "duration": "PT5M32S",
    "contentSize": "53616000",
    "encodingFormat": "audio/mpeg",
    "name": "radiolab_podcast19.mp3",
    "transcript": "Transcript of the episode",
    "bitrate": "64Kbps"
},

ListenAction (potentialAction)

הישות ListenAction מגדירה את קישורי העומק שלכם לצורך הפעלה ואת הקריטריונים של המשתמשים (לדוגמה, מיקום גיאוגרפי, כרונולוגי, התחברות או סטטוס המינוי) לצורך גישה לתוכן.

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-ListenAction.
target נדרש

EntryPoint

חזרה

המפרטים של קישור העומק שלך עם פרטי הפלטפורמה הנתמכים. ניתן להשתמש בכמה שדות מסוג EntryPoint כדי להגדיר קישורי עומק שונים לקבוצות שונות של פלטפורמות.
actionAccessibilityRequirement נדרש

ActionAccessSpecification

חזרה

ההגדרה של דרישות המשתמש לגישה לישות הזו. אם יש כמה ActionAccessSpecification פריטים, משתמש שמתאים לקריטריונים כלשהם של המפרט יוכל לגשת לתוכן.

EntryPoint (potentialAction.target)

table class="fixed"> מאפיין עדיפות סוג תיאור @type חובה טקסט תמיד הוגדר כ-EntryPoint. urlTemplate חובה כתובת URL הקישור המשמש להפעלת התוכן שלכם. 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/GoogleAudioCast"
  • "http://schema.googleapis.com/GoogleVideoCast"

ActionAccessSpecification (potentialAction.actionAccessibilityRequiredment)

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-ActionAccessSpecification.
category נדרש טקסט

סוג דרישת הגישה. הערך הזה צריך להיות אחד מהערכים הבאים:

  • nologinrequired: הפעולה זמינה למשתמש ללא רכישה או התחברות כדי לגשת לתוכן.
  • free: הפעולה זמינה ללא רכישה או מינוי בתשלום של המשתמש. הפעולה כן מחייבת את המשתמש להתחבר.
  • subscription: הפעולה כלולה במינוי בתשלום לשירות שלך.
availabilityStarts אופציונלי תאריך ושעה שעת ההתחלה של חלון הזמינות. אפשר להשתמש בתנאי הזה כדי לקבוע מתי בדיוק אנשים יוכלו להיחשף לתוכן הזה.
availabilityEnds אופציונלי תאריך ושעה שעת הסיום של חלון הזמינות. אפשר להשתמש בה כדי לקבוע את המועד המדויק שבו התוכן הזה ייחשף למשתמשים.
eligibleRegion נדרש

המדינה

חזרה

המדינה הזכאית למבצע זה. אפשר להשתמש באפשרות הזו כדי לשלוט במדינה או באזור שבהם התוכן חייב להיות זמין.
requiresSubscription חובה אם רלוונטי מינוי מדיה חבילת המינויים הנדרשת כדי לגשת לתוכן הזה. אם השירות שלך מציע חבילות מינויים רבות, זהו שדה חובה. אם השירות ניתן בחינם, או שיש רק רמת מינויים אחת, אפשר לדלג על השדה הזה.

מדינה (potentialAction.actionAccessibilityRequiredment.eligibilityRegion)

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-Country.
name נדרש טקסט קוד מדינה ISO 3166-1 alpha 2.

MediaSubscription (potentialAction.actionAccessibilityRequiredment.requiresSubscription)

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-MediaSubscription.
@id נדרש כתובת URL מזהה ייחודי וגלובלי של חבילת המינוי בפורמט URI. המזהה צריך להיות יציב ולא ישתנה עם הזמן. הוא נחשב למחרוזת אטומה ולא חייב להיות קישור תקין.
name נדרש טקסט השם של חבילת המינוי. לדוגמה: Premium, Basic.
expectsAcceptanceOf מומלץ המבצע המבצע המשויך לרכישת מינוי המדיה. אפשר להשתמש במאפיין הזה כדי לציין את מחיר המינוי.

מבצע (potentialAction.actionAccessibilityRequiredment.requiresSubscription.expectsAcceptanceOf)

מאפיין (property) עדיפות סוג תיאור
@type נדרש טקסט תמיד מוגדר ל-Offer.
price נדרש מספר מחיר המינוי.
priceCurrency נדרש טקסט המטבע (בפורמט ISO 4217 בן שלוש אותיות).
seller מומלץ ארגון הארגון שמציע את המינוי או הרכישה של הפעולה. יש להשתמש באותה סכימה כפי שמתואר בקטע Organization (author/Publisher).

דוגמה 1

"potentialAction": {
    "@type": "ListenAction",
    "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://www.tjpodcast.org/?streamStationId=170",
        "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/GoogleAudioCast",
            "http://schema.googleapis.com/GoogleVideoCast"
        ]
    },
    "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "nologinrequired",
        "availabilityStarts": "2018-04-01T11:01:00-04:00",
        "availabilityEnds": "2018-06-30T23:59:00-04:00",
        "eligibleRegion": {
            "@type": "Country",
            "name": "US"
        }
    }
},

דוגמה 2

"potentialAction": {
    "@type": "ListenAction",
    "target": [
        {
            "@type": "EntryPoint",
            "urlTemplate": "https://www.tjpodcast.org/?streamStationId=170",
            "actionPlatform": [
                "http://schema.org/DesktopWebPlatform",
                "http://schema.org/MobileWebPlatform",
                "http://schema.org/AndroidPlatform",
                "http://schema.org/AndroidTVPlatform",
                "http://schema.org/IOSPlatform"
            ]
        },
        {
            "@type": "EntryPoint",
            "urlTemplate": "https://www.tjpodcast.org/castlink?streamStationId=170",
            "actionPlatform": [
                "http://schema.googleapis.com/GoogleAudioCast",
                "http://schema.googleapis.com/GoogleVideoCast"
            ]
        }
    ],
    "actionAccessibilityRequirement": [
        {
            "@type": "ActionAccessSpecification",
            "category": "nologinrequired",
            "availabilityStarts": "2018-04-01T11:01:00-04:00",
            "availabilityEnds": "2018-06-30T23:59:00-04:00",
            "eligibleRegion": [
                {
                    "@type": "Country",
                    "name": "IN"
                },
                {
                    "@type": "Country",
                    "name": "GB"
                }
            ]
        },
        {
            "@type": "ActionAccessSpecification",
            "category": "Subscription",
            "requiresSubscription": {
                "@type": "MediaSubscription",
                "@id": "http://www.example.com/packages/basic-pack",
                "name": "Basic Pack",
                "expectsAcceptanceOf": {
                    "@type": "Offer",
                    "price": 8.99,
                    "priceCurrency": "USD"
                }
            },
            "availabilityStarts": "2018-04-01T11:01:00-04:00",
            "availabilityEnds": "2018-06-30T23:59:00-04:00",
            "eligibleRegion": {
                "@type": "Country",
                "name": "US"
            }
        }
    ]
},

נספח

דוגמה מלאה

{
    "@context": "http://schema.org",
    "@type": "DataFeed",
    "dateModified": "2018-09-10T13:58:26.892Z",
    "dataFeedElement": [
        {
            "@context": [
                "http://schema.googleapis.com",
                {
                    "@language": "en"
                }
            ],
            "@type": "PodcastSeries",
            "@id": "http://www.tjpodcast.org/series?id=2",
            "url": "http://www.tjpodcast.org/series?id=2",
            "name": "Radiolab",
            "description": "A two-time Peabody Award-winner...",
            "alternativeHeadline": "Radiolab - Powered by WNYC",
            "sameAs": "https://en.wikipedia.org/wiki/Radiolab",
            "image": {
                "@type": "ImageObject",
                "height": "100",
                "width": "800",
                "contentUrl": "http://www.tjpodcast.org/img/2.jpg"
            },
            "logo": {
                "@type": "ImageObject",
                "height": "100",
                "width": "800",
                "contentUrl": "http://www.tjpodcast.org/logo/2/1.jpg"
            },
            "keywords": [
                "Science",
                "Technology",
                "Philosophy",
                "Education"
            ],
            "author": [
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/jad_abumrad",
                    "name": "Jad Abumrad",
                    "sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
                },
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/robert_krulwich",
                    "name": "Robert Krulwich",
                    "sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
                }
            ],
            "publisher": {
                "@type": "Organization",
                "name": "WNYC",
                "@id": "https://www.tjpodcast.org/network/wnyc_studios",
                "sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
            },
            "isFamilyFriendly": "True",
            "inLanguage": "en",
            "genre": [
                "Science & Medicine",
                "Natural Sciences"
            ],
            "endDate": "2017-12-22T08:59:00",
            "rssFeed": "http://feeds.wnyc.org/radiolab",
            "potentialAction": {
                "@type": "ListenAction",
                "target": {
                    "@type": "EntryPoint",
                    "urlTemplate": "https://www.tjpodcast.org/?streamSeriesId=2",
                    "actionPlatform": [
                        "http://schema.org/DesktopWebPlatform",
                        "http://schema.org/MobileWebPlatform",
                        "http://schema.googleapis.com/GoogleAudioCast",
                        "http://schema.googleapis.com/GoogleVideoCast"
                    ]
                },
                "actionAccessibilityRequirement": {
                    "@type": "ActionAccessSpecification",
                    "category": "nologinrequired",
                    "availabilityStarts": "2018-04-01T11:01:00-04:00",
                    "availabilityEnds": "2019-12-30T23:59:00-04:00",
                    "eligibleRegion": {
                        "@type": "Country",
                        "name": "FR"
                    }
                }
            },
            "popularityScore": {
                "@type": "PopularityScoreSpecification",
                "value": 4.2
            }
        },
        {
            "@context": [
                "http://schema.googleapis.com",
                {
                    "@language": "en"
                }
            ],
            "@type": "PodcastEpisode",
            "@id": "http://www.tjpodcast.org/episode?id=1",
            "url": "http://www.tjpodcast.org/episode?id=1",
            "name": "A Clockwork Miracle",
            "description": "As legend goes, in 1562, King Philip II...",
            "sameAs": "https://www.wnycstudios.org/story/radiolab-clockwork-miracle",
            "image": {
                "@type": "ImageObject",
                "height": "100",
                "width": "800",
                "contentUrl": "http://www.tjpodcast.org/img/2/1.jpg"
            },
            "keywords": [
                "Education",
                "Philosophy",
                "Science",
            ],
            "partOfSeries": {
                "@type": "PodcastSeries",
                "@id": "http://www.tjpodcast.org/series?id=2",
                "name": "Radiolab",
                "sameAs": "https://en.wikipedia.org/wiki/Radiolab",
            },
            "episodeNumber": 101,
            "inLanguage": "en",
            "author": [
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/jad_abumrad",
                    "name": "Jad Abumrad",
                    "sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
                },
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/robert_krulwich",
                    "name": "Robert Krulwich",
                    "sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
                }
            ],
            "publisher": {
                "@type": "Organization",
                "name": "WNYC",
                "@id": "https://www.tjpodcast.org/network/wnyc_studios",
                "sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
            },
            "isFamilyFriendly": "True",
            "genre": [
                "Science",
                "Philosophy",
                "Fiction"
            ],
            "datePublished": "2018-12-27T23:23:00Z",
            "timeRequired": "PT22M",
            "associatedMedia": {
                "@type": "AudioObject",
                "contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
                "duration": "PT21M45S",
                "contentSize": "53616000",
                "encodingFormat": "audio/mpeg",
                "transcript": "Transcript of the episode",
                "bitrate": "64Kbps"
            },
            "potentialAction": {
                "@type": "ListenAction",
                "target": {
                    "@type": "EntryPoint",
                    "urlTemplate": "https://www.tjpodcast.org/?streamEpisodeId=1",
                    "actionPlatform": [
                        "http://schema.org/DesktopWebPlatform",
                        "http://schema.org/MobileWebPlatform",
                        "http://schema.googleapis.com/GoogleAudioCast",
                        "http://schema.googleapis.com/GoogleVideoCast"
                    ]
                },
                "actionAccessibilityRequirement": {
                    "@type": "ActionAccessSpecification",
                    "category": "nologinrequired",
                    "availabilityStarts": "2018-04-01T11:01:00-04:00",
                    "availabilityEnds": "2019-12-30T23:59:00-04:00",
                    "eligibleRegion": {
                        "@type": "Country",
                        "name": "FR"
                    }
                }
            },
            "popularityScore": {
                "@type": "PopularityScoreSpecification",
                "value": 3.8
            },
            "identifier": [
                {
                    "@type": "PropertyValue",
                    "propertyID": "GUID",
                    "value": "53ff386e-e768-40b5-8854-1b7415826ded"
                }
            ]
        }
    ],
    "actor": [
        {
            "@type": "PerformanceRole",
            "actor": {
                "@type": "Person",
                "@id": "https://www.tjpodcast.org/person/Roman",
                "name": {
                    "@language": "en",
                    "@value": "Roman Mars"
                },
                "roleName": "Host",
                "sameAs": "https://en.wikipedia.org/wiki/Roman"
            },
            "actor": {
                "@type": "Person",
                "@id": "https://www.tjpodcast.org/person/guest",
                "name": {
                    "@language": "en",
                    "@value": "Kurt Kohlstedt"
                },
                "roleName": "Guest"
            }
        }
    ],
    "releasedEvent": [
        {
            "@type": "FeaturedEvent",
            "location": "US",
            "startDate": "2020-04-18T20:00",
            "endDate": "2020-05-21T20:00",
            "publishedBy": {
                "@type": "Organization",
                "@id": "https://www.tjpodcast.org/organization/tjpodcast",
                "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
                "name": "TJPodcast"
            }
        },
        {
            "@type": "ExclusiveEvent",
            "location": "US",
            "startDate": "2020-04-18T20:00",
            "endDate": "2020-04-24T20:00",
            "publishedBy": {
                "@type": "Organization",
                "@id": "https://www.tjpodcast.org/organization/tjpodcast",
                "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
                "name": "TJPodcast"
            }
        },
        {
            "@type": "ExclusiveEvent",
            "location": "CA",
            "startDate": "2020-04-21T20:00",
            "endDate": "2020-04-24T20:00",
            "publishedBy": {
                "@type": "Organization",
                "@id": "https://www.tjpodcast.org/organization/tjpodcast",
                "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
                "name": "TJPodcast"
            }
        }
    ]
}