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

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

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

נכס סוג צפוי תיאור
@type טקסט חובה – תמיד מוגדר לערך WatchAction.
target EntryPoint חובה – אובייקט יעד שעומד מספקת את המיפוי של עמוק לפלטפורמות שונות של Google.
target.@type טקסט חובה – תמיד מוגדר לערך EntryPoint.
target.urlTemplate כתובת URL חובה – A עמוק קישור שמעביר את המשתמשים לאפליקציה או לפלטפורמה שלכם ויפעיל הפעלת התוכן.
target.inLanguage טקסט אופציונלי – שפת המקור של הסדרה BCP 47 הפורמט.
target.actionPlatform טקסט חובה – הפלטפורמות שממופות אל urlTemplate. פעולות מדיה תומכות בתכונות הבאות:
  • http://schema.org/DesktopWebPlatform: פלטפורמת חיפוש בדפדפני אינטרנט שמותאמים למחשבים.
  • http://schema.org/MobileWebPlatform: פלטפורמת החיפוש פועלת דפדפני אינטרנט לנייד.
  • http://schema.org/AndroidPlatform: חיפוש ו-PlayGuide פלטפורמות באפליקציה ל-Android.
  • http://schema.org/AndroidTVPlatform: Android TV בפלטפורמה ל-Android TV.
  • http://schema.org/IOSPlatform: פלטפורמת החיפוש ב-iOS אפליקציה.
  • http://schema.googleapis.com/GoogleVideoCast: הפעלת Cast ו פלטפורמות ביתיות במכשירי Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: הפעלת Cast ו פלטפורמות ביתיות במכשירי Chromecast (פעולות האזנה בלבד).
לצפייה פלטפורמה הסוגים של הדרישות.
target.additionalProperty PropertyValue חובה אם רלוונטי – רשימה של צמדי נכס-ערך שמייצגים מאפיינים נוספים של קישור העומק. דוגמאות לתוכן מהסוג הזה: הבאים:
  • contentLanguage: שפת השידור (דיבוב), ב: BCP 47 פורמט. אם התוכן דובב בשפה אחרת, נדרש נכס. שימוש במערך למספר קודי שפה.
  • subtitleLanguage: שפות הכתוביות או כיתובים, ב- BCP 47 פורמט. שימוש במערך למספר קודי שפה.
  • cameraAngle: זווית המצלמה של התוכן. עבור לדוגמה, "רמת העין" ו-High-Angle. אם התוכן זמין זוויות המצלמה שונות, המאפיין הזה הוא חובה. צריך להשתמש במערך כדי זוויות שונות של המצלמה.
  • videoFormat: פורמט הקובץ שמשמש לשמירת הקובץ הדיגיטלי תאריך סרטון; לדוגמה, "SD" עבור "איכות רגילה" ו-"HD" עבור באיכות 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 ימים לפני תאריך הזמינות שלה. הפעולה הזו תשפר את שיש סיכוי גבוה שהתוכן יופיע בפלטפורמות של Google בזמן.

actionAccessibilityRequirement.availabilityEnds ‫תאריך חובה – התאריך שאחריו הפעולה לא תהיה זמינה יותר. בISO בפורמט 8601 (כולל אזור זמן).
  • חייב להיות שווה ל-72 שעות או יותר availabilityStarts
  • אם התוכן תמיד זמין לאחר הפרסום, צריך להגדיר את האפשרות הזו להיות 20 שנה מהתאריך הנוכחי.

חובה לבצע עדכונים בתאריך סיום הזמינות בפיד לפחות 7 ימים לפני תאריך סיום הזמינות. הזה ישפרו את הסיכויים שהתוכן יפסיק להופיע ב-Google בתאריך הזמינות עד לתאריך הסיום.

actionAccessibilityRequirement.eligibleRegion Country, עיר, State, GeoShape, או טקסט חובה – אזורים שבהם התוכן זמין. משתמשים ב מחרוזת מיוחדת EARTH אם התוכן זמין בכל העולם.
actionAccessibilityRequirement.ineligibleRegion Country, עיר, State, או 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, זהו השם של מאמת החשבונות שרשום אצל של ה-TVE. היא מחרוזת שמזהה באופן ייחודי את שם השירות במאמת החשבונות של 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 בוליאני חובה אם רלוונטי – חובה אם הקטגוריה מוגדרת כ- במינוי. אפשר לקרוא מידע נוסף על CommonTier ב משותף מידע על הדרישות מהרמות.

הדרישות של Entitlement API

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

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

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

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

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

דף שקשור להצעה

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

מזהים

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

מאפייני מזהה

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

הנכס הזה זמין בכל סוגי הישויות של פעולות צפייה.

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

נכסי EIDR

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

נכס סוג צפוי תיאור
titleEIDR טקסט מומלץ מאוד – מזהה EIDR (Entertainment Identifier Registry) מייצג, ברמה הכללית/המופשטת ביותר, יצירה של סרט או טלוויזיה.

הנכס הזה זמין בדפי המפרט של ישויות

