Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Właściwości obrazu

W tej sekcji opisano właściwości znaczników treści image dotyczące filmów, seriali i programów telewizyjnych, transmisji telewizyjnych na żywo oraz wydarzeń sportowych. Te znaczniki umożliwiają dostawcom opisanie typu obrazu, np. czy jest to tytuł, tło czy ikona, oraz sugerowanego zastosowania.

Tabela specyfikacji

Właściwość image można podać w przypadku tych typów encji: Movie, TVSeries, TVSeason, TVEpisode, SportsEvent lub BroadcastEvent. W tabeli poniżej opisano dostępne właściwości właściwości image. Zauważ, że właściwość additionalProperty zawiera nazwę właściwości niestandardowej contentAttributes, która zawiera tablicę wartości opisujących typ obrazu i jego przeznaczenie.

Właściwość	Oczekiwany typ	Opis
`@context`	Text	Wymagany – zawsze ustawiony na `"http://schema.org"`.
`@type`	Text	Wymagany – zawsze ustawiony na `ImageObject`.
`contentUrl`	Adres URL	Wymagany – adres URL obrazu.
`additionalProperty`	PropertyValue	Wymagana – definiuje właściwość `contentAttributes`, która opisuje typ obrazu i jego przeznaczenie. Więcej informacji znajdziesz w artykule `contentAttributes`.
`character`	Person	Wymagany w odpowiednich przypadkach – fikcyjna postać powiązana z obrazem. Jest to wymagane, jeśli `contentAttribute` zawiera `castInCharacter`. Uwaga: możesz tu użyć typu `Person`, nawet jeśli postać nie jest człowiekiem.
`inLanguage`	Text	Wymagany w odpowiednich przypadkach – język tekstu użytego na obrazie. Użyj jednego z kodów języków ze standardu IETF BCP 47. Jeśli obraz zawiera `contentAttribute` o wartości `hasTitle`, ta właściwość jest wymagana.
`regionsAllowed`	Miejsce	Zalecane – regiony, w których obraz jest dozwolony. Jeśli ich nie określisz, założymy, że obraz jest dozwolony wszędzie. Określ kraje w formacie ISO 3166.
`datePublished`	Data	Wymagany w odpowiednich przypadkach – data, po której obraz jest dostępny, podana w formacie ISO 8601 (wraz ze strefą czasową). Możesz ustawić datę w przyszłości. Jeśli istnieją ograniczenia czasowe dotyczące użycia obrazu, ta właściwość jest wymagana, gdy obraz nie może być wyświetlany przed określoną datą. Jeśli nie ma takiego ograniczenia, można je pominąć. Odpowiedni obraz musi zostać przesłany w pliku danych co najmniej 7 dni przed datą opublikowania. Zwiększy to szanse na to, że treści będą wyświetlane w usługach Google na czas.
`expires`	Data	Wymagany w stosownych przypadkach – data, po której obraz nie będzie już dostępny, podana w formacie ISO 8601 (wraz ze strefą czasową). Jeśli treść jest zawsze dostępna po opublikowaniu, możesz pominąć tę właściwość. Wszelkie zmiany daty ważności muszą zostać wprowadzone w pliku danych co najmniej 7 dni przed datą ważności. Zwiększy to prawdopodobieństwo, że treści przestaną się wyświetlać na platformach Google w dniu wygaśnięcia.
`audience`	Odbiorcy	Recommended – docelowi lub preferowani odbiorcy tego obrazu.
`audience.geographicArea`	AdministrativeArea	Zalecane – regiony, dla których obraz jest przeznaczony lub preferowany. Z kolei `regionsAllowed` służy do określania ścisłych ograniczeń. Jeśli nie określisz parametru `audience.geographicArea`, założymy, że film jest przeznaczony do użytku wszędzie. Określ kraje w formacie ISO 3166.
`copyrightHolder`	Organization lub Person	Zalecane – podmiot, który posiada prawa autorskie do obrazu.
`keywords`	Text	Zalecane – słowa kluczowe lub tagi używane do opisu tego obrazu. Można podać kilka wartości `keywords`, używając tablicy. Na przykład: ["feature, biography"]
`name`	Text	Zalecany – nazwa obrazu.
`width`	Liczba całkowita	Opcjonalny – szerokość obrazu w pikselach (np. `1920`) podana jako dodatnia liczba całkowita. Nie dodawaj ciągów znaków jednostek, takich jak `"px"`.
`height`	Liczba całkowita	Opcjonalna – wysokość obrazu w pikselach jako dodatnia liczba całkowita (np. `1080`). Nie dodawaj ciągów znaków jednostek, takich jak `"px"`.

