В этом разделе приведены сведения об общих свойствах действий наблюдения.
Свойства разметки действий
| Свойство | Ожидаемый тип | Описание | 
|---|---|---|
 @type | Текст |  Обязательно — всегда устанавливайте на WatchAction . | 
 target | Точка входа | Обязательно - целевой объект , обеспечивающий отображение глубоких ссылок на различные платформы Google. | 
 target.@type | Текст |  Обязательно — всегда устанавливайте EntryPoint . | 
 target.urlTemplate | URL | Обязательно — глубокая ссылка , которая перенаправляет пользователей в ваше приложение или платформу и инициирует воспроизведение контента. | 
 target.inLanguage | Текст | Необязательно - Исходный язык серии в формате BCP 47 . | 
 target.actionPlatform | Текст |  Обязательно — платформы, сопоставленные с urlTemplate . Действия с медиа поддерживают следующее:
  | 
 target.additionalProperty | PropertyValue |  Обязательно, если применимо . Список пар «свойство-значение», представляющих дополнительные свойства глубинной ссылки. Сюда может входить следующее:
  | 
 actionAccessibilityRequirement | ActionAccessSpecification | Требуется — объект спецификации доступа к действию , описывающий требования к доступу к содержимому. См. раздел «Свойства спецификации доступа к действию». | 
Страницы, связанные с разметкой действий
Ознакомьтесь со следующими страницами, посвященными темам, связанным с этими объектами недвижимости:
Свойства спецификации доступа к действию
| Свойство | Ожидаемый тип | Описание | 
|---|---|---|
 actionAccessibilityRequirement.@type | Текст |  Обязательно — всегда устанавливайте значение ActionAccessSpecification . | 
 actionAccessibilityRequirement.category | Текст | Требуется — требование доступа к контенту. Подробнее см. в разделе «Тип платного доступа» .  Если сущность представляет собой группу контента, необходимо задать   | 
 actionAccessibilityRequirement.availabilityStarts | Дата | Обязательно — дата, после которой действие станет доступно, в формате ISO 8601 (включая часовой пояс). 
 Соответствующий объект должен быть представлен в фиде как минимум за 7 дней до даты начала доступности. Это повысит вероятность своевременного появления контента в результатах поиска Google.  | 
 actionAccessibilityRequirement.availabilityEnds | Дата |  Обязательно — дата, после которой действие перестанет быть доступным, в формате ISO 8601 (включая часовой пояс).
 Любые обновления даты availableEnds в ленте должны быть сделаны не менее чем за 7 дней до неё. Это повысит вероятность того, что контент перестанет отображаться в результатах поиска Google в указанную дату.  | 
 actionAccessibilityRequirement.eligibleRegion | Страна , город , штат , геоформа или текст |  Обязательно — регионы, в которых доступен контент. Используйте специальную строку EARTH если контент доступен по всему миру. | 
 actionAccessibilityRequirement.ineligibleRegion | Страна , город , штат или геоформа |  Обязательно, если применимо — регионы, где контент ограничен. Это свойство не нужно указывать, если контент доступен везде в пределах eligibleRegion . | 
 actionAccessibilityRequirement.requiresSubscription | МедиаПодписка | Обязательно, если применимо . Сведения о подписке, необходимые пользователям для доступа к контенту. См. раздел «Свойства подписки на медиа» . 
  | 
 actionAccessibilityRequirement.expectsAcceptanceOf | Предложение |  Обязательно, если контент требует покупки . Подробности предложения, связанного с этим контентом. Укажите информацию о цене в следующих случаях:
 Offer и установите category free в объекте ActionAccessSpecification . См. раздел «Свойства Offer» . | 
 actionAccessibilityRequirement.additionalProperty | PropertyValue | Обязательно, если применимо — ссылка на пакет подписки, которая будет отображена в опыте. | 
 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 читайте в документации по требованиям Common Tier . | 
Требования к API прав доступа
 API для управления правами требуется, если actionAccessibilityRequirement.category — это subscription или externalSubscription , а ваша подписка включает несколько пакетов или уровней или поддерживает дополнения. Не включайте его, если ваша подписка одноуровневая и предоставляет доступ ко всему контенту в каталоге.
- Компания A предлагает единую подписку, которая предоставляет подписчикам доступ ко всему доступному контенту: идентификатор прав доступа/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 есть собственное репрезентативное свойство. Оба эти свойства обсуждаются ниже.
Свойства идентификатора
| Свойство | Ожидаемый тип | Описание | 
|---|---|---|
 identifier | Текст |  Настоятельно рекомендуется — идентификатор, обычно внешний, однозначно идентифицирующий данную сущность. Допускается несколько идентификаторов. Это свойство доступно для всех типов сущностей Watch Action. В таблице ниже перечислены допустимые идентификаторы и подсвойства свойства identifier . См. пример идентификатора/EIDR в разделе «Примеры фидов Watch Actions». | 
