Role

Тип schema.org ?

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

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

Описание:

Представляет дополнительную информацию о взаимосвязи или свойстве. Например, роль может использоваться для указания, что роль 'члена', связывающая некоторую спортивную команду с игроком, имела место в определенный период времени. Или что роль 'актера' лица в фильме была для определенного имени персонажа. Такие свойства могут быть прикреплены к сущности Роль, которая затем ассоциируется с основными сущностями с использованием обычных свойств, таких как 'member' или 'actor'.

Смотрите также blog post.

Тип Schema.org под названием "Role" предназначен для представления дополнительной информации о взаимосвязях или свойствах между разными сущностями. Его основная функция заключается в уточнении контекста, в котором происходит взаимодействие между этими сущностями.

Например, если у нас есть команда и игрок, то использование типа "Role" позволяет указать, что игрок является членом команды в определённый период времени. Это помогает создать более точное и детализированное описание отношения между игроком и командой. Аналогично, если мы рассматриваем актёра и фильм, тип "Role" может быть использован для указания, что актёр исполнял определённую роль в фильме, при этом также может быть указано имя персонажа.

Тип "Role" используется в тех случаях, когда важно уточнить, как именно одна сущность связана с другой, добавляя к этой связи дополнительные характеристики. Это может быть полезно в различных контекстах, например, в киноиндустрии, спорте, бизнесе и других областях, где важны детали о ролях и отношениях между участниками.

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

Свойство	Ожидаемый тип	Описание
Свойство из Role
endDate	Date, DateTime	Дата и время окончания элемента (в формате даты ISO 8601).
roleName	Text, URL	Роль, исполняемая или занимаемая человеком или организацией. Например, команда создателей комикса может занимать роли, названные 'инкер', 'пензлер' и 'литер'; или спортсмен в спортивной команде может играть на позиции, названной 'квотербек'.
startDate	Date, DateTime	Дата и время начала элемента (в формате даты ISO 8601).
Свойство из 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 JSON example of an OrganizationRole being used to qualify
the 'alumniOf' property (which is inverseOf 'alumni').

Note that we use startDate to indicate when the alumniOf
situation began, which was the date of leaving the organization.

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


<div itemscope itemtype="https://schema.org/Person">
    <span itemprop="name">Delia Derbyshire</span>
    <link itemprop="sameAs" href="http://en.wikipedia.org/wiki/Delia_Derbyshire">
    <div itemprop="alumniOf" itemscope itemtype="https://schema.org/OrganizationRole">
        <div itemprop="alumniOf" itemscope itemtype="https://schema.org/CollegeOrUniversity">
            <span itemprop="name">University of Cambridge</span>
            <link itemprop="sameAs" href="http://en.wikipedia.org/wiki/University_of_Cambridge">
        </div>
        <span itemprop="startDate">1959</span>
    </div>
</div>

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


<div vocab="https://schema.org/" typeof="Person">
    <span property="name">Delia Derbyshire</span>
    <link property="sameAs" href="http://en.wikipedia.org/wiki/Delia_Derbyshire">
    <div property="alumniOf" typeof="OrganizationRole">
        <div property="alumniOf" typeof="CollegeOrUniversity">
            <span property="name">University of Cambridge</span>
            <link property="sameAs" href="http://en.wikipedia.org/wiki/University_of_Cambridge">
        </div>
        <span property="startDate">1959</span>
    </div>
</div>

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


<script type="application/ld+json">
{
    "@context": "https://schema.org",
    "@type": "Person",
    "name": "Delia Derbyshire",
    "sameAs": "http://en.wikipedia.org/wiki/Delia_Derbyshire",
    "alumniOf": {
        "@type": "OrganizationRole",
        "alumniOf": {
            "@type": "CollegeOrUniversity",
            "name": "University of Cambridge",
            "sameAs": "http://en.wikipedia.org/wiki/University_of_Cambridge"
        },
        "startDate": "1959"
    }
}
</script>

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

@context

https://schema.org

@type

Person

name

Delia Derbyshire

sameAs

http://en.wikipedia.org/wiki/Delia_Derbyshire

alumniOf

@type

OrganizationRole

alumniOf

@type: CollegeOrUniversity
name: University of Cambridge
sameAs: http://en.wikipedia.org/wiki/University_of_Cambridge

startDate

1959

Пример 2

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


See JSON example.

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


<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Person",
  "name": "Albert Einstein",
  "hasOccupation": [
    {
      "@type": "Role",
      "hasOccupation": {
      "@type": "Occupation",
      "name": "Patent examiner",
        "occupationalCategory": "23-2099.00"
      },
      "startDate": "1901",
      "endDate": "1906"
    },
    {
      "@type": "Occupation",
      "name": "Professor of Physics",
      "educationRequirements": "PhD in Physics"
    }
  ]
}
</script>

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

@context

https://schema.org/

@type

Person

