Просмотр общих свойств действий

В этом разделе приведены сведения об общих свойствах действий наблюдения.

Свойства разметки действий

Свойство Ожидаемый тип Описание
@type Текст Обязательно — всегда устанавливайте на WatchAction .
target Точка входа Обязательно - целевой объект , обеспечивающий отображение глубоких ссылок на различные платформы Google.
target.@type Текст Обязательно — всегда устанавливайте EntryPoint .
target.urlTemplate URL Обязательноглубокая ссылка , которая перенаправляет пользователей в ваше приложение или платформу и инициирует воспроизведение контента.
target.inLanguage Текст Необязательно - Исходный язык серии в формате BCP 47 .
target.actionPlatform Текст Обязательно — платформы, сопоставленные с urlTemplate . Действия с медиа поддерживают следующее:
  • http://schema.org/DesktopWebPlatform : Поисковая платформа для настольных веб-браузеров.
  • http://schema.org/MobileWebPlatform : Поисковая платформа для мобильных веб-браузеров.
  • http://schema.org/AndroidPlatform : платформы Search и PlayGuide в приложении Android.
  • http://schema.org/AndroidTVPlatform : Платформа Android TV в приложении Android TV.
  • http://schema.org/IOSPlatform : Поисковая платформа в приложении iOS.
  • http://schema.googleapis.com/GoogleVideoCast : платформы Cast и Home на устройстве Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast : платформы Cast и Home на устройстве Chromecast (только действия Listen).
Требования см. в разделе «Типы платформ» .
target.additionalProperty PropertyValue Обязательно, если применимо . Список пар «свойство-значение», представляющих дополнительные свойства глубинной ссылки. Сюда может входить следующее:
  • contentLanguage : Язык вещания (дублированный) в формате BCP 47. Если контент дублирован на другом языке, это свойство обязательно. Для кодов нескольких языков используйте массив.
  • subtitleLanguage : языки субтитров или титров в формате BCP 47. Для кодов нескольких языков используйте массив.
  • cameraAngle : Угол обзора камеры для контента; например, «Уровень глаз» и «Верхний угол». Если контент доступен с разных ракурсов, это свойство обязательно. Для нескольких ракурсов используйте массив.
  • videoFormat : формат файла, используемый для хранения данных цифрового видео; например, «SD» для стандартного разрешения и «HD» для высокого разрешения. Допустимые видеоформаты: SD, HD, 2K, 4K и 8K. Для хранения нескольких видеоформатов используйте массив.
  • audioDescriptionLanguage : массив поддерживаемых языков аудио в формате BCP 47 , поддерживающих Audio Description . Это подмножество массива contentLanguage .
См. пример additionalProperty .
actionAccessibilityRequirement ActionAccessSpecification Требуетсяобъект спецификации доступа к действию , описывающий требования к доступу к содержимому. См. раздел «Свойства спецификации доступа к действию».

Ознакомьтесь со следующими страницами, посвященными темам, связанным с этими объектами недвижимости:

Свойства спецификации доступа к действию

Свойство Ожидаемый тип Описание
actionAccessibilityRequirement.@type Текст Обязательно — всегда устанавливайте значение ActionAccessSpecification .
actionAccessibilityRequirement.category Текст

Требуется — требование доступа к контенту. Подробнее см. в разделе «Тип платного доступа» .

Если сущность представляет собой группу контента, необходимо задать category , соответствующую наименее ограничивающим требованиям к доступу к этому контенту. Например, если для некоторых TVEpisode TVSeries установлено значение nologinrequired , а для некоторых — значение subscription , установите для этого TVSeries значение nologinrequired .

actionAccessibilityRequirement.availabilityStarts Дата

Обязательно — дата, после которой действие станет доступно, в формате ISO 8601 (включая часовой пояс).

  • Дату можно установить в будущем.

Соответствующий объект должен быть представлен в фиде как минимум за 7 дней до даты начала доступности. Это повысит вероятность своевременного появления контента в результатах поиска Google.

actionAccessibilityRequirement.availabilityEnds Дата Обязательно — дата, после которой действие перестанет быть доступным, в формате ISO 8601 (включая часовой пояс).
  • Должно быть равно или больше 72 часов после availabilityStarts .
  • Если контент всегда доступен после публикации, установите эту дату на 20 лет с текущей даты.