TVSeriesTVSeasonTVEpisode הוא '10.5240/7EC7-228A-510A-053E-CBB8-J'.

אפשר לעיין דוגמה למזהה/EIDR בקטע דוגמאות בפיד 'פעולות בשעון'.
editEIDR טקסט מומלץ מאוד – מזהה EIDR (Entertainment Identifier Registry) מייצג מהדורה ספציפית של יצירה או מהדורה ספציפית של סרט או טלוויזיה.

הנכס הזה זמין בדפי מפרטי הישויות TVEpisode ו-Movie.

לדוגמה, הסרט שנקרא "Ghostbusters" שכותרת EIDR היא "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 של "TVPG TV-MA".

מדינה סוכנות לדירוג תוכניות טלוויזיה סוכנות לדירוג סרטים
אלבניה (AL) לא זמין לא זמין
אנגולה (AO) לא זמין CCE
אנטיגואה וברבודה (AG) לא זמין MPAA
ארגנטינה (AR) INCAA INCAA
ארמניה (AM) לא זמין MKRF/RUSSIA
ארובה (AW) לא זמין לא זמין
אוסטרליה (AU) ACB TV סרטים ב-ACB
אוסטריה (AT) FSK FSK
אזרבייג'ן (AZ) לא זמין MKRF/RUSSIA
בחריין (BH) לא זמין MPAA
בלארוס (BY) לא זמין MKRF/RUSSIA
בלגיה (BE) לא זמין MPAA
בליז (BZ) לא זמין לא זמין
בנין (BJ) לא זמין CNC
בוליביה (BO) לא זמין MPAA
בוסניה והרצגובינה (BA) לא זמין MPAA
בוטסואנה (BW) לא זמין MPAA
ברזיל (BR) קלאסית קלאסית
בורקינה פאסו (BF) לא זמין CNC
קמבודיה (KH) לא זמין לא זמין
קנדה (CA) CA_TV CHVRS
כף ורדה (CV) לא זמין CCE
צ'ילה (CL) לא זמין MPAA
קולומביה (CO) לא זמין MPAA
קוסטה ריקה לא זמין MPAA
קרואטיה (HR) לא זמין לא זמין
קפריסין (CY) לא זמין GRFILM
צ'כיה (CZ) לא זמין CZFILM
דנמרק (DK) לא זמין MCCYP
אקוודור (EC) לא זמין MPAA
מצרים (EG) לא זמין MPAA
אל סלוודור (SV) לא זמין MPAA
אסטוניה (EE) לא זמין EEFILM
פיג'י (FJ) לא זמין לא זמין
פינלנד (FI) לא זמין MEKU
צרפת (FR) CSA CSA
גבון (GA) לא זמין CNC
גרמניה (DE) FSK FSK
יוון (GR) ESR GRFILM
גואטמלה (GT) לא זמין MPAA
האיטי (HT) לא זמין לא זמין
הונדורס (HN) לא זמין MPAA
הונג קונג (HK) CA FCO
הונגריה (HU) לא זמין MPAA
איסלנד (IS) לא זמין KIJKWIJZER
הודו (IN) CBFC CBFC
אינדונזיה (ID) KPI LSF
אירלנד (IE) לא זמין IFCO
איטליה (IT) 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
ליטא (LT) לא זמין לא זמין
לוקסמבורג (LU) לא זמין KIJKWIJZER
מקדוניה הצפונית לא זמין MPAA
מלזיה (MY) לא זמין FCBM
מאלי (ML) לא זמין CNC
מלטה (MT) לא זמין MCCAA
מאוריציוס (MU) לא זמין BBFC
מקסיקו (MX) RTC RTC
מולדובה (מרילנד) לא זמין לא זמין
נמיביה (NA) לא זמין לא זמין
נפאל (NP) לא זמין MPAA
הולנד (NL) KIJKWIJZER KIJKWIJZER
ניו זילנד (NZ) BSA OFLC
ניקרגואה (NI) לא זמין MPAA
ניז'ר (NE) לא זמין CNC
נורווגיה (NO) לא זמין 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
ספרד (ES) SETSI ICAA
סרי לנקה (LK) לא זמין לא זמין
שוודיה (SE) לא זמין הודעות SMSA
שווייץ (CH) FSK FSK
טייוואן (TW) לא זמין MOCTW
טג'יקיסטן (TJ) לא זמין MKRF/RUSSIA
טנזניה (TZ) לא זמין MPAA
תאילנד (TH) לא זמין 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

מאפייני GeoForm

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

נכס סוג צפוי תיאור
@id כתובת URL חובה – מזהה האזור הגיאוגרפי בפורמט URI.
@type טקסט חובה – תמיד מוגדר לערך GeoShape.
addressCountry טקסט חובה – שתי אותיות ISO קוד מדינה 3166-1 alpha-2.
postalCode טקסט אופציונלי – רשימה של מיקוד אחד או יותר ו/או קוד FSA (אזור מיון קדימה).
identifier PropertyValue אופציונלי – A מזהה אזור השוק הייעודי (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"
    }
  ]
}