'פעולות צפייה' תכונות נפוצות

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

מאפייני תגי עיצוב של פעולות

נכס	סוג צפוי	תיאור
@type	טקסט	חובה – תמיד מוגדר ל-WatchAction.
target	EntryPoint	חובה – אובייקט יעד שמספק את המיפוי של קישורים עומק לפלטפורמות שונות של Google.
target.@type	טקסט	חובה – תמיד מוגדר ל-EntryPoint.
target.urlTemplate	כתובת URL	חובה – קישור עומק שמפנה את המשתמשים לאפליקציה או לפלטפורמה שלכם ומפעיל את ההפעלה של התוכן.
target.inLanguage	טקסט	אופציונלי – השפה המקורית של הסדרה בפורמט BCP 47.
target.actionPlatform	טקסט	חובה – הפלטפורמות שממופות אל urlTemplate. יש תמיכה ב'פעולות במדיה' באפשרויות הבאות: http://schema.org/DesktopWebPlatform: פלטפורמת חיפוש בדפדפני אינטרנט למחשב. http://schema.org/MobileWebPlatform: פלטפורמת חיפוש בדפדפני אינטרנט בנייד. http://schema.org/AndroidPlatform: פלטפורמות החיפוש והמדריך ל-Play באפליקציה ל-Android. http://schema.org/AndroidTVPlatform: פלטפורמת Android TV באפליקציית Android TV. http://schema.org/IOSPlatform: פלטפורמת החיפוש באפליקציה ל-iOS. http://schema.googleapis.com/GoogleVideoCast: פלטפורמות Cast ו-Home במכשיר Chromecast. http://schema.googleapis.com/GoogleAudioCast: פלטפורמות Cast ו-Home במכשיר Chromecast (פעולות הקשבה בלבד). הדרישות מפורטות בקטע סוגי הפלטפורמות.
target.additionalProperty	PropertyValue	חובה אם רלוונטי – רשימה של זוגות מאפיין-ערך שמייצגים מאפיינים נוספים של הקישור המעמיק. למשל: contentLanguage: שפת השידור (דיבוב), בפורמט BCP 47. אם התוכן ודובב בשפה אחרת, צריך לציין את המאפיין הזה. שימוש במערך לכמה קודי שפות. subtitleLanguage: השפות של הכתוביות, בפורמט BCP 47. שימוש במערך לכמה קודי שפות. cameraAngle: זווית המצלמה של התוכן. לדוגמה, 'גובה העיניים' ו'זווית גבוהה'. אם התוכן זמין בזויות מצלמה שונות, צריך לציין את המאפיין הזה. שימוש במערך למספר זוויות מצלמה. videoFormat: פורמט הקובץ שבו מאוחסן הסרטון הדיגיטלי. לדוגמה, 'SD' לרזולוציה רגילה ו-'HD' לרזולוציה גבוהה. פורמטים חוקיים של סרטונים כוללים SD, ‏ HD, ‏ 2K, ‏ 4K ו-8K. משתמשים במערך עבור כמה פורמטים של סרטונים. אפשר לעיין בדוגמה של additionalProperty.
actionAccessibilityRequirement	ActionAccessSpecification	חובה – אובייקט של מפרט גישה של פעולה שמתאר את דרישת הגישה לתוכן. מאפייני מפרט הגישה של פעולה

דפים קשורים למטא-תגים של פעולות

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

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

מאפייני מפרט הגישה לפעולה