contentAttributes

Właściwość contentAttributes elementu image opisuje typ obrazu i określa jego sugerowane zastosowania. Kategorie na poniższej liście zawierają wartości contentAttributes, które dostawcy muszą uwzględnić w każdym elemencie ImageObject.

Typ

iconic: obraz ilustrujący program. Często jest to artystyczna wizja.
sceneStill: fragment obrazu z programu.
castInCharacter: zdjęcie członka obsady w charakteryzacji. Jeśli używasz tej wartości, dodaj też właściwość character, aby określić konkretną postać na obrazie. Jeśli jest wiele postaci, np. w obsadzie, podaj kilka właściwości character w tablicy.
logo: obraz zawiera tylko logo. Może to być logo graficzne lub logo tytułowe. Dołącz odpowiednią nakładkę, aby określić, o które chodzi.

Aby zachować zgodność, użyj tylko jednego z tych typów.

Zalecane zastosowanie

poster: obraz plakatu programu. W interfejsach komputerowych można ich używać w karuzelach. Mogą, ale nie muszą, zawierać tytuł programu.
background: obraz, który może służyć jako tło z tekstem lub nakładkami interfejsu. Te obrazy nie zawierają tekstu.

Aby kod był prawidłowy, podaj maksymalnie jedno z tych zalecanych zastosowań.

Dopasowanie rozmiaru

smallFormat: obraz odpowiedni na mniejsze ekrany, np. telefonów komórkowych. Wszystkie teksty i logo na obrazie są czytelne na małym ekranie.
largeFormat: obraz, który nadaje się na większe ekrany lub drukowane plakaty.

Uwaga: większość obrazów nadaje się do dużych formatów. Wyjątkiem są obrazy o niskiej rozdzielczości, które po powiększeniu byłyby spikselowane.

Obraz może używać obu tych wartości.

Dopasowanie tła

forDarkBackground: obraz, zwykle przezroczyste logo, który nadaje się do użycia na ciemnym tle.
forLightBackground: obraz, zwykle przezroczyste logo, który nadaje się do użycia na jasnym tle.

Aby wartość była prawidłowa, użyj maksymalnie jednej wartości przydatności tła.

Nakładki

hasTitle: tytuł programu lub imię i nazwisko postaci albo aktora na obrazie. Pamiętaj, aby uwzględnić właściwość inLanguage obrazu.
noTitle: obraz nie zawiera tytułu.
hasLogo: obraz zawiera logo filmu lub programu, właściciela treści lub dystrybutora.
noLogo: obraz nie zawiera logo.
hasCopyright: obraz zawiera widoczne powiadomienie o prawach autorskich.
noCopyright: obraz nie zawiera widocznego powiadomienia o prawach autorskich. Google zwykle nie może używać takich obrazów bez modyfikacji.
hasMatte: obraz ma matowe wykończenie. Mogą to być paski poziome (letterbox), pionowe (pillarbox) lub jedne i drugie (windowbox). Czasami obrazy są przycinane, aby pasowały do formatu obrazu. Google zwykle nie może używać takich obrazów bez modyfikacji.
noMatte: obraz nie ma matowego wykończenia.
transparentBackground: tło obrazu jest przezroczyste. Zwykle używa się go w przypadku obrazów, które zawierają tylko tytuł lub logo.

Aby plik był prawidłowy, dozwolony jest tylko 1 tytuł, 1 logo, 1 atrybut praw autorskich i 1 atrybut matte.

