Właściwości obrazu

W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści image w przypadku filmów i programów telewizyjnych. Ten znacznik umożliwia dostawcom opisywanie typu obrazu, np. czy jest to tytuł, tło czy obraz ikony, oraz sugerowane użycie.

Tabela specyfikacji

Właściwość image może być podawana w przypadku typów elementów Movie, TVSeries, TVSeason lub TVEpisode. W tej tabeli opisano dostępne właściwości właściwości image. Zwróć uwagę, że właściwość additionalProperty zawiera nazwę właściwości niestandardowej o nazwie contentAttributes, która zawiera tablicę wartości opisujących typ obrazu i jego przeznaczenie.

Właściwość Oczekiwany typ Opis
@context Text Wymagany – zawsze ma wartość "http://schema.org".
@type Text Wymagany – zawsze ma wartość ImageObject.
contentUrl Adres URL Wymagany – adres URL obrazu.
additionalProperty PropertyValue Wymagany – definiuje właściwość contentAttributes, która opisuje typ obrazu i jego przeznaczenie. Więcej informacji znajdziesz w artykule contentAttributes.
character Person

Wymagany w stosownych przypadkach – fikcyjna postać związana z obrazem. Jest to wymagane, jeśli contentAttribute obejmuje castInCharacter.
inLanguage Text Wymagany, jeśli ma zastosowanie – 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 z hasTitle, ta właściwość jest wymagana.
regionsAllowed Miejsce Zalecane – regiony, w których obraz jest dozwolony. Jeśli nie określisz ich, założymy, że obraz jest dozwolony wszędzie. Określ kraje w formacie ISO 3166.
datePublished Data

Wymagane w odpowiednich przypadkach – data, po której obraz jest dostępny, w formacie ISO 8601 (wraz ze strefą czasową).

  • Data może przypadać w przyszłości.

Jeśli istnieją ograniczenia czasowe dotyczące wykorzystania obrazu, ta właściwość jest wymagana, jeśli obraz nie może być wyświetlany przed określoną datą. Jeśli takie ograniczenie nie istnieje, można je pominąć. Odpowiednie zdjęcie musi zostać przesłane w pliku danych co najmniej 7 dni przed datą publikacji. Zwiększy to szanse na to, że treści pojawią się w Google na czas.

expires Data

Wymagany w odpowiednich przypadkach – data, po której obraz nie będzie już dostępny, podana w formacie ISO 8601 (wraz ze strefą czasową).

  • Jeśli treści są zawsze dostępne 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. Dzięki temu zwiększysz szanse na to, że treści przestaną wyświetlać się w usługach Google w dacie wygaśnięcia.

audience Odbiorcy Zalecany – docelowi lub preferowani odbiorcy tego obrazu.
audience.geographicArea AdministrativeArea Zalecany – docelowe lub preferowane regiony dla tego obrazu. Z kolei, aby określić ścisłe ograniczenia, użyj wartości regionsAllowed. Jeśli audience.geographicArea nie został określony, zakładamy, że jest przeznaczony do użycia wszędzie. Określ kraje w formacie ISO 3166.
copyrightHolder Organization lub Person Zalecany: strona, która jest właścicielem praw autorskich do zdjęcia.
keywords Text Zalecane – słowa kluczowe lub tagi używane do opisu tego obrazu. Możesz podać wiele wartości keywords za pomocą tablicy. Na przykład [„feature, biography”]
name Text Zalecany – nazwa obrazu.

contentAttributes

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

Typ

  • iconic: obraz ilustrujący program. Często jest to renderowanie artystyczne.
  • sceneStill: fragment obrazu z programu.
  • castInCharacter: zdjęcie aktora w roli. Jeśli używasz tej wartości, uwzględnij też właściwość character, aby zidentyfikować konkretny znak na obrazie. Jeśli występuje wiele postaci, np. w zestawie, dodaj wiele właściwości character jako tablicę.
  • logo: obraz zawiera tylko logo. Może to być logo graficzne lub logo w tytule. Dołącz odpowiednią nakładkę, aby określić, która z nich ma być użyta.

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

  • poster: obraz plakatu programu. W interfejsie użytkownika na komputerze można ich używać w karuzelkach. Mogą one zawierać lub nie zawierać tytułu programu.
  • background: obraz odpowiedni do użycia jako tło z tekstem lub nakładkami interfejsu. Te obrazy nie zawierają tekstu.

