Film

Dodaj do swoich materiałów wideo uporządkowane dane, by umożliwić użytkownikom odkrywanie i oglądanie filmów przez wyszukiwarkę Google. Możesz podawać takie szczegóły jak opis, adres URL miniatury, data umieszczenia w sieci i czas trwania, dodając do filmu znacznik VideoObject. Do obiektu VideoObject możesz też dołączyć dodatkowe uporządkowane dane, by umożliwić korzystanie z tych ulepszeń filmów:

Karuzela filmów: użyj uporządkowanych danych ItemList, by dodać znaczniki do stron galerii filmów (strony z listą filmów).
Segmenty wideo: użyj uporządkowanych danych Clip, by oznaczyć ważne fragmenty filmu. Dzięki temu użytkownicy będą mogli szybko przejść do określonego miejsca w filmie.
Segmenty wideo są obecnie dostępne dla niewielkiej grupy dostawców. Jeśli też chcesz z nich skorzystać, wyraź swoje zainteresowanie w naszym formularzu.

Nadanie treściom struktury zgodnej z opisaną w tym przewodniku może im automatycznie włączyć plakietkę wideo w wynikach wyszukiwania grafiki na urządzeniach mobilnych.

Przykłady

Standardowy wynik z elementami rozszerzonymi wideo

Oto przykład standardowych znaczników filmu zapisanych w postaci kodu JSON-LD: Obejmuje tylko właściwość VideoObject i nie kwalifikuje się do karuzeli filmów ani segmentów wideo.

<html>
  <head>
    <title>Introducing the self-driving bicycle in the Netherlands</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "name": "Introducing the self-driving bicycle in the Netherlands",
      "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world’s premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google’s ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
      "thumbnailUrl": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "uploadDate": "2016-03-31T08:00:00+08:00",
      "duration": "PT1M54S",
      "contentUrl": "https://www.example.com/video/123/file.mp4",
      "embedUrl": "https://www.example.com/embed/123",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "http://schema.org/WatchAction" },
        "userInteractionCount": 5647018
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Karuzela filmów

Oto przykład strony z listą filmów. Włączenie karuzeli filmów umożliwia właściwość VideoObject i dodatkowe uporządkowane dane ItemList na stronie.

JSON-LD