נכס	סוג צפוי	תיאור
actionAccessibilityRequirement.@type	טקסט	חובה – תמיד מוגדר ל-ActionAccessSpecification.
actionAccessibilityRequirement.category	טקסט	חובה – דרישת גישה לתוכן. למידע נוסף, ראו סוג חומת התשלום. אם יש ישות שמייצגת קבוצת תוכן, צריך להגדיר את category לדרישה הכי פחות מגבילה לגישה לתוכן שלה. לדוגמה, אם ל-TVSeries יש תוכן TVEpisode מסוים שמוגדר כ-nologinrequired וחלק שמוגדר כ-subscription, צריך להגדיר את ה-TVSeries הזה כ-nologinrequired.
actionAccessibilityRequirement.availabilityStarts	‫תאריך	חובה – התאריך שאחרי שבו הפעולה תהיה זמינה, בפורמט ISO 8601 (כולל אזור זמן). אפשר להגדיר תאריך עתידי. יש לספק את הישות המתאימה בפיד לפחות 7 ימים לפני תאריך availabilityStarts שלה. כך תוכלו להגדיל את הסיכויים שהתוכן יוצג בפלטפורמות של Google בזמן.
actionAccessibilityRequirement.availabilityEnds	‫תאריך	חובה – התאריך שאחרי כן הפעולה לא תהיה זמינה יותר, בפורמט ISO 8601 (כולל אזור זמן). חייב להיות שווה ל-72 שעות או גדול ממנה אחרי availabilityStarts. אם התוכן תמיד יהיה זמין אחרי הפרסום שלו, צריך להגדיר את התאריך הזה ל-20 שנה מהתאריך הנוכחי. חובה לבצע עדכונים בתאריך availabilityEnds בפיד לפחות 7 ימים לפני תאריך availabilityEnds. כך תוכלו להגדיל את הסיכויים שהתוכן יפסיק להופיע בפלטפורמות של Google בתאריך availabilityEnds.
actionAccessibilityRequirement.eligibleRegion	Country,‏ City,‏ State,‏ GeoShape או Text	חובה – האזורים שבהם התוכן זמין. אם התוכן זמין בכל העולם, צריך להשתמש במחרוזת המיוחדת EARTH.
actionAccessibilityRequirement.ineligibleRegion	מדינה,‏ עיר,‏ מדינה או GeoShape	חובה אם רלוונטי – האזורים שבהם התוכן מוגבל. אין צורך לספק את המאפיין הזה אם התוכן זמין בכל מקום ב-eligibleRegion.
actionAccessibilityRequirement.requiresSubscription	MediaSubscription	חובה אם רלוונטי – פרטי המינוי שנדרשים למשתמשים כדי לגשת לתוכן. נכסי מינויים לתוכן מדיה יש לציין את המאפיין הזה אם הערך של category הוא subscription או externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf	מבצע	חובה אם התוכן מחייב רכישה – פרטי המבצע שמשויך לתוכן. יש לציין את פרטי המחיר במקרים הבאים: תוכן לרכישה חד-פעמית (rental או purchase) תוכן שמבוסס על מינוי ומחייב רכישה נוספת ממנויים (subscription או externalsubscription) אם המחיר הוא 0.00, מסירים את האובייקט Offer לחלוטין ומגדירים את category מהאובייקט ActionAccessSpecification ל-free. מאפייני מבצעים

מאפייני מינויים לשירותי מדיה

חובה אם הערך של actionAccessibilityRequirement.category הוא subscription או externalSubscription.