Pozycja dominującej postaci

centered: główna postać znajduje się na środku obrazu.
rightCentered: główna postać znajduje się po prawej stronie obrazu, dzięki czemu po lewej stronie jest stosunkowo dużo miejsca na tekst i nakładki interfejsu.
leftCentered: główna postać znajduje się po lewej stronie obrazu, dzięki czemu prawa strona jest stosunkowo pusta i można na niej umieścić tekst i nakładki interfejsu.

Aby zachować zgodność, uwzględnij maksymalnie jedną z tych pozycji.

Przykładowe obrazy z ich przeznaczeniem

Interfejs telewizora, który wyświetla obraz tła z tekstem i nakładką interfejsu.

Interfejs telewizora, który wyświetla karuzele z obrazami plakatów na obrazie tła.

Interfejs mobilny z obrazem plakatu i obrazem tła `iconic`.

Interfejs mobilny z obrazem plakatu i obrazem tła.`sceneStill`

Przykładowe obrazy i ich atrybuty contentAttributes

`contentAttributes: ["iconic", "poster", "centered", "hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat", "largeFormat"]`

`contentAttributes: ["iconic", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["iconic", "background", "rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]`

`contentAttributes: ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]`

`contentAttributes: ["castInCharacter", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character: {name: "Captain Pulsar"}`

`contentAttributes: ["logo", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "smallFormat", "largeFormat"]`

`contentAttributes: ["logo", "hasTitle", "hasLogo" "noCopyright", "noMatte", "centered", "transparentBackground", "forLightBackground", "forDarkBackground", "smallFormat", "largeFormat"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "noMatte"]`

`contentAttributes: ["iconic", "poster", "centered", "noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat", "largeFormat"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "hasMatte"]`

Pożądane typy obrazów w usługach Google

Różne usługi i platformy Google wymagają różnych typów obrazów i formatów obrazu. Aby mieć pewność, że treści będą wyświetlać się prawidłowo we wszystkich usługach Google, prosimy dostawców o przesłanie wszystkich typów obrazów wymienionych w tabeli poniżej.

Format obrazu i atrybuty contentAttributes	Minimalna rozdzielczość (w pikselach)	Film	Serial telewizyjny	Sezon TV	Odcinek telewizyjny	Usługa transmisji
16:9, `iconic` `poster`	3840 x 2160
2:3, `iconic` `poster`	1000 x 1500
4:3, `iconic` `poster`	800x600
1:1, `iconic` `poster`	600 x 600
3:4, `iconic` `poster`	600 x 800
16:9, `iconic` `background` [preferowany] lub `sceneStill`	3840 x 2160
2:3, `iconic` `background` [preferowany] lub `sceneStill`	1000 x 1500
3:4, `iconic` `background` [preferowany] lub `sceneStill`	600 x 800
1:1, pokaż logo (`hasLogo`)	600 x 600
4:3, logo kanału (`logo`)	800x600
1:1, logo kanału (`logo`)	600 x 600
16:9, logo kanału (`logo`)	3840 x 2160
9:5, `hasTitle` `logo` (z `transparentBackground` oraz `forLightBackground` i `forDarkBackground`)	1800 x 1000

Podczas przesyłania zdjęć obowiązują te wytyczne:

Obrazy muszą być w formacie JPEG, PNG lub WebP.
Używaj zdjęć w najwyższej rozdzielczości, jaką dysponujesz.
Rozmiar pliku nie może przekraczać 20 MB.
Preferowane są obrazy o wymiarach centered. rightCentered i leftCentered Obrazy tła mogą być też używane przez niektóre usługi, więc możesz je dołączyć, jeśli je masz.
Preferujemy obrazy, które pasują zarówno do smallFormat, jak i largeFormat.
Możesz uwzględnić rozmiary obrazów inne niż wymienione w powyższej tabeli.
Sprawdź, czy format obrazu każdego zdjęcia jest jedną z typowych wartości wymienionych w tabeli powyżej. W przeciwnym razie otrzymasz ostrzeżenie.

