Dieser Abschnitt enthält Details zu den allgemeinen Eigenschaften von Watch Actions.
Aktions-Markup-Eigenschaften
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
@type |
Text | Erforderlich: Immer auf WatchAction festgelegt. |
target |
Einstiegspunkt | Erforderlich: Ein Zielobjekt, das die Zuordnung von Deeplinks zu verschiedenen Google-Plattformen ermöglicht. |
target.@type |
Text | Erforderlich: Immer auf EntryPoint festgelegt. |
target.urlTemplate |
URL | Erforderlich – Ein Deeplink, über den Nutzer zu Ihrer App oder Plattform gelangen und die Wiedergabe der Inhalte gestartet wird. |
target.inLanguage |
Text | Optional: Originalsprache der Reihe im BCP 47-Format. |
target.actionPlatform |
Text | Erforderlich: Die Plattformen, die urlTemplate zugeordnet sind. Media Actions unterstützt folgende Elemente:
|
target.additionalProperty |
PropertyValue | Erforderlich, sofern zutreffend: Eine Liste von Property-Wert-Paaren, die zusätzliche Properties des Deeplinks darstellen. Dazu kann Folgendes gehören:
|
actionAccessibilityRequirement |
ActionAccessSpecification | Erforderlich: Ein Objekt zur Aktionszugriffsspezifikation, das die Zugriffsanforderung des Inhalts beschreibt. Siehe Eigenschaften der Aktionszugriffsspezifikation. |
Seiten mit Markup für Aktions-Markup
Auf den folgenden Seiten finden Sie Themen zu diesen Properties:
Eigenschaften der Aktionszugriffsspezifikation
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
actionAccessibilityRequirement.@type |
Text | Erforderlich: Immer auf ActionAccessSpecification festgelegt. |
actionAccessibilityRequirement.category |
Text | Erforderlich: Eine Zugriffsanforderung für den Inhalt. Weitere Informationen findest du unter Paywall-Typ. Wenn eine Entität eine Gruppe von Inhalten repräsentiert, müssen Sie für
|
actionAccessibilityRequirement.availabilityStarts |
Datum | Erforderlich: Datum, nach dem die Aktion verfügbar ist. Die Angabe erfolgt im ISO 8601-Format (einschließlich Zeitzone).
Die entsprechende Entität muss im Feed mindestens 7 Tage vor dem „availabilityStarts“-Datum angegeben werden. Dadurch steigt die Wahrscheinlichkeit, dass die Inhalte rechtzeitig auf Google-Plattformen angezeigt werden. |
actionAccessibilityRequirement.availabilityEnds |
Datum | Erforderlich – Das Datum, nach dem die Aktion nicht mehr verfügbar ist. Die Angabe erfolgt im ISO 8601-Format (einschließlich Zeitzone).
Alle Aktualisierungen am „availabilityEnds“-Datum müssen mindestens sieben Tage vor dem „availabilityEnds“-Datum im Feed erfolgen. Dadurch steigt die Wahrscheinlichkeit, dass die Inhalte ab dem Verfügbarkeitsdatum auf Google-Plattformen nicht mehr angezeigt werden. |
actionAccessibilityRequirement.eligibleRegion |
Land, Stadt, Bundesstaat, GeoShape oder Text | Erforderlich – Regionen, in denen die Inhalte verfügbar sind. Verwende den speziellen String EARTH , wenn der Inhalt global verfügbar ist. |
actionAccessibilityRequirement.ineligibleRegion |
Land, Stadt, Bundesland oder GeoShape | Erforderlich, sofern zutreffend: Regionen, in denen der Inhalt eingeschränkt ist. Du musst diese Property nicht angeben, wenn die Inhalte überall in eligibleRegion verfügbar sind. |
actionAccessibilityRequirement.requiresSubscription |
Mediaabo | Erforderlich, sofern zutreffend: Die Details des Abos, das Nutzer benötigen, um auf die Inhalte zugreifen zu können. Weitere Informationen findest du unter Eigenschaften von Mediaabos.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Angebot | Erforderlich, wenn für den Inhalt ein Kauf erforderlich ist: Die Details des Angebots, das mit dem Inhalt verknüpft ist. Gib die Preisinformationen für die folgenden Fälle an:
Offer -Objekt vollständig und setzen Sie category aus dem ActionAccessSpecification -Objekt auf free . Siehe Angebotseigenschaften.
|
Eigenschaften von Mediaabos
Erforderlich, wenn actionAccessibilityRequirement.category
subscription
oder externalSubscription
ist.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
requiresSubscription.@type |
Text | Erforderlich – Immer festgelegt auf MediaSubscription |
requiresSubscription.@id |
URL | Erforderlich – Die eindeutige ID für das Abo. Wenn über verschiedene Abos auf die Inhalte zugegriffen werden kann, muss jedes Abo eine eindeutige ID haben. |
requiresSubscription.name |
Text | Erforderlich – Der Name des Abos. Beachten Sie Folgendes:
|
requiresSubscription.sameAs |
URL | Die Seite, auf der das Abo beschrieben wird. |
requiresSubscription.identifier |
Text | Erforderlich, wenn category gleich subscription UND
commonTier gleich false ist
– ein eindeutiger String für dieses Abo, der den Zugriff auf eine Gruppe von Inhalten in Ihrem Medienkatalog darstellt.
|
requiresSubscription.authenticator |
Organisation | Erforderlich, wenn category gleich externalsubscription ist – Ein Container, der die Details der Authentifizierung des externen Anbieters enthält. |
requiresSubscription.authenticator.@type |
Text | Erforderlich, wenn category gleich externalsubscription ist – Immer auf Organization festgelegt. |
requiresSubscription.authenticator.name |
Text | Erforderlich, wenn category gleich externalsubscription ist – Der Name des Authentifizierungsdienstes. Für TVE-Anbieter setzen Sie sie auf TVE. |
requiresSubscription.commonTier |
Boolesch | Erforderlich, sofern zutreffend: Dies ist erforderlich, wenn die Kategorie auf „Abo“ gesetzt ist. Weitere Informationen zu CommonTier finden Sie in der Dokumentation zu den allgemeinen Anforderungen. |
Anforderungen an die Entitlement API
Eine Berechtigungs-API ist erforderlich, wenn actionAccessibilityRequirement.category
den Wert subscription
oder externalSubscription
hat und dein Aboangebot mehrere Pakete oder Ebenen umfasst oder Add-on-Unterstützung bietet. Verwende diese Option nicht, wenn dein Abo einstufig ist und Zugriff auf alle Inhalte in deinem Katalog bietet.
- Unternehmen A hat ein einziges Abo, mit dem Abonnenten auf alle verfügbaren Inhalte zugreifen können: Die Berechtigungs-ID / die API ist nicht erforderlich
- Unternehmen B hat ein Basisabo, das Zugriff auf einige Inhalte bietet, und ein Premiumabo, das Zugriff auf Premiuminhalte bietet: Entitlement Identifier / API ist erforderlich
- Unternehmen C hat ein Basis-Abo, das Zugriff auf einige Inhalte bietet und Paketen bietet, die Zugriff auf Inhalte von Dritten ermöglichen: Entitlement Identifier / API ist erforderlich.
Seiten zu Medienabos
Auf den folgenden Seiten finden Sie Themen zu diesen Properties:
Angebotseigenschaften
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
expectsAcceptanceOf.@type |
Text | Erforderlich: Immer auf Offer festgelegt. |
expectsAcceptanceOf.price |
Number | Erforderlich – Der Kaufpreis des Inhalts. Der Preis muss ein positiver Wert ungleich null sein. Geben Sie für Entitäten mit einem Preis von 0.00 die Kategorie „kostenlos“ an. |
expectsAcceptanceOf.priceCurrency |
Text | Erforderlich – Die Währung des Preises im dreistelligen ISO 4217-Format. |
expectsAcceptanceOf.seller |
Organisation | Die Organisation, die den Kauf von Inhalten anbietet. |
expectsAcceptanceOf.seller.@type |
Text | Immer auf Organization festgelegt. |
expectsAcceptanceOf.seller.name |
Text | Der Name des Verkäufers. |
expectsAcceptanceOf.seller.sameAs |
Text | Die URL einer Webseite, die den Verkäufer identifiziert, z. B. die Startseite des Verkäufers. |
Seite mit Angeboten
Auf den folgenden Seiten finden Sie Themen zu diesen Properties:
Kennungen
Media Action-Feeds akzeptieren eine Vielzahl von Kennungen, mit denen sich eine Entität eindeutig identifizieren lässt. Diese Kennungen können dazu beitragen, den Inhalt in Ihrem Feed mit den Inhalten in den Google-Datenbanken abzugleichen. Während die meisten dieser IDs dem Feed mit der Property identifier
für verschiedene Entitätstypen hinzugefügt werden können, haben EIDRs eine eigene repräsentative Property. Beide Fälle werden unten erläutert.
ID-Attribute
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
identifier |
Text | Dringend empfohlen: Eine Kennung, normalerweise eine externe, die eine bestimmte Entität eindeutig identifiziert. Es sind mehrere IDs zulässig. Diese Property ist für alle Entitätstypen für „WatchAction“ verfügbar. In der folgenden Tabelle sind die akzeptierten IDs und untergeordneten Properties der Property „ identifier “ aufgeführt. Weitere Informationen findest du im Abschnitt zu Feedaktionen mit Beobachtungsbeispiel unter Identifier/EIDR-Beispiel. |
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
@type |
Text | Erforderlich: Immer auf PropertyValue festgelegt. |
propertyID |
Text | Erforderlich: Wir unterstützen die folgenden ID-Typen:
|
value |
Text | Erforderlich – Der Wert für das angegebene ID-System. |
EIDR-Properties
EIDR (kurz für „Entertainment Identifier Registry“) ist ein weltweit eindeutiges System für Kennungen für zahlreiche Medieninhalte, darunter Filmbilder und Fernsehprogramme. Das Identifikationssystem löst eine Kennung in einen Metadateneintrag auf, der Titel, Änderungen usw. auf oberster Ebene zugeordnet ist. In der folgenden Tabelle sind die mit EIDR verknüpften Properties und ihre Verwendung aufgeführt.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
titleEIDR |
Text | Dringende Empfehlung: Eine EIDR-ID (Entertainment Identifier Registry) stellt im Allgemeinen bzw. abstrakten Hintergrund ein Werk von Film oder Fernsehen dar. Diese Property ist auf den Seiten mit den Spezifikationen für die Serien TVSeries, TVSeason, TVEpisode und Movie verfügbar. Beispiel: titleEIDR für das Filmbild „Ghostbusters“ lautet „10.5240/7EC7-228A-510A-053E-CBB8-J“. Siehe Feed1. |
editEIDR |
Text | Dringend empfohlen: Eine EIDR-ID (Entertainment Identifier Registry) steht für eine spezielle Bearbeitung/Ausgabe eines Werks in einem Film oder einer Serie. Diese Property ist auf den Seiten mit den Spezifikationen für TVEpisode und Movie verfügbar. Beispiel: Das Filmbild „Ghostbusters“, dessen Titel EIDR „10.5240/7EC7-228A-510A-053E-CBB8-J“ lautet, wurde mehrfach bearbeitet, z. B. „10.5240/1161111611199999999110111001100121202202112822122122822822 zum Beispielaus zum Beispiel Aus- Aus Aus Aus Aus Aus Aus Entfernen UmGewand |
Agenturen zur Altersfreigabe
Verwenden Sie die Werte in dieser Tabelle für BroadcastService.contentRating
, Movie.contentRating
und TVSeries.contentRating
. Der Einstufungsstelle sollte der Einstufung vorangestellt werden. Beispiele:
- Ein Film mit der Altersfreigabe „R“ in den USA sollte den
Movie.contentRating
-Wert „MPAA R“ haben. - Eine TV-Serie mit der Bewertung „TV-MA“ in den USA sollte den
TVSeries.contentRating
-Wert „TVPG TV-MA“ haben.
Land | TV-Bewertungsagentur | Filmbewertungsagentur |
---|---|---|
Albanien (AL) | Nicht verfügbar | Nicht verfügbar |
Angola (AO) | Nicht verfügbar | CCE |
Antigua und Barbuda (AG) | Nicht verfügbar | MPAA |
Argentinien (AR) | Logo: IncAA | Logo: IncAA |
Armenien (AM) | Nicht verfügbar | MKRF/RUSSIEN |
Aruba (AW) | Nicht verfügbar | Nicht verfügbar |
Australien (AU) | ACB TV | ACB-Filme |
Österreich (AT) | FSK | FSK |
Aserbaidschan (AZ) | Nicht verfügbar | MKRF/RUSSIEN |
Bahrain (BH) | Nicht verfügbar | MPAA |
Belarus (BY) | Nicht verfügbar | MKRF/RUSSIEN |
Belgien (BE) | Nicht verfügbar | MPAA |
Belize (BZ) | Nicht verfügbar | Nicht verfügbar |
Benin (BJ) | Nicht verfügbar | CNC |
Bolivien (BO) | Nicht verfügbar | MPAA |
Bosnien und Herzegowina (BA) | Nicht verfügbar | MPAA |
Botsuana (BW) | Nicht verfügbar | MPAA |
Brasilien (BR) | KLASSIERT | KLASSIERT |
Burkina Faso (Bao) | Nicht verfügbar | CNC |
Kambodscha (KH) | Nicht verfügbar | Nicht verfügbar |
Kanada (CA) | CA_TV | CHVRS |
Kap Verde (CV) | Nicht verfügbar | CCE |
Chile (CL) | Nicht verfügbar | MPAA |
Kolumbien (CO) | Nicht verfügbar | MPAA |
Costa Rica (CR) | Nicht verfügbar | MPAA |
Kroatien (HR) | Nicht verfügbar | Nicht verfügbar |
Zypern (CY) | Nicht verfügbar | GRFILM |
Tschechien (CZ) | Nicht verfügbar | CZFILM |
Dänemark (DK) | Nicht verfügbar | Verwaltungskonto |
Ecuador (EG) | Nicht verfügbar | MPAA |
Ägypten (EG) | Nicht verfügbar | MPAA |
El Salvador (SV) | Nicht verfügbar | MPAA |
Estland (EE) | Nicht verfügbar | EEFILM |
Fidschi (FJ) | Nicht verfügbar | Nicht verfügbar |
Finnland (FI) | Nicht verfügbar | MEKU |
Frankreich (FR) | CSA | CSA |
Gabun (GA) | Nicht verfügbar | CNC |
Deutschland (DE) | FSK | FSK |
Griechenland (GR) | Notfall-Standortdienst | GRFILM |
Guatemala (GT) | Nicht verfügbar | MPAA |
Haiti (HT) | Nicht verfügbar | Nicht verfügbar |
Honduras (HN) | Nicht verfügbar | MPAA |
Hongkong (HK) | CA | FCO |
Ungarn (HU) | Nicht verfügbar | MPAA |
Island (IS) | Nicht verfügbar | KIJKWIJZER |
Indien (IN) | CBFC | CBFC |
Indonesien (ID) | KPI | LSF |
Irland (IE) | Nicht verfügbar | IFCO |
Italien (IT) | AGCOM | AGCOM |
Côte d'Ivoire (CI) | Nicht verfügbar | CNC |
Jamaika (JM) | Nicht verfügbar | MPAA |
Japan (JP) | – | EIRN |
Jordanien (JO) | Nicht verfügbar | MPAA |
Kasachstan (KZ) | Nicht verfügbar | MRKF |
Korea (KR) | KMRB-Datei | KMRB-Datei |
Kuwait (KW) | Nicht verfügbar | MPAA |
Kirgisistan (KG) | Nicht verfügbar | MKRF/RUSSIEN |
Laos (LA) | Nicht verfügbar | Nicht verfügbar |
Lettland (LV) | Nicht verfügbar | NKCLV |
Libanon (LB) | Nicht verfügbar | MPAA |
Litauen (LT) | Nicht verfügbar | Nicht verfügbar |
Luxemburg (LU) | Nicht verfügbar | KIJKWIJZER |
Mazedonien (MK) | Nicht verfügbar | MPAA |
Malaysia (MY) | Nicht verfügbar | FCBM |
Mali (ML) | Nicht verfügbar | CNC |
Malta (MT) | Nicht verfügbar | Verwaltungskonto |
Mauritius (MU) | Nicht verfügbar | BBFC |
Mexiko (MX) | RTC | RTC |
Moldau (MD) | Nicht verfügbar | Nicht verfügbar |
Namibia (NA) | Nicht verfügbar | Nicht verfügbar |
Nepal (NP) | Nicht verfügbar | MPAA |
Niederlande (NL) | KIJKWIJZER | KIJKWIJZER |
Neuseeland (NZ) | Servicemitteilung – | OFLC |
Nicaragua (NI) | Nicht verfügbar | MPAA |
Niger (NE) | Nicht verfügbar | CNC |
Norwegen (NO) | Nicht verfügbar | MEDIETILSYNET |
Oman (OM) | Nicht verfügbar | MPAA |
Panama (PA) | Nicht verfügbar | MPAA |
Papua-Neuguinea (PG) | Nicht verfügbar | MPAA |
Paraguay (PY) | Nicht verfügbar | MPAA |
Peru (PE) | Nicht verfügbar | MPAA |
Philippinen (PH) | MEZ | MEZ |
Polen (PL) | Nicht verfügbar | MPAA |
Portugal (PT) | Nicht verfügbar | CCE |
Katar (QA) | Nicht verfügbar | MPAA |
Russland (RU) | MKRF/RUSSIEN | MKRF/RUSSIEN |
Ruanda (RW) | Nicht verfügbar | CNC |
Saudi-Arabien (SA) | Nicht verfügbar | MPAA |
Senegal (SN) | Nicht verfügbar | MPAA |
Singapur (SG) | Nicht verfügbar | MDA |
Slowakei (SK) | Nicht verfügbar | MPAA |
Slowenien (SI) | Nicht verfügbar | MPAA |
Südafrika (ZA) | ||
Spanien (ES) | SETSI | ICAA |
Sri Lanka (LK) | Nicht verfügbar | Nicht verfügbar |
Schweden (SE) | Nicht verfügbar | SMSA |
Schweiz (CH) | FSK | FSK |
Taiwan (Taiwan) | Nicht verfügbar | MOCTW |
Tadschikistan (TJ) | Nicht verfügbar | MKRF/RUSSIEN |
Tansania (TZ) | Nicht verfügbar | MPAA |
Thailand (TH) | Nicht verfügbar | BVG |
Togo (TG) | Nicht verfügbar | CNC |
Trinidad und Tobago (TT) | Nicht verfügbar | Nicht verfügbar |
Türkei (TR) | RTÜK | ECBMCT |
Turkmenistan (TM) | Nicht verfügbar | MKRF/RUSSIEN |
Uganda (UG) | Nicht verfügbar | MPAA |
Ukraine – UA | Nicht verfügbar | Nicht verfügbar |
Vereinigte Arabische Emirate (AE) | Nicht verfügbar | MPAA |
Großbritannien (GB) | BBFC | BBFC |
USA (US) | TV_PG | MPAA |
Uruguay (UY) | Nicht verfügbar | MPAA |
Usbekistan (UZ) | Nicht verfügbar | MKRF/RUSSIEN |
Venezuela (VE) | Nicht verfügbar | RESORTEVIOLENCIA |
Vietnam (VN) | Nicht verfügbar | MCST |
Sambia (ZM) | Nicht verfügbar | MPAA |
Simbabwe (ZW) | Nicht verfügbar | MPAA |
GeoShape-Eigenschaften
Ein GeoShape-Objekt enthält einen der folgenden Datentypen:
- Eine Liste mit Postleitzahlen (z. B. USA, Kanada oder andere Postleitzahlen)
- Eine Liste der kanadischen Sortierbereiche
- Eine DMA-ID (Designated Market Area): die Kennung einer Region in den USA, für die dieselben TV-Kanäle und -Programme empfangen werden.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
@id |
URL | Erforderlich: die Kennung der Region im URI-Format |
@type |
Text | Erforderlich: Immer auf GeoShape festgelegt. |
addressCountry |
Text | Erforderlich: Der zweistellige Alpha-2-Ländercode nach ISO 3166-1. |
postalCode |
Text | Optional: Liste mit einer oder mehreren Postleitzahlen und/oder FSA-Codes (Vorsortierung) |
identifier |
PropertyValue | Optional: Eine DMA-ID (Designated Market Area), die eine Kennung für eine Region in den USA ist, in der Nutzer dieselben TV-Kanäle und -Programme empfangen. |
identifier.@type |
Text | Erforderlich: Immer auf PropertyValue festgelegt. |
identifier.propertyID |
Text | Erforderlich: Immer auf DMA_ID festgelegt. |
identifier.value |
Text | Erforderlich – der DMA-Code für die Region |
Beispiel für ein GeoShape
-Objekt, das eine Liste mit Postleitzahlen enthält:
{
"@type": "GeoShape",
"@id": "http://example.com/area1",
"addressCountry": "US",
"postalCode": [
"94118",
"94119"
]
}
Beispiel für ein GeoShape
-Objekt, das eine Kombination aus FSA-Bereich (Vorsortierung) und Postleitzahlen enthält:
{
"@type": "GeoShape",
"@id": "http://example.com/area2",
"addressCountry": "CA",
"postalCode": [
"1A1",
"K1A",
"K1AOB1"
]
}
Beispiel für ein GeoShape
-Objekt mit einer DMA-ID:
{
"@type": "GeoShape",
"@id": "http://example.com/area3",
"addressCountry": "US",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "DMA_ID",
"value": "501"
}
]
}