⚠️ Важно: данный сайт не имеет отношения к владельцам schema.org, это всего лишь любительский (неофициальный) перевод. Сайт сделан для тех, кто плохо воспринимает технический английский. Оригинал текста можно найти тут: schema.org/PayAction.

PayAction

Тип schema.org ?

Описание:

Агент оплачивает цену участнику.

PayAction — это тип Schema.org, который используется для описания действия, связанного с оплатой. Он представляет собой сценарий, в котором один агент (например, покупатель или клиент) производит оплату определенной суммы (цены) другому участнику (например, продавцу или поставщику услуг).

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

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

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

Свойство Ожидаемый тип Описание
Свойство из PayAction
recipient Audience, ContactPoint, Organization, Person Подсвойство участника. Участник, который находится наReceiving end действия.
Свойство из TradeAction
price Number, Text Цена предложения продукта или компонента цены, когда он прикреплен к PriceSpecification и его подтипам.

Руководство по использованию:

  • Используйте свойство priceCurrency (в стандартных форматах: ISO 4217 currency format, например, "USD"; Ticker symbol для криптовалют, например, "BTC"; известные названия для Local Exchange Trading Systems (LETS) и других типов валют, например, "Ithaca HOUR"), вместо того чтобы включать неоднозначные символы, такие как '$' в значении.
  • Используйте '.' (Unicode 'FULL STOP' (U+002E)), а не ',' для обозначения десятичной точки. Избегайте использования этих символов в качестве разделителей для удобочитаемости.
  • Обратите внимание, что как RDFa, так и синтаксис Microdata позволяют использовать атрибут "content=" для публикации простых машинно-читаемых значений наряду с более удобным для человека форматированием.
  • Используйте значения из 0123456789 (Unicode 'DIGIT ZERO' (U+0030) до 'DIGIT NINE' (U+0039)), а не поверхностно похожие символы Unicode.
priceCurrency Text Валюта цены или компонент цены, когда он прикреплен к PriceSpecification и его подтипам.

Используйте стандартные форматы: ISO 4217 формат валюты, например, "USD"; Тикер для криптовалют, например, "BTC"; общеизвестные названия для Местных систем обмена валют (LETS) и других типов валют, например, "Ithaca HOUR".
priceSpecification PriceSpecification Одна или несколько детализированных спецификаций цены, указывающих цену за единицу и расходы на доставку или оплату.
Свойство из 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 разметки.


John paid US$ 1,500 for a flight.

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


<!--  John paid US$ 1,500 for a flight.-->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "PayAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "price": "1500",
  "priceCurrency": "USD",
  "recipient": {
    "@type": "Organization",
    "name": "An Airline"
  }
}
</script>

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

@context
https://schema.org
@type
PayAction
agent
@type
Person
name
John
price
1500
priceCurrency
USD
recipient
@type
Organization
name
An Airline
Автор: Семён Авдосов [schema.su]
Дата публикации: 16.11.2024
Дата обновления: 20.11.2024
Комментарии
Новые материалы на сайте