<html>
  <head>
    <title>Introducing the self-driving bicycle in the Netherlands</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "VideoObject",
          "position": 1,
          "name": "Introducing the self-driving bicycle in the Netherlands",
          "url": "https://www.example.com/video/self-driving-bicycle",
          "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world’s premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google’s ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
          "thumbnailUrl": [
            "https://www.example.com/video/self-driving-bicycle/1x1/photo.jpg",
            "https://www.example.com/video/self-driving-bicycle/4x3/photo.jpg",
            "https://www.example.com/video/self-driving-bicycle/16x9/photo.jpg"
          ],
          "uploadDate": "2016-03-31T08:00:00+08:00",
          "duration": "PT1M54S",
          "contentUrl": "https://www.example.com/video/self-driving-bicycle/file.mp4",
          "embedUrl": "https://www.example.com/embed/self-driving-bicycle",
          "interactionStatistic": {
            "@type": "InteractionCounter",
            "interactionType": { "@type": "http://schema.org/WatchAction" },
            "userInteractionCount": 5647018
          }
        },
        {
          "@type": "VideoObject",
          "position": 2,
          "name": "How to tie a tie",
          "url": "https://www.example.com/video/how-to-tie-a-tie",
          "description": "How to tie a four-in-hand knot.",
          "thumbnailUrl": [
            "https://www.example.com/video/how-to-tie-a-tie/1x1/photo.jpg",
            "https://www.example.com/video/how-to-tie-a-tie/4x3/photo.jpg",
            "https://www.example.com/video/how-to-tie-a-tie/16x9/photo.jpg"
          ],
          "uploadDate": "2019-02-28T08:00:00+08:00",
          "duration": "PT5M01S",
          "contentUrl": "https://www.example.com/video/how-to-tie-a-tie/file.mp4",
          "embedUrl": "https://www.example.com/embed/how-to-tie-a-tie",
          "interactionStatistic": {
            "@type": "InteractionCounter",
            "interactionType": { "@type": "http://schema.org/WatchAction" },
            "userInteractionCount": 102111
          }
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Mikrodane

<div>
      <div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
        
        <a href="https://example.com/videos/self-driving-bicycle"
           title="Introducing the self-driving bicycle in the Netherlands">
          <img src="https://example.com/videos/self-driving-bicycle/thumbnail.jpg"
               alt="Introducing the self-driving bicycle in the Netherlands"
               title="Introducing the self-driving bicycle in the Netherlands"
               itemprop="thumbnailUrl">
        </a>
        
        <h1>
          <a itemprop="url" href="https://example.com/videos/self-driving-bicycle"
             title="Introducing the self-driving bicycle in the Netherlands">
            <span itemprop="name">Introducing the self-driving bicycle in the Netherlands</span>
          </a>
        </h1>
        <a href="https://example.com/videos/self-driving-bicycle"
             title="Introducing the self-driving bicycle in the Netherlands">
          <div itemprop="description">"This spring, Google is introducing the self-driving bicycle
            in Amsterdam, the world’s premier cycling city. The Dutch cycle more than any other
            nation in the world, almost 900 kilometres per year per person, amounting to over 15
            billion kilometres annually. The self-driving bicycle enables safe navigation through
            the city for Amsterdam residents, and furthers Google’s ambition to improve urban
            mobility with technology. Google Netherlands takes enormous pride in the fact that a
            Dutch team worked on this innovation that will have great impact in their home country.
          "</div>
        </a>
        
        <meta itemprop="duration" content="PT1M54S" />
        <meta itemprop="uploadDate" content="2016-03-31T08:00:00+08:00" />
        <span itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter">
        	<span itemprop="interactionType" itemscope itemtype="http://schema.org/WatchAction"></span>
        	<meta itemprop="userInteractionCount" content="5647018" />
        </span>
      </div>

Segmenty wideo (ograniczony dostęp)

Oto przykład znacznika VideoObject zapisanego w postaci kodu JSON-LD z dodatkowymi uporządkowanymi danymi Clip do oznaczania segmentów wideo. Segmenty wideo są obecnie dostępne dla niewielkiej grupy dostawców. Jeśli też chcesz z nich skorzystać, wyraź swoje zainteresowanie w naszym formularzu.

Strona AMP z filmem

Oto przykład znacznika VideoObject na stronie AMP.

<html>
  <head>
    <title>Introducing the self-driving bicycle in the Netherlands</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "name": "Introducing the self-driving bicycle in the Netherlands",
      "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world’s premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google’s ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
      "thumbnailUrl": "https://www.example.com/thumbnail.jpg",
      "uploadDate": "2016-03-31T08:00:00+08:00",
      "duration": "PT1M54S",
      "publisher": {
        "@type": "Organization",
        "name": "Google Nederland",
        "logo": {
          "@type": "ImageObject",
          "url": "https://example.com/logo.jpg",
          "width": 600,
          "height": 60
        }
      },
      "contentUrl": "https://www.example.com/video/123/file.mp4",
      "embedUrl": "https://www.example.com/embed/123",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "http://schema.org/WatchAction" },
        "userInteractionCount": 5647018
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Wytyczne

Aby film mógł się wyświetlać w wynikach z elementami rozszerzonymi wideo, musisz przestrzegać tych wytycznych.

Wskazówki dla webmasterów
Ogólne wytyczne dotyczące uporządkowanych danych
Sprawdzone metody dotyczące filmów
Wytyczne dotyczące karuzeli (jeśli mają zastosowanie)
Wytyczne dotyczące segmentów wideo (jeśli mają zastosowanie)

Wytyczne dotyczące segmentów wideo (ograniczony dostęp)

Jeśli oznaczasz segmenty wideo za pomocą znacznika Clip, musisz przestrzegać tych wytycznych:

