يوفّر هذا القسم تفاصيل السمات الشائعة لإجراءات المشاهدة.
خصائص ترميز الإجراءات
الموقع | النوع المتوقع | الوصف |
---|---|---|
@type |
Text | مطلوبة: يتم ضبطها دائمًا على WatchAction . |
target |
EntryPoint | مطلوبة: عنصر مستهدَف يقدّم ربطًا بين الروابط العميقة ومنصّات Google المختلفة |
target.@type |
Text | مطلوبة: يتم ضبطها دائمًا على EntryPoint . |
target.urlTemplate |
URL | مطلوبة: رابط لصفحة معيّنة في التطبيق ينقل المستخدمين إلى تطبيقك أو منصتك ويبدأ تشغيل المحتوى |
target.inLanguage |
Text | اختياري: اللغة الأصلية للسلسلة بتنسيق BCP 47 |
target.actionPlatform |
Text | مطلوبة: المنصّات التي تمّ ربطها بأحد الخيارَين التاليَين:
urlTemplate تتيح "إجراءات على الوسائط" ما يلي:
|
target.additionalProperty |
PropertyValue | مطلوبة إذا كان ذلك منطبقًا: قائمة بأزواج السمات والقيم لتمثيل سمات إضافية للرابط المؤدّي إلى محتوى معيّن. ويمكن أن يشمل ذلك
ما يلي:
|
actionAccessibilityRequirement |
ActionAccessSpecification | مطلوبة: عنصر مواصفات الوصول إلى الإجراء الذي يصف متطلبات الوصول إلى المحتوى اطّلِع على الإجراء الوصول إلى سمات المواصفات. |
الصفحات ذات الصلة بترميز الإجراءات
يمكنك الاطّلاع على الصفحات التالية للاطّلاع على المواضيع ذات الصلة بهذه المواقع:
خصائص مواصفات الوصول إلى الإجراءات
الموقع | النوع المتوقع | الوصف |
---|---|---|
actionAccessibilityRequirement.@type |
Text | مطلوبة: يتم ضبطها دائمًا على ActionAccessSpecification . |
actionAccessibilityRequirement.category |
Text | مطلوب: شرط للوصول إلى المحتوى لمزيد من المعلومات، يُرجى الاطّلاع على نوع جدار الدفع. إذا كان الكيان يمثّل مجموعة من المحتوى، عليك ضبط
|
actionAccessibilityRequirement.availabilityStarts |
التاريخ | سمة مطلوبة: التاريخ الذي يصبح فيه الإجراء متاحًا، وهو بالتنسيق ISO 8601 (بما في ذلك المنطقة الزمنية).
يجب تقديم الكيان المقابل في الخلاصة قبل أقلّ من 7 أيّام من تاريخ بدء التوفّر. سيؤدي ذلك إلى تحسين فرص ظهور المحتوى في مساحات العرض على Google في الوقت المحدّد. |
actionAccessibilityRequirement.availabilityEnds |
التاريخ | سمة مطلوبة: التاريخ الذي لن يعود الإجراء متاحًا بعده،
بتنسيق ISO
8601 (بما في ذلك المنطقة الزمنية).
يجب إجراء أي تعديلات على تاريخ availabilityEnds في الخلاصة قبل 7 أيام على الأقل من تاريخ availabilityEnds. سيؤدي ذلك إلى زيادة فرص توقُّف ظهور المحتوى على مساحات عرض Google في تاريخ availabilityEnds. |
actionAccessibilityRequirement.eligibleRegion |
Country أو City أو State أو GeoShape أو Text | مطلوبة: المناطق التي يتوفّر فيها المحتوى استخدِم
السلسلة الخاصة EARTH إذا كان المحتوى متاحًا على مستوى العالم. |
actionAccessibilityRequirement.ineligibleRegion |
البلد أو المدينة أو الولاية أو GeoShape | سمة مطلوبة إذا كان ذلك منطبقًا: المناطق التي يتم فيها
حظر المحتوى لست بحاجة إلى تقديم هذه السمة إذا كان المحتوى
متوفّرًا في كل مكان ضمن eligibleRegion . |
actionAccessibilityRequirement.requiresSubscription |
MediaSubscription | مطلوبة إذا كان ذلك منطبقًا: تفاصيل الاشتراك التي يحتاجها المستخدمون للوصول إلى المحتوى اطّلِع على خصائص اشتراكات الوسائط.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
العرض الترويجي | مطلوبة إذا كان المحتوى يتطلّب إجراء عملية شراء: تفاصيل
العرض الترويجي المرتبط بالمحتوى قدِّم معلومات الأسعار في الحالات التالية:
Offer بالكامل وضبط category من عنصر ActionAccessSpecification على free . اطّلِع على
خصائص العرض.
|
خصائص اشتراكات الوسائط
مطلوبة إذا كان actionAccessibilityRequirement.category
هو
subscription
أو externalSubscription
.
الموقع | النوع المتوقع | الوصف |
---|---|---|
requiresSubscription.@type |
Text | مطلوب: يتم ضبطها دائمًا على MediaSubscription |
requiresSubscription.@id |
URL | مطلوبة: المعرّف الفريد للاشتراك. إذا كان بالإمكان الوصول إلى المحتوى من خلال اشتراكات مختلفة، يجب أن يكون لكل اشتراك معرّف فريد. |
requiresSubscription.name |
Text | مطلوبة: اسم الاشتراك. يُرجى مراعاة ما يلي:
|
requiresSubscription.sameAs |
URL | الصفحة التي تصف الاشتراك |
requiresSubscription.identifier |
Text | مطلوبة إذا كان category هو subscription
commonTier هو false
-
سلسلة فريدة لهذا الاشتراك تمثّل إمكانية الوصول إلى مجموعة من المحتوى في مجموعة أعمالك.
|
requiresSubscription.authenticator |
المؤسسة | مطلوبة إذا كان category هو
externalsubscription : حاوية تقدّم
تفاصيل معتمِد مقدّم الخدمة الخارجي |
requiresSubscription.authenticator.@type |
Text | مطلوبة إذا كانت قيمة category هي
externalsubscription - يجب ضبطها دائمًا على
Organization . |
requiresSubscription.authenticator.name |
Text | سمة مطلوبة إذا كانcategory هو
externalsubscription : اسم خدمة مصادقة العميل
بالنسبة إلى موفّري خدمات البث التلفزيوني على الإنترنت، اضبط القيمة على TVE. |
requiresSubscription.commonTier |
صحيح/خطأ | مطلوبة إذا كانت منطبقة: تكون هذه السمة مطلوبة إذا تم ضبط الفئة على الاشتراك. يمكنك الاطّلاع على مزيد من المعلومات عن commonTier في مستندات متطلبات المستوى الشائع. |
متطلبات واجهة برمجة التطبيقات Entitlement API
يجب أن تتوفّر واجهة برمجة تطبيقات لمنح الأذونات
إذا كان actionAccessibilityRequirement.category
هو subscription
أو
externalSubscription
وكان عرض الاشتراك يتضمّن عدة
حِزم أو فئات أو يتيح استخدام إضافات. لا تُدرِج هذه المعلومات إذا كان
اشتراكك من فئة واحدة ويمنح إمكانية الوصول إلى كل المحتوى في قائمتك.
- توفّر الشركة "أ" اشتراكًا واحدًا يمنح المشتركين إمكانية الوصول إلى كل المحتوى المتاح: لا يكون معرّف الإذن أو واجهة برمجة التطبيقات مطلوبَين.
- لدى الشركة "ب" اشتراك أساسي يتيح الوصول إلى بعض المحتوى، واشتراك مدفوع يتيح الوصول إلى محتوى مدفوع: يجب توفُّر معرّف الإذن / واجهة برمجة التطبيقات.
- لدى الشركة "ج" اشتراك أساسي يتيح الوصول إلى بعض المحتوى و حِزم إضافية تتيح الوصول إلى محتوى تابع لجهات خارجية: معرّف الإذن / واجهة برمجة التطبيقات مطلوبة
الصفحات ذات الصلة باشتراكات الوسائط
يمكنك الاطّلاع على الصفحات التالية للاطّلاع على المواضيع المتعلّقة بهذه المواقع:
سمات العرض
الموقع | النوع المتوقع | الوصف |
---|---|---|
expectsAcceptanceOf.@type |
Text | مطلوبة: يتم ضبطها دائمًا على Offer . |
expectsAcceptanceOf.price |
Number | مطلوبة: سعر شراء المحتوى. يجب أن يكون السعر قيمة موجبة غير صفرية. بالنسبة إلى الكيانات التي يكون سعرها 0.00، يُرجى تحديد الفئة على أنّها "مجاني". |
expectsAcceptanceOf.priceCurrency |
Text | مطلوبة: تمثّل هذه السمة العملة المستخدَمة للسعر بتنسيق ISO 4217 المكوّن من ثلاثة أحرف. |
expectsAcceptanceOf.seller |
المؤسسة | المؤسسة التي توفّر إمكانية شراء المحتوى |
expectsAcceptanceOf.seller.@type |
Text | يتم ضبطه دائمًا على Organization . |
expectsAcceptanceOf.seller.name |
Text | اسم البائع |
expectsAcceptanceOf.seller.sameAs |
Text | عنوان URL لصفحة ويب تحدِّد البائع، مثل الصفحة الرئيسية للبائع |
صفحة ذات صلة بالعرض
يمكنك الاطّلاع على الصفحات التالية للاطّلاع على المواضيع ذات الصلة بهذه المواقع:
المعرفات
تقبل خلاصات إجراءات الوسائط مجموعة متنوعة من المعرّفات التي يمكن أن تساعد في تحديد
العنصر بطريقة لا لبس فيها. يمكن أن تساعد هذه المعرّفات في تسريع
عملية التوفيق بين المحتوى في خلاصتك والمحتوى في قواعد بيانات Google. على الرغم من أنّه يمكن إضافة معظم هذه المعرّفات إلى الخلاصة باستخدام سمة
identifier
في أنواع الكيانات المختلفة، إلا أنّ معرّفات EIDR لها سمة
ممثّلة خاصة بها. نناقش كلاهما أدناه.
سمات المعرّفات
الموقع | النوع المتوقع | الوصف |
---|---|---|
identifier |
Text | مُستحسَن بشدة: معرّف، عادةً ما يكون خارجيًا، يحدّد كيانًا معيّنًا بوضوح. يُسمح باستخدام عدّة معرّفات. تتوفّر هذه السمة في جميع أنواع عناصر "الإجراء أثناء المشاهدة". يسرد الجدول التالي المعرّفات والسمات الفرعية المقبولة لسمة identifier . اطّلِع على مثال على المعرّف/معرّف EIDR في قسم "أمثلة على خلاصة إجراءات المشاهدة". |
الموقع | النوع المتوقع | الوصف |
---|---|---|
@type |
Text | مطلوبة: يتم ضبطها دائمًا على PropertyValue . |
propertyID |
Text | مطلوبة: نقبل أنواع مستندات التعريف التالية:
|
value |
Text | سمة مطلوبة: قيمة نظام التعريف المحدّد. |
خصائص معرّف EIDR
EIDR (اختصارًا لـ Entertainment Identifier Registry) هو نظام معرّفات فريد على مستوى العالم لمجموعة كبيرة من محتوى الوسائط، بما في ذلك الأفلام السينمائية والبرامج التلفزيونية. يحدِّد نظام التعريف معرّفًا لسجلّ بيانات وصفية مرتبط بالعناوين والتعديلات وغيرها من العناصر ذات المستوى الأعلى. يسرد الجدول التالي السمات المرتبطة بمعرّف EIDR وكيفية استخدامها.
الموقع | النوع المتوقع | الوصف |
---|---|---|
titleEIDR |
Text | مُستحسَن بشدة: يمثّل معرّف EIDR (Entertainment Identifier Registry) عملًا سينمائيًا أو تلفزيونيًا على المستوى الأكثر عمومية/تجريدًا. تتوفّر هذه السمة في صفحات مواصفات الكيانات TVSeries وTVSeason وTVEpisode وMovie. على سبيل المثال، عنوان EIDR للفيلم السينمائي المعروف باسم "Ghostbusters" هو "10.5240/7EC7-228A-510A-053E-CBB8-J". اطّلِع على مثال على المعرّف/EIDR في قسم أمثلة خلاصة Watch Actions. |
editEIDR |
Text | يُنصح بشدة باستخدام معرّف 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" في الولايات المتحدة مصحوبًا بالقيمة "MPAA R" في الحقل
Movie.contentRating
. - يجب أن يكون لسلسلة تلفزيونية مصنّفة بـ "TV-MA" في الولايات المتحدة قيمة
TVSeries.contentRating
"TV_PG TV-MA".
البلد | وكالة تقييم برامج التلفزيون | وكالة تقييم الأفلام |
---|---|---|
ألبانيا (AL) | غير متوفر | غير متوفر |
أنغولا (AO) | غير متوفر | CCE |
أنتيغوا وباربودا (AG) | غير متوفر | MPAA |
الأرجنتين (AR) | INCAA | INCAA |
أرمينيا (AM) | غير متوفر | MKRF/روسيا |
أروبا (AW) | غير متوفر | غير متوفر |
أستراليا | ACB TV | أفلام ACB |
النمسا (AT) | FSK | FSK |
أذربيجان (AZ) | غير متوفر | MKRF/روسيا |
البحرين (BH) | غير متوفر | MPAA |
بيلاروسيا (BY) | غير متوفر | MKRF/روسيا |
بلجيكا (BE) | غير متوفر | MPAA |
بليز (BZ) | غير متوفر | غير متوفر |
بنين (BJ) | غير متوفر | CNC |
بوليفيا (BO) | غير متوفر | MPAA |
البوسنة والهرسك (BA) | غير متوفر | MPAA |
بوتسوانا (BW) | غير متوفر | MPAA |
البرازيل | CLASSIND | CLASSIND |
بوركينا فاسو (BF) | غير متوفر | CNC |
كمبوديا (KH) | غير متوفر | غير متوفر |
كندا | 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 |
فرنسا | CSA | CSA |
الغابون (GA) | غير متوفر | CNC |
ألمانيا (DE) | FSK | FSK |
اليونان (GR) | ESR | GRFILM |
غواتيمالا (GT) | غير متوفر | MPAA |
هايتي (HT) | غير متوفر | غير متوفر |
هندوراس (HN) | غير متوفر | MPAA |
هونغ كونغ | CA | FCO |
المجر (HU) | غير متوفر | MPAA |
أيسلندا (IS) | غير متوفر | KIJKWIJZER |
الهند | CBFC | CBFC |
إندونيسيا (ID) | مؤشرات الأداء الرئيسية | LSF |
أيرلندا (IE) | غير متوفر | IFCO |
إيطاليا | AGCOM | AGCOM |
ساحل العاج | غير متوفر | CNC |
جامايكا (JM) | غير متوفر | MPAA |
اليابان | غير متاح | EIRIN |
الأردن (JO) | غير متوفر | MPAA |
كازاخستان (KZ) | غير متوفر | MRKF |
كوريا (KR) | KMRB | KMRB |
الكويت (KW) | غير متوفر | MPAA |
قيرغيزستان (KG) | غير متوفر | MKRF/روسيا |
لاوس (LA) | غير متوفر | غير متوفر |
لاتفيا (LV) | غير متوفر | NKCLV |
لبنان (LB) | غير متوفر | MPAA |
ليتوانيا (LT) | غير متوفر | غير متوفر |
لوكسمبورغ (LU) | غير متوفر | KIJKWIJZER |
مقدونيا (MK) | غير متوفر | MPAA |
ماليزيا (MY) | غير متوفر | FCBM |
مالي (ML) | غير متوفر | CNC |
مالطا (MT) | غير متوفر | MCCAA |
موريشيوس (MU) | غير متوفر | BBFC |
المكسيك | RTC | RTC |
مولدوفا | غير متوفر | غير متوفر |
ناميبيا (NA) | غير متوفر | غير متوفر |
نيبال (NP) | غير متوفر | MPAA |
هولندا (NL) | KIJKWIJZER | KIJKWIJZER |
نيوزيلندا | BSA | OFLC |
نيكاراغوا (NI) | غير متوفر | MPAA |
النيجر (NE) | غير متوفر | CNC |
النرويج (NO) | غير متوفر | MEDIETILSYNET |
عُمان (OM) | غير متوفر | MPAA |
بنما (PA) | غير متوفر | MPAA |
بابوا غينيا الجديدة (PG) | غير متوفر | MPAA |
باراغواي (PY) | غير متوفر | MPAA |
بيرو (PE) | غير متوفر | MPAA |
الفلبين | MTRCB | MTRCB |
بولندا (PL) | غير متوفر | MPAA |
البرتغال (PT) | غير متوفر | CCE |
قطر (QA) | غير متوفر | MPAA |
روسيا (RU) | MKRF/روسيا | MKRF/روسيا |
رواندا (RW) | غير متوفر | CNC |
المملكة العربية السعودية (SA) | غير متوفر | MPAA |
السنغال (SN) | غير متوفر | MPAA |
سنغافورة (SG) | غير متوفر | MDA |
سلوفاكيا (SK) | غير متوفر | MPAA |
سلوفينيا (SI) | غير متوفر | MPAA |
جنوب أفريقيا (ZA) | FPB | FPB |
إسبانيا | SETSI | ICAA |
سريلانكا (LK) | غير متوفر | غير متوفر |
السويد (SE) | غير متوفر | SMSA |
سويسرا (CH) | FSK | FSK |
تايوان | غير متوفر | MOCTW |
طاجيكستان (TJ) | غير متوفر | MKRF/روسيا |
تنزانيا (TZ) | غير متوفر | MPAA |
تايلاند (TH) | غير متوفر | BFVC |
توغو (TG) | غير متوفر | CNC |
ترينيداد وتوباغو (TT) | غير متوفر | غير متوفر |
تركيا (TR) | RTÜK | ECBMCT |
تركمانستان (TM) | غير متوفر | MKRF/روسيا |
أوغندا (UG) | غير متوفر | MPAA |
أوكرانيا (UA) | غير متوفر | غير متوفر |
الإمارات العربية المتحدة (AE) | غير متوفر | MPAA |
المملكة المتحدة | BBFC | BBFC |
الولايات المتحدة الأمريكية (US) | TV_PG | MPAA |
أوروغواي (UY) | غير متوفر | MPAA |
أوزبكستان (UZ) | غير متوفر | MKRF/روسيا |
فنزويلا (VE) | غير متوفر | RESORTEVIOLENCIA |
فيتنام (VN) | غير متوفر | MCST |
زامبيا (ZM) | غير متوفر | MPAA |
زيمبابوي (ZW) | غير متوفر | MPAA |
خصائص GeoShape
يحتوي عنصر GeoShape على أحد أنواع البيانات التالية:
- قائمة بالرموز البريدية (مثلاً، رموز بريدية أمريكية أو كندية أو رموز بريدية أخرى)
- قائمة بمناطق الفرز الوجهة في كندا
- رقم تعريف منطقة السوق المحدّدة (DMA): معرّف لمنطقة في الولايات المتحدة يتلقّى فيها المستخدمون القنوات والبرامج التلفزيونية نفسها.
الموقع | النوع المتوقع | الوصف |
---|---|---|
@id |
URL | مطلوبة: معرّف المنطقة الجغرافية بتنسيق معرّف الموارد المنتظم (URI) |
@type |
Text | مطلوبة: يتم ضبطها دائمًا على GeoShape . |
addressCountry |
Text | سمة مطلوبة: رمز البلد المكوّن من حرفَين وفقًا لمعيار 3166-1 alpha-2. |
postalCode |
Text | اختيارية: قائمة برموز بريدية واحدة أو أكثر و/أو رموز مناطق الفرز التلقائي (FSA) |
identifier |
PropertyValue | اختياري: رقم تعريف منطقة السوق المحدّدة (DMA)، وهو معرّف لمنطقة في الولايات المتحدة يتلقّى فيها المستخدمون القنوات التلفزيونية والبرامج نفسها. |
identifier.@type |
Text | مطلوبة: يتم ضبطها دائمًا على PropertyValue . |
identifier.propertyID |
Text | مطلوبة: يتم ضبطها دائمًا على DMA_ID . |
identifier.value |
Text | مطلوبة: رمز منطقة السوق المحدّدة للمنطقة. |
مثال على عنصر 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
يحتوي على معرّف منطقة مبيعات محددة:
{
"@type": "GeoShape",
"@id": "http://example.com/area3",
"addressCountry": "US",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "DMA_ID",
"value": "501"
}
]
}