WatchAction

Тип schema.org ^?

Thing > Action > ConsumeAction > WatchAction

Канонический URL: https://schema.org/WatchAction
👉 Проверить на наличие открытых проблем.

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

Описание:

Акт потребления динамического/движущегося визуального контента.

WatchAction — это тип действия в структуре Schema.org, который используется для обозначения акта просмотра динамического или движущегося визуального контента, такого как видео или фильмы. Этот тип действия помогает поисковым системам и другим платформам лучше понимать, что именно происходит на веб-странице, где он применяется.

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

Использование WatchAction позволяет владельцам сайтов структурировать информацию о контенте, что помогает алгоритмам анализировать и индексировать его более эффективно. Это также может способствовать улучшению пользовательского опыта, так как пользователи могут быстрее находить интересующий их контент.

Таким образом, WatchAction является важным инструментом для оптимизации контента, связанного с видео и другими визуальными медиа, делая его более доступным и понятным для автоматизированных систем и пользователей.

Свойство	Ожидаемый тип	Описание
Свойство из ConsumeAction
actionAccessibilityRequirement	ActionAccessSpecification	Набор требований, которые должны быть выполнены для выполнения действия. Если указано более одного значения, выполнение одного набора требований позволит выполнить действие.
expectsAcceptanceOf	Offer	Предложение, которое должно быть принято, прежде чем пользователь сможет выполнить действие. Например, пользователю может потребоваться купить фильм, прежде чем он сможет его посмотреть.
Свойство из Action
actionStatus	ActionStatusType	Указывает текущее состояние Действия.
agent	Organization, Person	Непосредственный исполнитель или движущая сила действия (живое или неживое). Например, Джон написал книгу.
endTime	DateTime, Time	Время окончания чего-либо. Для зарезервированного события или услуги (например, FoodEstablishmentReservation) — время, когда ожидается его завершение. Для действий, которые занимают определенный период времени, это время выполнения действия. Например, Джон писал книгу с января по декабрь. Для медиа, включая аудио и видео, это временной смещение конца клипа в рамках более крупного файла. Обратите внимание, что событие использует startDate/endDate вместо startTime/endTime, даже когда описываются даты с указанием времени. Эта ситуация может быть уточнена в будущих редакциях.
error	Thing	Для неудачных действий, дополнительная информация о причине неудачи.
instrument	Thing	Объект, который помог агенту выполнить действие. Например, Джон написал книгу с помощью ручки.
location	VirtualLocation, Text, PostalAddress, Place	Место, например, где проходит событие, где расположена организация или где происходит действие.
object	Thing	Объект, над которым выполняется действие, состояние которого остается неизменным или изменяется. Также известен как семантические роли пациент, затронутый или подвергающийся (которые изменяют свое состояние) или тема (которая не изменяет своего состояния). Например, Джон прочитал книгу.
participant	Organization, Person	Другие соучастники, которые косвенно участвовали в действии. Например, Джон написал книгу с Стивом.
provider	Organization, Person	Поставщик услуг, оператор услуг или исполнитель услуг; производитель товаров. Другая сторона (продавец) может предлагать эти услуги или товары от имени поставщика. Поставщик также может выступать в качестве продавца.
result	Thing	Результат, полученный в результате действия. Например, Джон написал книгу.
startTime	DateTime, Time	Время начала чего-либо. Для зарезервированного события или услуги (например, FoodEstablishmentReservation) это время, когда ожидается его начало. Для действий, которые занимают определенный период времени, это время, когда действие было выполнено. Например, Джон писал книгу с января по декабрь. Для медиа, включая аудио и видео, это временной смещение начала клипа в рамках большего файла. Обратите внимание, что событие использует startDate/endDate вместо startTime/endTime, даже при описании дат с указанием времени. Эта ситуация может быть уточнена в будущих редакциях.
target	EntryPoint, URL	Указывает целевую точку входа (EntryPoint) или URL для действия (Action).
Свойство из Thing
additionalType	URL, Text	Дополнительный тип для элемента, обычно используемый для добавления более специфичных типов из внешних словарей в синтаксисе микроданных. Это отношение между чем-то и классом, к которому это что-то относится. Обычно значение является URI-идентифицированным классом RDF, и в этом случае соответствует использованию rdf:type в RDF. Текстовые значения могут использоваться экономно, в случаях, когда полезная информация может быть добавлена без наличия соответствующей схемы для ссылки. В случае текстовых значений, метка класса должна следовать руководству по стилю schema.org.
alternateName	Text	Псевдоним для элемента.
description	Text, TextObject	Описание предмета.
disambiguatingDescription	Text	Субсвойство описания. Краткое описание элемента, используемое для различения его от других, похожих элементов. Информация из других свойств (в частности, имени) может быть необходима для того, чтобы описание было полезным для различения.
identifier	PropertyValue, Text, URL	Свойство identifier представляет собой любой вид идентификатора для любого рода Thing, такого как ISBN, коды GTIN, UUID и т.д. Schema.org предоставляет специальные свойства для представления многих из них, как в виде текстовых строк, так и в виде ссылок URL (URI). См. фоновую информацию для получения дополнительных деталей.
image	ImageObject, URL	Изображение предмета. Это может быть URL или полностью описанный ImageObject.
mainEntityOfPage	CreativeWork, URL	Указывает на страницу (или другое творческое произведение), для которой этот объект является основным описываемым объектом. См. фоновую информацию для получения деталей.
name	Text	Название элемента.
potentialAction	Action	Указывает на потенциальное действие, которое описывает идеализированное действие, в котором этот объект будет играть роль 'объекта'.
sameAs	URL	URL страницы в Интернете, которая однозначно указывает на идентичность элемента. Например, URL страницы элемента в Википедии, запись в Викиданных или официальный сайт.
subjectOf	CreativeWork, Event	Творческое произведение или событие, связанное с этой вещью.
url	URL	URL предмета.

