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: Immer auf WatchAction gesetzt. |
target |
EntryPoint | Erforderlich: Ein Zielobjekt, das die Zuordnung von Deeplinks zu verschiedenen Google-Plattformen enthält. |
target.@type |
Text | Erforderlich: Immer auf EntryPoint gesetzt. |
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 | Sehr empfehlenswert: Die Originalsprache der Inhalte 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. |
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: Immer auf ActionAccessSpecification gesetzt. |
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. Die Angabe erfolgt 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 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 des availabilityEnds-Datums müssen mindestens 7 Tage vor dem availabilityEnds-Datum 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 dieses Attribut 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 zum 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 gesetzt 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 Entitlement 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 für 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: Immer auf Offer gesetzt. |
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 Bezug zum Angebot
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 Kennungen, mit denen eine Einheit 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 Kennzeichnungen können dem Feed mit dem Attribut identifier für verschiedene Entitätstypen hinzugefügt werden. EIDRs haben jedoch ein eigenes Attribut. Beide werden im Folgenden erläutert.
Kennungseigenschaften
| 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: Immer auf PropertyValue gesetzt. |
propertyID |
Text | Erforderlich: Wir unterstützen die folgenden ID-Typen:
|
value |
Text | Erforderlich: Der Wert für das angegebene ID-System. |
EIDR-Attribute
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/abstraktsten 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 „Beispiele 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.Beispiel für Identifier/EIDR im Abschnitt „Beispiele 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“ eingestufte Serie sollte den
TVSeries.contentRating-Wert „TV_PG TV-MA“ haben.
| Land | Altersempfehlungsstelle 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 |
| 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 | 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: Immer auf GeoShape gesetzt. |
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: Immer auf PropertyValue gesetzt. |
identifier.propertyID |
Text | Erforderlich: Immer auf DMA_ID gesetzt. |
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"
}
]
}