Aby uznać to za prawidłowe, uwzględnij maksymalnie 1 z tych zalecanych zastosowań.

Dopasowanie rozmiaru

  • smallFormat: obraz odpowiedni na mniejsze ekrany, np. na telefony komórkowe. Teksty i logo na obrazie są czytelne na małym ekranie.

  • largeFormat: obraz odpowiedni do większych ekranów lub wydrukowanych plakatów.

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

Dopasowanie tła

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

Użyj maksymalnie 1 wartości dopasowania tła.

Nakładki

  • hasTitle: tytuł programu lub nazwa postaci lub aktora widocznych na zdjęciu. Pamiętaj, aby w przypadku obrazu użyć właściwości inLanguage.
  • 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 zazwyczaj nie może używać takich obrazów bez ich modyfikacji.
  • hasMatte: obraz ma mat. Może to być format poziomy (letterbox), pionowy (pillarbox) lub oba (windowbox). Czasami obrazy są matowane, aby pasowały do formatu. Google zazwyczaj nie może używać takich obrazów bez ich modyfikacji.
  • noMatte: obraz nie ma matowego tła.
  • transparentBackground: tło obrazu jest przezroczyste. Jest to typowe dla obrazów, które zawierają tylko tytuł lub logo.

Aby atrybut był prawidłowy, można użyć tylko jednego tytułu, jednego logo, jednego prawa autorskiego i jednego atrybutu mat.

Pozycja dominującej figury

  • centered: dominująca postać znajduje się w środku obrazu.
  • rightCentered: dominująca postać znajduje się po prawej stronie obrazu, co pozostawia po lewej stronie miejsce na tekst i przesuwane elementy interfejsu.
  • leftCentered: dominująca postać znajduje się po lewej stronie obrazu, co pozostawia po prawej stronie miejsce na tekst i nakładki interfejsu.

Aby kod był prawidłowy, uwzględnij maksymalnie jedną z tych pozycji.

przykładowe obrazy z oznaczeniem ich przeznaczenia;

Interfejs TV z obrazem tła z tekstem i nakładką interfejsu.
Interfejs TV z karuzelami z obrazami plakatu na tle
Interfejs mobilny z obrazem plakatu i tła iconic
Interfejs mobilny z obrazem plakatu i tła sceneStill

Przykładowe obrazy i ich atrybuty

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 przypadku usług Google

Różne usługi i platformy Google wymagają różnych typów obrazów oraz formatów obrazu. Aby zapewnić prawidłowe wyświetlanie treści we wszystkich usługach Google, prosimy dostawców o dostarczenie wszystkich typów obrazów wymienionych w tabeli poniżej.

Format obrazu i atrybuty treści 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 [preferowana] lub sceneStill

 1000 x 1500

3:4, iconic background [preferowana] 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 i forLightBackground oraz forDarkBackground)

 1800 x 1000

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

  1. Obrazy muszą być w formacie JPEG, PNG lub WebP.
  2. Prześlij obrazy w najwyższej dostępnej rozdzielczości.
  3. Rozmiar pliku nie może przekraczać 20 MB.
  4. Preferowane są obrazy centered. Obrazy tła rightCentered i leftCentered mogą być też używane przez niektóre produkty, więc możesz je dodać, jeśli je masz.
  5. Preferujemy obrazy, które sprawdzają się zarówno w przypadku smallFormat, jak i largeFormat.
  6. Oprócz rozmiarów wymienionych w poprzedniej tabeli możesz dodać inne rozmiary obrazów.
  7. Sprawdź, czy współczynnik proporcji każdego obrazu jest jedną z częstych wartości wymienionych w poprzedniej tabeli. W przeciwnym razie otrzymasz upomnienie.

Przykładowe obrazy ze schematem

Przykłady poniżej pokazują, jak sformatować schemat dla 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 TV ograniczony do dwóch 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"]
      }
    ]
  }
}

Obraz plakatu filmu 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 formacie dużym 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"]
      }
    ]
  }
}

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"]
        }
      ]
    }]
}