נכס	סוג צפוי	תיאור
requiresSubscription.@type	טקסט	חובה – תמיד מוגדר ל-MediaSubscription
requiresSubscription.@id	כתובת URL	חובה – המזהה הייחודי של המינוי. אם יש גישה לתוכן דרך מינויים שונים, לכל מינוי צריך להיות מזהה ייחודי.
requiresSubscription.name	טקסט	חובה – שם המינוי. חשוב לשים לב לפרטים הבאים: אם אפשר לגשת לתוכן דרך מינויים שונים, השם הזה צריך להתאים לשם שמופיע במערכת אימות המשתמשים. לדוגמה, אם משתמש יכול לגשת לתוכן על סמך המינוי שנקרא Package 1, אבל מערכת האימות משתמשת בשם PKG1a, צריך להשתמש ב-PKG1. לספקים של תוכניות טלוויזיה באינטרנט, זהו שם המאמת שרשום במאמת של תוכניות הטלוויזיה באינטרנט. זוהי מחרוזת שמזהה באופן ייחודי את שם השירות שלכם במאמת TVE.
requiresSubscription.sameAs	כתובת URL	הדף שמתאר את המינוי.
requiresSubscription.identifier	טקסט	חובה אם הערך של category הוא subscription וגם הערך של commonTier הוא false – מחרוזת ייחודית של המינוי הזה שמייצגת גישה לקבוצת תוכן בקטלוג המדיה. Google ממליצה להשתמש בתחביר הבא למזהה: שם הדומיין + פסיק נקודה (:) + רמת הגישה לתוכן, דוגמאות : example.com:basic,‏ example.com:premium, ‏ example.com:sports המאפיין הזה יהיה זהה למזהה ההרשאה שלכם, אם אתם מספקים API להרשאות.
requiresSubscription.authenticator	ארגון	חובה אם הערך של category הוא externalsubscription – מאגר שמספק את הפרטים של מאמת הספק החיצוני.
requiresSubscription.authenticator.@type	טקסט	חובה אם הערך של category הוא externalsubscription – תמיד מוגדר לערך Organization.
requiresSubscription.authenticator.name	טקסט	חובה אם הערך של category הוא externalsubscription – שם שירות האימות. לספקי TVE, מגדירים את הערך TVE
requiresSubscription.commonTier	בוליאני	חובה אם רלוונטי – השדה הזה נדרש אם הקטגוריה מוגדרת בתור subscription. מידע נוסף על commonTier זמין במסמכים בנושא דרישות ברמה המשותפת.

דרישות ל-Entitlements API

ממשק API להרשאות נדרש אם הערך של actionAccessibilityRequirement.category הוא subscription או externalSubscription, והמינוי כולל כמה חבילות או רמות או תמיכה בתוספים. אין צורך לכלול את האפשרות הזו אם למינויים שלכם יש רמה אחת והם מעניקים גישה לכל התוכן בקטלוג.

• לחברה א' יש חבילת מינויים אחת שמעניקה למשתמשים שנרשמו מינויים גישה לכל התוכן הזמין: מזהה הרשאה / API לא נדרש
• לחברה ב' יש מינוי בסיסי שמספק גישה לחלק מהתוכן ומינוי פרימיום שמספק גישה לתוכן פרימיום: נדרש מזהה הרשאה או API
• לחברה ג' יש מינוי בסיסי שמספק גישה לחלק מהתוכן, וחבילות נוספות שמספקות גישה לתוכן של צד שלישי: נדרש מזהה הרשאה או API

דפים שקשורים למינוי לשירותי מדיה

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

• סקירה כללית על מינויים לשירותי מדיה
• זיהוי דרישת הגישה לתוכן שלכם

מאפייני המבצע

נכס	סוג צפוי	תיאור
expectsAcceptanceOf.@type	טקסט	חובה – תמיד מוגדר ל-Offer.
expectsAcceptanceOf.price	מספר	חובה – מחיר הרכישה של התוכן. המחיר חייב להיות ערך חיובי שאינו אפס. יש לציין את הקטגוריה 'free' (חינם) עבור ישויות עם מחיר 0.00.
expectsAcceptanceOf.priceCurrency	טקסט	חובה – המטבע של המחיר בפורמט ISO 4217 בן 3 אותיות.
expectsAcceptanceOf.seller	ארגון	הארגון שמציע את הרכישה של התוכן.
expectsAcceptanceOf.seller.@type	טקסט	הערך תמיד מוגדר ל-Organization.
expectsAcceptanceOf.seller.name	טקסט	שם המוכר.
expectsAcceptanceOf.seller.sameAs	טקסט	כתובת ה-URL של דף אינטרנט שמזהה את המוכר. לדוגמה, דף הבית של המוכר.

דף קשור למבצע

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

• סקירה כללית של המבצע
• זיהוי המחיר של התוכן בתשלום

מזהים

