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

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

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

נכס סוג צפוי תיאור
@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
בלארוס (BY) לא זמין MKRF/RUSSIA
בלגיה לא זמין MPAA
בליז (BZ) לא זמין לא זמין
בנין (BJ) לא זמין CNC
בוליביה (BO) לא זמין MPAA
בוסניה והרצגובינה (BA) לא זמין MPAA
בוטסואנה (BW) לא זמין MPAA
ברזיל (BR) CLASSIND CLASSIND
בורקינה פאסו (BF) לא זמין CNC
קמבודיה (KH) לא זמין לא זמין
קנדה (CA) CA_TV CHVRS
כף ורדה (CV) לא זמין CCE
צ'ילה (CL) לא זמין MPAA
קולומביה (CO) לא זמין MPAA
קוסטה ריקה (CR) לא זמין MPAA
קרואטיה (HR) לא זמין לא זמין
קפריסין (CY) לא זמין GRFILM
צ'כיה (CZ) לא זמין CZFILM
דנמרק (DK) לא זמין MCCYP
אקוודור (EC) לא זמין MPAA
מצרים (EG) לא זמין MPAA
אל סלבדור (SV) לא זמין MPAA
אסטוניה (EE) לא זמין EEFILM
פיג'י (FJ) לא זמין לא זמין
פינלנד (FI) לא זמין MEKU
צרפת (FR) CSA CSA
גאבון (GA) לא זמין CNC
גרמניה FSK FSK
יוון ESR GRFILM
גואטמלה (GT) לא זמין MPAA
האיטי (HT) לא זמין לא זמין
הונדורס (HN) לא זמין MPAA
הונג קונג (HK) CA FCO
הונגריה (HU) לא זמין MPAA
איסלנד (IS) לא זמין KIJKWIJZER
הודו (IN) CBFC CBFC
אינדונזיה (ID) KPI LSF
אירלנד (IE) לא זמין IFCO
איטליה AGCOM AGCOM
חוף השנהב (CI) לא זמין CNC
ג'מייקה (JM) לא זמין MPAA
יפן (JP) לא רלוונטי EIRIN
ירדן (JO) לא זמין MPAA
קזחסטן (KZ) לא זמין MRKF
קוריאה (KR) KMRB KMRB
כווית (KW) לא זמין MPAA
קירגיזסטן (KG) לא זמין MKRF/RUSSIA
לאוס (LA) לא זמין לא זמין
לטביה (LV) לא זמין NKCLV
לבנון (LB) לא זמין MPAA
ליטא לא זמין לא זמין
לוקסמבורג (LU) לא זמין KIJKWIJZER
מקדוניה (MK) לא זמין MPAA
מלזיה (MY) לא זמין FCBM
מאלי (ML) לא זמין CNC
מלטה (MT) לא זמין MCCAA
מאוריציוס (MU) לא זמין BBFC
מקסיקו (MX) RTC RTC
מולדובה (MD) לא זמין לא זמין
נמיביה (NA) לא זמין לא זמין
נפאל (NP) לא זמין MPAA
הולנד (NL) KIJKWIJZER KIJKWIJZER
ניו זילנד (NZ) BSA OFLC
ניקרגואה (NI) לא זמין MPAA
ניז'ר (NE) לא זמין CNC
נורווגיה לא זמין MEDIETILSYNET
עומאן (OM) לא זמין MPAA
פנמה (PA) לא זמין MPAA
פפואה גינאה החדשה (PG) לא זמין MPAA
פרגוואי (PY) לא זמין MPAA
פרו (PE) לא זמין MPAA
הפיליפינים (PH) MTRCB MTRCB
פולין (PL) לא זמין MPAA
פורטוגל (PT) לא זמין CCE
קטאר (QA) לא זמין MPAA
רוסיה (RU) MKRF/RUSSIA MKRF/RUSSIA
רואנדה (RW) לא זמין CNC
ערב הסעודית (SA) לא זמין MPAA
סנגל (SN) לא זמין MPAA
סינגפור (SG) לא זמין MDA
סלובקיה (SK) לא זמין MPAA
סלובניה (SI) לא זמין MPAA
דרום אפריקה (ZA) FPB FPB
ספרד SETSI ICAA
סרי לנקה (LK) לא זמין לא זמין
שוודיה (SE) לא זמין SMSA
שווייץ (CH) FSK FSK
טייוואן (TW) לא זמין MOCTW
טג'יקיסטן (TJ) לא זמין MKRF/RUSSIA
טנזניה (TZ) לא זמין MPAA
תאילנד לא זמין BFVC
טוגו (TG) לא זמין CNC
טרינידד וטובגו (TT) לא זמין לא זמין
טורקיה (TR) RTÜK ECBMCT
טורקמניסטן (TM) לא זמין MKRF/RUSSIA
אוגנדה (UG) לא זמין MPAA
אוקראינה (UA) לא זמין לא זמין
איחוד האמירויות הערביות (AE) לא זמין MPAA
בריטניה (GB) BBFC BBFC
ארצות הברית (US) TV_PG MPAA
אורוגוואי (UY) לא זמין MPAA
אוזבקיסטן (UZ) לא זמין MKRF/RUSSIA
ונצואלה (VE) לא זמין RESORTEVIOLENCIA
וייטנאם (VN) לא זמין MCST
זמביה (ZM) לא זמין MPAA
זימבבואה (ZW) לא זמין MPAA

מאפייני GeoShape

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

נכס סוג צפוי תיאור
@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"
    }
  ]
}