В этом разделе содержится подробная информация об общих свойствах Watch Actions.
Свойства разметки действий
| Имущество | Ожидаемый тип | Описание |
|---|---|---|
@type | Текст | Обязательно — всегда установлено значение WatchAction . |
target | Точка входа | Требуется — целевой объект , обеспечивающий сопоставление глубоких ссылок с различными платформами Google. |
target.@type | Текст | Обязательно — всегда установлено значение EntryPoint . |
target.urlTemplate | URL-адрес | Обязательно — глубокая ссылка , которая ведет пользователей к вашему приложению или платформе и инициирует воспроизведение контента. |
target.inLanguage | Текст | Необязательно - Исходный язык сериала в формате BCP 47 . |
target.actionPlatform | Текст | Обязательно — платформы, сопоставленные с urlTemplate . Действия с мультимедиа поддерживают следующее:
|
target.additionalProperty | Стоимость имущества | Обязательно, если применимо . Список пар «свойство-значение» для представления дополнительных свойств ссылки на контент. Это может включать следующее:
|
actionAccessibilityRequirement | ActionAccessSpecification | Required — объект спецификации доступа Action , описывающий требование доступа к содержимому. См . Свойства спецификации доступа к действию. |
Страницы, связанные с разметкой действий
Ознакомьтесь со следующими страницами для тем, связанных с этими свойствами:
Свойства спецификации доступа к действию
| Имущество | Ожидаемый тип | Описание |
|---|---|---|
actionAccessibilityRequirement.@type | Текст | Обязательно — всегда установлено значение ActionAccessSpecification . |
actionAccessibilityRequirement.category | Текст | Required — требование доступа к содержимому. Дополнительные сведения см. в разделе Тип платного доступа. Если объект представляет собой группу контента, вам необходимо установить для |
actionAccessibilityRequirement.availabilityStarts | Свидание | Обязательно — дата, после которой действие становится доступным, в формате ISO 8601 (включая часовой пояс).
Необходимо, чтобы соответствующий объект был представлен в фиде не менее чем за 7 дней до даты его доступности. Это повысит шансы на то, что контент будет вовремя отображаться на поверхностях Google. |
actionAccessibilityRequirement.availabilityEnds | Свидание | Обязательно — дата, после которой действие становится недоступным, в формате ISO 8601 (включая часовой пояс).
Необходимо, чтобы любые обновления датыavailabilityEnds делались в ленте по крайней мере за 7 дней до датыavailabilityEnds. Это повысит вероятность того, что контент перестанет появляться на платформах Google в дату окончания доступности. |
actionAccessibilityRequirement.eligibleRegion | Страна , город , штат , GeoShape или текст | Обязательное — регионы, в которых доступен контент. Используйте специальную строку 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 прав
API предоставления прав требуется, если actionAccessibilityRequirement.category — это subscription или externalSubscription , а ваше предложение по подписке включает несколько пакетов или уровней или поддерживает надстройки. Не включайте это, если ваша подписка является одноуровневой и дает доступ ко всему контенту в вашем каталоге.
- Компания А предлагает единую подписку, которая дает подписанным пользователям доступ ко всему доступному контенту: Идентификатор прав/API не требуется.
- Компания B имеет базовую подписку, которая предоставляет доступ к некоторому контенту, и премиум-подписку, которая предоставляет доступ к премиум-контенту: требуется идентификатор прав / API .
- Компания C имеет базовую подписку, которая предоставляет доступ к некоторому контенту, и дополнительные пакеты, которые обеспечивают доступ к контенту третьих лиц: требуется идентификатор прав / API .
Страницы, связанные с подпиской на СМИ
Ознакомьтесь со следующими страницами для тем, связанных с этими свойствами:
Предложить свойства
| Имущество | Ожидаемый тип | Описание |
|---|---|---|
expectsAcceptanceOf.@type | Текст | Обязательно — всегда установлено значение Offer . |
expectsAcceptanceOf.price | Число | Обязательно - Цена покупки контента. Цена должна быть ненулевым положительным значением. Для объектов с ценой 0,00 укажите категорию «бесплатно». |
expectsAcceptanceOf.priceCurrency | Текст | Обязательно - Валюта цены в трехбуквенном формате ISO 4217 . |
expectsAcceptanceOf.seller | Организация | Организация, предлагающая покупку контента. |
expectsAcceptanceOf.seller.@type | Текст | Всегда устанавливайте в Organization . |
expectsAcceptanceOf.seller.name | Текст | Имя продавца. |
expectsAcceptanceOf.seller.sameAs | Текст | URL-адрес веб-страницы, которая идентифицирует продавца; например, домашняя страница продавца. |
Страница, связанная с предложением
Ознакомьтесь со следующими страницами для тем, связанных с этими свойствами:
Идентификаторы
Каналы Media Action принимают различные идентификаторы, которые могут помочь однозначно идентифицировать объект. Эти идентификаторы могут помочь ускорить процесс согласования контента в вашей ленте с контентом в базах данных Google. Хотя большинство этих идентификаторов можно добавить в ленту с помощью свойства identifier для различных типов сущностей, у EIDR есть свое собственное репрезентативное свойство. Оба они обсуждаются ниже.
Свойства идентификатора
| Имущество | Ожидаемый тип | Описание |
|---|---|---|
identifier | Текст | Настоятельно рекомендуется — идентификатор, обычно внешний, который однозначно идентифицирует данный объект. Допускается использование нескольких идентификаторов. Это свойство доступно для всех типов сущностей Watch Action. В таблице ниже перечислены принятые идентификаторы и подсвойства свойства identifier . См. пример идентификатора/EIDR в разделе «Примеры фида Watch Actions». |
| Имущество | Ожидаемый тип | Описание |
|---|---|---|
@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/8А35-3БЭЭ-6497-5Д12-9Э4Ф-3». titleEIDR требуется , когда предоставляется editEIDR .См. пример идентификатора/EIDR в разделе «Примеры фида Watch Actions». |
Агентства рейтинга контента
Используйте значения в этой таблице для BroadcastService.contentRating , Movie.contentRating и TVSeries.contentRating . Рейтинговое агентство должно стоять перед значением рейтинга. Примеры:
- Фильм с рейтингом "R" в США должен иметь значение
Movie.contentRating"MPAA R". - Телесериал с рейтингом "TV-MA" в США должен иметь значение
TVSeries.contentRating"TVPG TV-MA".
| Страна | Рейтинговое агентство телевидения | Рейтинговое агентство фильмов |
|---|---|---|
| Албания (АЛ) | Нет в наличии | Нет в наличии |
| Ангола (АО) | Нет в наличии | ССЕ |
| Антигуа и Барбуда (АГ) | Нет в наличии | MPAA |
| Аргентина (АР) | ИНКАА | ИНКАА |
| Армения (AM) | Нет в наличии | МКРФ/РОССИЯ |
| Аруба (AW) | Нет в наличии | Нет в наличии |
| Австралия (AU) | АКБ ТВ | ACB фильмы |
| Австрия (АТ) | ФСК | ФСК |
| Азербайджан (AZ) | Нет в наличии | МКРФ/РОССИЯ |
| Бахрейн (БГ) | Нет в наличии | MPAA |
| Беларусь (BY) | Нет в наличии | МКРФ/РОССИЯ |
| Бельгия (BE) | Нет в наличии | MPAA |
| Белиз (БЗ) | Нет в наличии | Нет в наличии |
| Бенин (БЖ) | Нет в наличии | ЧПУ |
| Боливия (БО) | Нет в наличии | MPAA |
| Босния и Герцеговина (BA) | Нет в наличии | MPAA |
| Ботсвана (ЧБ) | Нет в наличии | MPAA |
| Бразилия (BR) | КЛАССИНД | КЛАССИНД |
| Буркина-Фасо (БФ) | Нет в наличии | ЧПУ |
| Камбоджа (KH) | Нет в наличии | Нет в наличии |
| Канада (Калифорния) | CA_TV | ЧВРС |
| Кабо-Верде (резюме) | Нет в наличии | ССЕ |
| Чили (ЧЛ) | Нет в наличии | MPAA |
| Колумбия (Колорадо) | Нет в наличии | MPAA |
| Коста-Рика (ЧР) | Нет в наличии | MPAA |
| Хорватия (HR) | Нет в наличии | Нет в наличии |
| Кипр (КИ) | Нет в наличии | ГРФИЛЬМ |
| Чехия (CZ) | Нет в наличии | ЦЗФИЛЬМ |
| Дания (ДК) | Нет в наличии | MCCYP |
| Эквадор (ЕС) | Нет в наличии | MPAA |
| Египет (EG) | Нет в наличии | MPAA |
| Сальвадор (SV) | Нет в наличии | MPAA |
| Эстония (EE) | Нет в наличии | ЭФИЛЬМ |
| Фиджи (Ф.Дж.) | Нет в наличии | Нет в наличии |
| Финляндия (FI) | Нет в наличии | МЕКУ |
| Франция (фр.) | КСА | КСА |
| Габон (Джорджия) | Нет в наличии | ЧПУ |
| Германия (DE) | ФСК | ФСК |
| Греция (GR) | СОЭ | ГРФИЛЬМ |
| Гватемала (GT) | Нет в наличии | MPAA |
| Гаити (HT) | Нет в наличии | Нет в наличии |
| Гондурас (HN) | Нет в наличии | MPAA |
| Гонконг (Гонконг) | Калифорния | FCO |
| Венгрия (HU) | Нет в наличии | MPAA |
| Исландия (ИС) | Нет в наличии | КИЙКВЕЙЗЕР |
| Индия (Индия) | КБФК | КБФК |
| Индонезия (Айдахо) | КПЭ | ЛСФ |
| Ирландия (IE) | Нет в наличии | ИФКО |
| Италия (ИТ) | АГКОМ | АГКОМ |
| Кот-д'Ивуар (КИ) | Нет в наличии | ЧПУ |
| Ямайка (JM) | Нет в наличии | MPAA |
| Япония (Япония) | нет данных | ЭИРИН |
| Джордан (JO) | Нет в наличии | MPAA |
| Казахстан (KZ) | Нет в наличии | МРКФ |
| Корея (КР) | КМРБ | КМРБ |
| Кувейт (кВт) | Нет в наличии | MPAA |
| Кыргызстан (KG) | Нет в наличии | МКРФ/РОССИЯ |
| Лаос (Луизиана) | Нет в наличии | Нет в наличии |
| Латвия (LV) | Нет в наличии | NKCLV |
| Ливан (ЛБ) | Нет в наличии | MPAA |
| Литва (LT) | Нет в наличии | Нет в наличии |
| Люксембург (LU) | Нет в наличии | КИЙКВЕЙЗЕР |
| Македония (МК) | Нет в наличии | MPAA |
| Малайзия (МОЯ) | Нет в наличии | FCBM |
| Мали (МЛ) | Нет в наличии | ЧПУ |
| Мальта (MT) | Нет в наличии | МСССА |
| Маврикий (МЮ) | Нет в наличии | ББФЦ |
| Мексика (Мексика) | РТК | РТК |
| Молдова (MD) | Нет в наличии | Нет в наличии |
| Намибия (Северная Америка) | Нет в наличии | Нет в наличии |
| Непал (НП) | Нет в наличии | MPAA |
| Нидерланды (Нидерланды) | КИЙКВЕЙЗЕР | КИЙКВЕЙЗЕР |
| Новая Зеландия (НЗ) | ЗБТ | ОФЛК |
| Никарагуа (NI) | Нет в наличии | MPAA |
| Нигер (СВ) | Нет в наличии | ЧПУ |
| Норвегия (НЕТ) | Нет в наличии | МЕДИЕТИЛСИНЕТ |
| Оман (ОМ) | Нет в наличии | MPAA |
| Панама (Пенсильвания) | Нет в наличии | MPAA |
| Папуа-Новая Гвинея (PG) | Нет в наличии | MPAA |
| Парагвай (PY) | Нет в наличии | MPAA |
| Перу (PE) | Нет в наличии | MPAA |
| Филиппины (PH) | МТРКБ | МТРКБ |
| Польша (PL) | Нет в наличии | MPAA |
| Португалия (Португалия) | Нет в наличии | ССЕ |
| Катар (КК) | Нет в наличии | MPAA |
| Россия (RU) | МКРФ/РОССИЯ | МКРФ/РОССИЯ |
| Руанда (RW) | Нет в наличии | ЧПУ |
| Саудовская Аравия (SA) | Нет в наличии | MPAA |
| Сенегал (SN) | Нет в наличии | MPAA |
| Сингапур (SG) | Нет в наличии | МДА |
| Словакия (Словакия) | Нет в наличии | MPAA |
| Словения (SI) | Нет в наличии | MPAA |
| Южная Африка (ZA) | ФПБ | ФПБ |
| Испания (Испания) | СЭТСИ | ИКАА |
| Шри-Ланка (LK) | Нет в наличии | Нет в наличии |
| Швеция (ЮВ) | Нет в наличии | СМСА |
| Швейцария (Швейцария) | ФСК | ФСК |
| Тайвань (TW) | Нет в наличии | MOCTW |
| Таджикистан (ТДж) | Нет в наличии | МКРФ/РОССИЯ |
| Танзания (TZ) | Нет в наличии | MPAA |
| Таиланд (TH) | Нет в наличии | БФВК |
| Того (ТГ) | Нет в наличии | ЧПУ |
| Тринидад и Тобаго (TT) | Нет в наличии | Нет в наличии |
| Турция (ТР) | РТЮК | ЭБУМТ |
| Туркменистан (ТМ) | Нет в наличии | МКРФ/РОССИЯ |
| Уганда (УГ) | Нет в наличии | MPAA |
| Украина (UA) | Нет в наличии | Нет в наличии |
| Объединенные Арабские Эмираты (AE) | Нет в наличии | MPAA |
| Соединенное Королевство (ГБ) | ББФЦ | ББФЦ |
| Соединенные Штаты (США) | TV_PG | MPAA |
| Уругвай (UY) | Нет в наличии | MPAA |
| Узбекистан (УЗ) | Нет в наличии | МКРФ/РОССИЯ |
| Венесуэла (VE) | Нет в наличии | КУРОРТВИОЛЕНЦИЯ |
| Вьетнам (ВН) | Нет в наличии | МЦСТ |
| Замбия (ЗМ) | Нет в наличии | MPAA |
| Зимбабве (ZW) | Нет в наличии | MPAA |
Свойства GeoShape
Объект GeoShape содержит один из следующих типов данных:
- Список почтовых индексов (например, США, Канады или других почтовых индексов))
- Список канадских зон прямой сортировки
- Идентификатор выделенной рыночной зоны (DMA) — идентификатор региона в Соединенных Штатах, где люди получают одни и те же телевизионные каналы и программы.
| Имущество | Ожидаемый тип | Описание |
|---|---|---|
@id | URL-адрес | Обязательно — идентификатор георегиона в формате 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"
}
]
}