Identify the price of the paid content

AI-generated Key Takeaways

• For Watch Actions, price information is required for rentals, purchases, and any additional costs for subscribers of subscription-based content.

• Watch Action pricing is specified within the ActionAccessSpecification object using the expectsAcceptanceOf and Offer properties.

• For Listen Actions, providing the price is optional for subscription-based content.

• Listen Action pricing, when provided, is specified directly within the ListenAction object using the expectsAcceptanceOf and Offer properties.

• Both Watch and Listen Actions utilize the Offer schema to define price, currency, and seller information.

Lastly, you need to provide the price information of your content.

Price

For Watch Actions, specify the price of the content for the following cases:

• category is rental or purchase.
• category is subscription or externalsubscription, but the content requires an additional purchase for subscribers.

For Listen Actions, it's optional to specify the price if category is subscription.

Figure 1. Media Actions showing the prices of content on Google Search.

For Watch Actions, specify the price of content in the Action access specification object:

"potentialAction":{
  "@type":"WatchAction",
  "target":{
    "@type":"EntryPoint",
    "urlTemplate":"http://www.example.com/my_favorite_movie?autoplay=true",
    "actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
  },
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2019-01-01T00:00Z",
    "availabilityEnds": "2019-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "My example seller"
      }
    }
  }
}

For Listen Actions, specify the price of content directly in the Action markup object:

"potentialAction":{
  "@type":"ListenAction",
  "target":{
    "@type":"EntryPoint",
    "urlTemplate":"http://www.example.com/playlist/top_pop_songs?autoplay=true",
    "actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
  },
  "expectsAcceptanceOf":{
    "@type": "Offer",
    "eligibleRegion": {
      "@type":"Country",
      "name":"US"
    },
    "category": "subscription",
    "name": "Example Music",
    "price": 9.99,
    "priceCurrency": "USD",
    "seller": {
      "@type": "Organization",
      "name": "My example seller",
      "sameAs": "http://www.example.com"
    }
  }
}

Identify the price

Do the following:

1. For Watch Actions,
   • If category is rental or purchase, you need to provide the price of the one-time purchase.
   • If category is subscription or externalsubscription, but the content requires an additional purchase for subscribers, you need to provide the price of the additional cost.
     • Otherwise, you do not need to provide the price for subscription or externalsubscription.
2. For Listen Actions,
   • If category is subscription, it's optional to provide the price of the subscription.

See the Action access requirement examples section for detailed examples.