| Свойство | Ожидаемый тип | Описание | 
|---|---|---|
 @type | Текст |  Обязательно — всегда устанавливайте значение PropertyValue . | 
 propertyID | Текст |  Обязательно . Мы поддерживаем следующие типы идентификаторов:
  | 
 value | Текст | Обязательно - значение для указанной системы идентификаторов. | 
Свойства EIDR
EIDR (сокращение от The Entertainment Identifier Registry) — это глобальная система уникальных идентификаторов для широкого спектра медиаконтента, включая фильмы и телепрограммы. Система идентификации сопоставляет идентификатор с записью метаданных, связанной с заголовками верхнего уровня, редакциями и другими элементами. В следующей таблице перечислены свойства, связанные с EIDR, и их использование.
| Свойство | Ожидаемый тип | Описание | 
|---|---|---|
 titleEIDR | Текст |  Настоятельно рекомендуется . Идентификатор EIDR (Реестр идентификаторов развлечений) представляет собой на самом общем/абстрактном уровне произведение кино или телевидения. Это свойство доступно на страницах спецификации сущностей TVSeries , TVSeason , TVEpisode и Movie . Например, titleEIDR для фильма «Охотники за привидениями» — «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) | Нет в наличии | Нет в наличии | 
| Ангола (АО) | Нет в наличии | CCE | 
| Антигуа и Барбуда (AG) | Нет в наличии | MPAA | 
| Аргентина (AR) | ИНКАА | ИНКАА | 
| Армения (АМ) | Нет в наличии | МКРФ/РОССИЯ | 
| Аруба (AW) | Нет в наличии | Нет в наличии | 
| Австралия (AU) | ACB ТВ | Фильмы ACB | 
| Австрия (AT) | ФСК | ФСК | 
| Азербайджан (AZ) | Нет в наличии | МКРФ/РОССИЯ | 
| Бахрейн (BH) | Нет в наличии | MPAA | 
| Беларусь (BY) | Нет в наличии | МКРФ/РОССИЯ | 
| Бельгия (BE) | Нет в наличии | MPAA | 
| Белиз (BZ) | Нет в наличии | Нет в наличии | 
| Бенин (BJ) | Нет в наличии | ЧПУ | 
| Боливия (БО) | Нет в наличии | MPAA | 
| Босния и Герцеговина (БА) | Нет в наличии | MPAA | 
| Ботсвана (BW) | Нет в наличии | MPAA | 
| Бразилия (BR) | КЛАССИНД | КЛАССИНД | 
| Буркина-Фасо (БФ) | Нет в наличии | ЧПУ | 
| Камбоджа (КХ) | Нет в наличии | Нет в наличии | 
| Канада (Калифорния) | CA_TV | ЧВРС | 
| Кабо-Верде (CV) | Нет в наличии | CCE | 
| Чили (CL) | Нет в наличии | MPAA | 
| Колумбия (CO) | Нет в наличии | MPAA | 
| Коста-Рика (CR) | Нет в наличии | MPAA | 
| Хорватия (HR) | Нет в наличии | Нет в наличии | 
| Кипр (CY) | Нет в наличии | ГРФИЛЬМ | 
| Чехия (CZ) | Нет в наличии | CZFILM | 
| Дания (DK) | Нет в наличии | MCCYP | 
| Эквадор (ЕС) | Нет в наличии | MPAA | 
| Египет (EG) | Нет в наличии | MPAA | 
| Сальвадор (SV) | Нет в наличии | MPAA | 
| Эстония (EE) | Нет в наличии | EEFILM | 
| Фиджи (ФДж) | Нет в наличии | Нет в наличии | 
| Финляндия (FI) | Нет в наличии | МЕКУ | 
| Франция (FR) | CSA | CSA | 
| Габон (GA) | Нет в наличии | ЧПУ | 
| Германия (DE) | ФСК | ФСК | 
| Греция (GR) | СОЭ | ГРФИЛЬМ | 
| Гватемала (GT) | Нет в наличии | MPAA | 
| Гаити (HT) | Нет в наличии | Нет в наличии | 
| Гондурас (HN) | Нет в наличии | MPAA | 
| Гонконг (HK) | Калифорния | МИД | 
| Венгрия (HU) | Нет в наличии | MPAA | 
| Исландия (ИС) | Нет в наличии | КИЙКВИЙЗЕР | 
| Индия (IN) | CBFC | CBFC | 
| Индонезия (ID) | КПЭ | ЛСФ | 
| Ирландия (IE) | Нет в наличии | ИФКО | 
| Италия (IT) | АГКОМ | АГКОМ | 
| Кот-д'Ивуар (CI) | Нет в наличии | ЧПУ | 
| Ямайка (JM) | Нет в наличии | MPAA | 
| Япония (JP) | NA | ЭЙРИН | 
| Джордан (JO) | Нет в наличии | MPAA | 
| Казахстан (КЗ) | Нет в наличии | МРКФ | 
| Корея (КР) | КМРБ | КМРБ | 
| Кувейт (KW) | Нет в наличии | MPAA | 
| Кыргызстан (КГ) | Нет в наличии | МКРФ/РОССИЯ | 
| Лаос (LA) | Нет в наличии | Нет в наличии | 
| Латвия (LV) | Нет в наличии | НКЛВ | 
| Ливан (LB) | Нет в наличии | MPAA | 
| Литва (LT) | Нет в наличии | Нет в наличии | 
| Люксембург (LU) | Нет в наличии | КИЙКВИЙЗЕР | 
| Македония (МК) | Нет в наличии | MPAA | 
| Малайзия (MY) | Нет в наличии | FCBM | 
| Мали (ML) | Нет в наличии | ЧПУ | 
| Мальта (MT) | Нет в наличии | MCCAA | 
| Маврикий (MU) | Нет в наличии | ББФК | 
| Мексика (MX) | РТК | РТК | 
| Молдова (MD) | Нет в наличии | Нет в наличии | 
| Намибия (NA) | Нет в наличии | Нет в наличии | 
| Непал (НП) | Нет в наличии | MPAA | 
| Нидерланды (NL) | КИЙКВИЙЗЕР | КИЙКВИЙЗЕР | 
| Новая Зеландия (НЗ) | БСА | OFLC | 
| Никарагуа (NI) | Нет в наличии | MPAA | 
| Нигер (NE) | Нет в наличии | ЧПУ | 
| Норвегия (NO) | Нет в наличии | MEDIETILSYNET | 
| Оман (OM) | Нет в наличии | MPAA | 
| Панама (PA) | Нет в наличии | MPAA | 
| Папуа-Новая Гвинея (ПГ) | Нет в наличии | MPAA | 
| Парагвай (PY) | Нет в наличии | MPAA | 
| Перу (PE) | Нет в наличии | MPAA | 
| Филиппины (PH) | МТРКБ | МТРКБ | 
| Польша (PL) | Нет в наличии | MPAA | 
| Португалия (PT) | Нет в наличии | CCE | 
| Катар (QA) | Нет в наличии | MPAA | 
| Россия (RU) | МКРФ/РОССИЯ | МКРФ/РОССИЯ | 
| Руанда (RW) | Нет в наличии | ЧПУ | 
| Саудовская Аравия (СА) | Нет в наличии | MPAA | 
| Сенегал (SN) | Нет в наличии | MPAA | 
| Сингапур (SG) | Нет в наличии | МДА | 
| Словакия (SK) | Нет в наличии | MPAA | 
| Словения (SI) | Нет в наличии | MPAA | 
| Южная Африка (ЗА) | ФПБ | ФПБ | 
| Испания (ES) | СЕТИ | ИКАА | 
| Шри-Ланка (ЛК) | Нет в наличии | Нет в наличии | 
| Швеция (SE) | Нет в наличии | СМСА | 
| Швейцария (CH) | ФСК | ФСК | 
| Тайвань (TW) | Нет в наличии | MOCTW | 
| Таджикистан (TJ) | Нет в наличии | МКРФ/РОССИЯ | 
| Танзания (TZ) | Нет в наличии | MPAA | 
| Таиланд (TH) | Нет в наличии | БФВК | 
| Того (TG) | Нет в наличии | ЧПУ | 
| Тринидад и Тобаго (TT) | Нет в наличии | Нет в наличии | 
| Турция (TR) | РТЮК | ECBMCT | 
| Туркменистан (ТМ) | Нет в наличии | МКРФ/РОССИЯ | 
| Уганда (UG) | Нет в наличии | MPAA | 
| Украина (UA) | Нет в наличии | Нет в наличии | 
| Объединенные Арабские Эмираты (АЭ) | Нет в наличии | MPAA | 
| Соединенное Королевство (GB) | ББФК | ББФК | 
| Соединенные Штаты (США) | TV_PG | MPAA | 
| Уругвай (UY) | Нет в наличии | MPAA | 
| Узбекистан (UZ) | Нет в наличии | МКРФ/РОССИЯ | 
| Венесуэла (VE) | Нет в наличии | RESORTEVIOLENCIA | 
| Вьетнам (VN) | Нет в наличии | МЦСТ | 
| Замбия (ЗМ) | Нет в наличии | MPAA | 
| Зимбабве (ZW) | Нет в наличии | MPAA | 
Свойства GeoShape
Объект GeoShape содержит один из следующих типов данных:
- Список почтовых индексов (например, США, Канады или других почтовых индексов)
 - Список канадских передовых сортировочных зон
 - Идентификатор выделенной рыночной зоны (DMA) — идентификатор региона в Соединенных Штатах, где люди смотрят одни и те же телевизионные каналы и программы.
 
| Свойство | Ожидаемый тип | Описание | 
|---|---|---|
 @id | URL | Обязательно - идентификатор георегиона в формате URI. | 
 @type | Текст |  Обязательно — всегда устанавливайте значение GeoShape . | 
 addressCountry | Текст | Обязательно - двухбуквенный код страны ISO 3166-1 alpha-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"
    }
  ]
}