يقدّم هذا القسم تفاصيل حول الخصائص الشائعة لـ "إجراءات المشاهدة".
خصائص ترميز الإجراءات
الموقع | النوع المتوقع | الوصف |
---|---|---|
@type |
Text | مطلوب: يتم ضبطه دائمًا على WatchAction . |
target |
EntryPoint | مطلوب - كائن مستهدف تعيين عميق تؤدي إلى العديد من منصات Google. |
target.@type |
Text | مطلوب: يتم ضبطه دائمًا على EntryPoint . |
target.urlTemplate |
URL | مطلوبة - A عميق يوجّه المستخدمين إلى تطبيقك أو منصتك ويبدأ تشغيل المحتوى. |
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 (بما في ذلك المنطقة الزمنية).
يجب إجراء أي تعديلات على تاريخ انتهاء التوفّر. في الخلاصة قبل 7 أيام على الأقل من تاريخ انتهاء التوفّر. هذا النمط إلى تحسين فرص توقّف المحتوى عن الظهور على Google مساحات العرض في تاريخ انتهاء التوفّر. |
actionAccessibilityRequirement.eligibleRegion |
البلد المدينة، الولاية، GeoShape نص | مطلوب: المناطق التي يتوفّر فيها المحتوى. يمكنك استخدام
سلسلة خاصة 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 AND
commonTier هو false
-
سلسلة فريدة لهذا الاشتراك تمثّل إمكانية الوصول إلى مجموعة من المحتوى في كتالوج الوسائط.
|
requiresSubscription.authenticator |
المؤسسة | مطلوب إذا كانت قيمة category
externalsubscription - هي حاوية توفّر
تفاصيل حول مصادقة الموفر الخارجي. |
requiresSubscription.authenticator.@type |
Text | مطلوب إذا كانت قيمة category
externalsubscription - الضبط دائمًا على
Organization |
requiresSubscription.authenticator.name |
Text | مطلوب إذا كانت قيمة category
externalsubscription - اسم المصادقة
خدمة ما. بالنسبة إلى مقدّمي خدمات TVE، يجب ضبطها على TVE. |
requiresSubscription.commonTier |
منطقي | مطلوبة إن أمكن - يجب توفير هذه السمة إذا تم ضبط الفئة على اشتراكك. يمكنك الاطّلاع على مزيد من المعلومات حول SharedTier في شائع متطلبات المستوى. |
متطلبات واجهة برمجة تطبيقات الاستحقاق
إنّ واجهة برمجة تطبيقات الاستحقاق هي
مطلوبة إذا كانت قيمة actionAccessibilityRequirement.category
هي subscription
أو
externalSubscription
وعروض الاشتراك تشمل عدة خيارات
الحزم أو الفئات أو تتضمن دعمًا للإضافات. لا تقم بتضمين هذا إذا كان
ويكون الاشتراك مستوى واحد ويتيح إمكانية الوصول إلى كل المحتوى في الكتالوج الخاص بك.
- تمتلك الشركة "أ" عرض اشتراك واحدًا يمنح المستخدمين المشتركين الوصول إلى كل المحتوى المتاح: ليس معرّف الاستحقاق أو واجهة برمجة التطبيقات مطلوب تحديد خيار
- تمتلك الشركة "ب" اشتراكًا أساسيًا يوفر الوصول إلى بعض المحتوى هو اشتراك مدفوع يوفّر إمكانية الوصول إلى محتوى مدفوع: معرّف الاستحقاق / واجهة برمجة التطبيقات مطلوبان
- تمتلك الشركة "ج" اشتراكًا أساسيًا يوفر الوصول إلى بعض المحتوى إضافة حِزم توفّر إمكانية الوصول إلى محتوى تابع لجهة خارجية: معرّف الاستحقاق / واجهة برمجة التطبيقات مطلوبان
الصفحات ذات الصلة باشتراكات الوسائط
اطلع على الصفحات التالية للحصول على الموضوعات ذات الصلة بهذه الخصائص:
خصائص العرض
الموقع | النوع المتوقع | الوصف |
---|---|---|
expectsAcceptanceOf.@type |
Text | مطلوب: يتم ضبطه دائمًا على Offer . |
expectsAcceptanceOf.price |
Number | مطلوب - سعر شراء المحتوى. يجب أن يكون السعر قيمة موجبة غير صفرية. بالنسبة إلى الكيانات التي بسعر 0.00، يُرجى تحديد الفئة على أنها "مجانية". |
expectsAcceptanceOf.priceCurrency |
Text | مطلوبة - عملة السعر المكوّنة من 3 أحرف شهادة 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 (سجلّ معرّفات الترفيه) إلى الأعمال الفنية أو التلفزيونية على المستوى العام أو التجريدي. تتوفّر هذه السمة على صفحات مواصفات الكيانات، مثل TVSeries وTVSeason وTVEpisode وMovie. على سبيل المثال، titleEIDR للصورة المتحركة المعروفة باسم "Ghostbusters". هي "10.5240/7EC7-228A-510A-053E-CBB8-J". يمكنك الاطّلاع على مثال على المعرّف/معرّف EIDR في قسم أمثلة خلاصة "إجراءات المشاهدة". |
editEIDR |
Text | يُنصح به بشدة: يمثّل معرّف EIDR (سجلّ معرّفات الترفيه) تعديلاً أو إصدارًا محدّدًا لأحد الأفلام أو البرامج التلفزيونية. تتوفّر هذه السمة على صفحات مواصفات الكيان TVEpisode والأفلام. مثل الصورة الحيّة المعروفة باسم "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) | غير متوفر | غير متوفر |
أستراليا | 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 |
البرازيل | تصنيف | تصنيف |
بوركينا فاسو (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 |
ساحل العاج (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 |
النيجر (شمال شرق) | غير متوفر | 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) | غير متوفر | الرسائل القصيرة SMS |
سويسرا (CH) | FSK | FSK |
تايوان (تايوان) | غير متوفر | 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 على أحد أنواع البيانات التالية:
- قائمة بالرموز البريدية (على سبيل المثال، الولايات المتحدة أو كندا أو رموز بريدية أخرى)
- قائمة بمناطق الفرز الأمامية الكندية
- رقم تعريف منطقة السوق المحدّدة: معرّف لمنطقة في الولايات المتحدة يتلقّى الأشخاص فيها القنوات والبرامج التلفزيونية نفسها
الموقع | النوع المتوقع | الوصف |
---|---|---|
@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"
}
]
}