פידים של פעולות מדיה מקבלים מגוון מזהים שיכולים לעזור לזהות ישות באופן ברור. המזהים האלה יכולים לעזור לכם לזרז את תהליך ההתאמה בין התוכן בפיד לבין התוכן במסדי הנתונים של Google. אפשר להוסיף את רוב המזהים האלה לפיד באמצעות המאפיין identifier בסוגי ישויות שונים, אבל למזהי EIDR יש מאפיין ייצוג משלהם. שני הנושאים האלה מוסברים בהמשך.

מאפייני מזהה

נכס	סוג צפוי	תיאור
identifier	טקסט	מומלץ מאוד – מזהה, בדרך כלל חיצוני, שמזהה באופן חד-משמעי ישות נתונה. מותר להשתמש במספר מזהים. הנכס הזה זמין בכל סוגי הישויות של פעולות צפייה. בטבלה הבאה מפורטים המזהים והנכסי המשנה המותרים של הנכס identifier. דוגמה למזהה/EIDR בקטע 'דוגמאות לפידים של פעולות צפייה'.

נכס	סוג צפוי	תיאור
@type	טקסט	חובה – תמיד מוגדר ל-PropertyValue.
propertyID	טקסט	חובה – אנחנו תומכים בסוגים הבאים של תעודות מזהות: TMS_ROOT_ID: מזהה הבסיס של Gracenote‏ (TMS) (לדוגמה, 15829). . הכלל הזה לא חל על הישות Organization ועל הישות BroadcastService, שבהן צריך להשתמש רק ב-TMS_ID. TMS_ID: מזהה הווריאנט של Gracenote‏ (TMS) (לדוגמה, MV000398520000). WIKIDATA_ID: המזהה ב-WikiData (לדוגמה, Q134773). IMDB_ID: מזהה IMDB (לדוגמה, tt0109830). OPTA_ID: מזהה OPTA Sports. STATS_ID: מזהה הביצועים של STATS. VIP_TIMES_ID: המזהה של Japan VIPTimes‏ (Nihon Tarento Meikan) לתוכניות טלוויזיה יפניות. DMA_ID: קוד האזור של אזור השיווק הייעודי בארה"ב, שמשמש באובייקט GeoShape. _PARTNER_ID_: המאפיין הזה חייב לכלול את המחרוזת "_PARTNER_ID_", והערך חייב להיות מזהה ייחודי שספק השירות משתמש בו, באופן פנימי או חיצוני, כדי לזהות את הישות (לדוגמה, 12345 או a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value	טקסט	חובה – הערך של מערכת המזהים שצוינה.

מאפייני EIDR

EIDR (ראשי תיבות של Entertainment Identifier Registry) היא מערכת למזהים ייחודיים גלובליים למגוון רחב של תוכן מדיה, כולל סרטים ותוכניות טלוויזיה. מערכת הזיהוי ממירה מזהה לרשומת מטא-נתונים שמשויכת לשמות, לעריכות ולפרטים נוספים ברמה העליונה. בטבלה הבאה מפורטים המאפיינים שמשויכים ל-EIDR והשימוש בהם.

נכס	סוג צפוי	תיאור
titleEIDR	טקסט	מומלץ מאוד – מזהה EIDR ‏ (Entertainment Identifier Registry) מייצג, ברמה הכללית או המופשטת ביותר, יצירה של סרט או תוכנית טלוויזיה. הנכס הזה זמין בדפי המפרט של הישויות TVSeries,‏ TVSeason,‏ TVEpisode ו-Movie. לדוגמה, הערך של titleEIDR לסרט הנקרא 'Ghostbusters' הוא '10.5240/7EC7-228A-510A-053E-CBB8-J'. דוגמה למזהה/EIDR מופיעה בקטע 'דוגמאות לפידים של פעולות צפייה'.
editEIDR	טקסט	מומלץ מאוד – מזהה EIDR ‏ (Entertainment Identifier Registry) מייצג גרסה ספציפית של עריכה או מהדורה של סרט או תוכנית טלוויזיה. הנכס הזה זמין בדפי המפרט של הישות TVEpisode ושל הישות Movie. לדוגמה, לסרט 'Ghostbusters' שמספר ה-titleEIDR שלו הוא '10.5240/7EC7-228A-510A-053E-CBB8-J' יש כמה גרסאות עריכה, למשל '10.5240/1F2A-E1C5-680A-14C6-E76B-I' ו-'10.5240/8A35-3BEE-6497-5D12-9E4F-3'. הנכס titleEIDR נדרש כאשר editEIDR מסופק. דוגמה למזהה/EIDR מופיעה בקטע 'דוגמאות לפידים של פעולות צפייה'.