Przykładowe obrazy ze schematem

Poniższe przykłady pokazują, jak sformatować schemat obrazów powiązanych z filmami lub programami telewizyjnymi.

Obraz tła filmu z 2 postaciami

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/mountain_view",
  "url": "http://www.example.com/my_favorite_movie",

  ...,

  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mountain View: A Movie poster",
    "Keywords": ["Mauren, Lord Wingflap the Destroyer"],
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "character": [
      { "@type": "Person", "name": "Mauren" },
      { "@type": "Person", "name": "Lord Wingflap the Destoyer" },
    ],
    "copyrightHolder": {
      "@type": "Organization",
      "name": " ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": {
        "@type": "Audience",
        "geographicArea": [{"@type": "Country", "name": "US"},
                           {"@type": "Country", "name": "GB"},
                           {"@type": "Country", "name": "CA"},
                           {"@type": "Country", "name": "AU"}]
    },
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
                   "noCopyright", "noMatte", "smallFormat", "largeFormat"]
      }
    ]
  }
}

Obraz tła serialu telewizyjnego ograniczony do 2 regionów

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "TVSeries",
  "@id": "http://www.example.com/mountain_view",
  "url": "http://www.example.com/mountain_view",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mountain View: A TV Show",
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "regionsAllowed": [{ "@type": "Country", "name": "US" },
                       { "@type": "Country", "name": "GB" }],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "background", "rightCentered", "smallFormat",
                  "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
      }
    ]
  }
}

Plakat filmowy przeznaczony dla 2 regionów

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier",
    "contentUrl": "http://example.com/images/pulsar-quest.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": [{ "@type": "Country", "name": "US" },
                 { "@type": "Country", "name": "GB" }],
    "character": [
      {
        "@type": "Person",
        "name": "Captain Pulsar"
      }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle",
                  "hasLogo", "noCopyright", "noMatte", "centered"]
      }
    ]
  }
}

Plakat filmowy w dużym formacie z tekstem w języku koreańskim i angielskim

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": ["kr", "en"],
    "audience": { "@type": "Country", "name": "KR" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" },
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
  }
}

reprezentują wiele obrazów na region.

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": [{
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest-us.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": ["en"],
    "audience": { "@type": "Country", "name": "US" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
    },{
      "@context": "http://schema.org",
      "@type": "ImageObject",
      "name": "Pulsar Quest: A New Frontier poster",
      "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
      "copyrightHolder": {
        "@type": "Organization",
        "name": "ExampleOrganization Studios, Inc."
      },
      "inLanguage": ["kr"],
      "audience": { "@type": "Country", "name": "KR" },
      "character": [
        { "@type": "Person", "name": "Captain Pulsar" },
        { "@type": "Person", "name": "Space Cadet Shaniah" },
        { "@type": "Person", "name": "Rove the Rover" }
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentAttributes",
          "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                    "noCopyright", "noMatte", "centered"]
        }
      ]
    }]
}

Obrazy z ograniczeniem czasowym

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": [{
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest-jp.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "datePublished": "2022-10-31T17:00:00Z",
    "expires": "2025-10-31T16:59:59Z",
    "inLanguage": ["ja"],
    "audience": { "@type": "Country", "name": "JP" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
    },{
      "@context": "http://schema.org",
      "@type": "ImageObject",
      "name": "Pulsar Quest: A New Frontier poster",
      "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
      "copyrightHolder": {
        "@type": "Organization",
        "name": "ExampleOrganization Studios, Inc."
      },
      "datePublished": "2021-10-31T17:00:00Z",
      "expires": "2023-10-31T16:59:59Z",
      "inLanguage": ["kr"],
      "audience": { "@type": "Country", "name": "KR" },
      "character": [
        { "@type": "Person", "name": "Captain Pulsar" },
        { "@type": "Person", "name": "Space Cadet Shaniah" },
        { "@type": "Person", "name": "Rove the Rover" }
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentAttributes",
          "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                    "noCopyright", "noMatte", "centered"]
        }
      ]
    }]
}