مشاهدة "المهام مع مساعد Google" الخصائص المشتركة

يوفّر هذا القسم تفاصيل السمات الشائعة لإجراءات المشاهدة.

خصائص ترميز الإجراءات

الموقع النوع المتوقع الوصف
@type Text مطلوبة: يتم ضبطها دائمًا على WatchAction.
target EntryPoint سمة مطلوبة: عنصر مستهدَف يقدّم ربطًا بين الروابط العميقة ومنصّات Google المختلفة
target.@type Text مطلوبة: يتم ضبطها دائمًا على EntryPoint.
target.urlTemplate URL مطلوبة: رابط لصفحة في التطبيق ينقل المستخدمين إلى تطبيقك أو منصتك ويبدأ تشغيل المحتوى
target.inLanguage Text اختياري: اللغة الأصلية للسلسلة بتنسيق BCP 47
target.actionPlatform Text مطلوبة: المنصّات التي تمّ ربطها بأحد الخيارَين التاليَين: urlTemplate تتيح "إجراءات على الوسائط" ما يلي:
  • http://schema.org/DesktopWebPlatform: منصة البحث على متصفّحات الويب المكتبية
  • http://schema.org/MobileWebPlatform: منصّة البحث على متصفّحات الويب المتوافقة مع الأجهزة الجوّالة
  • http://schema.org/AndroidPlatform: منصّتا Search وPlayGuide في تطبيق Android
  • ‫http://schema.org/AndroidTVPlatform: نظام Android TV الأساسي على تطبيق Android TV
  • http://schema.org/IOSPlatform: منصّة البحث على تطبيق iOS
  • http://schema.googleapis.com/GoogleVideoCast: بث المحتوى و تشغيل المحتوى على منصات Home على جهاز Chromecast
  • http://schema.googleapis.com/GoogleAudioCast: أجهزة البث و منصات Home على جهاز Chromecast (إجراءات الاستماع فقط)
يُرجى الاطّلاع على قسم أنواع الأنظمة الأساسية لمعرفة المتطلبات.
target.additionalProperty PropertyValue مطلوبة إذا كان ذلك منطبقًا: قائمة بأزواج السمات والقيم لتمثيل سمات إضافية للرابط المؤدّي إلى محتوى معيّن. ويمكن أن يشمل ذلك ما يلي:
  • ‫contentLanguage: لغة البث (الدبلجة)، بتنسيق BCP 47 إذا كان المحتوى مدبلجًا بلغة مختلفة، يجب إدخال هذه السمة. استخدِم صفيفًا لرموز لغات متعددة.
  • subtitleLanguage: لغات الترجمة والشرح بتنسيق BCP 47 استخدِم صفيفًا لرموز لغات متعددة.
  • cameraAngle: زاوية الكاميرا للمحتوى، مثلاً "مستوى العين" و "زاوية عالية" إذا كان المحتوى متوفّرًا من زوايا كاميرا مختلفة، تكون هذه السمة مطلوبة. استخدِم صفيفًا لتحديد زوايا كاميرا متعددة.
  • videoFormat: تنسيق الملف المستخدَم لتخزين بيانات الفيديو الرقمي، على سبيل المثال، "SD" للدقة العادية و "HD" للدقة العالية تشمل تنسيقات الفيديو الصالحة الدقة العادية والدقة العالية ودقة 2K و4K و8K. استخدِم صفيفًا لتنسيقات الفيديو المتعددة.
  • ‫audioDescription: صفيف من ملفّات الترجمة والشرح المتاحة بتنسيق BCP 47 والتي تتيح الوصف الصوتي هذه مجموعة فرعية من صفيف contentLanguage.
يمكنك الاطّلاع على مثال على additionalProperty.
actionAccessibilityRequirement ActionAccessSpecification مطلوبة: عنصر مواصفات الوصول إلى الإجراء الذي يصف متطلبات الوصول إلى المحتوى اطّلِع على الإجراء الوصول إلى سمات المواصفات.

