ListenAction

Тип schema.org ?

Thing > Action > ConsumeAction > ListenAction

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

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

Описание:

Акт потребления аудиоконтента.

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

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

Использование ListenAction позволяет улучшить видимость контента в поисковых системах. Когда веб-мастера добавляют структурированные данные, поисковые системы могут более точно индексировать и отображать информацию о контенте, что может привести к повышению кликабельности и улучшению пользовательского опыта.

Кроме того, этот тип действия может быть полезен для анализа поведения пользователей. Например, он может помочь понять, насколько часто и как долго пользователи слушают определенные аудиотреки, что может быть полезно для маркетинга и оптимизации контента.

Таким образом, ListenAction служит связующим звеном между аудиоконтентом и его потреблением, позволяя как пользователям, так и системам лучше взаимодействовать с аудиофайлами в интернете.

Свойство	Ожидаемый тип	Описание
Свойство из 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 разметки.


See JSON example.

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


<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "MusicRecording",
  "potentialAction": {
    "@type": "ListenAction",
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "availabilityStarts": "2017-01-01T00:00",
      "availabilityEnds": "2017-12-31T00:00",
      "eligibleRegion": {
        "@type": "Country",
        "sameAs": "https://www.wikidata.org/wiki/Q166433",
        "name": "US"
      },
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "ACME streaming music monthly subscription",
        "authenticator": {
          "@type": "Organization",
          "name": "ACME Media"
        }
      },
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "itemOffered": {
          "@type": "MusicRecording",
          "name": "Song I want to stream that is only available for streaming after I buy it."
        }
      }
    }
  }
}
</script>

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

@context

https://schema.org/

@type

MusicRecording

potentialAction

@type

ListenAction

actionAccessibilityRequirement

@type

ActionAccessSpecification

availabilityStarts

2017-01-01T00:00

availabilityEnds

2017-12-31T00:00

eligibleRegion

@type: Country
sameAs: https://www.wikidata.org/wiki/Q166433
name: US

requiresSubscription

@type

MediaSubscription

name

ACME streaming music monthly subscription

authenticator

@type: Organization
name: ACME Media

expectsAcceptanceOf

@type

Offer

itemOffered

@type: MusicRecording
name: Song I want to stream that is only available for streaming after I buy it.

Пример 2

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


John listened to Pink.

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


<!--  John listened to Pink. -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ListenAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "MusicGroup",
    "name": "Pink!"
  }
}
</script>

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

@context

https://schema.org

@type

ListenAction

agent

@type: Person
name: John

object

@type: MusicGroup
name: Pink!

Пример 3

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


John listened to star 101.3.

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


<!--  John listened to star 101.3. -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ListenAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "RadioStation",
    "name": "Star 101.3"
  }
}
</script>

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

@context

https://schema.org

@type

ListenAction

agent

@type: Person
name: John

object

@type: RadioStation
name: Star 101.3

Пример 4

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


John listened to an Elvis playlist.

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


<!--  John listened to an Elvis playlist. -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ListenAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "MusicPlaylist",
    "name": "All Elvis Songs"
  }
}
</script>

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

@context

https://schema.org

@type

ListenAction

agent