In diesem Abschnitt finden Sie Details zu den allgemeinen Eigenschaften von Wiedergabeaktionen.
Aktions-Markup-Eigenschaften
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 ermöglicht. |
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 werden und die Wiedergabe der Inhalte gestartet wird. |
target.inLanguage |
Text | Optional: Die Originalsprache der Reihe im BCP 47-Format. |
target.actionPlatform |
Text | Erforderlich: Die Plattformen, die urlTemplate zugeordnet sind. Media Actions unterstützt Folgendes:
|
target.additionalProperty |
PropertyValue | Falls zutreffend erforderlich: Liste von Attribut/Wert-Paaren, die zusätzliche Eigenschaften des Deeplinks darstellen. Dazu gehören:
|
actionAccessibilityRequirement |
ActionAccessSpecification | Erforderlich: Ein Objekt für die Zugriffsspezifikation von Aktionen, das die Zugriffsanforderungen der Inhalte beschreibt. Weitere Informationen finden Sie unter Eigenschaften der Zugriffsspezifikation für Aktionen. |
Seiten mit Aktions-Markup
Auf den folgenden Seiten finden Sie Informationen zu diesen Properties:
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 ein Rechtssubjekt eine Gruppe von Inhalten darstellt, müssen Sie
|
actionAccessibilityRequirement.availabilityStarts |
Datum | Erforderlich: Datum, ab dem die Aktion verfügbar ist. Die Angabe erfolgt im ISO 8601-Format (einschließlich Zeitzone).
Das entsprechende Element muss mindestens 7 Tage vor dem Datum „availabilityStarts“ im Feed angegeben werden. So erhöhen Sie die Wahrscheinlichkeit, dass die Inhalte pünktlich auf Google-Plattformen angezeigt werden. |
actionAccessibilityRequirement.availabilityEnds |
Datum | Erforderlich: Datum, nach dem die Aktion nicht mehr verfügbar ist. Die Angabe erfolgt im ISO 8601-Format (einschließlich Zeitzone).
Alle Aktualisierungen des Datums „Enddatum der Verfügbarkeit“ müssen mindestens 7 Tage vor dem Datum „Enddatum der Verfügbarkeit“ im Feed vorgenommen werden. So ist die Wahrscheinlichkeit höher, dass die Inhalte am Datum „Ende der Verfügbarkeit“ 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 | Falls zutreffend erforderlich: Die Details des Abos, die Nutzer benötigen, um auf die Inhalte zuzugreifen. Weitere Informationen finden Sie unter Medienabo-Attribute.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Angebot | Erforderlich, wenn für die Inhalte ein Kauf erforderlich ist: Die Details des mit den Inhalten verknüpften Angebots. Geben Sie die Preisinformationen für die folgenden Fälle an:
Offer -Objekt vollständig und legen Sie die category des ActionAccessSpecification -Objekts auf free fest. Weitere Informationen finden Sie unter Angebotseigenschaften.
|
Eigenschaften für Medienabos
Erforderlich, wenn actionAccessibilityRequirement.category
subscription
oder externalSubscription
ist.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
requiresSubscription.@type |
Text | Erforderlich: Muss immer auf MediaSubscription gesetzt sein. |
requiresSubscription.@id |
URL | Erforderlich: Die eindeutige ID für das Abo. Wenn auf die Inhalte über verschiedene Abos 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 = subscription UND commonTier = 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 Authenticators des externen Anbieters enthält. |
requiresSubscription.authenticator.@type |
Text | Erforderlich, wenn category = externalsubscription – sollte immer auf Organization gesetzt werden. |
requiresSubscription.authenticator.name |
Text | Erforderlich, wenn category externalsubscription ist: Der Name des Authentifizierungsdienstes. Für TVE-Anbieter TVE festlegen |
requiresSubscription.commonTier |
Boolesch | Erforderlich, wenn 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 Stufe „common“. |
Anforderungen an die Entitlements API
Eine Berechtigungs-API ist erforderlich, wenn actionAccessibilityRequirement.category
subscription
oder externalSubscription
ist und dein Abo mehrere Pakete oder Stufen umfasst oder Add-ons unterstützt. Fügen Sie diesen Abschnitt nicht hinzu, wenn Ihr Abo nur eine Stufe hat und Zugriff auf alle Inhalte in Ihrem Katalog gewährt.
- Unternehmen A bietet ein einzelnes Abo an, mit dem abonnierte Nutzer Zugriff auf alle verfügbaren Inhalte erhalten: Eine Berechtigungs-ID / API ist nicht erforderlich.
- Unternehmen B hat ein Basisabo, das Zugriff auf einige Inhalte gewährt, und ein Premiumabo, das Zugriff auf Premiuminhalte gewährt: Berechtigungs-ID / API ist erforderlich
- Unternehmen C hat ein Basisabo, das Zugriff auf einige Inhalte und Add-on-Pakete bietet, die Zugriff auf Inhalte von Drittanbietern gewähren:Berechtigungs-ID / API erforderlich
Seiten zu Medienabos
Auf den folgenden Seiten finden Sie Informationen zu diesen Properties:
Angebotseigenschaften
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
expectsAcceptanceOf.@type |
Text | Erforderlich: Muss immer auf Offer gesetzt sein. |
expectsAcceptanceOf.price |
Number | Erforderlich: Der Kaufpreis der Inhalte. Der Preis muss ein positiver Wert ungleich Null sein. Geben Sie für Entitäten mit dem Preis „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 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. |
Angebotsseite
Auf den folgenden Seiten finden Sie Informationen zu diesen Properties:
IDs
In Media Action-Feeds sind verschiedene Kennungen zulässig, mit denen sich eine Entität eindeutig identifizieren lässt. Mithilfe dieser IDs lässt sich der Abgleich der Inhalte in Ihrem Feed mit den Inhalten in den Google-Datenbanken beschleunigen. Die meisten dieser Kennungen können dem Feed über die Property identifier
für verschiedene Entitätstypen hinzugefügt werden. EIDRs haben jedoch eine eigene entsprechende Property. Beide werden nachfolgend erläutert.
ID-Eigenschaften
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
identifier |
Text | Empfohlen: Eine Kennung, in der Regel eine externe, die eine bestimmte Entität eindeutig identifiziert. Es sind mehrere IDs zulässig. Diese Property ist für alle Entitätstypen der Wiedergabeaktion verfügbar. In der folgenden Tabelle sind die zulässigen IDs und Unterproperties der Property identifier aufgeführt. Weitere Informationen finden Sie im Abschnitt „Beispiele für Feeds mit Wiedergabeaktionen“ unter Beispiel für eine Kennung/EIDR. |
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-Properties
EIDR (kurz für Entertainment Identifier Registry) ist ein System zur eindeutigen Kennzeichnung von Medieninhalten wie Filmen und Fernsehsendungen. Das Identifikationssystem löst eine Kennung in einen Metadatensatz auf, der unter anderem mit Titeln und Änderungen der obersten Ebene verknüpft ist. In der folgenden Tabelle sind die mit EIDR verknüpften Properties und ihre Verwendung aufgeführt.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
titleEIDR |
Text | Empfohlen: Eine EIDR-ID (Entertainment Identifier Registry) steht auf der allgemeinsten/abstraktesten Ebene für ein Film- oder Fernsehwerk. Diese Property ist auf den Seiten mit den Entitätsspezifikationen für TVSeries, TVSeason, TVEpisode und Movie verfügbar. Die EIDR für den Film „Ghostbusters“ lautet beispielsweise „10.5240/7EC7-228A-510A-053E-CBB8-J“. Siehe Beispiel für eine Kennung/EIDR im Abschnitt mit Beispielen für Feeds mit Wiedergabeaktionen. |
editEIDR |
Text | Empfohlen: Eine EIDR-ID (Entertainment Identifier Registry) steht für eine bestimmte Fassung eines Films oder Fernsehprogramms. Diese Property ist auf den Seiten mit den Entitätsspezifikationen für TVEpisode und Filme verfügbar. Der Spielfilm „Ghostbusters“, dessen TitleEIDR „10.5240/7EC7-228A-510A-053E-CBB8-J“ lautet, hat beispielsweise mehrere Fassungen, z. B. „10.5240/1F2A-E1C5-680A-14C6-E76B-I“ und „10.5240/8A35-3BEE-6497-5D12-9E4F-3“. titleEIDR ist erforderlich, wenn editEIDR angegeben wird.Beispiel für eine Kennung/EIDR im Abschnitt mit Beispielen für Feeds mit Wiedergabeaktionen |
Altersfreigabestellen
Verwenden Sie die Werte in dieser Tabelle für BroadcastService.contentRating
, Movie.contentRating
und TVSeries.contentRating
. Die Altersfreigabestelle muss dem Altersfreigabewert vorangestellt werden. Beispiele:
- Ein Film mit der Altersfreigabe „R“ in den USA sollte den
Movie.contentRating
-Wert „MPAA R“ haben. - Eine Fernsehserie mit der Altersfreigabe „TV-MA“ in den USA sollte den
TVSeries.contentRating
-Wert „TV_PG TV-MA“ haben.
Land | Altersfreigabestelle für TV | Altersfreigabebehörde |
---|---|---|
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 |
Mazedonien (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 mit Postleitzahlen (z. B. US-amerikanische, kanadische oder andere Postleitzahlen)
- Eine Liste der kanadischen Vorsortierzonen
- DMA-ID (Designated Market Area): Eine Kennung für eine Region in den USA, in der dieselben Fernsehsender und ‑programme empfangen werden.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
@id |
URL | Erforderlich: Die Kennung der Region im URI-Format. |
@type |
Text | Erforderlich: Muss immer auf GeoShape gesetzt sein. |
addressCountry |
Text | Erforderlich: Der aus zwei Buchstaben bestehende Ländercode nach ISO 3166-1 alpha-2. |
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 dieselben Fernsehsender und ‑programme empfangen werden. |
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 mit einer Liste von Postleitzahlen:
{
"@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 mit einer DMA-ID:
{
"@type": "GeoShape",
"@id": "http://example.com/area3",
"addressCountry": "US",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "DMA_ID",
"value": "501"
}
]
}