name

Albert Einstein

hasOccupation

0

@type

Role

hasOccupation

@type: Occupation
name: Patent examiner
occupationalCategory: 23-2099.00

startDate

1901

endDate

1906

1

@type: Occupation
name: Professor of Physics
educationRequirements: PhD in Physics

Пример 3

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


A JSON example of an OrganizationRole, showing information
about a 'member' of a 'SportsTeam', including time qualfiers
(when he began and ended that role).

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


<div itemscope itemtype="https://schema.org/SportsTeam">
    <span itemprop="name">San Francisco 49ers</span>
    <div itemprop="member" itemscope itemtype="https://schema.org/OrganizationRole">
        <div itemprop="member" itemscope itemtype="https://schema.org/Person">
            <span itemprop="name">Joe Montana</span>
        </div>
        <span itemprop="startDate">1979</span>
        <span itemprop="endDate">1992</span>
        <span itemprop="roleName">Quarterback</span>
    </div>
</div>

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


<div vocab="https://schema.org/" typeof="SportsTeam">
    <span property="name">San Francisco 49ers</span>
    <div property="member" typeof="OrganizationRole">
        <div property="member" typeof="https://schema.org/Person">
            <span property="name">Joe Montana</span>
        </div>
        <span property="startDate">1979</span>
        <span property="endDate">1992</span>
        <span property="roleName">Quarterback</span>
    </div>
</div>

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


<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SportsTeam",
  "name": "San Francisco 49ers",
  "member": {
    "@type": "OrganizationRole",
    "member": {
      "@type": "Person",
      "name": "Joe Montana"
    },
    "startDate": "1979",
    "endDate": "1992",
    "roleName": "Quarterback"
  }
}
</script>

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

@context

https://schema.org

@type

SportsTeam

name

San Francisco 49ers

member

@type

OrganizationRole

member

@type: Person
name: Joe Montana

startDate

1979

endDate

1992

roleName

Quarterback

Пример 4

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


A basic Role example in JSON that
shows how to qualify the 'member' property
by adding an intermediate Role entity.

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


<div itemscope itemtype="https://schema.org/Organization">
  <span itemprop="name">Cryptography Users</span>
  <div itemprop="member" itemscope
        itemtype="https://schema.org/OrganizationRole">
    <div itemprop="member" itemscope
            itemtype="https://schema.org/Person">
      <span itemprop="name">Alice</span>
    </div>
    <span itemprop="startDate">1977</span>
  </div>
</div>

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


<div vocab="https://schema.org/" typeof="Organization">
  <span property="name">Cryptography Users</span>
  <div property="member" typeof="OrganizationRole">
    <div property="member" typeof="Person">
      <span property="name">Alice</span>
    </div>
    <span property="startDate">1977</span>
  </div>
</div>

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


<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Cryptography Users",
  "member": {
    "@type": "OrganizationRole",
    "member": {
    "@type": "Person",
    "name": "Alice"
    },
    "startDate": "1977"
  }
}
</script>

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

@context

https://schema.org

@type

Organization

name

Cryptography Users

member

@type

OrganizationRole

member

@type: Person
name: Alice

startDate

1977

Пример 5

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


A JSON example of a PerformanceRole, in which
the Role represents the acting contribution made by
Bill Murray in the film Ghostbusters. The Role entity
allows us to additional information, such as the
character's name that he played in the film.

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


<div itemscope itemtype="https://schema.org/Movie">
  <span itemprop="name">Ghostbusters</span>
  <link itemprop="sameAs" href="http://en.wikipedia.org/wiki/Ghostbusters"/>
  <div itemprop="actor" itemscope
        itemtype="https://schema.org/PerformanceRole">
    <div itemprop="actor" itemscope
            itemtype="https://schema.org/Person">
      <span itemprop="name">Bill Murray</span>
    </div>
    <span itemprop="characterName">Dr. Peter Venkman</span>
  </div>
</div>

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


<div vocab="https://schema.org/" typeof="Movie">
  <span property="name">Ghostbusters</span>
  <link property="sameAs" href="http://en.wikipedia.org/wiki/Ghostbusters"/>
  <div property="actor" typeof="PerformanceRole">
    <div property="actor" typeof="Person">
      <span property="name">Bill Murray</span>
    </div>
    <span property="characterName">Dr. Peter Venkman</span>
  </div>
</div>

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


<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Movie",
  "name": "Ghostbusters",
  "sameAs": "http://en.wikipedia.org/wiki/Ghostbusters",
  "actor": {
    "@type": "PerformanceRole",
    "actor": {
      "@type": "Person",
      "name": "Bill Murray"
    },
    "characterName": "Dr. Peter Venkman"
  }
}
</script>

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

@context

https://schema.org

@type

Movie

name

Ghostbusters

sameAs

http://en.wikipedia.org/wiki/Ghostbusters

actor

@type

PerformanceRole