הפיד של פעולות במדיה הוא אובייקט JSON שמכיל אוסף של ישויות. ישות היא אובייקט schema.org שמייצג פריט בקטלוג: פרק בתוכנית טלוויזיה, סדרת טלוויזיה, סרט, שיר, אלבום ועוד.
![](https://developers.google.cn/actions/media/images/image-media-actions-29.jpg?authuser=0000&hl=he)
מבנה הפיד
ל'פעולות צפייה' ול'פעולות האזנה' יש מבנה פיד שונה.
הפעולות בשעון מאורגנות לפי ההיררכיה הבאה: |
פעולות האזנה מאורגנות לפי ההיררכיה הבאה: |
מעטפת הנתונים של פיד הנתונים
מעטפת נתונים היא האובייקט ברמה העליונה בפיד 'פעולות במדיה'. האובייקט מכיל מערך של אובייקטים של תגי עיצוב של תוכן (ישויות) שמייצגים את כל התוכן בקטלוג שלכם.
מעטפת של פיד נתונים תומכת במאפיינים הבאים:
נכס | סוג | תיאור |
---|---|---|
@context |
כתובת URL | חובה – מוגדר ל-http://schema.org |
@type |
טקסט | חובה – מוגדר ל-DataFeed . |
dateModified |
DateTime | חובה – תאריך ושעת השינוי האחרון של הפיד, בפורמט ISO 8601 (כולל אזור זמן). |
dataFeedElement |
דבר | חובה – הישויות בקטלוג המדיה. |
תבנית מעטפה של פיד נתונים
{
"@context": "http://schema.org",
"@type": "DataFeed",
"dateModified": "2018-07-20T00:44:51Z",
"dataFeedElement": [
{ <CONTENT MARKUP OBJECT 01> },
{ <CONTENT MARKUP OBJECT 02> },
{ <CONTENT MARKUP OBJECT 03> },
...
]
}
תגי עיצוב של תוכן
אובייקט של תגי עיצוב של תוכן מייצג ישות אחת בקטלוג: סרט, פרק בתוכנית טלוויזיה, סדרת טלוויזיה, שיר, אלבום, תחנת רדיו וכו'. האובייקט מכיל את המזהה וכתובת ה-URL הקנונית של התוכן, ועוזר לתאר את התוכן באמצעות מטא-נתונים.
תבנית לתגי עיצוב של תוכן
אובייקט של תגי עיצוב של תוכן יכול לכלול מערך של אובייקטים של תגי עיצוב של פעולות, שמאפשרים לשייך את התוכן לכמה אובייקטים של תגי עיצוב של Action. לדוגמה, התוכן יכול להכיל אובייקט תגי עיצוב שונה של Action לכל אזור.
{
"@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": [
{ <ACTION MARKUP OBJECT 01> },
{ <ACTION MARKUP OBJECT 02> }
],
...
}
תגי עיצוב של פעולות
אובייקט של תגי עיצוב של פעולה מתאר את קישור העומק שמעביר את המשתמשים לתוכן ואת רמת הגישה הנדרשת לתוכן. האובייקט הוא מאפיין (potentialAction
) של אובייקט תגי עיצוב של תוכן.
יש שתי דרכים להגדיר את הגבלות הגישה:
- לפעולות צפייה, יש להשתמש אובייקט של מפרט גישה לפעולה.
- לפעולות האזנה, משתמשים באובייקט מבצע.
תבנית תגי עיצוב של פעולה
אם התוכן כולל כמה קישורי עומק, אובייקט תגי עיצוב של פעולה כולל מספר אובייקטי יעד. למשל, קישור העומק של התוכן ל-iOS עשוי להיות שונה מקישור העומק ל-Android. בנוסף, אם יש הגבלות גישה שונות בהתאם לאזורים ולתקופות הזמן, אובייקט תגי העיצוב של Action יכול לכלול מספר אובייקטים של מפרט גישה לפעולות, או להציע אובייקטים, כפי שמוצג בתבניות שלמטה.
תבנית אובייקט של תגי עיצוב של פעולה לפעולות צפייה:
"potentialAction": {
"@type": "WatchAction",
"target": [
{ <TARGET OBJECT 01> },
{ <TARGET OBJECT 02> }
],
"actionAccessibilityRequirement": [
{ <ACTION ACCESSIBILITY OBJECT 01> },
{ <ACTION ACCESSIBILITY OBJECT 02> }
]
}
תבנית אובייקט של תגי עיצוב של פעולה לפעולות האזנה:
"potentialAction": {
"@type": "ListenAction",
"target": [
{ <TARGET OBJECT 01> },
{ <TARGET OBJECT 02> }
],
"expectsAcceptanceOf": [
{ <OFFER OBJECT 01> },
{ <OFFER OBJECT 02> }
]
}
יעד
אובייקט יעד מספק מיפוי של קישור עומק לפלטפורמות שונות של Google. האובייקט הוא מאפיין (target
) של אובייקט תגי עיצוב של פעולה.
דוגמה לטירגוט
אם התוכן כולל כמה קישורי עומק בהתאם לפלטפורמות, צריך ליצור כמה אובייקטי יעד כדי לספק מיפויים שונים. למשל, קישור העומק של התוכן ל-Chromecast עשוי להיות שונה מזה של פלטפורמות אחרות בקישורי עומק, כמו בדוגמה הבאה.
דוגמה לאובייקט יעד (בסיסי):
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
"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"
]
}
דוגמה לאובייקט יעד עם שני קישורי עומק:
"target": [
{
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform"
]
},
{
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/cast/my_favorite_movie?autoplay=true",
"actionPlatform": [
"http://schema.googleapis.com/GoogleVideoCast"
]
}
]
מפרט גישה לפעולות
אובייקט של מפרט גישה לפעולה מתאר את דרישת הגישה של
תוכן שמבוסס על האזור ותקופת הזמן. האובייקט הוא מאפיין,
actionAccessibilityRequirement
, מתוך
אובייקט תגי עיצוב של פעולה.
הערך category
של האובייקט יכול להיות כל אחת מהאפשרויות הבאות:
nologinrequired
free
subscription
כדי לתאר את פרטי המינוי, צריך ליצור אובייקט 'מינוי למדיה'. אם המיקום התוכן מחייב רכישה נוספת עבור המנויים, צריך להשתמש offer object כדי לציין את המחיר.
externalsubscription
כדי לתאר את פרטי המינוי, צריך ליצור אובייקט 'מינוי למדיה'. אם המיקום התוכן מחייב רכישה נוספת עבור המנויים, צריך להשתמש offer object כדי לציין את המחיר.
rental
צריך להשתמש ב offer object כדי לציין את המחיר.
purchase
צריך להשתמש ב offer object כדי לציין את המחיר.
מינוי למדיה
אובייקט של מינוי למדיה שמתאר את פרטי המינוי הנדרשים
לתוכן. האובייקט הוא מאפיין, requiresSubscription
, של
אובייקט של מפרט גישה לפעולה. הדבר
חובה אם הערך של actionAccessibilityRequirement.category
הוא subscription
או
externalSubscription
וחבילת המינוי שלך כוללת מספר אפשרויות
חבילות או שכבות, או שיש לו תמיכה באמצעות תוספים. אין לכלול את המידע הזה אם
המינוי הוא רב-שכבתי ומעניק גישה לכל התוכן בקטלוג.
דוגמה למינוי מדיה
דוגמה לאובייקט של מינוי למדיה:
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://www.example.com/premium_subscription",
"name": "Example Premium",
"sameAs": "http://www.example.com/premium_subscription"
}
ההצעה
אובייקט מבצע מתאר את המחיר שמשויך לתוכן. האובייקט הוא מאפיין (expectsAcceptanceOf
) של האובייקטים הבאים:
- עבור פעולות צפייה, אובייקט של מפרט גישה לפעולה.
- לפעולות האזנה, אובייקט תגי עיצוב של פעולה.
דוגמה להצעה
פעולות צפייה מציינות את המאפיין expectsAcceptanceOf
ב
אובייקט של מפרט גישה לפעולה:
"potentialAction":{
"@type":"WatchAction",
"target":{
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/my_favorite_movie?autoplay=true",
"actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "purchase",
"availabilityStarts": "2019-01-01T00:00Z",
"availabilityEnds": "2019-12-31T00:00Z",
"eligibleRegion": {
"@type": "Country",
"name": "US"
},
"expectsAcceptanceOf": {
"@type": "Offer",
"price": 7.99,
"priceCurrency": "USD",
"seller": {
"@type": "Organization",
"name": "My example seller"
}
}
}
}
פעולות האזנה מציינות את המאפיין expectsAcceptanceOf
ישירות באובייקט תגי העיצוב של פעולה:
"potentialAction":{
"@type":"ListenAction",
"target":{
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/playlist/top_pop_songs?autoplay=true",
"actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
},
"expectsAcceptanceOf":{
"@type": "Offer",
"eligibleRegion": {
"@type":"Country",
"name":"US"
},
"category": "subscription",
"name": "Example Music",
"price": 9.99,
"priceCurrency": "USD",
"seller": {
"@type": "Organization",
"name": "My example seller",
"sameAs": "http://www.example.com"
}
}
}
תמונה
אובייקט תמונה מתאר את התמונה שמשויכת לתוכן.
דרישות התמונה הן:
- לפעולות צפייה, צריך לספק תמונה ברזולוציה גבוהה (מינימום 140x210 פיקסלים) עם יחס גובה-רוחב של 2:3.
- התמונה חייבת להיות בפורמט
.jpg
או.png
.
- התמונה חייבת להיות בפורמט
- לפעולות האזנה, צריך לספק תמונה ברזולוציה גבוהה (לפחות 300x300 פיקסלים) עם יחס גובה-רוחב של 1x1.
- מומלץ להשתמש בגודל 600x600 פיקסלים ומעלה.
- התמונה צריכה להיות בפורמט
.jpg
,.png
או.gif
.
- כתובת ה-URL של התמונה חייבת להיות ניתנת לסריקה וניתנת להוספה לאינדקס.
- אתם צריכים להחזיק בזכויות כדי להשתמש בתמונה ולאפשר להציג אותה במכשירים ובמאפיינים של Google.
- אסור לכלול בתמונה את הפריטים הבאים:
- תמונה מטושטשת, מפוקסלת, מסובבת או באיכות נמוכה.
- צילום ללא רישיון או תמונות ממאגר.
- עירום.
- תוכן לא חוקי
- כשמעדכנים את
MusicPlaylist
, צריך לעדכן את התמונה שלו כך שתשקף את התוכן החדש.
תמונה לדוגמה
"image": {
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
"dateModified" : "2019-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
}
דוגמאות של פידים
בדוגמאות הבאות אפשר לראות את ההבדל במבנה הפיד בין פעולות צפייה ופעולות האזנה.
דוגמה לפעולות צפייה
{
"@context": "http://schema.org",
"@type": "DataFeed",
"dateModified": "2018-07-20T00:44:51Z",
"dataFeedElement": [
{
"@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",
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
],
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"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"
}
]
}
]
}
דוגמה לפעולות האזנה
{
"@context": "http://schema.org",
"@type": "DataFeed",
"dateModified": "2018-07-20T00:44:51Z",
"dataFeedElement": [
{
"@context":"http://schema.googleapis.com/",
"@type":"MusicGroup",
"@id":"http://www.example.com/artist/my_favorite_artist/",
"url":"http://www.example.com/artist/my_favorite_artist/",
"name":"My Favorite Artist",
"sameAs":"https://en.wikipedia.org/wiki/my_favorite_artist",
"description":"This is my favorite pop music artist.",
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/artist/my_favorite_artist?autoplay=true",
"actionPlatform":[
"http://schema.org/DesktopWebPlatform",
"http://schema.org/IOSPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
},
"price": 8.99,
"priceCurrency": "USD"
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/artist_mix/my_favorite_artist/",
"url":"http://www.example.com/artist_mix/my_favorite_artist/",
"name":"My Favorite Artist Mix",
"description":"A mix of music similar to My Favorite Artist",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?autoplay=true",
"actionPlatform":[
"http://schema.org/DesktopWebPlatform",
"http://schema.org/IOSPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
]
}