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

В этом разделе представлена ​​подробная информация об общих свойствах Watch Actions.

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

Свойство Ожидаемый тип Описание
@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 : платформы поиска и 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 (только действия прослушивания).
Требования см. в разделе «Типы платформ» .
target.additionalProperty Стоимость имущества Обязательно, если применимо . Список пар свойство-значение для представления дополнительных свойств глубокой ссылки. Это может включать следующее:
  • contentLanguage : язык вещания (дубляж) в формате BCP 47 . Если контент дублирован на другом языке, это свойство является обязательным. Используйте массив для кодов нескольких языков.
  • subtitleLanguage : языки субтитров или подписей в формате BCP 47 . Используйте массив для кодов нескольких языков.
  • cameraAngle : угол камеры для контента; например, «На уровне глаз» и «Высокий угол». Если контент доступен под разными углами камеры, это свойство является обязательным. Используйте массив для нескольких ракурсов камеры.
  • videoFormat : формат файла, используемый для хранения даты цифрового видео; например, «SD» для стандартной четкости и «HD» для высокой четкости. Допустимые форматы видео: SD, HD, 2K, 4K и 8K. Используйте массив для нескольких видеоформатов.
См. пример дополнительного свойства .
actionAccessibilityRequirement Спецификация ActionAccess Обязательно — объект спецификации доступа к действию , который описывает требования к доступу к содержимому. См. Свойства спецификации доступа к действию.

На следующих страницах вы найдете темы, связанные с этими свойствами:

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

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

Обязательно — требование доступа к содержимому. Дополнительную информацию см. в разделе Тип платного доступа .

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

actionAccessibilityRequirement.availabilityStarts Дата

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

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

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

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

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

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

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

  • Укажите это свойство, если category — это subscription или externalSubscription .
actionAccessibilityRequirement.expectsAcceptanceOf Предложение Обязательно, если контент требует покупки — сведения о предложении, связанном с контентом. Предоставьте информацию о цене для следующих случаев:
  • Контент для единоразовой покупки ( rental или purchase )
  • Контент на основе подписки, требующий дополнительной покупки от подписчиков ( subscription или externalsubscription ).
Если цена равна 0,00, полностью удалите объект Offer и установите category объекта ActionAccessSpecification значение free . См. Свойства предложения .

Свойства медиа-подписки

Требуется, если actionAccessibilityRequirement.category — это subscription или externalSubscription .

Свойство Ожидаемый тип Описание
requiresSubscription.@type Текст Обязательно — всегда установлено значение MediaSubscription
requiresSubscription.@id URL-адрес Обязательно — уникальный идентификатор подписки. Если контент доступен через разные подписки, каждая подписка должна иметь уникальный идентификатор.
requiresSubscription.name Текст Обязательно — название подписки. Обратите внимание на следующее:
  • Если контент доступен по разным подпискам, это имя должно совпадать с именем в вашей системе аутентификации пользователей. Например, если пользователь может получить доступ к контенту на основе подписки под названием «Пакет 1» , но система аутентификации использует имя PKG1a , используйте PKG1 .
  • Для провайдеров TVE это имя аутентификатора, зарегистрированное в вашем аутентификаторе TVE. Это строка, которая уникальным образом идентифицирует имя вашей службы с помощью аутентификатора TVE.
