این بخش جزئیات ویژگی های رایج Watch Actions را ارائه می دهد.
ویژگی های نشانه گذاری اقدام
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
@type | متن | مورد نیاز - همیشه روی WatchAction تنظیم شود. |
target | نقطه ورود | مورد نیاز - یک شی هدف که نگاشت پیوندهای عمیق به پلتفرم های مختلف گوگل را فراهم می کند. |
target.@type | متن | مورد نیاز - همیشه روی EntryPoint تنظیم شود. |
target.urlTemplate | URL | مورد نیاز - یک پیوند عمیق که کاربران را به برنامه یا پلتفرم شما می برد و بازپخش محتوا را آغاز می کند. |
target.inLanguage | متن | اختیاری - زبان اصلی سری در قالب BCP 47 . |
target.actionPlatform | متن | مورد نیاز - پلتفرم هایی که به urlTemplate نگاشت شده اند. Media Actions موارد زیر را پشتیبانی می کند:
|
target.additionalProperty | PropertyValue | در صورت وجود الزامی است - فهرستی از جفتهای ویژگی-مقدار برای نشان دادن ویژگیهای اضافی پیوند عمیق. این می تواند شامل موارد زیر باشد:
|
actionAccessibilityRequirement | ActionAccessSpecification | مورد نیاز - یک شی مشخصات دسترسی Action که نیاز دسترسی به محتوا را توصیف می کند. به ویژگی های Action Access Specification مراجعه کنید. |
صفحات مربوط به نشانه گذاری اقدام
برای موضوعات مرتبط با این خواص، صفحات زیر را بررسی کنید:
ویژگی های مشخصات دسترسی اقدام
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
actionAccessibilityRequirement.@type | متن | مورد نیاز - همیشه روی ActionAccessSpecification تنظیم شود. |
actionAccessibilityRequirement.category | متن | مورد نیاز - یک الزام دسترسی برای محتوا. برای اطلاعات بیشتر، نوع Paywall را ببینید. اگر یک موجودیت نشان دهنده گروهی از محتوا است، باید |
actionAccessibilityRequirement.availabilityStarts | تاریخ | مورد نیاز - تاریخی که پس از آن اقدام در دسترس است، در قالب ISO 8601 (از جمله منطقه زمانی).
لازم است که موجودیت مربوطه حداقل 7 روز قبل از تاریخ شروع در دسترس بودن در فید ارائه شود. این کار شانس نمایش به موقع محتوا در سطوح Google را افزایش می دهد. |
actionAccessibilityRequirement.availabilityEnds | تاریخ | مورد نیاز - تاریخی که پس از آن اقدام دیگر در دسترس نیست، در قالب ISO 8601 (از جمله منطقه زمانی).
لازم است که هرگونه بهروزرسانی در تاریخ AvailabilityEnds حداقل 7 روز قبل از تاریخ AvailabilityEnds در فید انجام شود. این احتمال را افزایش می دهد که محتوا در تاریخ پایان دسترسی در سطوح Google ظاهر نشود. |
actionAccessibilityRequirement.eligibleRegion | کشور ، شهر ، ایالت ، ژئوشکل یا متن | مورد نیاز - مناطقی که محتوا در آن موجود است. اگر محتوا در سطح جهانی در دسترس است از رشته ویژه EARTH استفاده کنید. |
actionAccessibilityRequirement.ineligibleRegion | کشور ، شهر ، ایالت یا GeoShape | در صورت وجود الزامی است - مناطقی که محتوا محدود شده است. اگر محتوا در همه جا در eligibleRegion در دسترس باشد، نیازی به ارائه این ویژگی ندارید. |
actionAccessibilityRequirement.requiresSubscription | اشتراک رسانه | در صورت وجود الزامی است - جزئیات اشتراکی که کاربران برای دسترسی به محتوا به آن نیاز دارند. به ویژگی های اشتراک رسانه مراجعه کنید.
|
actionAccessibilityRequirement.expectsAcceptanceOf | پیشنهاد | اگر محتوا نیاز به خرید دارد، الزامی است - جزئیات پیشنهاد مرتبط با محتوا. اطلاعات قیمت را برای موارد زیر ارائه دهید:
Offer را به طور کامل حذف کنید و category از شی ActionAccessSpecification روی free قرار دهید. به پیشنهاد خواص مراجعه کنید. |
ویژگی های اشتراک رسانه
اگر actionAccessibilityRequirement.category
subscription
یا externalSubscription
باشد، الزامی است.
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
requiresSubscription.@type | متن | مورد نیاز - همیشه روی MediaSubscription تنظیم شود |
requiresSubscription.@id | URL | مورد نیاز - شناسه منحصر به فرد برای اشتراک. اگر محتوا از طریق اشتراک های مختلف قابل دسترسی است، هر اشتراک باید یک شناسه منحصر به فرد داشته باشد. |
requiresSubscription.name | متن | مورد نیاز - نام اشتراک. به موارد زیر توجه کنید:
|
requiresSubscription.sameAs | URL | صفحه ای که اشتراک را توضیح می دهد. |
requiresSubscription.identifier | متن | اگر category subscription باشد و commonTier false است - یک رشته منحصر به فرد برای این اشتراک که نشان دهنده دسترسی به گروهی از محتوا در کاتالوگ رسانه شما است، الزامی است .
|
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 حق لازم است. اگر اشتراک شما یک طبقه است و به تمام محتوای موجود در کاتالوگ شما دسترسی دارد، این مورد را درج نکنید.
- شرکت A یک پیشنهاد اشتراک دارد که به کاربران مشترک امکان دسترسی به تمام محتوای موجود را میدهد: شناسه حق / API مورد نیاز نیست
- شرکت B دارای یک اشتراک پایه است که دسترسی به برخی از محتوا را فراهم می کند و یک اشتراک ممتاز که دسترسی به محتوای برتر را فراهم می کند: شناسه حق / API مورد نیاز است.
- شرکت C دارای یک اشتراک پایه است که دسترسی به برخی از محتوا و بستههایی را اضافه میکند که دسترسی به محتوای شخص ثالث را فراهم میکند: شناسه حقوق / API مورد نیاز است.
صفحات مرتبط با اشتراک رسانه
برای موضوعات مرتبط با این خواص، صفحات زیر را بررسی کنید:
املاک را ارائه دهید
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
expectsAcceptanceOf.@type | متن | مورد نیاز - همیشه روی Offer تنظیم شود. |
expectsAcceptanceOf.price | عدد | مورد نیاز - قیمت خرید محتوا. قیمت باید یک مقدار مثبت غیر صفر باشد. برای نهادهای با قیمت 0.00، لطفاً دسته را به عنوان "رایگان" مشخص کنید. |
expectsAcceptanceOf.priceCurrency | متن | مورد نیاز - واحد پول قیمت در قالب 3 حرف ایزو 4217 . |
expectsAcceptanceOf.seller | سازمان | سازمانی که خرید محتوا را ارائه می دهد. |
expectsAcceptanceOf.seller.@type | متن | همیشه روی Organization تنظیم شود. |
expectsAcceptanceOf.seller.name | متن | نام فروشنده. |
expectsAcceptanceOf.seller.sameAs | متن | URL یک صفحه وب که فروشنده را مشخص می کند. به عنوان مثال، صفحه اصلی فروشنده. |
صفحه مربوط به پیشنهاد
برای موضوعات مرتبط با این خواص، صفحات زیر را بررسی کنید:
شناسه ها
فیدهای Media Action انواع شناسهها را میپذیرند که میتوانند به شناسایی یک موجودیت به شیوهای بدون ابهام کمک کنند. این شناسهها میتوانند به تسریع روند تطبیق محتوای موجود در فید شما با محتوای پایگاههای داده Google کمک کنند. در حالی که بیشتر این شناسهها را میتوان با استفاده از ویژگی identifier
در انواع مختلف نهاد به فید اضافه کرد، EIDRها دارای ویژگی نماینده خاص خود هستند. هر دوی این موارد در زیر مورد بحث قرار گرفته است.
ویژگی های شناسه
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
identifier | متن | بسیار توصیه می شود - یک شناسه، معمولاً خارجی، که به طور واضح یک موجودیت معین را شناسایی می کند. چندین شناسه مجاز است. این ویژگی در همه انواع نهادهای Watch Action موجود است. جدول زیر، شناسه های پذیرفته شده و ویژگی های فرعی ویژگی identifier را فهرست می کند. مثال شناسه/EIDR را در بخش نمونههای فید Actions ببینید. |
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
@type | متن | مورد نیاز - همیشه روی PropertyValue تنظیم شود. |
propertyID | متن | مورد نیاز - ما از انواع ID زیر پشتیبانی می کنیم:
|
value | متن | مورد نیاز - مقدار برای سیستم ID مشخص شده. |
خواص EIDR
EIDR (مخفف The Entertainment Identifier Registry)، یک سیستم شناسایی منحصربفرد جهانی برای مجموعه وسیعی از محتوای رسانهای، از جمله تصاویر متحرک و برنامههای تلویزیونی است. سیستم شناسایی یک شناسه را به یک رکورد ابرداده که با عناوین سطح بالا، ویرایشها و موارد دیگر مرتبط است، حل میکند. جدول زیر ویژگی های مرتبط با EIDR و استفاده از آنها را فهرست می کند.
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
titleEIDR | متن | بسیار توصیه می شود - یک شناسه EIDR (ثبت شناسه سرگرمی) در کلی ترین/انتزاعی ترین سطح، یک اثر سینمایی یا تلویزیونی را نشان می دهد. این ویژگی در صفحههای مشخصات TVSeries ، TVSeason ، TVEpisode و Movie موجود است. به عنوان مثال، عنوانEIDR برای فیلمی که با نام "شکارچیان ارواح" شناخته می شود، "10.5240/7EC7-228A-510A-053E-CBB8-J" است. مثال شناسه/EIDR را در بخش نمونههای فید Actions ببینید. |
editEIDR | متن | بسیار توصیه می شود - یک شناسه EIDR (ثبت شناسه سرگرمی) یک ویرایش/ویرایش خاص را برای یک اثر سینمایی یا تلویزیونی نشان می دهد. این ویژگی در صفحات TVEpisode و مشخصات موجودیت فیلم موجود است. برای مثال، فیلمی که با نام «شکارچیان ارواح» شناخته میشود و عنوان EIDR آن «10.5240/7EC7-228A-510A-053E-CBB8-J» است، چندین ویرایش دارد، بهعنوان مثال «10.5240/1F2A-E1C5-680A-14C6-I» و E76 "10.5240/8A35-3BEE-6497-5D12-9E4F-3". هنگامی که editEIDR ارائه می شود، ویژگی titleEIDR مورد نیاز است.مثال شناسه/EIDR را در بخش نمونههای فید Actions ببینید. |
آژانس های رتبه بندی محتوا
از مقادیر موجود در این جدول برای 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/روسیه |
آروبا (AW) | در دسترس نیست | در دسترس نیست |
استرالیا (AU) | تلویزیون ACB | فیلم های ACB |
اتریش (AT) | FSK | FSK |
آذربایجان (AZ) | در دسترس نیست | MKRF/روسیه |
بحرین (BH) | در دسترس نیست | MPAA |
بلاروس (BY) | در دسترس نیست | MKRF/روسیه |
بلژیک (BE) | در دسترس نیست | MPAA |
بلیز (BZ) | در دسترس نیست | در دسترس نیست |
بنین (BJ) | در دسترس نیست | CNC |
بولیوی (BO) | در دسترس نیست | MPAA |
بوسنی و هرزگوین (BA) | در دسترس نیست | MPAA |
بوتسوانا (BW) | در دسترس نیست | MPAA |
برزیل (BR) | کلاسیند | کلاسیند |
بورکینافاسو (BF) | در دسترس نیست | CNC |
کامبوج (KH) | در دسترس نیست | در دسترس نیست |
کانادا (CA) | 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 |
فرانسه (FR) | CSA | CSA |
گابن (GA) | در دسترس نیست | CNC |
آلمان (DE) | FSK | FSK |
یونان (GR) | ESR | GRFILM |
گواتمالا (GT) | در دسترس نیست | MPAA |
هائیتی (HT) | در دسترس نیست | در دسترس نیست |
هندوراس (HN) | در دسترس نیست | MPAA |
هنگ کنگ (هنگ کنگ) | CA | FCO |
مجارستان (HU) | در دسترس نیست | MPAA |
ایسلند (IS) | در دسترس نیست | KIJKWIJZER |
هند (IN) | CBFC | CBFC |
اندونزی (ID) | KPI | LSF |
ایرلند (IE) | در دسترس نیست | IFCO |
ایتالیا (IT) | AGCOM | AGCOM |
ساحل عاج (CI) | در دسترس نیست | CNC |
جامائیکا (JM) | در دسترس نیست | MPAA |
ژاپن (JP) | NA | 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 |
مکزیک (MX) | RTC | RTC |
مولداوی (MD) | در دسترس نیست | در دسترس نیست |
نامیبیا (NA) | در دسترس نیست | در دسترس نیست |
نپال (NP) | در دسترس نیست | MPAA |
هلند (NL) | KIJKWIJZER | KIJKWIJZER |
نیوزلند (NZ) | 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/روسیه | MKRF/روسیه |
رواندا (RW) | در دسترس نیست | CNC |
عربستان سعودی (SA) | در دسترس نیست | MPAA |
سنگال (SN) | در دسترس نیست | MPAA |
سنگاپور (SG) | در دسترس نیست | MDA |
اسلواکی (SK) | در دسترس نیست | MPAA |
اسلوونی (SI) | در دسترس نیست | MPAA |
آفریقای جنوبی (ZA) | FPB | FPB |
اسپانیا (ES) | SETSI | ICAA |
سریلانکا (LK) | در دسترس نیست | در دسترس نیست |
سوئد (SE) | در دسترس نیست | SMSA |
سوئیس (CH) | FSK | FSK |
تایوان (TW) | در دسترس نیست | MOCTW |
تاجیکستان (TJ) | در دسترس نیست | MKRF/روسیه |
تانزانیا (TZ) | در دسترس نیست | MPAA |
تایلند (TH) | در دسترس نیست | BFVC |
توگو (TG) | در دسترس نیست | CNC |
ترینیداد و توباگو (TT) | در دسترس نیست | در دسترس نیست |
ترکیه (TR) | RTÜK | ECBMCT |
ترکمنستان (TM) | در دسترس نیست | MKRF/روسیه |
اوگاندا (UG) | در دسترس نیست | MPAA |
اوکراین (UA) | در دسترس نیست | در دسترس نیست |
امارات متحده عربی (AE) | در دسترس نیست | MPAA |
بریتانیا (GB) | BBFC | BBFC |
ایالات متحده آمریکا (ایالات متحده آمریکا) | TV_PG | MPAA |
اروگوئه (UY) | در دسترس نیست | MPAA |
ازبکستان (UZ) | در دسترس نیست | MKRF/روسیه |
ونزوئلا (VE) | در دسترس نیست | RESORTEVIOLENCIA |
ویتنام (VN) | در دسترس نیست | MCST |
زامبیا (ZM) | در دسترس نیست | MPAA |
زیمبابوه (ZW) | در دسترس نیست | MPAA |
ویژگی های GeoShape
یک شی GeoShape شامل یکی از انواع داده های زیر است:
- فهرستی از کدهای پستی (به عنوان مثال، کد(های) پستی ایالات متحده، کانادا یا سایر کدهای پستی)
- فهرستی از مناطق مرتب سازی رو به جلو کانادایی
- شناسه منطقه بازار تعیین شده (DMA) - شناسه منطقه ای در ایالات متحده است که در آن افراد کانال ها و برنامه های تلویزیونی مشابهی را دریافت می کنند.
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
@id | URL | مورد نیاز - شناسه منطقه جغرافیایی در قالب URI. |
@type | متن | مورد نیاز - همیشه روی GeoShape تنظیم شود. |
addressCountry | متن | الزامی - کد کشور دو حرف ایزو 3166-1 آلفا-2 . |
postalCode | متن | اختیاری - فهرست یک یا چند کد پستی و/یا کدهای FSA (منطقه مرتبسازی پیشرو). |
identifier | PropertyValue | اختیاری - شناسه منطقه بازار تعیین شده (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"
}
]
}