Film musi być dostępny publicznie i nie może być objęty subskrypcją.
Film musi zawierać precyzyjne linki prowadzące do innych punktów niż punkt początkowy w adresie URL filmu. Na przykład http://www.example.com/example?t=30 rozpoczyna się po 30 sekundach filmu.
Uporządkowane dane segmentów wideo należy dodać do strony, na której użytkownicy mogą obejrzeć film. Wskazanie strony, na której nie można go wyświetlić, może powodować frustrację użytkowników.
Łączny czas trwania filmu musi wynosić co najmniej 30 sekund.
Upewnij się, że żadne dwa klipy w jednym filmie zdefiniowane na określonej stronie nie mają tego samego czasu rozpoczęcia.
Film musi zawierać uporządkowane dane VideoObject.

Definicje typów uporządkowanych danych

W tej sekcji opisano typy uporządkowanych danych związane z funkcjami wideo w wyszukiwarce Google. Aby treści mogły wyświetlać się w wynikach z elementami rozszerzonymi wideo, musisz określić dla nich wymagane właściwości VideoObject. Możesz też dodawać do nich właściwości zalecane, by wzbogacać informacje o treściach dla wygody użytkowników. Oprócz właściwości VideoObject możesz też dodać poniższe typy danych, by włączyć ulepszenia filmów w wyszukiwarce Google:

ItemList: dodaj do stron znaczniki listy filmów, by włączyć karuzelę filmów.
Clip: oznacz ważne segmenty filmu, by umożliwić użytkownikom szybkie przejście do określonych fragmentów filmu.
Czy Twój film zawiera instrukcje krok po kroku, jak wykonać określone zadanie? Umieść film w obrębie uporządkowanych danych HowTo.

VideoObject

Pełną definicję znaczników VideoObject znajdziesz na schema.org/VideoObject. Jeśli nie podasz wymaganych właściwości, Google może nie być w stanie wyodrębnić żadnych informacji o filmie. Możesz też dodawać do nich właściwości zalecane, by wzbogacać informacje o treściach dla wygody użytkowników.

Właściwości wymagane
`description`	`Text` Opis filmu. Tagi HTML są ignorowane.
`name`	`Text` Tytuł filmu.
`thumbnailUrl`	Powtórzone pole `ImageObject` lub `URL` URL wskazujący plik miniatury filmu. Adresy URL obrazów muszą być dostępne do zeskanowania i zindeksowania. Obrazy muszą symbolizować treści objęte znacznikami. Obrazy muszą być w formacie JPG, PNG lub GIF. Rozmiary obrazów muszą wynosić co najmniej 60 x 30 pikseli.
`uploadDate`	`Date` Data pierwszej publikacji filmu podana w formacie ISO 8601.

Właściwości zalecane
`contentUrl`	`URL` Zalecamy podanie adresu URL filmu. Możesz to zrobić, używając właściwości `contentUrl` lub `embedUrl` albo obu naraz. URL wskazujący multimedialny plik wideo. Przykład "contentUrl": "https://www.example.com/video/123/file.mp4" Przestrzegaj naszych sprawdzonych metod dotyczących filmów. Wskazówka: aby upewnić się, że tylko Googlebot ma dostęp do Twoich treści, skorzystaj z odwrotnego wyszukiwania DNS.
`duration`	`Duration` Czas trwania filmu podany w formacie ISO 8601. Na przykład `T00H30M5S` wskazuje czas trwania „trzydzieści minut i pięć sekund”.
`embedUrl`	`URL` Zalecamy podanie adresu URL filmu. Możesz to zrobić, używając właściwości `contentUrl` lub `embedUrl` albo obu naraz. Adres URL prowadzący do odtwarzacza konkretnego filmu. Zazwyczaj ta informacja znajduje się w elemencie `src` tagu `<embed>`. Przykład "embedUrl": "https://www.example.com/embed/123" Przestrzegaj naszych sprawdzonych metod dotyczących filmów. Wskazówka: aby upewnić się, że tylko Googlebot ma dostęp do Twoich treści, skorzystaj z odwrotnego wyszukiwania DNS.
`expires`	`Date` Data, po której film nie będzie już dostępny, podana w formacie ISO 8601. Nie podawaj tej informacji, jeśli Twój film będzie dostępny przez cały czas.
`interactionStatistic`	`InteractionCounter` Liczba obejrzeń filmu, np.: "interactionStatistic": { "@type": "InteractionCounter", "interactionType": { "@type": "http://schema.org/WatchAction" }, "userInteractionCount": 12345 } Od października 2019 roku w naszej dokumentacji zalecamy używanie właściwości `interactionStatistic` zamiast `interactionCount`. Nadal obsługujemy znacznik `interactionCount`, ale zalecamy korzystanie w przyszłości ze znacznika `interactionStatistic`.

