בקטע הזה מופיעים הפרטים של מאפייני תגי העיצוב לפודקאסטים.
המפרט של 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 |
נדרש | ערך נכס חזרה |
עבור לדוגמה, תוכלו לעיין בקטע 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 |
אופציונלי | המדינה חזרה |
המדינות שבהן המדיה מותרת:
|
מדינה (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 |
אופציונלי | מדינה או טקסט חזרה |
אזור אחד או רשימה של האזורים שעליהם חל ציון הפופולריות הזה. אם ציון הפופולריות חל באופן גלובלי, משתמשים בערך אם יש לציין אזורים ספציפיים, יש להשתמש בסוג 'מדינה'. אם השדה הזה לא ייכלל, ברירת המחדל של |
מדינה (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 כדי להגדיר קישורי עומק שונים לקבוצות שונות של פלטפורמות. |
actionAccessibilityRequirement |
נדרש |
חזרה |
ההגדרה של דרישות המשתמש לגישה לישות הזו. אם יש כמה
ActionAccessSpecification פריטים, משתמש שמתאים לקריטריונים
כלשהם של המפרט יוכל לגשת לתוכן. |
EntryPoint (potentialAction.target)
@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 |
נדרש | טקסט |
סוג דרישת הגישה. הערך הזה צריך להיות אחד מהערכים הבאים:
|
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"
}
}
]
}