הקטע הזה מפרט את הפרטים של המאפיינים הנפוצים של פעולות הצפייה.
מאפייני תגי עיצוב של פעולות
מאפיין (property) | סוג צפוי | תיאור |
---|---|---|
@type |
טקסט | חובה – תמיד מוגדר ל-WatchAction . |
target |
ערך כניסה | חובה – אובייקט יעד שמספק מיפוי של קישורי עומק לפלטפורמות שונות של Google. |
target.@type |
טקסט | חובה – תמיד מוגדר ל-EntryPoint . |
target.urlTemplate |
כתובת URL | חובה – קישור עומק שמעביר את המשתמשים לאפליקציה או לפלטפורמה ומפעיל את התוכן. |
target.inLanguage |
טקסט | אופציונלי – השפה המקורית של הסדרה בפורמט BCP 47. |
target.actionPlatform |
טקסט | חובה – הפלטפורמות שממופות אל
urlTemplate . פעולות במדיה תומכות בפעולות הבאות:
|
target.additionalProperty |
נכס Value | חובה אם רלוונטי – רשימה של צמדי נכסים-ערך
כדי לייצג מאפיינים נוספים של קישור העומק. למשל:
|
actionAccessibilityRequirement |
ActionAccessSpecification | חובה – אובייקט מפרט גישה לפעולה שמתאר את דרישת הגישה לתוכן. עיינו במאפייני מפרט הגישה לפעולה. |
דפים הקשורים לתגי עיצוב של פעולות
בדפים הבאים מפורטים הנושאים הקשורים לנכסים אלה:
מאפייני מפרט של גישה לפעולה
מאפיין (property) | סוג צפוי | תיאור |
---|---|---|
actionAccessibilityRequirement.@type |
טקסט | חובה – תמיד מוגדר ל-ActionAccessSpecification . |
actionAccessibilityRequirement.category |
טקסט | חובה – דרישת גישה לתוכן. מידע נוסף מפורט בקטע סוג חומת תשלום. אם ישות מייצגת קבוצה של תכנים, צריך להגדיר את
|
actionAccessibilityRequirement.availabilityStarts |
תאריך | חובה – התאריך שאחריו הפעולה זמינה, בפורמט ISO 8601 (כולל אזור זמן).
חובה לציין את הישות המתאימה בפיד לפחות 7 ימים לפני תאריך הזמינות שלה. כך תשפרו את הסיכויים שהתוכן יופיע בפלטפורמות של Google בזמן. |
actionAccessibilityRequirement.availabilityEnds |
תאריך | חובה – תאריך שאחריו הפעולה לא תהיה זמינה יותר,
בפורמט ISO 8601 (כולל אזור זמן).
צריך לעדכן את תאריך הסיום של הזמינות בפיד לפחות 7 ימים לפני תאריך הזמינות. כך, יהיה יותר סיכוי שהתוכן יפסיק להופיע בפלטפורמות של Google בתאריך הזמינות. |
actionAccessibilityRequirement.eligibleRegion |
מדינה, עיר, מדינה, אזור גיאוגרפי או טקסט | חובה – אזורים שבהם התוכן זמין. יש להשתמש
במחרוזת המיוחדת EARTH אם התוכן זמין בכל העולם. |
actionAccessibilityRequirement.ineligibleRegion |
מדינה, עיר, מדינה או Geform | חובה אם רלוונטי – אזורים שבהם
התוכן מוגבל. אין צורך לספק את הנכס הזה אם התוכן
זמין בכל מקום בeligibleRegion . |
actionAccessibilityRequirement.requiresSubscription |
מינוי מדיה | חובה אם רלוונטי – פרטי המינוי שמשתמשים צריכים כדי לגשת לתוכן. מידע נוסף זמין במאמר מאפייני מינוי למדיה.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
מבצע | חובה אם התוכן מחייב רכישה – פרטי המבצע שמשויך לתוכן. יש להזין את פרטי המחיר במקרים הבאים:
Offer ולהגדיר את category מהאובייקט ActionAccessSpecification ל-free . בקישור הבא תוכלו לקרוא על מאפייני מבצע.
|
מאפייני מינוי למדיה
חובה אם actionAccessibilityRequirement.category
הוא
subscription
או externalSubscription
.
מאפיין (property) | סוג צפוי | תיאור |
---|---|---|
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 |
ערך בוליאני | חובה אם רלוונטי – חובה לעשות זאת אם הקטגוריה מוגדרת למינוי. מידע נוסף על CommonTier מופיע בתיעוד של הדרישות הנפוצות לגבי רמות. |
דרישות API להרשאות
הרשאת API נדרשת אםactionAccessibilityRequirement.category
היא subscription
או externalSubscription
וחבילת שירות התמיכה כוללת מספר חבילות או רמות או שיש לה תמיכה בתוסף. אל תכללו את זה אם המינוי שלכם הוא רב-מפלסי ונותן גישה לכל התוכן בקטלוג.
- לחברה א' יש מינוי יחיד שמספק למשתמשים רשומים גישה לכל התוכן הזמין: אין צורך במזהה הרשאה / ממשק API
- לחברה ב' יש מינוי בסיסי שמספק גישה לתוכן מסוים ומינוי פרימיום שמספק גישה לתוכן פרימיום: נדרש מזהה הרשאה / API
- לחברה ג' יש מינוי בסיסי שמספק גישה לתוכן מסוים והוספה לחבילות שמספקות גישה לתוכן של צד שלישי: נדרש מזהה הרשאה / API
דפים הקשורים למינויים למדיה
בדפים הבאים מפורטים הנושאים הקשורים לנכסים אלה:
מאפייני מבצע
מאפיין (property) | סוג צפוי | תיאור |
---|---|---|
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 של דף אינטרנט שמזהה את אתר המכירה. לדוגמה, דף הבית של המוכר. |
דף הקשור למבצע
בדפים הבאים מפורטים הנושאים הקשורים לנכסים אלה:
מזהים
פידים של פעולות במדיה מקבלים מגוון מזהים שיכולים לעזור לזהות ישות באופן לא ברור. המזהים האלה יכולים להאיץ את תהליך ההתאמה של התוכן בפיד לבין התוכן שבמאגרי הנתונים של Google. למרות שאפשר להוסיף את רוב המזהים האלה לפיד באמצעות המאפיין identifier
בסוגים שונים של ישויות, ל-EIDR יש נכס מיוצג משלהם. שתי האפשרויות האלה מפורטות בהמשך.
מאפייני מזהה
מאפיין (property) | סוג צפוי | תיאור |
---|---|---|
identifier |
טקסט | מומלץ מאוד – מזהה, בדרך כלל מזהה חיצוני, שמזהה באופן חד-משמעי ישות נתונה. מותר להשתמש בכמה מזהים. הנכס הזה זמין בכל סוגי הישויות של פעולות צפייה. הטבלה למטה מפרטת את המזהים ונכסי המשנה הקבילים של נכס identifier . ראו דוגמה למזהה/EIDR בקטע הדוגמאות של פעולות צפייה. |
מאפיין (property) | סוג צפוי | תיאור |
---|---|---|
@type |
טקסט | חובה – תמיד מוגדר ל-PropertyValue . |
propertyID |
טקסט | חובה – אנחנו תומכים בסוגי המזהים הבאים:
|
value |
טקסט | חובה – הערך של מערכת המזהים שצוינה. |
נכסי EIDR
EIDR (קיצור של The Entertainment Identifier Registry) היא מערכת מזהים ייחודית גלובלית למגוון רחב של תוכן מדיה, כולל תמונות תנועה ותוכניות טלוויזיה. מערכת הזיהוי מעבירה מזהה לרשומת מטא-נתונים המשויכת לכותרות, לעריכות ועוד ברמה העליונה. בטבלה הבאה מפורטים הנכסים המשויכים ל-EIDR והשימוש בהם.
מאפיין (property) | סוג צפוי | תיאור |
---|---|---|
titleEIDR |
טקסט | מומלץ מאוד – מזהה EIDR (מזהה בידור) מייצג, באופן הכללי/המופשט, יצירה של סרט או טלוויזיה. הנכס הזה זמין בדפי המפרטים של ישויות TVSeries, TVSeason, TVEpisode ו-Movie. לדוגמה, titleEIDR עבור תמונת התנועה הידועה בתור 'Ghostbusters' הוא " 10.5240/7EC7-228A-510A-053E-CBB8-J". ניתן לראות את קטע ה- IDR . |
editEIDR |
טקסט | מומלץ מאוד – מזהה EIDR (מזהה בידור) מייצג עריכה/מהדורה ספציפית של סרט או טלוויזיה. |
סוכנויות לסיווג תוכן
צריך להשתמש בערכים שבטבלה בשביל BroadcastService.contentRating
, Movie.contentRating
וTVSeries.contentRating
. סוכנות הדירוג צריכה להופיע לפני ערך הדירוג. דוגמאות:
- סרט עם סיווג "R" בארה"ב צריך להיות ערך
Movie.contentRating
של "MPAA R". - סדרת טלוויזיה בדירוג "TV-MA" בארה"ב צריכה לקבל את הערך
TVSeries.contentRating
של "TVPG TV-MA".
המדינה | סוכנות לדירוג טלוויזיה | סוכנות לדירוג סרטים |
---|---|---|
אלבניה (AL) | הנתונים לא זמינים | הנתונים לא זמינים |
אנגולה (AO) | הנתונים לא זמינים | CECE |
אנטיגואה וברבודה (AG) | הנתונים לא זמינים | MPAA |
ארגנטינה (AR) | הודו | הודו |
ארמניה (AM) | הנתונים לא זמינים | MKRF/רוסיה |
ארובה (AW) | הנתונים לא זמינים | הנתונים לא זמינים |
אוסטרליה (אוסטרליה) | ACB TV | ACB Movies |
אוסטריה (AT) | מוסדות פיננסיים | מוסדות פיננסיים |
אזרבייג'ן (AZ) | הנתונים לא זמינים | MKRF/רוסיה |
בחריין (BH) | הנתונים לא זמינים | MPAA |
בלארוס (BY) | הנתונים לא זמינים | MKRF/רוסיה |
בלגיה (BE) | הנתונים לא זמינים | MPAA |
בליז (BZ) | הנתונים לא זמינים | הנתונים לא זמינים |
בנין (BJ) | הנתונים לא זמינים | CNC |
בוליביה (BO) | הנתונים לא זמינים | MPAA |
בוסניה והרצגובינה (BA) | הנתונים לא זמינים | MPAA |
בוטסואנה (BW) | הנתונים לא זמינים | MPAA |
ברזיל (BR) | קביעה | קביעה |
בורקינה פאסו (BF) | הנתונים לא זמינים | CNC |
קמבודיה (KH) | הנתונים לא זמינים | הנתונים לא זמינים |
קנדה (קנדה) | CA_TV | מכנסיים |
כף ורדה (CV) | הנתונים לא זמינים | CECE |
צ'ילה (CL) | הנתונים לא זמינים | MPAA |
קולומביה (CO) | הנתונים לא זמינים | MPAA |
קוסטה ריקה (CR) | הנתונים לא זמינים | MPAA |
קרואטיה (HR) | הנתונים לא זמינים | הנתונים לא זמינים |
קפריסין (CY) | הנתונים לא זמינים | סרט |
צ'כיה (CZ) | הנתונים לא זמינים | CZFILM |
דנמרק (DK) | הנתונים לא זמינים | מרכז הלקוחות שלי |
אקוודור (EC) | הנתונים לא זמינים | MPAA |
מצרים (EG) | הנתונים לא זמינים | MPAA |
אל סלבדור (SV) | הנתונים לא זמינים | MPAA |
אסטוניה (EE) | הנתונים לא זמינים | EEFELM |
פיג'י (FJ) | הנתונים לא זמינים | הנתונים לא זמינים |
פינלנד (FI) | הנתונים לא זמינים | MEKU |
צרפת (FR) | מודעות CSA | מודעות CSA |
גאבון (GA) | הנתונים לא זמינים | CNC |
גרמניה (DE) | מוסדות פיננסיים | מוסדות פיננסיים |
יוון (GR) | משחקי ESR | סרט |
גוואטמלה (GT) | הנתונים לא זמינים | MPAA |
האיטי (HT) | הנתונים לא זמינים | הנתונים לא זמינים |
הונדורס (HN) | הנתונים לא זמינים | MPAA |
הונג קונג (HK) | CA | FCO |
הונגריה (HU) | הנתונים לא זמינים | MPAA |
איסלנד (IS) | הנתונים לא זמינים | קייג'ויז'ר |
הודו (הודו) | CBFC | CBFC |
אינדונזיה (ID) | KPI | LSF |
אירלנד (IE) | הנתונים לא זמינים | חברת IFCO |
איטליה (IT) | AGCOM | AGCOM |
חוף השנהב | הנתונים לא זמינים | CNC |
ג'מייקה (JM) | הנתונים לא זמינים | MPAA |
יפן (יפן) | לא רלוונטי | אירלנד |
ירדן (JO) | הנתונים לא זמינים | MPAA |
קזחסטן (KZ) | הנתונים לא זמינים | MRKF |
קוריאה (KR) | KMRB | KMRB |
כוויית (ק"ו) | הנתונים לא זמינים | MPAA |
קירגיזסטן (KG) | הנתונים לא זמינים | MKRF/רוסיה |
לאוס (LA) | הנתונים לא זמינים | הנתונים לא זמינים |
לטביה (LV) | הנתונים לא זמינים | NKCLV |
לבנון (LB) | הנתונים לא זמינים | MPAA |
ליטא (LT) | הנתונים לא זמינים | הנתונים לא זמינים |
לוקסמבורג (LU) | הנתונים לא זמינים | קייג'ויז'ר |
מקדוניה (הרפובליקה היוגוסלבית לשעבר מקדוניה) | הנתונים לא זמינים | MPAA |
מלזיה (MY) | הנתונים לא זמינים | FCBM |
מאלי (ML) | הנתונים לא זמינים | CNC |
מלטה (MT) | הנתונים לא זמינים | מרכז הלקוחות שלי |
מאוריציוס (MU) | הנתונים לא זמינים | BBFC |
מקסיקו (MX) | RTC | RTC |
מולדובה (MD) | הנתונים לא זמינים | הנתונים לא זמינים |
נמיביה (NA) | הנתונים לא זמינים | הנתונים לא זמינים |
נפאל (NP) | הנתונים לא זמינים | MPAA |
הולנד (NL) | קייג'ויז'ר | קייג'ויז'ר |
ניו זילנד (ניו זילנד) | BSA | OFLC |
ניקרגואה (NI) | הנתונים לא זמינים | MPAA |
ניז'ר (NE) | הנתונים לא זמינים | CNC |
נורווגיה (NO) | הנתונים לא זמינים | מדינאי |
עומאן (OM) | הנתונים לא זמינים | MPAA |
פנמה (PA) | הנתונים לא זמינים | MPAA |
פפואה גינאה החדשה (PG) | הנתונים לא זמינים | MPAA |
פרגוואי (PY) | הנתונים לא זמינים | MPAA |
פרו (PE) | הנתונים לא זמינים | MPAA |
הפיליפינים (PH) | MTRCB | MTRCB |
פולין (PL) | הנתונים לא זמינים | MPAA |
פורטוגל (PT) | הנתונים לא זמינים | CECE |
קטאר (QA) | הנתונים לא זמינים | MPAA |
רוסיה (RU) | MKRF/רוסיה | MKRF/רוסיה |
רואנדה (RW) | הנתונים לא זמינים | CNC |
ערב הסעודית (SA) | הנתונים לא זמינים | MPAA |
סנגל (SN) | הנתונים לא זמינים | MPAA |
סינגפור (SG) | הנתונים לא זמינים | MDA |
סלובקיה (SK) | הנתונים לא זמינים | MPAA |
סלובניה (SI) | הנתונים לא זמינים | MPAA |
דרום אפריקה (ZA) | FPB | FPB |
ספרד (ES) | סטסי | ICAA |
סרי לנקה (LK) | הנתונים לא זמינים | הנתונים לא זמינים |
שוודיה (SE) | הנתונים לא זמינים | הודעות SMS |
שווייץ (CH) | מוסדות פיננסיים | מוסדות פיננסיים |
טייוואן (TW) | הנתונים לא זמינים | MOCTW |
טג'יקיסטן (TJ) | הנתונים לא זמינים | MKRF/רוסיה |
טנזניה (TZ) | הנתונים לא זמינים | MPAA |
תאילנד (TH) | הנתונים לא זמינים | BFVC |
טוגו (TG) | הנתונים לא זמינים | CNC |
טרינידד וטובגו (TT) | הנתונים לא זמינים | הנתונים לא זמינים |
טורקיה (TR) | טובין | ECBMCT |
טורקמניסטן (TM) | הנתונים לא זמינים | MKRF/רוסיה |
אוגנדה (UG) | הנתונים לא זמינים | MPAA |
אוקראינה (UA) | הנתונים לא זמינים | הנתונים לא זמינים |
איחוד האמירויות הערביות (AE) | הנתונים לא זמינים | MPAA |
בריטניה (GB) | BBFC | BBFC |
ארצות הברית (US) | TV_PG | MPAA |
אורוגוואי (UY) | הנתונים לא זמינים | MPAA |
אוזבקיסטן (UZ) | הנתונים לא זמינים | MKRF/רוסיה |
ונצואלה (VE) | הנתונים לא זמינים | Reposeviolencia |
וייטנאם (VN) | הנתונים לא זמינים | MCST |
זמביה (ZM) | הנתונים לא זמינים | MPAA |
זימבבווה (ZW) | הנתונים לא זמינים | MPAA |
מאפייני צורה גיאוגרפית
אובייקט צורה גיאוגרפי מכיל אחד מסוגי הנתונים הבאים:
- רשימה של מספרי מיקוד (לדוגמה: ארה"ב, קנדה או אזורי מיקוד אחרים)
- רשימה של אזורי מיון קדימה בקנדה
- מזהה אזור שוק ייעודי (DMA) – מזהה של אזור בארצות הברית, שבו אנשים מקבלים את אותם ערוצי טלוויזיה ותוכניות.
מאפיין (property) | סוג צפוי | תיאור |
---|---|---|
@id |
כתובת URL | חובה – המזהה של האזור הגיאוגרפי בפורמט URI. |
@type |
טקסט | חובה – תמיד מוגדר ל-GeoShape . |
addressCountry |
טקסט | חובה - שתי אותיות קוד ISO 3166-1 alpha-2. |
postalCode |
טקסט | אופציונלי – רשימה של מספרי מיקוד ו/או מספרי FSA (אזור מיון קדימה). |
identifier |
נכס Value | אופציונלי – מזהה אזור שוק ייעודי (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"
}
]
}