requiresSubscription.sameAs URL-адрес Страница с описанием подписки.
requiresSubscription.identifier Текст Требуется, если category — это subscription И commonTier имеет значение false — уникальная строка для этой подписки, которая представляет доступ к группе контента в вашем медиа-каталоге.
  • Google рекомендует использовать следующий синтаксис идентификатора:
    имя домена + двоеточие (:) + уровень доступа к контенту . Примеры: example.com:basic, example.com:premium, example.com:sports.
  • Это свойство будет таким же, как ваш идентификатор права , если вы предоставляете API прав.
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 не требуется.
  • У компании Б есть базовая подписка, предоставляющая доступ к некоторому контенту, и премиум-подписка, предоставляющая доступ к премиум-контенту: требуется идентификатор разрешения / 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 Текст Обязательно – мы поддерживаем следующие типы идентификаторов:
  • TMS_ROOT_ID : корневой идентификатор Gracenote (TMS) (например, 15829 ).
    • . Это неприменимо к объектам Organization и 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 (сокращение от 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/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 «TVPG TV-MA».

Страна Телерейтинговое агентство Рейтинговое агентство фильмов
Албания (AL) Нет в наличии Нет в наличии
Ангола (АО) Нет в наличии CCE
Антигуа и Барбуда (AG) Нет в наличии МПАА
Аргентина (АР) ИНКАА ИНКАА
Армения (AM) Нет в наличии МКРФ/РОССИЯ
Аруба (AW) Нет в наличии Нет в наличии
Австралия (Австралия) АСБ ТВ Фильмы ACB
Австрия (Австрия) ФСК ФСК
Азербайджан (AZ) Нет в наличии МКРФ/РОССИЯ
Бахрейн (БГ) Нет в наличии МПАА
Беларусь (BY) Нет в наличии МКРФ/РОССИЯ
Бельгия (BE) Нет в наличии МПАА
Белиз (БЗ) Нет в наличии Нет в наличии
Бенин (БЖ) Нет в наличии ЧПУ
Боливия (BO) Нет в наличии МПАА
Босния и Герцеговина (BA) Нет в наличии МПАА
Ботсвана (BW) Нет в наличии МПАА
Бразилия (БР) КЛАССИНД КЛАССИНД
Буркина-Фасо (BF) Нет в наличии ЧПУ
Камбоджа (KH) Нет в наличии Нет в наличии
Канада (Калифорния) CA_TV ЧВРС
Кабо-Верде (CV) Нет в наличии CCE
Чили (CL) Нет в наличии МПАА
Колумбия (Колорадо) Нет в наличии МПАА
Коста-Рика (CR) Нет в наличии МПАА
Хорватия (HR) Нет в наличии Нет в наличии
Кипр (CY) Нет в наличии ГРФИЛЬМ
Чехия (CZ) Нет в наличии CZFILM
Дания (ДК) Нет в наличии MCCYP
Эквадор (ЕС) Нет в наличии МПАА
Египет (EG) Нет в наличии МПАА
Сальвадор (SV) Нет в наличии МПАА
Эстония (EE) Нет в наличии ЭФИЛЬМ
Фиджи (ФДж) Нет в наличии Нет в наличии
Финляндия (FI) Нет в наличии МЕКУ
Франция (FR) CSA CSA
Габон (Джорджия) Нет в наличии ЧПУ
Германия (DE) ФСК ФСК
Греция (GR) СОЭ ГРФИЛЬМ
Гватемала (GT) Нет в наличии МПАА
Гаити (HT) Нет в наличии Нет в наличии
Гондурас (HN) Нет в наличии МПАА
Гонконг (Гонконг) Калифорния МИД
Венгрия (HU) Нет в наличии МПАА
Исландия (ИС) Нет в наличии КЕЙКВИДЖЕР
Индия (Индия) CBFC CBFC
Индонезия (ID) КПЭ ЛСФ
Ирландия (IE) Нет в наличии ИФКО
Италия (ИТ) АГКОМ АГКОМ
Кот-д'Ивуар (CI) Нет в наличии ЧПУ
Ямайка (JM) Нет в наличии МПАА
Япония (Япония) NA ЭЙРИН
Джордан (JO) Нет в наличии МПАА
Казахстан (KZ) Нет в наличии МРКФ
Корея (КР) КМРБ КМРБ
Кувейт (КВТ) Нет в наличии МПАА
Кыргызстан (КГ) Нет в наличии МКРФ/РОССИЯ
Лаос (Лос-Анджелес) Нет в наличии Нет в наличии
Латвия (LV) Нет в наличии НККЛВ
Ливан (LB) Нет в наличии МПАА
Литва (LT) Нет в наличии Нет в наличии
Люксембург (LU) Нет в наличии КЕЙКВИДЖЕР
Македония (МК) Нет в наличии МПАА
Малайзия (МОЙ) Нет в наличии ФКБМ
Мали (ML) Нет в наличии ЧПУ
Мальта (MT) Нет в наличии МССАА
Маврикий (МЮ) Нет в наличии ББФК
Мексика (MX) РТК РТК
Молдова (MD) Нет в наличии Нет в наличии
Намибия (NA) Нет в наличии Нет в наличии
Непал (NP) Нет в наличии МПАА
Нидерланды (NL) КЕЙКВИДЖЕР КЕЙКВИДЖЕР
Новая Зеландия (НЗ) БСА ОФЛК
Никарагуа (Нью-Йорк) Нет в наличии МПАА
Нигер (NE) Нет в наличии ЧПУ
Норвегия (НЕТ) Нет в наличии МЕДИЕТИЛСИНЕТ
Оман (OM) Нет в наличии МПАА
Панама (Пенсильвания) Нет в наличии МПАА
Папуа-Новая Гвинея (PG) Нет в наличии МПАА
Парагвай (ПЮ) Нет в наличии МПАА
Перу (PE) Нет в наличии МПАА
Филиппины (PH) МТРКБ МТРКБ
Польша (PL) Нет в наличии МПАА
Португалия (ПТ) Нет в наличии CCE
Катар (КК) Нет в наличии МПАА
Россия (RU) МКРФ/РОССИЯ МКРФ/РОССИЯ
Руанда (RW) Нет в наличии ЧПУ
Саудовская Аравия (СА) Нет в наличии МПАА
Сенегал (SN) Нет в наличии МПАА
Сингапур (SG) Нет в наличии МДА
Словакия (СК) Нет в наличии МПАА
Словения (SI) Нет в наличии МПАА
Южная Африка (ZA) ФПБ ФПБ
Испания (ES) СЭЦИ ИКАА
Шри-Ланка (ЛК) Нет в наличии Нет в наличии
Швеция (ЮВ) Нет в наличии СМСА
Швейцария (CH) ФСК ФСК
Тайвань (TW) Нет в наличии MOCTW
Таджикистан (ТДж) Нет в наличии МКРФ/РОССИЯ
Танзания (ТЗ) Нет в наличии МПАА
Таиланд (TH) Нет в наличии БФВК
Того (TG) Нет в наличии ЧПУ
Тринидад и Тобаго (TT) Нет в наличии Нет в наличии
Турция (ТР) РТЮК ECBMCT
Туркменистан (ТМ) Нет в наличии МКРФ/РОССИЯ
Уганда (UG) Нет в наличии МПАА
Украина (UA) Нет в наличии Нет в наличии
Объединенные Арабские Эмираты (AE) Нет в наличии МПАА
Великобритания (Великобритания) ББФК ББФК
Соединенные Штаты (США) ТВ_ПГ МПАА
Уругвай (UY) Нет в наличии МПАА
Узбекистан (УЗ) Нет в наличии МКРФ/РОССИЯ
Венесуэла (VE) Нет в наличии КУРОРТВИОЛЕНЦИЯ
Вьетнам (ВН) Нет в наличии МЦСТ
Замбия (ZM) Нет в наличии МПАА
Зимбабве (ZW) Нет в наличии МПАА

Свойства геоформы

Объект GeoShape содержит один из следующих типов данных:

Свойство Ожидаемый тип Описание
@id URL-адрес Обязательно — идентификатор географического региона в формате URI.
@type Текст Обязательно — всегда установлено значение GeoShape .
addressCountry Текст Обязательно — двухбуквенный код страны ISO 3166-1 альфа-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"
    }
  ]
}