يقدّم هذا القسم تفاصيل الخصائص الشائعة لـ "إجراءات المشاهدة".
خصائص ترميز الإجراءات
الخاصية | النوع المتوقع | الوصف |
---|---|---|
@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 (بما في ذلك المنطقة الزمنية).
ويجب إجراء أي تعديلات على تاريخ availability.end في الخلاصة قبل 7 أيام على الأقل من تاريخ availabilityEnds. سيؤدي ذلك إلى تحسين فرص إيقاف ظهور المحتوى على مساحات عرض Google في تاريخ التوفّر. |
actionAccessibilityRequirement.eligibleRegion |
البلد أو المدينة أو الولاية أو الموقع الجغرافي أو النص | مطلوبة: المناطق التي يتوفّر فيها المحتوى استخدِم السلسلة الخاصة EARTH إذا كان المحتوى متاحًا عالميًا. |
actionAccessibilityRequirement.ineligibleRegion |
البلد أو المدينة أو الولاية أو الموقع الجغرافي | مطلوبة إذا كانت منطبقة: المناطق التي يتم حظر
المحتوى فيها ولن تحتاج إلى تقديم هذه السمة إذا كان المحتوى
متاحًا في كل مكان في eligibleRegion . |
actionAccessibilityRequirement.requiresSubscription |
اشتراك الوسائط | مطلوبة إذا كانت منطبقة: تفاصيل الاشتراك الذي يحتاجه المستخدمون للوصول إلى المحتوى. راجِع سمات اشتراكات الوسائط.
|
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، يجب ضبطها على TVE. |
requiresSubscription.commonTier |
منطقي | مطلوبة إذا كانت منطبقة: تكون هذه السمة مطلوبة في حال ضبط الفئة على الاشتراك. يمكنك الاطّلاع على المزيد من المعلومات عن CommonTier في مستندات المتطلبات العامة. |
متطلبات واجهة برمجة تطبيقات التخويل
يجب توفير واجهة برمجة تطبيقات الاستحقاق إذا كان actionAccessibilityRequirement.category
هو subscription
أو
externalSubscription
وكان عرض الاشتراك يتضمّن
عدّة حِزم أو فئات أو يتضمّن دعمًا إضافيًا. لا تُدرج هذا الحقل إذا كان اشتراكك يتضمّن فئة واحدة ويتيح إمكانية الوصول إلى كل المحتوى في قائمة كتبك.
- لدى الشركة (أ) عرض اشتراك واحد يمنح المستخدمين المشتركين إمكانية الوصول إلى كل المحتوى المتوفّر: معرّف التخويل / واجهة برمجة التطبيقات ليس مطلوب.
- تمتلك الشركة "ب" اشتراكًا أساسيًا يتيح الوصول إلى بعض المحتوى ويتوفّر اشتراك مدفوع يوفّر إمكانية الوصول إلى المحتوى المميّز: معرّف التخويل / واجهة برمجة التطبيقات مطلوب
- تمتلك الشركة (ج) اشتراكًا أساسيًا يتيح الوصول إلى بعض المحتوى وتضيف حزمًا تتيح الوصول إلى محتوى تابع لجهة خارجية: معرّف التخويل / API مطلوب
الصفحات ذات الصلة باشتراك الوسائط
اطّلِع على الصفحات التالية للمواضيع ذات الصلة بهذه السمات:
خصائص العرض
الخاصية | النوع المتوقع | الوصف |
---|---|---|
expectsAcceptanceOf.@type |
Text | مطلوبة: يتم ضبطها دائمًا على Offer . |
expectsAcceptanceOf.price |
Number | مطلوبة - سعر شراء المحتوى يجب أن يكون السعر قيمة موجبة غير صفرية. بالنسبة إلى الكيانات التي يبلغ سعرها 0.00، يُرجى تحديد الفئة على أنها "مجانية". |
expectsAcceptanceOf.priceCurrency |
Text | مطلوبة: تمثّل هذه السمة العملة المستخدمة للسعر بتنسيق ISO 4217 المكوّن من 3 أحرف. |
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 (سجلّ المعرّفات الترفيهية) على المستوى العام/الجرد عمل فيلم أو برنامج تلفزيوني. تتوفّر هذه الخاصية في صفحات مواصفات الكيانات التلفزيونية في TVSeries وTVSeason وTVحلقة والأفلام. على سبيل المثال، العنوان "EIDR" للصورة المتحركة المعروفة باسم "Ghostbusters" هو "10.5240/7EC7-228A-510A-053E-CBB8-J". الاطّلاع على مثال على المعرّف:{/1 |
editEIDR |
Text | موصى بها بشدة - يمثّل معرّف EIDR (سجلّ معرّفات الترفيه) تعديلاً/إصدارًا معيّنًا لعمل فيلم أو برنامج تلفزيوني. تتوفّر هذه السمة في صفحات مواصفات كل من TVحلقة وفيلم. على سبيل المثال، الصورة الحيّة المعروفة باسم "Ghostbusters" وعنوانها EER هو 10.5240/7EC7-228A-510A-053E-CBB8-J. "S.1.5.6.1 " .5.5. .5.5. .5. .5. وهو SAR .6.1. A.6. 1.5. .5. وقد تم عرض بطاقة السيارة. |
وكالات تقييم المحتوى
استخدِم القيم الواردة في هذا الجدول لكل من BroadcastService.contentRating
وMovie.contentRating
وTVSeries.contentRating
. يجب إضافة وكالة التقييم إلى قيمة التقييم في البداية. أمثلة:
- يجب أن يتضمّن الفيلم المصنّف "R" في الولايات المتحدة القيمة
Movie.contentRating
من MPAA R. - يجب أن تكون قيمة السلسلة التلفزيونية "TV-MA" في الولايات المتحدة
TVSeries.contentRating
هي "TVPG TV-MA".
البلد | وكالة تقييم برامج تلفزيونية | وكالة تقييم أفلام |
---|---|---|
ألبانيا (AL) | البيانات غير متاحة | البيانات غير متاحة |
أنغولا (AO) | البيانات غير متاحة | CEC |
أنتيغوا وبربودا (AG) | البيانات غير متاحة | شهادة MPAA |
الأرجنتين (AR) | إنكا | إنكا |
أرمينيا (AM) | البيانات غير متاحة | MKRF/RUSSIA |
أروبا (AW) | البيانات غير متاحة | البيانات غير متاحة |
أستراليا | تلفزيون ACB | أفلام ACB |
النمسا (AT) | العمليات السابقة | العمليات السابقة |
أذربيجان (AZ) | البيانات غير متاحة | MKRF/RUSSIA |
البحرين (BH) | البيانات غير متاحة | شهادة MPAA |
بيلاروس (BY) | البيانات غير متاحة | MKRF/RUSSIA |
بلجيكا (BE) | البيانات غير متاحة | شهادة MPAA |
بليز (BZ) | البيانات غير متاحة | البيانات غير متاحة |
بنين (BJ) | البيانات غير متاحة | CNC |
بوليفيا (BO) | البيانات غير متاحة | شهادة MPAA |
البوسنة والهرسك (BA) | البيانات غير متاحة | شهادة MPAA |
بوتسوانا (BW) | البيانات غير متاحة | شهادة MPAA |
البرازيل | الفئة | الفئة |
بوركينا فاسو (BF) | البيانات غير متاحة | CNC |
كمبوديا (KH) | البيانات غير متاحة | البيانات غير متاحة |
كندا | CA_TV | كاميرات الفيديو (VRVR) |
الرأس الأخضر (CV) | البيانات غير متاحة | CEC |
تشيلي (CL) | البيانات غير متاحة | شهادة MPAA |
كولومبيا (CO) | البيانات غير متاحة | شهادة MPAA |
كوستاريكا (CR) | البيانات غير متاحة | شهادة MPAA |
كرواتيا (HR) | البيانات غير متاحة | البيانات غير متاحة |
قبرص (CY) | البيانات غير متاحة | رسوم |
تشيكيا (CZ) | البيانات غير متاحة | طريقة CZFILM |
الدانمرك (DK) | البيانات غير متاحة | مركز عملائي |
الإكوادور (EC) | البيانات غير متاحة | شهادة MPAA |
مصر (EG) | البيانات غير متاحة | شهادة MPAA |
السلفادور (SV) | البيانات غير متاحة | شهادة MPAA |
إستونيا (EE) | البيانات غير متاحة | القانون الأوروبي |
فيجي (FJ) | البيانات غير متاحة | البيانات غير متاحة |
فنلندا (FI) | البيانات غير متاحة | MEKU |
فرنسا | إعلانات CSA | إعلانات CSA |
الغابون (GA) | البيانات غير متاحة | CNC |
ألمانيا (DE) | العمليات السابقة | العمليات السابقة |
اليونان (GR) | ESR | رسوم |
غواتيمالا (GT) | البيانات غير متاحة | شهادة MPAA |
هايتي (HT) | البيانات غير متاحة | البيانات غير متاحة |
هندوراس (HN) | البيانات غير متاحة | شهادة MPAA |
هونغ كونغ | كندا | المنظمة المالية الدولية |
هنغاريا (HU) | البيانات غير متاحة | شهادة MPAA |
أيسلندا (IS) | البيانات غير متاحة | كيجويكر |
الهند | CBFC | CBFC |
إندونيسيا (ID) | مؤشرات الأداء الرئيسية | LSF |
أيرلندا (IE) | البيانات غير متاحة | اليونسكو |
إيطاليا | AGCOM | AGCOM |
ساحل العاج (CI) | البيانات غير متاحة | CNC |
جامايكا (JM) | البيانات غير متاحة | شهادة MPAA |
اليابان | لا ينطبق | إيرين |
الأردن (JO) | البيانات غير متاحة | شهادة MPAA |
كازاخستان (KZ) | البيانات غير متاحة | MRKF |
كوريا (KR) | المركز الماليزي في الهند | المركز الماليزي في الهند |
الكويت (الكويت) | البيانات غير متاحة | شهادة MPAA |
قيرغيزستان (KG) | البيانات غير متاحة | MKRF/RUSSIA |
لاوس (لويزيانا) | البيانات غير متاحة | البيانات غير متاحة |
لاتفيا (LV) | البيانات غير متاحة | قناة NKCLV |
لبنان (LB) | البيانات غير متاحة | شهادة MPAA |
ليتوانيا (LT) | البيانات غير متاحة | البيانات غير متاحة |
لوكسمبورغ (LU) | البيانات غير متاحة | كيجويكر |
مقدونيا (MK) | البيانات غير متاحة | شهادة MPAA |
ماليزيا (MY) | البيانات غير متاحة | FCBM |
مالي (ML) | البيانات غير متاحة | CNC |
مالطا (MT) | البيانات غير متاحة | مركز عملائي (AAAA) |
موريشيوس (MU) | البيانات غير متاحة | BBFC |
المكسيك | المراسلة النصية في الوقت الفعلي | المراسلة النصية في الوقت الفعلي |
مولدوفا (MD) | البيانات غير متاحة | البيانات غير متاحة |
ناميبيا (NA) | البيانات غير متاحة | البيانات غير متاحة |
نيبال (NP) | البيانات غير متاحة | شهادة MPAA |
هولندا (NL) | كيجويكر | كيجويكر |
نيوزيلندا | المملكة العربية السعودية | OFLC |
نيكاراغوا (NI) | البيانات غير متاحة | شهادة MPAA |
النيجر (نبراسكا) | البيانات غير متاحة | CNC |
النرويج (NO) | البيانات غير متاحة | المتوسط |
عُمان (OM) | البيانات غير متاحة | شهادة MPAA |
بنما (PA) | البيانات غير متاحة | شهادة MPAA |
بابوا غينيا الجديدة (PG) | البيانات غير متاحة | شهادة MPAA |
باراغواي (PY) | البيانات غير متاحة | شهادة MPAA |
بيرو (PE) | البيانات غير متاحة | شهادة MPAA |
الفلبين (PH) | محطة النقل العام (MTRCB) | محطة النقل العام (MTRCB) |
بولندا (PL) | البيانات غير متاحة | شهادة MPAA |
البرتغال (PT) | البيانات غير متاحة | CEC |
قطر (ضمان الجودة) | البيانات غير متاحة | شهادة MPAA |
روسيا (روسيا) | MKRF/RUSSIA | MKRF/RUSSIA |
رواندا (RW) | البيانات غير متاحة | CNC |
المملكة العربية السعودية | البيانات غير متاحة | شهادة MPAA |
السنغال (SN) | البيانات غير متاحة | شهادة MPAA |
سنغافورة (SG) | البيانات غير متاحة | اتفاقية مطوّري البرامج للنشر (MDA) |
سلوفاكيا (SK) | البيانات غير متاحة | شهادة MPAA |
سلوفينيا (SI) | البيانات غير متاحة | شهادة MPAA |
جنوب إفريقيا (ZA) | شهادة FPB | شهادة FPB |
إسبانيا | مدينة سيتي | ICAA |
سريلانكا (LK) | البيانات غير متاحة | البيانات غير متاحة |
السويد (SE) | البيانات غير متاحة | الرسائل القصيرة SMS |
سويسرا (CH) | العمليات السابقة | العمليات السابقة |
تايوان (TW) | البيانات غير متاحة | التصوير الحركي |
طاجيكستان (TJ) | البيانات غير متاحة | MKRF/RUSSIA |
تنزانيا (TZ) | البيانات غير متاحة | شهادة MPAA |
تايلاند (TH) | البيانات غير متاحة | هيئة السلوك المالي (BFVC) |
توغو (TG) | البيانات غير متاحة | CNC |
ترينيداد وتوباغو (TT) | البيانات غير متاحة | البيانات غير متاحة |
تركيا (TR) | نقطة الانطلاق | ECBMCT |
تركمانستان (TM) | البيانات غير متاحة | MKRF/RUSSIA |
أوغندا (UG) | البيانات غير متاحة | شهادة MPAA |
أوكرانيا (UA) | البيانات غير متاحة | البيانات غير متاحة |
الإمارات العربية المتحدة (AE) | البيانات غير متاحة | شهادة MPAA |
المملكة المتحدة | BBFC | BBFC |
الولايات المتحدة الأمريكية (US) | TV_PG | شهادة MPAA |
أورغواي (UY) | البيانات غير متاحة | شهادة MPAA |
أوزبكستان (UZ) | البيانات غير متاحة | MKRF/RUSSIA |
فنزويلا (VE) | البيانات غير متاحة | الحفاظ على البيئة |
فيتنام (VN) | البيانات غير متاحة | ضريبة المبيعات في أمريكا (MCST) |
زامبيا (ZM) | البيانات غير متاحة | شهادة MPAA |
زيمبابوي (ZW) | البيانات غير متاحة | شهادة MPAA |
خصائص الشكل الجغرافي
يحتوي كائن Geoالشكل على أحد أنواع البيانات التالية:
- قائمة بالرموز البريدية (على سبيل المثال، الولايات المتحدة أو كندا أو الرموز البريدية الأخرى)
- قائمة بمناطق الفرز الأمامي في كندا
- رقم تعريف منطقة السوق المحدّدة (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"
}
]
}