يقدّم هذا القسم تفاصيل حول الخصائص المشتركة لـ Watch Actions.
خصائص ترميز الإجراءات
الموقع | النوع المتوقع | الوصف |
---|---|---|
@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 أيام على الأقل من تاريخ availabilityStarts. سيؤدي ذلك إلى زيادة فرص ظهور المحتوى على مساحات عرض 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.additionalProperty |
PropertyValue | مطلوب إذا كان ذلك منطبقًا: مرجع إلى حزمة الاشتراك التي سيتم عرضها في التجربة. |
actionAccessibilityRequirement.additionalProperty.name |
Text | مطلوب: يجب ضبطه دائمًا على "DisplaySubscriptionIdentifier" |
actionAccessibilityRequirement.additionalProperty.value |
Text | مطلوب: requiresSubscription.@id الذي سيتم عرضه للكيان.
|
سمات الاشتراك في الوسائط
هذه السمة مطلوبة إذا كانت قيمة 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، اضبط القيمة على TVE. |
requiresSubscription.commonTier |
Boolean | مطلوبة إذا كانت منطبقة: تكون هذه السمة مطلوبة إذا تم ضبط الفئة على "اشتراك". يمكنك الاطّلاع على مزيد من المعلومات حول commonTier في مستندات متطلبات الفئة العامة. |
متطلبات Entitlement API
واجهة برمجة تطبيقات تحديد الأهلية مطلوبة إذا كانت قيمة actionAccessibilityRequirement.category
هي subscription
أو externalSubscription
وكان عرض الاشتراك يتضمّن حِزمًا أو فئات متعدّدة أو يتيح استخدام الإضافات. لا تُدرِج هذه المعلومات إذا كانت اشتراكاتك ذات مستوى واحد وتتيح الوصول إلى كل المحتوى في قائمتك.
- تقدّم الشركة (أ) اشتراكًا واحدًا يتيح للمستخدمين المشتركين الوصول إلى كل المحتوى المتاح، وبالتالي لا يلزم توفير معرّف الأهلية أو واجهة برمجة التطبيقات.
- تقدّم الشركة "ب" اشتراكًا أساسيًا يتيح الوصول إلى بعض المحتوى واشتراكًا مميّزًا يتيح الوصول إلى المحتوى المميّز: معرّف الأهلية / واجهة برمجة التطبيقات مطلوبة
- لدى الشركة "ج" اشتراك أساسي يتيح الوصول إلى بعض المحتوى، بالإضافة إلى حِزم تتيح الوصول إلى محتوى تابع لجهات خارجية: معرّف الأهلية / واجهة برمجة التطبيقات مطلوبة
صفحات ذات صلة باشتراكات الوسائط
يمكنك الاطّلاع على الصفحات التالية لمعرفة المواضيع ذات الصلة بهذه المواقع:
سمات العرض
الموقع | النوع المتوقع | الوصف |
---|---|---|
expectsAcceptanceOf.@type |
Text | مطلوبة - يجب ضبطها دائمًا على Offer . |
expectsAcceptanceOf.price |
Number | مطلوبة: تشير إلى سعر شراء المحتوى. يجب أن يكون السعر قيمة موجبة غير صفرية. بالنسبة إلى الكيانات التي يبلغ سعرها 0.00، يُرجى تحديد الفئة على أنّها `free`. |
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 (اختصار لـ The Entertainment Identifier Registry) هو نظام معرّف فريد عالميًا لمجموعة كبيرة من محتوى الوسائط، بما في ذلك الأفلام السينمائية والبرامج التلفزيونية. يحلّ نظام التعريف معرّفًا إلى سجلّ بيانات وصفية مرتبط بعناوين المستوى الأعلى والتعديلات وغير ذلك. يسرد الجدول التالي السمات المرتبطة بمعرّف EIDR وكيفية استخدامها.
الموقع | النوع المتوقع | الوصف |
---|---|---|
titleEIDR |
Text | يُنصح به بشدة: يمثّل معرّف EIDR (Entertainment Identifier Registry) على المستوى العام/المجرّد، عملاً سينمائيًا أو تلفزيونيًا. تتوفّر هذه السمة في صفحات مواصفات الكيانات TVSeries وTVSeason وTVEpisode وMovie. على سبيل المثال، المعرّف titleEIDR للفيلم المعروف باسم "Ghostbusters" هو "10.5240/7EC7-228A-510A-053E-CBB8-J". راجِع مثال على المعرّف/EIDR في قسم أمثلة خلاصات "إجراءات المشاهدة". |
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
. يجب أن تسبق وكالة التقييم قيمة التقييم. أمثلة:
- يجب أن تكون قيمة
Movie.contentRating
لفيلم مصنّف "R" في الولايات المتحدة هي "MPAA R". - يجب أن تكون قيمة
TVSeries.contentRating
لمسلسل تلفزيوني مصنّف ضمن الفئة "TV-MA" في الولايات المتحدة هي "TV_PG TV-MA".
البلد | وكالة تقييم تلفزيوني | جهة تقييم الأفلام |
---|---|---|
ألبانيا (AL) | غير متوفر | غير متوفر |
أنغولا (AO) | غير متوفر | CCE |
أنتيغوا وبربودا (AG) | غير متوفر | MPAA |
الأرجنتين (AR) | INCAA | INCAA |
أرمينيا (AM) | غير متوفر | MKRF/RUSSIA |
أروبا (AW) | غير متوفر | غير متوفر |
أستراليا | 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 |
البرازيل | 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 |
هونغ كونغ | كندا | FCO |
المجر (HU) | غير متوفر | MPAA |
أيسلندا (IS) | غير متوفر | KIJKWIJZER |
الهند | CBFC | CBFC |
إندونيسيا (ID) | مؤشرات الأداء الرئيسية | LSF |
أيرلندا (IE) | غير متوفر | IFCO |
إيطاليا | AGCOM | AGCOM |
ساحل العاج (CI) | غير متوفر | CNC |
جامايكا (JM) | غير متوفر | MPAA |
اليابان | غير متاح | 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 |
المكسيك | RTC | RTC |
مولدوفا (MD) | غير متوفر | غير متوفر |
ناميبيا (NA) | غير متوفر | غير متوفر |
نيبال (NP) | غير متوفر | MPAA |
هولندا (NL) | KIJKWIJZER | KIJKWIJZER |
نيوزيلندا | 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 |
إسبانيا | 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 |
المملكة المتحدة | BBFC | BBFC |
الولايات المتحدة الأمريكية (US) | TV_PG | MPAA |
أوروغواي (UY) | غير متوفر | MPAA |
أوزبكستان (UZ) | غير متوفر | MKRF/RUSSIA |
فنزويلا (VE) | غير متوفر | RESORTEVIOLENCIA |
فيتنام (VN) | غير متوفر | MCST |
زامبيا (ZM) | غير متوفر | MPAA |
زيمبابوي (ZW) | غير متوفر | MPAA |
سمات GeoShape
يحتوي عنصر GeoShape على أحد أنواع البيانات التالية:
- قائمة بالرموز البريدية (مثلاً، رموز ZIP الأمريكية أو الكندية أو غيرها)
- قائمة بمناطق الفرز المسبق الكندية
- رقم تعريف منطقة السوق المحدّدة (DMA): هو معرّف لمنطقة في الولايات المتحدة يتلقّى فيها المستخدمون قنوات وبرامج تلفزيونية نفسها.
الموقع | النوع المتوقع | الوصف |
---|---|---|
@id |
URL | مطلوب: معرّف المنطقة الجغرافية بتنسيق URI. |
@type |
Text | مطلوبة - يجب ضبطها دائمًا على GeoShape . |
addressCountry |
Text | مطلوبة - تمثّل هذه السمة رمز البلد المكوّن من حرفَين حسب المعيار ISO 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"
}
]
}