In diesem Abschnitt finden Sie Details zu den allgemeinen Eigenschaften von Watch Actions.
Eigenschaften für Aktions-Markup
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
@type |
Text | Erforderlich: Muss immer auf WatchAction gesetzt sein. |
target |
EntryPoint | Erforderlich: Ein Zielobjekt, das die Zuordnung von Deeplinks zu verschiedenen Google-Plattformen enthält. |
target.@type |
Text | Erforderlich: Muss immer auf EntryPoint gesetzt sein. |
target.urlTemplate |
URL | Erforderlich: Ein Deeplink, über den Nutzer zu Ihrer App oder Plattform weitergeleitet und die Wiedergabe der Inhalte gestartet wird. |
target.inLanguage |
Text | Optional: Die Originalsprache der Serie im BCP 47-Format. |
target.actionPlatform |
Text | Erforderlich: Die Plattformen, die urlTemplate zugeordnet sind. Media Actions unterstützen Folgendes:
|
target.additionalProperty |
PropertyValue | Erforderlich, falls zutreffend: Eine Liste von Attribut-Wert-Paaren, die zusätzliche Attribute des Deeplinks darstellen. Dazu kann Folgendes gehören:
|
actionAccessibilityRequirement |
ActionAccessSpecification | Erforderlich: Ein Action-Zugriffsspezifikationsobjekt, das die Zugriffsanforderung des Inhalts beschreibt. Weitere Informationen finden Sie unter Attribute für die Zugriffsspezifikation für Aktionen. |
Seiten mit Aktions-Markup
Weitere Informationen zu den Themen, die mit diesen Attributen zusammenhängen, finden Sie auf den folgenden Seiten:
Eigenschaften der Spezifikation für den Aktionszugriff
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
actionAccessibilityRequirement.@type |
Text | Erforderlich: Muss immer auf ActionAccessSpecification gesetzt sein. |
actionAccessibilityRequirement.category |
Text | Erforderlich: Eine Zugriffsanforderung für die Inhalte. Weitere Informationen finden Sie unter Paywall-Typ. Wenn eine Einheit eine Gruppe von Inhalten repräsentiert, müssen Sie
|
actionAccessibilityRequirement.availabilityStarts |
Datum | Erforderlich: Das Datum, nach dem die Aktion verfügbar ist, im ISO 8601-Format (einschließlich Zeitzone).
Die entsprechende Einheit muss mindestens 7 Tage vor dem availabilityStarts-Datum im Feed angegeben werden. Dadurch erhöhen Sie die Chancen, 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 des Datums „availabilityEnds“ müssen mindestens 7 Tage vor dem Datum „availabilityEnds“ im Feed vorgenommen werden. Dadurch wird die Wahrscheinlichkeit erhöht, dass die Inhalte ab dem Datum „availabilityEnds“ nicht mehr auf Google-Plattformen angezeigt werden. |
actionAccessibilityRequirement.eligibleRegion |
Country, City, State, GeoShape oder Text | Erforderlich: Regionen, in denen die Inhalte verfügbar sind. Verwenden Sie den speziellen String EARTH , wenn die Inhalte weltweit verfügbar sind. |
actionAccessibilityRequirement.ineligibleRegion |
Country, City, State oder GeoShape | Erforderlich, falls zutreffend: Regionen, in denen die Inhalte eingeschränkt sind. Sie müssen diese Eigenschaft nicht angeben, wenn die Inhalte überall in eligibleRegion verfügbar sind. |
actionAccessibilityRequirement.requiresSubscription |
MediaSubscription | Erforderlich, falls zutreffend: Die Details des Abos, das Nutzer benötigen, um auf die Inhalte zuzugreifen. Weitere Informationen finden Sie unter Media-Abo-Attribute.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Angebot | Erforderlich, wenn für die Inhalte ein Kauf erforderlich ist: Die Details des Angebots, das mit den Inhalten verknüpft ist. Geben Sie die Preisinformationen für die folgenden Fälle an:
Offer -Objekt vollständig und setzen Sie category aus dem ActionAccessSpecification -Objekt auf free . Weitere Informationen finden Sie unter Angebotseigenschaften.
|
actionAccessibilityRequirement.additionalProperty |
PropertyValue | Erforderlich, falls zutreffend: Eine Referenz auf das Abopaket, das in der Benutzeroberfläche angezeigt wird. |
actionAccessibilityRequirement.additionalProperty.name |
Text | Erforderlich: Muss immer auf „DisplaySubscriptionIdentifier“ festgelegt sein. |
actionAccessibilityRequirement.additionalProperty.value |
Text | Erforderlich: Die requiresSubscription.@id , die für die Entität angezeigt wird.
|
Media-Abo-Attribute
Erforderlich, wenn actionAccessibilityRequirement.category
subscription
oder externalSubscription
ist.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
requiresSubscription.@type |
Text | Erforderlich: Immer auf MediaSubscription gesetzt. |
requiresSubscription.@id |
URL | Erforderlich: Die eindeutige ID für das Abo. Wenn die Inhalte über verschiedene Abos zugänglich sind, 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
–
Ein eindeutiger String für dieses Abo, der den Zugriff auf eine Gruppe von Inhalten in deinem Medienkatalog darstellt.
|
requiresSubscription.authenticator |
Organisation | Erforderlich, wenn category externalsubscription ist: Ein Container, der die Details des Authentifikators des externen Anbieters enthält. |
requiresSubscription.authenticator.@type |
Text | Erforderlich, wenn category externalsubscription ist: Muss immer auf Organization festgelegt werden. |
requiresSubscription.authenticator.name |
Text | Erforderlich, wenn category externalsubscription ist: Der Name des Authentifizierungsdienstes. Für TVE-Anbieter legen Sie den Wert auf TVE fest. |
requiresSubscription.commonTier |
Boolesch | Erforderlich, falls zutreffend: Dies ist erforderlich, wenn die Kategorie auf „Abo“ festgelegt ist. Weitere Informationen zu „commonTier“ finden Sie in der Dokumentation zu den Anforderungen für die gemeinsame Stufe. |
Anforderungen an die Entitlements API
Eine Berechtigungs-API ist erforderlich, wenn actionAccessibilityRequirement.category
subscription
oder externalSubscription
ist und Ihr Aboangebot mehrere Pakete oder Stufen umfasst oder Add-ons unterstützt. Lassen Sie diesen Teil weg, wenn Ihr Abo nur eine Stufe hat und Zugriff auf alle Inhalte in Ihrem Katalog bietet.
- Unternehmen A hat ein einzelnes Aboangebot, das Abonnenten Zugriff auf alle verfügbaren Inhalte bietet: Berechtigungs-ID / API ist nicht erforderlich
- Unternehmen B hat ein Basisabo, das Zugriff auf einige Inhalte bietet, und ein Premium-Abo, das Zugriff auf Premiuminhalte bietet: Berechtigungs-ID / API ist erforderlich
- Unternehmen C hat ein Basisabo, das Zugriff auf einige Inhalte bietet, und Add-on-Pakete, die Zugriff auf Inhalte von Drittanbietern bieten: Berechtigungs-ID / API ist erforderlich
Seiten zu Media-Abos
Weitere Informationen zu den Themen, die mit diesen Attributen zusammenhängen, finden Sie auf den folgenden Seiten:
Angebotsattribute
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
expectsAcceptanceOf.@type |
Text | Erforderlich: Muss immer auf Offer gesetzt sein. |
expectsAcceptanceOf.price |
Number | Erforderlich: Der Kaufpreis von Inhalten. Der Preis muss ein positiver Wert ungleich null sein. Geben Sie für Artikel mit einem Preis von 0, 00 die Kategorie „free“ 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 gesetzt. |
expectsAcceptanceOf.seller.name |
Text | Der Name des Verkäufers. |
expectsAcceptanceOf.seller.sameAs |
Text | Die URL einer Webseite, auf der der Verkäufer identifiziert wird, z. B. die Startseite des Verkäufers. |
Seite mit Angebotsbezug
Weitere Informationen zu den Themen, die mit diesen Attributen zusammenhängen, finden Sie auf den folgenden Seiten:
IDs
Media Action-Feeds akzeptieren eine Vielzahl von Kennzeichnungen, mit denen eine Entität eindeutig identifiziert werden kann. Diese Kennzeichnungen können den Abgleich der Inhalte in Ihrem Feed mit den Inhalten in den Google-Datenbanken beschleunigen. Die meisten dieser Kennungen können dem Feed mit der Property identifier
für verschiedene Entitätstypen hinzugefügt werden. EIDRs haben jedoch eine eigene repräsentative Property. Beide werden im Folgenden erläutert.
Eigenschaften von Kennungen
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
identifier |
Text | Sehr empfehlenswert: Eine Kennung, in der Regel eine externe, die eine bestimmte Einheit eindeutig identifiziert. Es sind mehrere IDs zulässig. Diese Property ist für alle Entitätstypen vom Typ „Watch Action“ verfügbar. In der Tabelle unten sind die akzeptierten IDs und untergeordneten Properties der Property identifier aufgeführt. Ein Beispiel für eine Kennung/EIDR finden Sie im Abschnitt „Beispiele für Watch Actions-Feeds“. |
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
@type |
Text | Erforderlich: Muss immer auf PropertyValue gesetzt sein. |
propertyID |
Text | Erforderlich: Wir unterstützen die folgenden ID-Typen:
|
value |
Text | Erforderlich: Der Wert für das angegebene ID-System. |
EIDR-Eigenschaften
EIDR (kurz für The Entertainment Identifier Registry) ist ein weltweit eindeutiges Kennzeichnungssystem für eine Vielzahl von Medieninhalten, darunter Filme und Fernsehsendungen. Das Identifizierungssystem löst eine Kennung in einen Metadatensatz auf, der mit Titeln auf höchster Ebene, Bearbeitungen usw. verknüpft ist. In der folgenden Tabelle sind die mit EIDR verknüpften Eigenschaften und ihre Verwendung aufgeführt.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
titleEIDR |
Text | Sehr empfehlenswert: Eine EIDR-ID (Entertainment Identifier Registry) repräsentiert auf der allgemeinsten/abstraktesten Ebene ein Film- oder Fernsehwerk. Diese Property ist auf den Spezifikationsseiten für die Entitäten TVSeries, TVSeason, TVEpisode und Movie verfügbar. Der titleEIDR für den Film „Ghostbusters“ ist beispielsweise „10.5240/7EC7-228A-510A-053E-CBB8-J“. Weitere Informationen finden Sie im Abschnitt mit Beispielen für Watch Actions-Feeds unter Identifier/EIDR example. |
editEIDR |
Text | Sehr empfehlenswert: Eine EIDR-Kennung (Entertainment Identifier Registry) steht für eine bestimmte Bearbeitung/Ausgabe eines Film- oder Fernsehwerks. Diese Eigenschaft ist auf den Spezifikationsseiten für die Entitäten TVEpisode und Movie verfügbar. Der Film „Ghostbusters“ mit der titleEIDR „10.5240/7EC7-228A-510A-053E-CBB8-J“ hat beispielsweise mehrere Bearbeitungen, z.B. „10.5240/1F2A-E1C5-680A-14C6-E76B-I“ und „10.5240/8A35-3BEE-6497-5D12-9E4F-3“. Die Eigenschaft titleEIDR ist erforderlich, wenn editEIDR angegeben wird.Weitere Informationen finden Sie im Abschnitt Identifier/EIDR example (Beispiel für Identifier/EIDR) in den Beispielen für Watch Actions-Feeds. |
Agenturen für Altersfreigaben
Verwenden Sie die Werte in dieser Tabelle für BroadcastService.contentRating
, Movie.contentRating
und TVSeries.contentRating
. Die Ratingagentur sollte dem Ratingwert vorangestellt werden. Beispiele:
- Ein Film mit der Altersfreigabe „R“ in den USA sollte den
Movie.contentRating
-Wert „MPAA R“ haben. - Eine in den USA mit „TV-MA“ bewertete Serie sollte den
TVSeries.contentRating
-Wert „TV_PG TV-MA“ haben.
Land | Agentur für Altersempfehlungen für TV | Filmbewertungsstelle |
---|---|---|
Albanien (AL) | Nicht verfügbar | Nicht verfügbar |
Angola (AO) | Nicht verfügbar | CCE |
Antigua und Barbuda (AG) | Nicht verfügbar | MPAA |
Argentinien (AR) | INCAA | INCAA |
Armenien (AM) | Nicht verfügbar | MKRF/RUSSLAND |
Aruba (AW) | Nicht verfügbar | Nicht verfügbar |
Australien (AU) | ACB TV | ACB Movies |
Österreich (AT) | FSK | FSK |
Aserbaidschan (AZ) | Nicht verfügbar | MKRF/RUSSLAND |
Bahrain (BH) | Nicht verfügbar | MPAA |
Belarus (BY) | Nicht verfügbar | MKRF/RUSSLAND |
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) | CLASSIND | CLASSIND |
Burkina Faso (BF) | Nicht verfügbar | CNC |
Kambodscha (KH) | Nicht verfügbar | Nicht verfügbar |
Kanada (CA) | CA_TV | CHVRS |
Cabo 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 | MCCYP |
Ecuador (EC) | 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) | ESR | 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) | – | EIRIN |
Jordanien (JO) | Nicht verfügbar | MPAA |
Kasachstan (KZ) | Nicht verfügbar | MRKF |
Südkorea (KR) | KMRB | KMRB |
Kuwait (KW) | Nicht verfügbar | MPAA |
Kirgisistan (KG) | Nicht verfügbar | MKRF/RUSSLAND |
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 |
Nordmazedonien (MK) | Nicht verfügbar | MPAA |
Malaysia (MY) | Nicht verfügbar | FCBM |
Mali (ML) | Nicht verfügbar | CNC |
Malta (MT) | Nicht verfügbar | MCCAA |
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) | BSA | 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) | MTRCB | MTRCB |
Polen (PL) | Nicht verfügbar | MPAA |
Portugal (PT) | Nicht verfügbar | CCE |
Katar (QA) | Nicht verfügbar | MPAA |
Russland (RU) | MKRF/RUSSLAND | MKRF/RUSSLAND |
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) | FPB | FPB |
Spanien (ES) | SETSI | ICAA |
Sri Lanka (LK) | Nicht verfügbar | Nicht verfügbar |
Schweden (SE) | Nicht verfügbar | SMSA |
Schweiz (CH) | FSK | FSK |
Taiwan (TW) | Nicht verfügbar | MOCTW |
Tadschikistan (TJ) | Nicht verfügbar | MKRF/RUSSLAND |
Tansania (TZ) | Nicht verfügbar | MPAA |
Thailand (TH) | Nicht verfügbar | BFVC |
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/RUSSLAND |
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/RUSSLAND |
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-Attribute
Ein GeoShape-Objekt enthält einen der folgenden Datentypen:
- Eine Liste von Postleitzahlen (z. B. US-amerikanische, kanadische oder andere Postleitzahlen)
- Eine Liste der kanadischen Vorwärts-Sortierbereiche
- Eine DMA-ID (Designated Market Area): Eine ID für eine Region in den USA, in der Nutzer dieselben Fernsehsender und ‑programme empfangen.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
@id |
URL | Erforderlich: Die Kennung der geografischen Region im URI-Format. |
@type |
Text | Erforderlich: Muss immer auf GeoShape gesetzt sein. |
addressCountry |
Text | Erforderlich: Der aus zwei Buchstaben bestehende ALPHA-2-Ländercode nach ISO 3166-1. |
postalCode |
Text | Optional: Liste mit einer oder mehreren Postleitzahlen und/oder FSA-Codes (Forward Sortation Area). |
identifier |
PropertyValue | Optional: Eine DMA-ID (Designated Market Area), die eine Region in den USA identifiziert, in der Nutzer dieselben Fernsehsender und ‑programme empfangen. |
identifier.@type |
Text | Erforderlich: Muss immer auf PropertyValue gesetzt sein. |
identifier.propertyID |
Text | Erforderlich: Muss immer auf DMA_ID gesetzt sein. |
identifier.value |
Text | Erforderlich: Der DMA-Code für die Region. |
Beispiel für ein GeoShape
-Objekt, das eine Liste von 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 (Forward Sortation Area) und Postleitzahlen enthält:
{
"@type": "GeoShape",
"@id": "http://example.com/area2",
"addressCountry": "CA",
"postalCode": [
"1A1",
"K1A",
"K1AOB1"
]
}
Beispiel für ein GeoShape
-Objekt, das eine DMA-ID enthält:
{
"@type": "GeoShape",
"@id": "http://example.com/area3",
"addressCountry": "US",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "DMA_ID",
"value": "501"
}
]
}