این بخش جزئیات ویژگیهای رایج Watch Actions را ارائه میدهد.
ویژگیهای نشانهگذاری اکشن
| ملک | نوع مورد انتظار | توضیحات |
|---|---|---|
@type | متن | الزامی - همیشه روی WatchAction تنظیم شود. |
target | نقطه ورود | الزامی - یک شیء هدف که نگاشت لینکهای عمیق به پلتفرمهای مختلف گوگل را فراهم میکند. |
target.@type | متن | الزامی - همیشه روی EntryPoint تنظیم شود. |
target.urlTemplate | آدرس اینترنتی | الزامی - یک لینک عمیق که کاربران را به برنامه یا پلتفرم شما هدایت میکند و پخش محتوا را آغاز میکند. |
target.inLanguage | متن | اکیداً توصیه میشود - زبان اصلی محتوا در قالب BCP 47 . |
target.actionPlatform | متن | الزامی - پلتفرمهایی که به urlTemplate نگاشت شدهاند. اقدامات رسانهای از موارد زیر پشتیبانی میکنند:
|
target.additionalProperty | ارزش ملک | در صورت لزوم - فهرستی از جفتهای ویژگی-مقدار برای نمایش ویژگیهای اضافی پیوند عمیق. این میتواند شامل موارد زیر باشد:
|
actionAccessibilityRequirement | مشخصات دسترسی به اکشن | الزامی - یک شیء مشخصات دسترسی به اکشن که الزامات دسترسی به محتوا را توصیف میکند. به ویژگیهای مشخصات دسترسی به اکشن مراجعه کنید. |
صفحات مرتبط با نشانهگذاری اکشن
برای مباحث مربوط به این املاک، صفحات زیر را بررسی کنید:
ویژگیهای مشخصات دسترسی به اکشن
| ملک | نوع مورد انتظار | توضیحات |
|---|---|---|
actionAccessibilityRequirement.@type | متن | الزامی - همیشه روی ActionAccessSpecification تنظیم شود. |
actionAccessibilityRequirement.category | متن | الزامی - الزام دسترسی به محتوا. برای اطلاعات بیشتر، به نوع Paywall مراجعه کنید. اگر یک موجودیت، گروهی از محتوا را نشان میدهد، باید |
actionAccessibilityRequirement.availabilityStarts | تاریخ | الزامی - تاریخی که پس از آن اقدام در قالب ISO 8601 (شامل منطقه زمانی) در دسترس است.
لازم است که موجودیت مربوطه حداقل ۷ روز قبل از تاریخ شروع در دسترس بودن، در فید ارائه شود. این کار شانس نمایش به موقع محتوا در سطوح گوگل را افزایش میدهد. |
actionAccessibilityRequirement.availabilityEnds | تاریخ | الزامی - تاریخی که پس از آن اقدام دیگر در دسترس نیست، با فرمت ISO 8601 (شامل منطقه زمانی).
لازم است هرگونه بهروزرسانی در تاریخ پایان دسترسی، حداقل ۷ روز قبل از تاریخ پایان دسترسی در فید انجام شود. این کار احتمال عدم نمایش محتوا در سطوح گوگل در تاریخ پایان دسترسی را افزایش میدهد. |
actionAccessibilityRequirement.eligibleRegion | کشور ، شهر ، استان ، شکل جغرافیایی یا متن | الزامی - مناطقی که محتوا در آنها موجود است. اگر محتوا به صورت جهانی در دسترس است، از رشته ویژه EARTH استفاده کنید. |
actionAccessibilityRequirement.ineligibleRegion | کشور ، شهر ، ایالت یا شکل جغرافیایی | در صورت لزوم - مناطقی که محتوا در آنها محدود شده است. اگر محتوا در همه جای eligibleRegion در دسترس باشد، نیازی به ارائه این ویژگی نیست. |
actionAccessibilityRequirement.requiresSubscription | اشتراک رسانهای | در صورت لزوم - جزئیات اشتراکی که کاربران برای دسترسی به محتوا به آن نیاز دارند. به ویژگیهای اشتراک رسانه مراجعه کنید.
|
actionAccessibilityRequirement.expectsAcceptanceOf | پیشنهاد | در صورتی که محتوا نیاز به خرید داشته باشد، الزامی است - جزئیات پیشنهاد مرتبط با محتوا. اطلاعات قیمت را برای موارد زیر ارائه دهید:
Offer را به طور کامل حذف کرده و category شیء ActionAccessSpecification را روی free تنظیم کنید. به ویژگیهای Offer مراجعه کنید. |
actionAccessibilityRequirement.additionalProperty | ارزش ملک | در صورت لزوم - ارجاع به بسته اشتراک که در تجربه نمایش داده خواهد شد. |
actionAccessibilityRequirement.additionalProperty.name | متن | الزامی - همیشه روی "DisplaySubscriptionIdentifier" تنظیم شود |
actionAccessibilityRequirement.additionalProperty.value | متن | الزامی - requiresSubscription.@id که برای موجودیت نمایش داده خواهد شد. |
ویژگیهای اشتراک رسانهای
اگر actionAccessibilityRequirement.category subscription یا externalSubscription باشد، الزامی است.
| ملک | نوع مورد انتظار | توضیحات |
|---|---|---|
requiresSubscription.@type | متن | الزامی - همیشه روی MediaSubscription تنظیم شود |
requiresSubscription.@id | آدرس اینترنتی | الزامی - شناسه منحصر به فرد برای اشتراک. اگر محتوا از طریق اشتراکهای مختلف قابل دسترسی باشد، هر اشتراک باید یک شناسه منحصر به فرد داشته باشد. |
requiresSubscription.name | متن | الزامی - نام اشتراک. به موارد زیر توجه کنید:
|
requiresSubscription.sameAs | آدرس اینترنتی | صفحهای که اشتراک را شرح میدهد. |
requiresSubscription.identifier | متن | اگر category subscription و commonTier false باشد، الزامی است . - یک رشتهی منحصر به فرد برای این subscription که نشاندهندهی دسترسی به گروهی از محتوا در کاتالوگ رسانهی شما است.
|
requiresSubscription.authenticator | سازمان | اگر category externalsubscription باشد، الزامی است - محفظهای که جزئیات احراز هویت ارائه دهنده خارجی را ارائه میدهد. |
requiresSubscription.authenticator.@type | متن | اگر category externalsubscription باشد، الزامی است - همیشه روی Organization تنظیم شود. |
requiresSubscription.authenticator.name | متن | اگر category externalsubscription باشد، الزامی است - نام سرویس احراز هویت. برای ارائه دهندگان TVE، آن را روی TVE تنظیم کنید. |
requiresSubscription.commonTier | بولی | در صورت لزوم - در صورتی که دسته بندی روی اشتراک تنظیم شده باشد، این مورد الزامی است. برای اطلاعات بیشتر در مورد commonTier به مستندات الزامات لایه مشترک مراجعه کنید. |
الزامات API مربوط به حق امتیاز
اگر actionAccessibilityRequirement.category subscription یا externalSubscription باشد و اشتراک شما شامل چندین بسته یا سطح باشد یا از افزونهها پشتیبانی کند، به یک API مربوط به اعطای حق دسترسی نیاز است. اگر اشتراک شما یک سطح است و به همه محتوای کاتالوگ شما دسترسی میدهد، این API را اضافه نکنید.
- شرکت الف یک پیشنهاد اشتراک واحد دارد که به کاربران مشترک امکان دسترسی به تمام محتوای موجود را میدهد: شناسه حق امتیاز / API لازم نیست
- شرکت B یک اشتراک پایه دارد که دسترسی به برخی محتوا را فراهم میکند و یک اشتراک ویژه که دسترسی به محتوای ویژه را فراهم میکند: شناسه حق امتیاز / API مورد نیاز است.
- شرکت C یک اشتراک پایه دارد که دسترسی به برخی محتوا و بستههای الحاقی را فراهم میکند که دسترسی به محتوای شخص ثالث را فراهم میکند: شناسه حق امتیاز / API مورد نیاز است.
صفحات مرتبط با اشتراک رسانهای
برای مباحث مربوط به این املاک، صفحات زیر را بررسی کنید:
پیشنهاد املاک
| ملک | نوع مورد انتظار | توضیحات |
|---|---|---|
expectsAcceptanceOf.@type | متن | الزامی - همیشه روی Offer تنظیم شود. |
expectsAcceptanceOf.price | شماره | الزامی - قیمت خرید محتوا. قیمت باید یک مقدار مثبت غیر صفر باشد. برای موجودیتهایی با قیمت ۰.۰۰، لطفاً دستهبندی را «رایگان» مشخص کنید. |
expectsAcceptanceOf.priceCurrency | متن | الزامی - واحد پول قیمت با فرمت سه حرفی ISO 4217 . |
expectsAcceptanceOf.seller | سازمان | سازمانی که خرید محتوا را ارائه میدهد. |
expectsAcceptanceOf.seller.@type | متن | همیشه روی Organization تنظیم شود. |
expectsAcceptanceOf.seller.name | متن | نام فروشنده. |
expectsAcceptanceOf.seller.sameAs | متن | آدرس اینترنتی (URL) یک صفحه وب که فروشنده را مشخص میکند؛ برای مثال، صفحه اصلی فروشنده. |
صفحه مرتبط با پیشنهاد
برای مباحث مربوط به این املاک، صفحات زیر را بررسی کنید:
شناسهها
فیدهای اقدام رسانهای، شناسههای متنوعی را میپذیرند که میتوانند به شناسایی یک موجودیت به شیوهای بدون ابهام کمک کنند. این شناسهها میتوانند به تسریع روند تطبیق محتوای فید شما با محتوای پایگاههای داده گوگل کمک کنند. در حالی که اکثر این شناسهها را میتوان با استفاده از ویژگی identifier در انواع مختلف موجودیت به فید اضافه کرد، EIDRها ویژگی نماینده خود را دارند. هر دوی این موارد در زیر مورد بحث قرار گرفتهاند.
ویژگیهای شناسه
| ملک | نوع مورد انتظار | توضیحات |
|---|---|---|
identifier | متن | اکیداً توصیه میشود - شناسهای، معمولاً خارجی، که به طور واضح یک موجودیت مشخص را شناسایی میکند. استفاده از چندین شناسه مجاز است. این ویژگی در همه انواع موجودیت Watch Action موجود است. جدول زیر شناسههای پذیرفتهشده و زیرویژگیهای ویژگی identifier را فهرست میکند. به مثال شناسه/EIDR در بخش مثالهای فید اقدامات دیدهبانی مراجعه کنید. |
| ملک | نوع مورد انتظار | توضیحات |
|---|---|---|
@type | متن | الزامی - همیشه روی PropertyValue تنظیم شود. |
propertyID | متن | الزامی - ما از انواع شناسههای زیر پشتیبانی میکنیم:
|
value | متن | الزامی - مقدار برای سیستم شناسایی مشخص شده. |
خواص EIDR
EIDR (مخفف عبارت The Entertainment Identifier Registry)، یک سیستم شناسه منحصر به فرد جهانی برای طیف وسیعی از محتوای رسانهای، از جمله فیلمهای سینمایی و برنامههای تلویزیونی است. این سیستم شناسایی، یک شناسه را به یک رکورد فراداده تبدیل میکند که با عناوین سطح بالا، ویرایشها و موارد دیگر مرتبط است. جدول زیر ویژگیهای مرتبط با EIDR و کاربرد آنها را فهرست میکند.
| ملک | نوع مورد انتظار | توضیحات |
|---|---|---|
titleEIDR | متن | اکیداً توصیه میشود - شناسه EIDR (ثبت شناسه سرگرمی) در کلیترین/انتزاعیترین سطح، نشاندهنده یک اثر سینمایی یا تلویزیونی است. این ویژگی در صفحات مشخصات موجودیت TVSeries ، TVSeason ، TVEpisode و Movie موجود است. برای مثال، عنوان EIDR برای فیلم سینمایی «شکارچیان ارواح» به صورت «10.5240/7EC7-228A-510A-053E-CBB8-J» است. به مثال شناسه/EIDR در بخش مثالهای فید Watch Actions مراجعه کنید. |
editEIDR | متن | اکیداً توصیه میشود - شناسه EIDR (ثبت شناسه سرگرمی) نشاندهنده یک ویرایش/نسخه خاص برای یک اثر سینمایی یا تلویزیونی است. این ویژگی در صفحات مشخصات موجودیت TVEpisode و Movie موجود است. برای مثال، فیلم سینمایی معروف به «شکارچیان ارواح» که عنوان 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 در بخش مثالهای فید Watch Actions مراجعه کنید. |
آژانسهای رتبهبندی محتوا
از مقادیر موجود در این جدول برای BroadcastService.contentRating ، Movie.contentRating و TVSeries.contentRating استفاده کنید. آژانس رتبهبندی باید به مقدار رتبهبندی اضافه شود. مثالها:
- فیلمی که در ایالات متحده دارای رتبه "R" است، باید ارزش
Movie.contentRatingآن "MPAA R" باشد. - یک سریال تلویزیونی که در ایالات متحده رتبهبندی «TV-MA» دارد، باید مقدار
TVSeries.contentRatingآن «TV_PG TV-MA» باشد.
| کشور | آژانس رتبهبندی تلویزیون | موسسه رتبهبندی فیلمها |
|---|---|---|
| آلبانی (AL) | موجود نیست | موجود نیست |
| آنگولا (AO) | موجود نیست | سی سی ای |
| آنتیگوا و باربودا (AG) | موجود نیست | MPAA |
| آرژانتین (AR) | اینکا | اینکا |
| ارمنستان (AM) | موجود نیست | MKRF/روسیه |
| آروبا (AW) | موجود نیست | موجود نیست |
| استرالیا (AU) | تلویزیون ACB | فیلمهای ACB |
| اتریش (AT) | اف اس کی | اف اس کی |
| آذربایجان (AZ) | موجود نیست | MKRF/روسیه |
| بحرین (BH) | موجود نیست | MPAA |
| بلاروس (BY) | موجود نیست | MKRF/روسیه |
| بلژیک (BE) | موجود نیست | MPAA |
| بلیز (BZ) | موجود نیست | موجود نیست |
| بنین (BJ) | موجود نیست | سی ان سی |
| بولیوی (BO) | موجود نیست | MPAA |
| بوسنی و هرزگوین (BA) | موجود نیست | MPAA |
| بوتسوانا (BW) | موجود نیست | MPAA |
| برزیل (BR) | کلاسیند | کلاسیند |
| بورکینافاسو (BF) | موجود نیست | سی ان سی |
| کامبوج (KH) | موجود نیست | موجود نیست |
| کانادا (کالیفرنیا) | تلویزیون کالیفرنیا | CHVRS |
| کیپ ورد (CV) | موجود نیست | سی سی ای |
| شیلی (CL) | موجود نیست | MPAA |
| کلمبیا (CO) | موجود نیست | MPAA |
| کاستاریکا (CR) | موجود نیست | MPAA |
| کرواسی (HR) | موجود نیست | موجود نیست |
| قبرس (CY) | موجود نیست | جی آر فیلم |
| جمهوری چک (CZ) | موجود نیست | سیزیفیلم |
| دانمارک (DK) | موجود نیست | ام سی وای پی |
| اکوادور (EC) | موجود نیست | MPAA |
| مصر (EG) | موجود نیست | MPAA |
| السالوادور (SV) | موجود نیست | MPAA |
| استونی (EE) | موجود نیست | ایفیلم |
| فیجی (FJ) | موجود نیست | موجود نیست |
| فنلاند (FI) | موجود نیست | مکو |
| فرانسه (FR) | سی اس ای | سی اس ای |
| گابن (GA) | موجود نیست | سی ان سی |
| آلمان (DE) | اف اس کی | اف اس کی |
| یونان (GR) | رسوب ... | جی آر فیلم |
| گواتمالا (GT) | موجود نیست | MPAA |
| هائیتی (HT) | موجود نیست | موجود نیست |
| هندوراس (HN) | موجود نیست | MPAA |
| هنگ کنگ (HK) | کالیفرنیا | وزارت امور خارجه |
| مجارستان (HU) | موجود نیست | MPAA |
| ایسلند (IS) | موجود نیست | کیجکویزر |
| هند (IN) | سیبیافسی | سیبیافسی |
| اندونزی (ID) | شاخص کلیدی عملکرد (KPI) | ال اس اف |
| ایرلند (IE) | موجود نیست | ایفکو |
| ایتالیا (IT) | AGCOM | AGCOM |
| ساحل عاج (CI) | موجود نیست | سی ان سی |
| جامائیکا (JM) | موجود نیست | MPAA |
| ژاپن (JP) | نه | آیرین |
| اردن (JO) | موجود نیست | MPAA |
| قزاقستان (KZ) | موجود نیست | ام آر کی اف |
| کره (KR) | کی ام آر بی | کی ام آر بی |
| کویت (کیلووات) | موجود نیست | MPAA |
| قرقیزستان (کیلوگرم) | موجود نیست | MKRF/روسیه |
| لائوس (LA) | موجود نیست | موجود نیست |
| لتونی (LV) | موجود نیست | ان کی ال وی |
| لبنان (LB) | موجود نیست | MPAA |
| لیتوانی (LT) | موجود نیست | موجود نیست |
| لوکزامبورگ (LU) | موجود نیست | کیجکویزر |
| مقدونیه (MK) | موجود نیست | MPAA |
| مالزی (مالزی) | موجود نیست | اف سی بی ام |
| مالی (ML) | موجود نیست | سی ان سی |
| مالت (MT) | موجود نیست | مکسیایای |
| موریس (MU) | موجود نیست | بیبیافسی |
| مکزیک (MX) | آر تی سی | آر تی سی |
| مولداوی (MD) | موجود نیست | موجود نیست |
| نامیبیا (NA) | موجود نیست | موجود نیست |
| نپال (NP) | موجود نیست | MPAA |
| هلند (NL) | کیجکویزر | کیجکویزر |
| نیوزیلند (NZ) | بیاسای | اف ال سی |
| نیکاراگوئه (NI) | موجود نیست | MPAA |
| نیجر (شمال شرقی) | موجود نیست | سی ان سی |
| نروژ (خیر) | موجود نیست | مدیتیلسینِت |
| عمان (OM) | موجود نیست | MPAA |
| پاناما (PA) | موجود نیست | MPAA |
| پاپوآ گینه نو (PG) | موجود نیست | MPAA |
| پاراگوئه (PY) | موجود نیست | MPAA |
| پرو (PE) | موجود نیست | MPAA |
| فیلیپین (PH) | ام تی آر سی بی | ام تی آر سی بی |
| لهستان (PL) | موجود نیست | MPAA |
| پرتغال (PT) | موجود نیست | سی سی ای |
| قطر (QA) | موجود نیست | MPAA |
| روسیه (RU) | MKRF/روسیه | MKRF/روسیه |
| رواندا (RW) | موجود نیست | سی ان سی |
| عربستان سعودی (SA) | موجود نیست | MPAA |
| سنگال (SN) | موجود نیست | MPAA |
| سنگاپور (SG) | موجود نیست | ام دی ای |
| اسلواکی (SK) | موجود نیست | MPAA |
| اسلوونی (SI) | موجود نیست | MPAA |
| آفریقای جنوبی (ZA) | اف پی بی | اف پی بی |
| اسپانیا (ES) | ستسی | ایکا |
| سریلانکا (LK) | موجود نیست | موجود نیست |
| سوئد (جنوب شرقی) | موجود نیست | اس ام اس ای |
| سوئیس (CH) | اف اس کی | اف اس کی |
| تایوان (TW) | موجود نیست | MOCTW |
| تاجیکستان (TJ) | موجود نیست | MKRF/روسیه |
| تانزانیا (TZ) | موجود نیست | MPAA |
| تایلند (TH) | موجود نیست | بی اف وی سی |
| توگو (TG) | موجود نیست | سی ان سی |
| ترینیداد و توباگو (TT) | موجود نیست | موجود نیست |
| ترکیه (TR) | آر تی یو کی | ECBMCT |
| ترکمنستان (TM) | موجود نیست | MKRF/روسیه |
| اوگاندا (UG) | موجود نیست | MPAA |
| اوکراین (UA) | موجود نیست | موجود نیست |
| امارات متحده عربی (AE) | موجود نیست | MPAA |
| بریتانیا (GB) | بیبیافسی | بیبیافسی |
| ایالات متحده (ایالات متحده) | تلویزیون_PG | MPAA |
| اروگوئه (UY) | موجود نیست | MPAA |
| ازبکستان (UZ) | موجود نیست | MKRF/روسیه |
| ونزوئلا (VE) | موجود نیست | ریزورت ویولنسیا |
| ویتنام (VN) | موجود نیست | ام سی اس تی |
| زامبیا (ZM) | موجود نیست | MPAA |
| زیمبابوه (ZW) | موجود نیست | MPAA |
ویژگیهای GeoShape
یک شیء GeoShape شامل یکی از انواع داده زیر است:
- فهرستی از کدهای پستی (برای مثال، کد پستی ایالات متحده، کانادا یا سایر کد پستیها)
- فهرستی از مناطق مرتبسازی رو به جلو در کانادا
- شناسه منطقه بازار تعیینشده (DMA) - شناسه منطقهای در ایالات متحده که مردم در آن کانالها و برنامههای تلویزیونی یکسانی دریافت میکنند.
| ملک | نوع مورد انتظار | توضیحات |
|---|---|---|
@id | آدرس اینترنتی | الزامی - شناسه منطقه جغرافیایی در قالب URI. |
@type | متن | الزامی - همیشه روی GeoShape تنظیم شود. |
addressCountry | متن | الزامی - کد کشور دو حرفی ISO 3166-1 alpha-2 . |
postalCode | متن | اختیاری - فهرست یک یا چند کد پستی و/یا کدهای FSA (منطقه مرتبسازی رو به جلو). |
identifier | ارزش ملک | اختیاری - شناسه منطقه بازار تعیینشده (DMA) ، که شناسه منطقهای در ایالات متحده است که مردم در آن کانالها و برنامههای تلویزیونی یکسانی را دریافت میکنند. |
identifier.@type | متن | الزامی - همیشه روی PropertyValue تنظیم شود. |
identifier.propertyID | متن | الزامی - همیشه روی DMA_ID تنظیم شود. |
identifier.value | متن | الزامی - کد DMA برای منطقه. |
مثالی از شیء 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 که حاوی شناسه DMA است:
{
"@type": "GeoShape",
"@id": "http://example.com/area3",
"addressCountry": "US",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "DMA_ID",
"value": "501"
}
]
}