Примеры

Пример 1

Пример заметки или HTML разметки.


<!-- A Movie named "Footloose" with a WatchAction as a
potentialAction, with a target of http://example.com/player?id=123. -->

<div>
  <a href="http://example.com/player?id=123">Watch <cite>Footloose</cite></a>
</div>

Пример, закодированный в формате Microdata, встроенный в HTML.


<div itemscope itemtype="https://schema.org/Movie">
  <meta itemprop="name" content="Footloose">
  <div itemprop="potentialAction" itemscope itemtype="https://schema.org/WatchAction">
    <a itemprop="target" href="http://example.com/player?id=123">Watch <cite>Footloose</cite></a>
  </div>
</div>

Пример, закодированный в формате RDFa, встроенный в HTML.


<div vocab="https://schema.org/" typeof="Movie">
  <meta property="name" content="Footloose">
  <div property="potentialAction" typeof="WatchAction">
    <a property="target" href="http://example.com/player?id=123">Watch <cite>Footloose</cite></a>
  </div>
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Movie",
  "name": "Footloose",
  "potentialAction" : {
    "@type": "WatchAction",
    "target" : "http://example.com/player?id=123"
  }
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org

@type

Movie

name

Footloose

potentialAction

@type: WatchAction
target: http://example.com/player?id=123

Пример 2

Пример заметки или HTML разметки.


John watched Friends.

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<!-- John watched Friends. -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WatchAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "TVEpisode",
    "name": "Friends!"
  }
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org

@type

WatchAction

agent

@type: Person
name: John

object

@type: TVEpisode
name: Friends!

Пример 3

Пример заметки или HTML разметки.


John watched The Big Bang Theory

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<!-- John watched The Big Bang Theory -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WatchAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "TVSeries",
    "name": "The Big Bang Theory"
  }
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org

@type

WatchAction

agent

@type: Person
name: John

object

@type: TVSeries
name: The Big Bang Theory

Пример 4

Пример заметки или HTML разметки.


John watched The Internship

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<!-- John watched The Internship -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WatchAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "Movie",
    "name": "The Internship"
  }
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org

@type

WatchAction

agent

@type: Person
name: John

object

@type: Movie
name: The Internship

Пример 5

Пример заметки или HTML разметки.


John watched The Bolshoi Ballet group in Russia.

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<!-- John watched The Bolshoi Ballet group in Russia.-->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WatchAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "PerformingGroup",
    "name": "Bolshoi"
  },
  "location": {
    "@type": "PerformingArtsTheater",
    "name": "Chuvash State Opera and Ballet Theater"
  }
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org

@type

WatchAction

agent