يمكنك الاطّلاع على الصفحات التالية للاطّلاع على المواضيع المتعلّقة بهذه المواقع:

خصائص مواصفات الوصول إلى الإجراءات

الموقع النوع المتوقع الوصف
actionAccessibilityRequirement.@type Text مطلوبة: يتم ضبطها دائمًا على ActionAccessSpecification.
actionAccessibilityRequirement.category Text

مطلوب: شرط للوصول إلى المحتوى لمزيد من المعلومات، يُرجى الاطّلاع على نوع جدار الدفع.

إذا كان الكيان يمثّل مجموعة من المحتوى، عليك ضبط category على أقل متطلبات وصول تقييدية ل المحتوى. على سبيل المثال، إذا كان TVSeries يتضمّن بعضًا TVEpisode من المحتوى الذي تم ضبطه على nologinrequired وبعض المحتوى الذي تم ضبطه على subscription، اضبط TVSeries على nologinrequired.
actionAccessibilityRequirement.availabilityStarts التاريخ

سمة مطلوبة: التاريخ الذي يصبح فيه الإجراء متاحًا، وهو بالتنسيق ISO 8601 (بما في ذلك المنطقة الزمنية).

  • يمكن تحديد تاريخ في المستقبل.

يجب تقديم الكيان المقابل في الخلاصة قبل أقلّ من 7 أيّام من تاريخ بدء التوفّر. سيؤدي ذلك إلى تحسين فرص ظهور المحتوى في مساحات العرض على Google في الوقت المحدّد.

actionAccessibilityRequirement.availabilityEnds التاريخ سمة مطلوبة: التاريخ الذي لن يعود الإجراء متاحًا بعده، بتنسيق ISO 8601 (بما في ذلك المنطقة الزمنية).
  • يجب أن تكون مساوية أو أكبر من 72 ساعة بعد availabilityStarts.
  • إذا كان المحتوى متاحًا دائمًا بعد نشره، اضبط هذا التاريخ على 20 عامًا من التاريخ الحالي.

يجب إجراء أي تعديلات على تاريخ availabilityEnds في الخلاصة قبل 7 أيام على الأقل من تاريخ availabilityEnds. سيؤدي ذلك إلى زيادة فرص توقُّف ظهور المحتوى على مساحات عرض Google في تاريخ availabilityEnds.

actionAccessibilityRequirement.eligibleRegion Country أو City أو State أو GeoShape أو Text مطلوبة: المناطق التي يتوفّر فيها المحتوى استخدِم السلسلة الخاصة EARTH إذا كان المحتوى متاحًا على مستوى العالم.
actionAccessibilityRequirement.ineligibleRegion البلد أو المدينة أو الولاية أو GeoShape سمة مطلوبة إذا كان ذلك منطبقًا: المناطق التي يتم فيها حظر المحتوى لست بحاجة إلى تقديم هذه السمة إذا كان المحتوى متوفّرًا في كل مكان ضمن eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

مطلوبة إذا كان ذلك منطبقًا: تفاصيل الاشتراك التي يحتاجها المستخدمون للوصول إلى المحتوى اطّلِع على خصائص اشتراكات الوسائط.

  • قدِّم هذه السمة إذا كانت قيمة category هي subscription أو externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf العرض الترويجي مطلوبة إذا كان المحتوى يتطلّب إجراء عملية شراء: تفاصيل العرض الترويجي المرتبط بالمحتوى قدِّم معلومات الأسعار في الحالات التالية:
  • المحتوى الذي يتم شراؤه لمرة واحدة (rental أو purchase)
  • المحتوى المستند إلى الاشتراك الذي يتطلّب إجراء عملية شراء إضافية من المشتركين (subscription أو externalsubscription)
إذا كان السعر 0.00، عليك إزالة العنصر Offer بالكامل وضبط category من العنصر ActionAccessSpecification على free. اطّلِع على خصائص العرض.

