В этом разделе подробно описаны общие свойства действий при просмотре.
Свойства разметки действий
| Свойство | Ожидаемый тип | Описание |
|---|---|---|
@type | Текст | Обязательно - Всегда устанавливайте значение WatchAction . |
target | Точка входа | Обязательный параметр — целевой объект , обеспечивающий сопоставление прямых ссылок с различными платформами Google. |
target.@type | Текст | Обязательно - Всегда устанавливайте значение EntryPoint . |
target.urlTemplate | URL | Обязательный параметр — прямая ссылка , которая перенаправляет пользователей в ваше приложение или на платформу и запускает воспроизведение контента. |
target.inLanguage | Текст | Настоятельно рекомендуется — оригинальный текст на языке оригинала в формате BCP 47 . |
target.actionPlatform | Текст | Обязательно — платформы, которые сопоставляются с urlTemplate . Media Actions поддерживает следующие:
|
target.additionalProperty | Стоимость недвижимости | Обязательный, если применимо , список пар «свойство-значение», представляющих дополнительные свойства глубокой ссылки. Сюда могут входить следующие данные:
|
actionAccessibilityRequirement | ActionAccessSpecification | Обязательный параметр — объект спецификации доступа к действию , описывающий требования к доступу к содержимому. См. Свойства спецификации доступа к действию. |
Разметка действий, связанные страницы
Для получения информации по соответствующим темам ознакомьтесь со следующими страницами:
Свойства спецификации доступа к действию
| Свойство | Ожидаемый тип | Описание |
|---|---|---|
actionAccessibilityRequirement.@type | Текст | Обязательно - Всегда устанавливайте значение ActionAccessSpecification . |
actionAccessibilityRequirement.category | Текст | Обязательный — требование доступа к контенту. Для получения дополнительной информации см. раздел «Тип платного доступа» . Если сущность представляет собой группу контента, необходимо установить |
actionAccessibilityRequirement.availabilityStarts | Дата | Обязательно — дата, после которой действие станет доступно, в формате ISO 8601 (включая часовой пояс).
Необходимо, чтобы соответствующий контент был добавлен в ленту не менее чем за 7 дней до даты его появления. Это повысит вероятность того, что контент своевременно появится в результатах поиска Google. |
actionAccessibilityRequirement.availabilityEnds | Дата | Обязательно — дата, после которой действие становится недоступным, в формате ISO 8601 (включая часовой пояс).
Необходимо вносить любые изменения в дату окончания доступности контента в ленте не позднее чем за 7 дней до этой даты. Это повысит вероятность того, что контент перестанет отображаться в результатах поиска Google в указанную дату. |
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 | 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 см. в документации по требованиям к commonTier . |
Требования к API для управления правами доступа
API для управления правами доступа необходим, если actionAccessibilityRequirement.category имеет subscription или externalSubscription , и ваше предложение подписки включает несколько пакетов или уровней, или поддерживает дополнительные модули. Не следует включать его, если ваша подписка имеет один уровень и предоставляет доступ ко всему контенту в вашем каталоге.
- Компания А предлагает единую подписку, предоставляющую пользователям доступ ко всему доступному контенту: идентификатор права доступа / API не требуется.
- Компания B имеет базовую подписку, предоставляющую доступ к некоторому контенту, и премиум-подписку, предоставляющую доступ к премиум-контенту: требуется идентификатор права доступа / API.
- Компания C имеет базовую подписку, предоставляющую доступ к некоторому контенту, и дополнительные пакеты, предоставляющие доступ к контенту сторонних разработчиков: требуется идентификатор права доступа / API.
Страницы, посвященные подписке на медиаконтент
Для получения информации по соответствующим темам ознакомьтесь со следующими страницами:
Предлагаем недвижимость
| Свойство | Ожидаемый тип | Описание |
|---|---|---|
expectsAcceptanceOf.@type | Текст | Обязательно - Всегда устанавливайте значение Offer . |
expectsAcceptanceOf.price | Число | Обязательно — укажите цену покупки контента. Цена должна быть ненулевым положительным значением. Для объектов с ценой 0,00 укажите категорию «бесплатно». |
expectsAcceptanceOf.priceCurrency | Текст | Обязательно — валюта цены в 3-буквенном формате ISO 4217 . |
expectsAcceptanceOf.seller | Организация | Организация, предлагающая покупку контента. |
expectsAcceptanceOf.seller.@type | Текст | Всегда выбирайте Organization . |
expectsAcceptanceOf.seller.name | Текст | Имя продавца. |
expectsAcceptanceOf.seller.sameAs | Текст | URL веб-страницы, идентифицирующей продавца; например, домашняя страница продавца. |
Предложение на соответствующей странице
Для получения информации по соответствующим темам ознакомьтесь со следующими страницами:
Идентификаторы
В лентах Media Action принимаются различные идентификаторы, которые помогают однозначно идентифицировать объект. Эти идентификаторы могут ускорить процесс сопоставления контента в вашей ленте с контентом в базах данных Google. Хотя большинство этих идентификаторов можно добавить в ленту с помощью свойства identifier для различных типов объектов, у EIDR есть собственное свойство `representative`. Оба они рассматриваются ниже.
Свойства идентификатора
| Свойство | Ожидаемый тип | Описание |
|---|---|---|
identifier | Текст | Настоятельно рекомендуется — идентификатор, обычно внешний, который однозначно идентифицирует данную сущность. Допускается использование нескольких идентификаторов. Это свойство доступно для всех типов сущностей «Действия по наблюдению». В таблице ниже перечислены допустимые идентификаторы и под-свойства свойства identifier . См. пример идентификатора/EIDR в разделе примеров ленты действий при просмотре. |
| Свойство | Ожидаемый тип | Описание |
|---|---|---|
@type | Текст | Обязательно - Всегда устанавливайте PropertyValue . |
propertyID | Текст | Обязательно — мы поддерживаем следующие типы идентификаторов:
|
value | Текст | Обязательное поле — значение для указанной системы идентификаторов. |
Свойства EIDR
EIDR (сокращение от The Entertainment Identifier Registry) — это глобальная система уникальных идентификаторов для широкого спектра медиаконтента, включая кинофильмы и телепрограммы. Система идентификации сопоставляет идентификатор с записью метаданных, которая связана с заголовками верхнего уровня, правками и многим другим. В следующей таблице перечислены свойства, связанные с EIDR, и их использование.
| Свойство | Ожидаемый тип | Описание |
|---|---|---|
titleEIDR | Текст | Настоятельно рекомендуется — идентификатор EIDR (Entertainment Identifier Registry) на самом общем/абстрактном уровне обозначает произведение кино или телевидения. Этот объект доступен на страницах описания сущностей TVSeries , TVSeason , TVEpisode и Movie . Например, идентификатор titleEIDR для фильма «Охотники за привидениями» — «10.5240/7EC7-228A-510A-053E-CBB8-J». Пример использования идентификатора/EIDR см. в разделе примеров действий в ленте Watch Actions. |
editEIDR | Текст | Настоятельно рекомендуется — идентификатор EIDR (Entertainment Identifier Registry) обозначает конкретную редакцию/издание фильма или телесериала. Этот объект доступен на страницах описания сущностей 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".
| Страна | агентство по рейтингу телепрограмм | Агентство по рейтингу фильмов |
|---|---|---|
| Албания (АЛ) | Нет в наличии | Нет в наличии |
| Ангола (АО) | Нет в наличии | CCE |
| Антигуа и Барбуда (АГ) | Нет в наличии | MPAA |
| Аргентина (АР) | ИНКАА | ИНКАА |
| Армения (АМ) | Нет в наличии | МКРФ/РОССИЯ |
| Аруба (AW) | Нет в наличии | Нет в наличии |
| Австралия (AU) | ACB TV | Фильмы ACB |
| Австрия (AT) | ФСК | ФСК |
| Азербайджан (АЗ) | Нет в наличии | МКРФ/РОССИЯ |
| Бахрейн (БХ) | Нет в наличии | MPAA |
| Беларусь (BY) | Нет в наличии | МКРФ/РОССИЯ |
| Бельгия (BE) | Нет в наличии | MPAA |
| Белиз (BZ) | Нет в наличии | Нет в наличии |
| Бенин (БЖ) | Нет в наличии | ЧПУ |
| Боливия (БО) | Нет в наличии | MPAA |
| Босния и Герцеговина (БА) | Нет в наличии | MPAA |
| Ботсвана (БВ) | Нет в наличии | MPAA |
| Бразилия (BR) | КЛАССИНД | КЛАССИНД |
| Буркина-Фасо (БФ) | Нет в наличии | ЧПУ |
| Камбоджа (КГ) | Нет в наличии | Нет в наличии |
| Канада (CA) | CA_TV | ЧВРС |
| Кабо-Верде (CV) | Нет в наличии | CCE |
| Чили (CL) | Нет в наличии | MPAA |
| Колумбия (CO) | Нет в наличии | MPAA |
| Коста-Рика (CR) | Нет в наличии | MPAA |
| Хорватия (HR) | Нет в наличии | Нет в наличии |
| Кипр (CY) | Нет в наличии | ГРФИЛМ |
| Чехия (ЧЗ) | Нет в наличии | CZFILM |
| Дания (ДК) | Нет в наличии | MCCYP |
| Эквадор (ЕС) | Нет в наличии | MPAA |
| Египет (ЕГ) | Нет в наличии | MPAA |
| Сальвадор (SV) | Нет в наличии | MPAA |
| Эстония (Е) | Нет в наличии | EEFILM |
| Фиджи (FJ) | Нет в наличии | Нет в наличии |
| Финляндия (FI) | Нет в наличии | МЕКУ |
| Франция (FR) | CSA | CSA |
| Габон (ГА) | Нет в наличии | ЧПУ |
| Германия (DE) | ФСК | ФСК |
| Греция (GR) | ЭСР | ГРФИЛМ |
| Гватемала (ГТ) | Нет в наличии | MPAA |
| Гаити (HT) | Нет в наличии | Нет в наличии |
| Гондурас (HN) | Нет в наличии | MPAA |
| Гонконг (ГК) | Калифорния | ФКО |
| Венгрия (HU) | Нет в наличии | MPAA |
| Исландия (ИС) | Нет в наличии | КИКВАЙЗЕР |
| Индия (ИН) | ЦБФК | ЦБФК |
| Индонезия (ID) | KPI | ЛСФ |
| Ирландия (IE) | Нет в наличии | ИФКО |
| Италия (ИТ) | АГКОМ | АГКОМ |
| Кот-д'Ивуар (КИ) | Нет в наличии | ЧПУ |
| Ямайка (JM) | Нет в наличии | MPAA |
| Япония (JP) | НА | Эйрин |
| Джордан (JO) | Нет в наличии | MPAA |
| Казахстан (З) | Нет в наличии | МРКФ |
| Корея (KR) | КМРБ | КМРБ |
| Кувейт (КВ) | Нет в наличии | MPAA |
| Кыргызстан (КГ) | Нет в наличии | МКРФ/РОССИЯ |
| Лаос (ЛА) | Нет в наличии | Нет в наличии |
| Латвия (LV) | Нет в наличии | НККЛВ |
| Ливан (ЛБ) | Нет в наличии | MPAA |
| Литва (LT) | Нет в наличии | Нет в наличии |
| Люксембург (LU) | Нет в наличии | КИКВАЙЗЕР |
| Македония (МК) | Нет в наличии | MPAA |
| Малайзия (MY) | Нет в наличии | ФКБМ |
| Мали (ML) | Нет в наличии | ЧПУ |
| Мальта (MT) | Нет в наличии | MCCAA |
| Маврикий (МУ) | Нет в наличии | BBFC |
| Мексика (MX) | РТС | РТС |
| Молдова (MD) | Нет в наличии | Нет в наличии |
| Намибия (НА) | Нет в наличии | Нет в наличии |
| Непал (НП) | Нет в наличии | MPAA |
| Нидерланды (NL) | КИКВАЙЗЕР | КИКВАЙЗЕР |
| Новая Зеландия (НЗ) | БСА | ОФЛК |
| Никарагуа (NI) | Нет в наличии | MPAA |
| Нигер (северо-восток) | Нет в наличии | ЧПУ |
| Норвегия (NO) | Нет в наличии | MEDIETILSYNET |
| Оман (ОМ) | Нет в наличии | MPAA |
| Панама (ПА) | Нет в наличии | MPAA |
| Папуа-Новая Гвинея (ПГ) | Нет в наличии | MPAA |
| Парагвай (PY) | Нет в наличии | MPAA |
| Перу (PE) | Нет в наличии | MPAA |
| Филиппины (PH) | MTRCB | MTRCB |
| Польша (PL) | Нет в наличии | MPAA |
| Португалия (PT) | Нет в наличии | CCE |
| Катар (QA) | Нет в наличии | MPAA |
| Россия (РУ) | МКРФ/РОССИЯ | МКРФ/РОССИЯ |
| Руанда (RW) | Нет в наличии | ЧПУ |
| Саудовская Аравия (СА) | Нет в наличии | MPAA |
| Сенегал (SN) | Нет в наличии | MPAA |
| Сингапур (SG) | Нет в наличии | МДА |
| Словакия (СК) | Нет в наличии | MPAA |
| Словения (SI) | Нет в наличии | MPAA |
| Южная Африка (ЗА) | FPB | FPB |
| Испания (ES) | СЕТСИ | ИКАА |
| Шри-Ланка (ЛК) | Нет в наличии | Нет в наличии |
| Швеция (SE) | Нет в наличии | SMSA |
| Швейцария (CH) | ФСК | ФСК |
| Тайвань (TW) | Нет в наличии | МОКТВ |
| Таджикистан (ТДж) | Нет в наличии | МКРФ/РОССИЯ |
| Танзания (ТЗ) | Нет в наличии | MPAA |
| Таиланд (TH) | Нет в наличии | БФВС |
| Того (ТГ) | Нет в наличии | ЧПУ |
| Тринидад и Тобаго (ТТ) | Нет в наличии | Нет в наличии |
| Турция (ТР) | РТЮК | ЭКБМКТ |
| Туркменистан (ТМ) | Нет в наличии | МКРФ/РОССИЯ |
| Уганда (УГ) | Нет в наличии | MPAA |
| Украина (UA) | Нет в наличии | Нет в наличии |
| Объединенные Арабские Эмираты (АЭ) | Нет в наличии | MPAA |
| Соединенное Королевство (GB) | BBFC | BBFC |
| Соединенные Штаты (США) | ТВ_PG | MPAA |
| Уругвай (UY) | Нет в наличии | MPAA |
| Узбекистан (УЗ) | Нет в наличии | МКРФ/РОССИЯ |
| Венесуэла (ВЕ) | Нет в наличии | РЕЗОРТЕВИОЛЕНЦИЯ |
| Вьетнам (ВН) | Нет в наличии | МССТ |
| Замбия (ZM) | Нет в наличии | MPAA |
| Зимбабве (ЗВ) | Нет в наличии | MPAA |
Свойства GeoShape
Объект GeoShape содержит один из следующих типов данных:
- Список почтовых индексов (например, индексы США, Канады или других стран).
- Список канадских зон сортировки грузов.
- Идентификатор обозначенной рыночной зоны (DMA) — это идентификатор региона в Соединенных Штатах, где люди могут смотреть одни и те же телевизионные каналы и программы.
| Свойство | Ожидаемый тип | Описание |
|---|---|---|
@id | URL | Обязательно — идентификатор географического региона в формате URI. |
@type | Текст | Обязательно - Всегда устанавливайте значение GeoShape . |
addressCountry | Текст | Обязательно — двухбуквенный код страны ISO 3166-1 alpha-2 . |
postalCode | Текст | Необязательно — список одного или нескольких почтовых индексов и/или кодов FSA (зоны сортировки). |
identifier | Стоимость недвижимости | Необязательно — идентификатор обозначенной рыночной зоны (DMA ID) , который обозначает регион в Соединенных Штатах, где люди могут смотреть одни и те же телевизионные каналы и программы. |
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"
}
]
}