Любые обновления даты availableEnds в ленте должны быть сделаны не менее чем за 7 дней до неё. Это повысит вероятность того, что контент перестанет отображаться в результатах поиска Google в указанную дату.

actionAccessibilityRequirement.eligibleRegion Страна , город , штат , геоформа или текст Обязательно — регионы, в которых доступен контент. Используйте специальную строку EARTH если контент доступен по всему миру.
actionAccessibilityRequirement.ineligibleRegion Страна , город , штат или геоформа Обязательно, если применимо — регионы, где контент ограничен. Это свойство не нужно указывать, если контент доступен везде в пределах eligibleRegion .
actionAccessibilityRequirement.requiresSubscription МедиаПодписка

Обязательно, если применимо . Сведения о подписке, необходимые пользователям для доступа к контенту. См. раздел «Свойства подписки на медиа» .

  • Укажите это свойство, если categorysubscription или externalSubscription .
actionAccessibilityRequirement.expectsAcceptanceOf Предложение Обязательно, если контент требует покупки . Подробности предложения, связанного с этим контентом. Укажите информацию о цене в следующих случаях:
  • Разовая покупка контента ( rental или purchase )
  • Контент, доступный по подписке и требующий дополнительной покупки от подписчиков ( subscription или externalsubscription )
Если цена равна 0,00, полностью удалите объект 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 Текст Обязательно — название подписки. Обратите внимание на следующее:
  • Если контент доступен по разным подпискам, это имя должно совпадать с именем в вашей системе аутентификации пользователей. Например, если пользователь может получить доступ к контенту по подписке с названием Package 1 , но система аутентификации использует имя PKG1a , используйте PKG1 .
  • Для поставщиков услуг TVE это имя аутентификатора, зарегистрированное в вашем аутентификаторе TVE. Это строка, которая уникально идентифицирует имя вашей услуги в аутентификаторе TVE.
  • Если у подписки несколько имён, укажите их в виде массива значений. См. следующий пример , как добавить массив имён с несколькими переводами.
requiresSubscription.sameAs URL Страница с описанием подписки.
requiresSubscription.identifier Текст Обязательно, если categorysubscription И commonTierfalse — уникальная строка для этой подписки, которая представляет доступ к группе контента в вашем каталоге мультимедиа.
  • Google рекомендует использовать следующий синтаксис для идентификатора:
    доменное имя + двоеточие (:) + уровень доступа к контенту , примеры: example.com:basic, example.com:premium, example.com:sports
  • Это свойство будет совпадать с вашим идентификатором прав, если вы предоставляете API прав.
requiresSubscription.authenticator Организация Обязательно, если categoryexternalsubscription — контейнер, содержащий сведения об аутентификаторе внешнего поставщика.
requiresSubscription.authenticator.@type Текст Обязательно, если categoryexternalsubscription . Всегда установлено значение Organization .
requiresSubscription.authenticator.name Текст Обязательно, если categoryexternalsubscription — название службы аутентификации. Для поставщиков услуг 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 Текст Обязательно . Мы поддерживаем следующие типы идентификаторов:
  • TMS_ROOT_ID : корневой идентификатор Gracenote (TMS) (например, 15829 ).
  • . Это неприменимо к сущностям «Организация» и «BroadcastService», где следует использовать только TMS_ID.
  • TMS_ID : идентификатор варианта Gracenote (TMS) (например, MV000398520000 ).
  • WIKIDATA_ID : идентификатор WikiData (например, Q134773 ).
  • IMDB_ID : идентификатор IMDB (например, tt0109830 ).
  • OPTA_ID : спортивный идентификатор OPTA.
  • STATS_ID : Идентификатор выполнения STATS.
  • VIP_TIMES_ID : идентификатор Japan VIPTimes (Nihon Tarento Meikan) для японских талантов.
  • DMA_ID : код обозначенной маркетинговой зоны США, используемый в объекте GeoShape.
  • _PARTNER_ID_ : это свойство должно содержать строку «_PARTNER_ID_», значение должно быть уникальным идентификатором, который используется поставщиком услуг, внутри компании или за ее пределами, для идентификации объекта (например, 12345 или a5c604e2-e9e5-4ff3-b728-245799dc37f1 ).
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 содержит один из следующих типов данных:

Свойство Ожидаемый тип Описание
@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"
    }
  ]
}