خصائص اشتراكات الوسائط

مطلوبة إذا كان actionAccessibilityRequirement.category هو subscription أو externalSubscription.

الموقع النوع المتوقع الوصف
requiresSubscription.@type Text مطلوب: يتم ضبطها دائمًا على MediaSubscription
requiresSubscription.@id URL مطلوبة: المعرّف الفريد للاشتراك. إذا كان بالإمكان الوصول إلى المحتوى من خلال اشتراكات مختلفة، يجب أن يكون لكل اشتراك معرّف فريد.
requiresSubscription.name Text مطلوبة: اسم الاشتراك. يُرجى مراعاة ما يلي:
  • إذا كان بالإمكان الوصول إلى المحتوى من خلال اشتراكات مختلفة، يجب أن يتطابق هذا الاسم مع الاسم الوارد في نظام مصادقة المستخدمين. على سبيل المثال، إذا كان بإمكان المستخدم الوصول إلى المحتوى استنادًا إلى الاشتراك المُسمى الحزمة 1، ولكنّ نظام المصادقة يستخدم الاسم PKG1a، استخدِم PKG1.
  • بالنسبة إلى مقدّمي خدمات البث التلفزيوني على الإنترنت، هذا هو اسم معرّف الهوية المسجَّل في معرّف هوية مقدّم خدمات البث التلفزيوني على الإنترنت. وهي سلسلة تحدّد بشكل فريد اسم الخدمة باستخدام معرّف TVE Authenticator.
requiresSubscription.sameAs URL الصفحة التي تصف الاشتراك
requiresSubscription.identifier Text مطلوبة إذا كان category هو subscription commonTier هو false - سلسلة فريدة لهذا الاشتراك تمثّل إمكانية الوصول إلى مجموعة من المحتوى في مجموعة أعمالك.
  • تنصح Google باستخدام البنية التالية للمعرّف:
    اسم النطاق + فاصلة (:) + مستوى الوصول إلى المحتوى، على سبيل المثال : example.com:basic، example.com:premium، example.com:sports
  • ستكون هذه السمة مطابقة لسمة معرّف الإذن إذا كنت تقدّم واجهة برمجة تطبيقات للإذن.
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 مطلوبة: نقبل أنواع مستندات التعريف التالية:
  • TMS_ROOT_ID: معرّف الجذر في Gracenote‏ (TMS) (على سبيل المثال، 15829).
    • . لا ينطبق ذلك على الكيانات Organization و BroadcastService حيث يجب استخدام TMS_ID فقط.
  • TMS_ID: رقم تعريف الصيغة في Gracenote‏ (TMS) (على سبيل المثال، MV000398520000).
  • WIKIDATA_ID: رقم تعريف WikiData (على سبيل المثال، Q134773).
  • IMDB_ID: رقم تعريف IMDB (على سبيل المثال، tt0109830).
  • ‫OPTA_ID: رقم تعريف OPTA Sports
  • STATS_ID: رقم تعريف الأداء في STATS
  • VIP_TIMES_ID: رقم تعريف VIPTimes (Nihon Tarento Meikan) للفنانين اليابانيين في اليابان.
  • DMA_ID: رمز المنطقة التسويقية المحدّدة في الولايات المتحدة، المستخدَم في كائن GeoShape
  • _PARTNER_ID_: يجب أن تحتوي هذه السمة على السلسلة "‎_PARTNER_ID_"، ويجب أن تكون القيمة معرّفًا فريدًا يستخدمه مقدّم الخدمة، داخليًا أو خارجيًا، لتحديد الكيان (على سبيل المثال، 12345 أو a5c604e2-e9e5-4ff3-b728-245799dc37f1).
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 Movies
النمسا (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 على أحد أنواع البيانات التالية:

الموقع النوع المتوقع الوصف
@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"
    }
  ]
}