סוכנויות לסיווג תוכן

משתמשים בערכים בטבלה הזו עבור BroadcastService.contentRating, ‏ Movie.contentRating ו-TVSeries.contentRating. שם סוכנות הדירוג צריך להופיע בתחילת ערך הדירוג. דוגמאות:

• לסרט בדירוג R בארה"ב צריך להיות ערך Movie.contentRating של MPAA R.
• לסדרת טלוויזיה עם סיווג TV-MA בארה"ב צריך להיות ערך TVSeries.contentRating של TV_PG TV-MA.

מדינה	סוכנות לסיווג תוכן לטלוויזיה	סוכנות לסיווג סרטים
אלבניה (AL)	לא זמין	לא זמין
אנגולה (AO)	לא זמין	CCE
אנטיגואה וברבודה (AG)	לא זמין	MPAA
ארגנטינה (AR)	INCAA	INCAA
ארמניה (AM)	לא זמין	MKRF/RUSSIA
ארובה (AW)	לא זמין	לא זמין
אוסטרליה (AU)	ACB TV	ACB Movies
אוסטריה (AT)	FSK	FSK
אזרבייג'ן (AZ)	לא זמין	MKRF/RUSSIA
בחריין (BH)	לא זמין	MPAA

12345…12

מאפייני GeoShape

אובייקט GeoShape מכיל אחד מסוגי הנתונים הבאים:

• רשימה של מספרי מיקוד (לדוגמה, מספרי מיקוד בארה"ב, בקנדה או במדינות אחרות)
• רשימה של אזורי מיקוד בקנדה (FSA)
• מזהה של אזור שוק ייעודי (DMA) – מזהה של אזור בארצות הברית שבו אנשים מקבלים את אותם ערוצים ותוכניות טלוויזיה.

נכס	סוג צפוי	תיאור
@id	כתובת URL	חובה – המזהה של האזור הגיאוגרפי בפורמט URI.
@type	טקסט	חובה – תמיד מוגדר ל-GeoShape.
addressCountry	טקסט	חובה – קוד המדינה לפי תקן ISO 3166-1 alpha-2 בן שתי אותיות.
postalCode	טקסט	אופציונלי – רשימה של מיקוד אחד או יותר ו/או קודי FSA ‏ (Forward Sortation Area).
identifier	PropertyValue	אופציונלי – מזהה אזור שוק ייעודי (DMA), שהוא מזהה של אזור בארצות הברית שבו אנשים מקבלים את אותם ערוצי טלוויזיה ותוכניות.
identifier.@type	טקסט	חובה – תמיד מוגדר ל-PropertyValue.
identifier.propertyID	טקסט	חובה – תמיד מוגדר ל-DMA_ID.
identifier.value	טקסט	חובה – קוד אזור השוק הייעודי (DMA) של האזור.

דוגמה לאובייקט GeoShape שמכיל רשימה של מיקודים:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area1",
  "addressCountry": "US",
  "postalCode": [
    "94118",
    "94119"
  ]
}

דוגמה לאובייקט GeoShape שמכיל שילוב של FSA (אזור מיון קדמי) ומיקודי דואר:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area2",
  "addressCountry": "CA",
  "postalCode": [
    "1A1",
    "K1A",
    "K1AOB1"
  ]
}

דוגמה לאובייקט GeoShape שמכיל מזהה DMA:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area3",
  "addressCountry": "US",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "DMA_ID",
      "value": "501"
    }
  ]
}