ItemList

Aby film mógł się pojawić w karuzeli filmów, oprócz właściwości VideoObject musisz dodać poniższe właściwości ItemList. Chociaż właściwości ItemList nie są wymagane, musisz dodać poniższe właściwości, jeśli chcesz, by Twój film wyświetlał się w karuzeli filmów. Więcej informacji o karuzelach znajdziesz w artykule Karuzela.

Pełną definicję znaczników ItemList znajdziesz na schema.org/ItemList.

Właściwości wymagane

Właściwości wymagane
`itemListElement`	`ListItem` Adnotacja o pojedynczej stronie elementu. Każdy element `ListItem` powinien zawierać właściwości VideoObject, a także właściwości `ListItem`.
`ListItem.position`	`Integer` Pozycja porządkowa strony elementu na liście, np.: "itemListElement": [ { "@type": "VideoObject", "position": 1, ... other VideoObject properties ... }, { "@type": "VideoObject", "position": 2, ... other VideoObject properties ... } ]
`ListItem.url`	`URL` Kanoniczny URL strony elementu. Każdy element powinien mieć niepowtarzalny adres URL.

itemListElement

ListItem

Adnotacja o pojedynczej stronie elementu. Każdy element ListItem powinien zawierać właściwości VideoObject, a także właściwości ListItem.

ListItem.position

Integer

Pozycja porządkowa strony elementu na liście, np.:


"itemListElement": [
  {
    "@type": "VideoObject",
    "position": 1,
    ... other VideoObject properties ...
  }, {
    "@type": "VideoObject",
    "position": 2,
    ... other VideoObject properties ...
  }
]

ListItem.url

URL

Kanoniczny URL strony elementu. Każdy element powinien mieć niepowtarzalny adres URL.

Klip (ograniczony dostęp)

Aby umożliwić korzystanie z segmentów wideo w filmie, musisz w obiekcie VideoObject umieścić poniższe właściwości. Chociaż właściwości Clip nie są wymagane, musisz dodać poniższe właściwości, jeśli chcesz, by film wyświetlał się z segmentami wideo.

Pełną definicję znaczników Clip znajdziesz na schema.org/Clip.

Właściwości wymagane

Właściwości wymagane
`name`	`Text` Opisowy tytuł zawartości klipu.
`startOffset`	`Number` Czas rozpoczęcia klipu wyrażony w postaci liczby sekund, które upłynęły od początku filmu.
`url`	`URL` Adres URL wskazujący czas rozpoczęcia klipu. Adres URL klipu musi wskazywać tę samą ścieżkę adresu URL co film, z dodatkowymi parametrami zapytania określającymi czas. Na przykład ten URL oznacza, że klip rozpoczyna się po upływie 2 minut od początku filmu: "url": "https://www.example.com/example?t=120"

name

Text

Opisowy tytuł zawartości klipu.

startOffset

Number

Czas rozpoczęcia klipu wyrażony w postaci liczby sekund, które upłynęły od początku filmu.

url

URL

Adres URL wskazujący czas rozpoczęcia klipu.

Adres URL klipu musi wskazywać tę samą ścieżkę adresu URL co film, z dodatkowymi parametrami zapytania określającymi czas.

Na przykład ten URL oznacza, że klip rozpoczyna się po upływie 2 minut od początku filmu:


"url": "https://www.example.com/example?t=120"

Właściwości zalecane

Właściwości zalecane
`endOffset`	`Number` Czas zakończeniu klipu wyrażony w postaci liczby sekund, które upłynęły od rozpoczęcia filmu.

endOffset

Number

Czas zakończeniu klipu wyrażony w postaci liczby sekund, które upłynęły od rozpoczęcia filmu.