בקטע הזה מפורטים המאפיינים המשותפים של פעולות צפייה.
מאפייני תגי העיצוב של הפעולה
נכס | סוג צפוי | תיאור |
---|---|---|
@type |
טקסט | חובה – תמיד מוגדר ל-WatchAction . |
target |
EntryPoint | חובה – אובייקט יעד שמספק את המיפוי של קישורי עומק לפלטפורמות שונות של Google. |
target.@type |
טקסט | חובה – תמיד מוגדר ל-EntryPoint . |
target.urlTemplate |
כתובת URL | חובה – קישור עומק שמפנה את המשתמשים לאפליקציה או לפלטפורמה שלכם ומתחיל את הפעלת התוכן. |
target.inLanguage |
טקסט | אופציונלי – השפה המקורית של הסדרה בפורמט BCP 47. |
target.actionPlatform |
טקסט | חובה – הפלטפורמות שממופות לערך urlTemplate . שירות 'פעולות במדיה' תומך בפעולות הבאות:
|
target.additionalProperty |
PropertyValue | חובה אם רלוונטי – רשימה של זוגות מאפיין-ערך שמייצגים מאפיינים נוספים של הקישור העמוק. למשל:
|
actionAccessibilityRequirement |
ActionAccessSpecification | חובה – אובייקט של מפרט גישה מסוג Action שמתאר את דרישת הגישה לתוכן. מידע על מאפייני מפרט הגישה של פעולה |
דפים שקשורים לסימון פעולות
במאמרים הבאים מפורטים נושאים שקשורים לנכסים האלה:
מאפיינים של הגדרת גישה לפעולה
נכס | סוג צפוי | תיאור |
---|---|---|
actionAccessibilityRequirement.@type |
טקסט | חובה – תמיד מוגדר ל-ActionAccessSpecification . |
actionAccessibilityRequirement.category |
טקסט | חובה – דרישה לגישה לתוכן. מידע נוסף זמין במאמר בנושא סוג חומת תשלום. אם ישות מייצגת קבוצת תוכן, צריך להגדיר את
|
actionAccessibilityRequirement.availabilityStarts |
תאריך | חובה – התאריך שאחריו הפעולה זמינה, בפורמט ISO 8601 (כולל אזור זמן).
חובה לספק את הישות המתאימה בפיד לפחות 7 ימים לפני תאריך ההתחלה של הזמינות שלה. כך יוגדלו הסיכויים שהתוכן יוצג בזמן בפלטפורמות של Google. |
actionAccessibilityRequirement.availabilityEnds |
תאריך | חובה – התאריך שאחריו הפעולה לא זמינה יותר, בפורמט ISO 8601 (כולל אזור זמן).
חובה לבצע עדכונים בתאריך availabilityEnds בפיד לפחות 7 ימים לפני התאריך הזה. כך יוגדלו הסיכויים שהתוכן יפסיק להופיע בפלטפורמות של Google בתאריך availabilityEnds. |
actionAccessibilityRequirement.eligibleRegion |
Country, City, State, GeoShape, or Text | חובה – אזורים שבהם התוכן זמין. משתמשים במחרוזת המיוחדת EARTH אם התוכן זמין בכל העולם. |
actionAccessibilityRequirement.ineligibleRegion |
Country, City, State, or GeoShape | חובה אם רלוונטי – אזורים שבהם התוכן מוגבל. אין צורך לספק את המאפיין הזה אם התוכן זמין בכל מקום ב-eligibleRegion . |
actionAccessibilityRequirement.requiresSubscription |
MediaSubscription | חובה אם רלוונטי – פרטי המינוי שהמשתמשים צריכים כדי לגשת לתוכן. מאפייני מינוי למדיה
|
actionAccessibilityRequirement.expectsAcceptanceOf |
מבצע | חובה אם התוכן דורש רכישה – פרטי המבצע שמשויך לתוכן. צריך לספק את פרטי המחיר במקרים הבאים:
Offer לחלוטין ולהגדיר את category מהאובייקט ActionAccessSpecification לערך free . מאפייני המבצע
|
actionAccessibilityRequirement.additionalProperty |
PropertyValue | חובה אם רלוונטי – הפניה לחבילת המינוי שתופיע בחוויה. |
actionAccessibilityRequirement.additionalProperty.name |
טקסט | חובה – תמיד צריך להגדיר את הערך "DisplaySubscriptionIdentifier" |
actionAccessibilityRequirement.additionalProperty.value |
טקסט | חובה – requiresSubscription.@id שיוצג עבור הישות.
|
מאפיינים של מינוי למדיה
חובה אם הערך של actionAccessibilityRequirement.category
הוא subscription
או externalSubscription
.
נכס | סוג צפוי | תיאור |
---|---|---|
requiresSubscription.@type |
טקסט | חובה – תמיד מוגדר ל-MediaSubscription |
requiresSubscription.@id |
כתובת URL | חובה – המזהה הייחודי של המינוי. אם אפשר לגשת לתוכן באמצעות מינויים שונים, לכל מינוי צריך להיות מזהה ייחודי. |
requiresSubscription.name |
טקסט | חובה – שם המינוי. חשוב לשים לב לפרטים הבאים:
|
requiresSubscription.sameAs |
כתובת URL | הדף שמתאר את המינוי. |
requiresSubscription.identifier |
טקסט | חובה אם הערך של category הוא subscription וגם
הערך של commonTier הוא false
–
מחרוזת ייחודית למינוי הזה שמייצגת גישה לקבוצת תוכן בקטלוג המדיה שלכם.
|
requiresSubscription.authenticator |
ארגון | חובה אם category הוא
externalsubscription – מאגר שמספק את הפרטים של אמצעי האימות של הספק החיצוני. |
requiresSubscription.authenticator.@type |
טקסט | חובה אם הערך של category הוא
externalsubscription – תמיד צריך להגדיר את הערך Organization . |
requiresSubscription.authenticator.name |
טקסט | חובה אם הערך של category הוא
externalsubscription – שם שירות האימות. ספקי TVE צריכים להגדיר את הערך TVE |
requiresSubscription.commonTier |
Boolean | חובה אם רלוונטי – חובה אם הקטגוריה מוגדרת כמינוי. מידע נוסף על רמת Common זמין במסמכי התיעוד בנושא הדרישות לרמת Common. |
הדרישות של Entitlement API
אם הערך של מאפיין actionAccessibilityRequirement.category
הוא subscription
או externalSubscription
, ואם חבילת המינוי כוללת כמה חבילות או רמות, או אם היא תומכת בתוספים, צריך להשתמש בממשק API לזכויות גישה. אל תכללו את הנתון הזה אם המינוי שלכם הוא מינוי ברמה אחת שמאפשר גישה לכל התוכן בקטלוג.
- לחברה א' יש מינוי יחיד שמאפשר למשתמשים שנרשמו לקבל גישה לכל התוכן שזמין: מזהה הזכאות / API לא נדרש
- לחברה ב' יש מינוי בסיסי שמאפשר גישה לחלק מהתוכן ומינוי פרימיום שמאפשר גישה לתוכן פרימיום: מזהה הזכאות / API נדרש
- לחברה ג' יש מינוי בסיסי שמאפשר גישה לחלק מהתוכן, וחבילות נוספות שמאפשרות גישה לתוכן של צד שלישי: נדרש מזהה זכאות / API
דפים שקשורים למינוי למדיה
במאמרים הבאים מפורטים נושאים שקשורים לנכסים האלה:
מאפייני המבצע
נכס | סוג צפוי | תיאור |
---|---|---|
expectsAcceptanceOf.@type |
טקסט | חובה – תמיד מוגדר ל-Offer . |
expectsAcceptanceOf.price |
מספר | חובה – מחיר הרכישה של התוכן. המחיר חייב להיות ערך חיובי שונה מאפס. לגבי ישויות עם מחיר של 0.00, צריך לציין את הקטגוריה כ-`free`. |
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 |
טקסט | חובה – אנחנו תומכים בסוגי התעודות המזהות הבאים:
|
value |
טקסט | חובה – הערך של מערכת המזהים שצוינה. |
מאפייני EIDR
EIDR (קיצור של The Entertainment Identifier Registry) היא מערכת מזהים ייחודית גלובלית למגוון רחב של תכני מדיה, כולל סרטים ותוכניות טלוויזיה. מערכת הזיהוי מפענחת מזהה לרשומה של מטא-נתונים שמשויכת לפריטים ברמה העליונה, לעריכות ועוד. בטבלה הבאה מפורטים המאפיינים שמשויכים ל-EIDR והשימוש בהם.
נכס | סוג צפוי | תיאור |
---|---|---|
titleEIDR |
טקסט | מומלץ מאוד – מזהה EIDR (Entertainment Identifier Registry) מייצג, ברמה הכללית או המופשטת ביותר, יצירה של סרט או תוכנית טלוויזיה. המאפיין הזה זמין בדפי המפרט של הישויות TVSeries, TVSeason, TVEpisode ו-Movie. לדוגמה, הערך של titleEIDR לסרט 'מכסחי השדים' הוא 10.5240/7EC7-228A-510A-053E-CBB8-J. אפשר לעיין בדוגמה למזהה EIDR בקטע 'דוגמאות לפיד של פעולות צפייה'. |
editEIDR |
טקסט | מומלץ מאוד – מזהה EIDR (Entertainment Identifier Registry) מייצג עריכה או מהדורה ספציפית של יצירה קולנועית או טלוויזיונית. המאפיין הזה זמין בדפים של הגדרות הישות TVEpisode ו-Movie. לדוגמה, לסרט הקולנוע 'מכסחי השדים' עם מזהה 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
של 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 |
בלגיה (BE) | לא זמין | 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 |
גרמניה (DE) | FSK | FSK |
יוון | ESR | GRFILM |
גואטמלה (GT) | לא זמין | MPAA |
האיטי (HT) | לא זמין | לא זמין |
הונדורס (HN) | לא זמין | MPAA |
הונג קונג (HK) | קנדה | 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 |
מקדוניה (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 |
נורווגיה (NO) | לא זמין | MEDIETILSYNET |
עומאן (OM) | לא זמין | MPAA |
פנמה (PA) | לא זמין | MPAA |
פפואה גינאה החדשה (PG) | לא זמין | MPAA |
פרגוואי (PY) | לא זמין | MPAA |
פרו (PE) | לא זמין | MPAA |
הפיליפינים (PH) | MTRCB | MTRCB |
פולין (PL) | לא זמין | MPAA |
פורטוגל | לא זמין | 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 |
מאפייני GeoShape
אובייקט GeoShape מכיל אחד מסוגי הנתונים הבאים:
- רשימה של מיקודים (לדוגמה, מיקודים בארה"ב, בקנדה או במקומות אחרים)
- רשימה של אזורי מיקוד בקנדה (FSA)
- מזהה אזור שוק ייעודי (DMA) – מזהה של אזור בארצות הברית שבו אנשים מקבלים את אותם ערוצי טלוויזיה ואותן תוכניות.
נכס | סוג צפוי | תיאור |
---|---|---|
@id |
כתובת URL | חובה – המזהה של האזור הגיאוגרפי בפורמט URI. |
@type |
טקסט | חובה – תמיד מוגדר ל-GeoShape . |
addressCountry |
טקסט | חובה – קוד מדינה בן שתי אותיות לפי תקן ISO 3166-1 alpha-2. |
postalCode |
טקסט | אופציונלי – רשימה של מיקודים ו/או קודי FSA (אזור מיון קדימה). |
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"
}
]
}