Dieser Abschnitt enthält Details zu den allgemeinen Eigenschaften von Wiedergabeaktionen.
Eigenschaften des Aktions-Markups
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
@type |
Text | Erforderlich: muss immer auf WatchAction gesetzt sein. |
target |
EntryPoint | Erforderlich – ein Zielobjekt, das liefert die Zuordnung der Tief Links zu verschiedenen Google-Plattformen. |
target.@type |
Text | Erforderlich: muss immer auf EntryPoint gesetzt sein. |
target.urlTemplate |
URL | Erforderlich – A tief über einen Link zu Ihrer App oder Plattform Wiedergabe des Inhalts. |
target.inLanguage |
Text | Optional: Originalsprache der Reihe auf BCP 47 Format. |
target.actionPlatform |
Text | Erforderlich: die Plattformen, die zugeordnet sind
urlTemplate Aktionen für Medien unterstützen Folgendes:
<ph type="x-smartling-placeholder">
|
target.additionalProperty |
PropertyValue | Erforderlich, falls zutreffend: eine Liste von Attribut/Wert-Paaren, die
stehen für zusätzliche Eigenschaften des Deeplinks. Dazu gehören die
Folgendes:
<ph type="x-smartling-placeholder">
|
actionAccessibilityRequirement |
ActionAccessSpecification | Erforderlich: eine Aktion eines Zugriffsspezifikationsobjekts, das die Zugriffsanforderung von für den Inhalt. Siehe Aktion Attribute der Zugriffsspezifikation |
Seiten mit Aktions-Markup
Auf den folgenden Seiten finden Sie Informationen zu Themen im Zusammenhang mit diesen Properties:
Attribute der Aktionszugriffsspezifikation
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
actionAccessibilityRequirement.@type |
Text | Erforderlich: muss immer auf ActionAccessSpecification gesetzt sein. |
actionAccessibilityRequirement.category |
Text | Erforderlich: Eine Zugriffsanforderung für den Inhalt. Weitere Informationen finden Sie unter Art der Paywall: Wenn eine Entität eine Gruppe von Inhalten darstellt, müssen Sie
|
actionAccessibilityRequirement.availabilityStarts |
Datum | Erforderlich: Datum, nach dem die Aktion verfügbar ist, in ISO-Wert 8601-Format (einschließlich Zeitzone).
Die entsprechende Entität muss unter folgendem Pfad im Feed angegeben werden: mindestens 7 Tage vor dem „availabilityStart“-Datum. Dies verbessert die die Wahrscheinlichkeit, dass die Inhalte rechtzeitig auf Google-Plattformen angezeigt werden. |
actionAccessibilityRequirement.availabilityEnds |
Datum | Erforderlich – Datum, nach dem die Aktion nicht mehr verfügbar ist
in ISO
8601-Format (einschließlich Zeitzone).
Es ist erforderlich, dass alle Aktualisierungen am „availabilityEnde“-Datum vorgenommen werden. mindestens 7 Tage vor dem „availabilityEndet“ im Feed. Dieses erhöhen die Chancen, dass die Inhalte nicht mehr auf Google erscheinen Oberflächen am „availabilityEndet“. |
actionAccessibilityRequirement.eligibleRegion |
Land, Stadt Bundesland, GeoShape oder SMS | Erforderlich: Regionen, in denen die Inhalte verfügbar sind. Verwenden Sie die Methode
Spezieller String EARTH , wenn der Inhalt global verfügbar ist. |
actionAccessibilityRequirement.ineligibleRegion |
Land, Stadt Bundesland oder GeoShape | Erforderlich, falls zutreffend – Regionen, in denen sich die Inhalte befinden
eingeschränkt. Sie müssen diese Property nicht angeben, wenn der Inhalt
überall in eligibleRegion verfügbar. |
actionAccessibilityRequirement.requiresSubscription |
MediaSubscription | Erforderlich, falls zutreffend: Die Details der Abo, das Nutzer benötigen, um auf die Inhalte zugreifen zu können. Weitere Informationen finden Sie unter Medienabo-Eigenschaften.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Angebot | Erforderlich, wenn die Inhalte einen Kauf erfordern: Details zum
das mit den Inhalten in Verbindung steht. Geben Sie die Preisinformationen für die
folgenden Fällen:
<ph type="x-smartling-placeholder">
Offer -Objekt vollständig und setze den category vom ActionAccessSpecification -Objekt auf free . Weitere Informationen finden Sie unter
Angebotseigenschaften:
|
Eigenschaften von Medienabos
Erforderlich, wenn actionAccessibilityRequirement.category
gleich
subscription
oder externalSubscription
.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
requiresSubscription.@type |
Text | Erforderlich – immer auf MediaSubscription festgelegt |
requiresSubscription.@id |
URL | Erforderlich: Die eindeutige ID des Abos. Wenn der Inhalt über verschiedene Abos zugänglich ist, muss jedes Abo eine eindeutige ID. |
requiresSubscription.name |
Text | Erforderlich: Der Name des Abos. Beachten Sie Folgendes:
<ph type="x-smartling-placeholder">
|
requiresSubscription.sameAs |
URL | Die Seite, auf der das Abo beschrieben wird. |
requiresSubscription.identifier |
Text | Erforderlich, wenn category gleich subscription UND
commonTier ist false
–
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 – ein Container, der den
Details zum Authenticator des externen Anbieters. |
requiresSubscription.authenticator.@type |
Text | Erforderlich, wenn category gleich
externalsubscription – immer festgelegt auf
Organization |
requiresSubscription.authenticator.name |
Text | Erforderlich, wenn category gleich
externalsubscription – der Name der Authentifizierung
. Legen Sie für TVE-Anbieter TVE fest. |
requiresSubscription.commonTier |
Boolesch | Erforderlich, falls zutreffend: Dies ist erforderlich, wenn die Kategorie auf Abo. Weitere Informationen zu "commonTier" finden Sie in der Allgemein finden Sie in der Dokumentation zu den Stufenanforderungen. |
Anforderungen an die Entitlements API
Eine entitlement API ist
erforderlich, wenn actionAccessibilityRequirement.category
subscription
ist oder
externalSubscription
und Ihr Aboangebot umfasst mehrere
Pakete oder Stufen
oder Add-on-Unterstützung bietet. Geben Sie dies nicht an, wenn Ihre
ist ein mehrstufiges Abo, das Zugriff auf alle Inhalte in Ihrem Katalog bietet.
- Unternehmen A hat ein einzelnes Aboangebot für Nutzer*innen mit Abo Zugriff auf alle verfügbaren Inhalte: Berechtigungs-ID / API ist nicht erforderlich
- Unternehmen B hat ein Basisabo, das Zugriff auf einige Inhalte und ein Premium-Abonnement, das Zugriff auf Premiuminhalte bietet: Berechtigungs-ID / API ist erforderlich
- Unternehmen C hat ein Basisabo, das Zugriff auf einige Inhalte und Add-on-Pakete, die Zugriff auf Inhalte Dritter bieten: Berechtigungs-ID / API ist erforderlich
Seiten zu Medienabos
Auf den folgenden Seiten finden Sie Informationen zu Themen im Zusammenhang mit diesen Properties:
Angebotseigenschaften
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
expectsAcceptanceOf.@type |
Text | Erforderlich: muss immer auf Offer gesetzt sein. |
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 als Kategorie „free“ an. |
expectsAcceptanceOf.priceCurrency |
Text | Erforderlich: die Währung des Preises aus drei Buchstaben ISO-Wert 4217-Format. |
expectsAcceptanceOf.seller |
Organisation | Die Organisation, die den Kauf von Inhalten anbietet. |
expectsAcceptanceOf.seller.@type |
Text | Immer auf Organization festlegen. |
expectsAcceptanceOf.seller.name |
Text | Der Name des Verkäufers. |
expectsAcceptanceOf.seller.sameAs |
Text | Die URL einer Webseite, auf der der Verkäufer identifiziert wird Beispiel: Der Verkäufer-Startseite angezeigt. |
Seite mit Angebot
Auf den folgenden Seiten finden Sie Informationen zu Themen im Zusammenhang mit diesen Properties:
IDs
Media Action-Feeds akzeptieren eine Vielzahl von Kennzeichnungen zur Identifizierung
Entität auf unmissverständliche Weise angeben. Diese Kennzeichnungen können dazu beitragen,
Abgleich des Inhalts Ihres Feeds mit den Inhalten des
Datenbanken. Die meisten dieser Kennzeichnungen können dem Feed mithilfe des
identifier
-Property für verschiedene Entitätstypen. EIDRs haben ihre eigene
repräsentative Property. Beides wird nachfolgend erörtert.
ID-Eigenschaften
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
identifier |
Text | Dringend empfohlen: Eine in der Regel eine externe Kennung, mit der eine bestimmte Entität eindeutig identifiziert wird. Es sind mehrere IDs zulässig. Diese Eigenschaft ist für alle Smartwatch-Aktionstypen verfügbar. In der folgenden Tabelle sind die zulässigen IDs und untergeordneten Eigenschaften der identifier -Property aufgeführt. Sieh dir das ID-/EIDR-Beispiel im Abschnitt „Beispiele für Watch Actions-Feeds“ an. |
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
@type |
Text | Erforderlich: muss immer auf PropertyValue gesetzt sein. |
propertyID |
Text | Erforderlich: Wir unterstützen die folgenden ID-Typen:
<ph type="x-smartling-placeholder">
|
value |
Text | Erforderlich: Der Wert für das angegebene ID-System. |
EIDR-Eigenschaften
EIDR (kurz für Entertainment Identifier Registry) ist ein weltweit eindeutiges Kennungssystem für ein breites Spektrum an Medieninhalten, einschließlich Filmen und Fernsehprogrammen. Das Identifizierungssystem löst eine Kennung in einen Metadateneintrag auf, der mit Titeln, Änderungen usw. der obersten Ebene verknüpft ist. In der folgenden Tabelle sind die mit EIDR verknüpften Eigenschaften und deren Verwendung aufgeführt.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
titleEIDR |
Text | Dringend empfohlen: Eine EIDR-Kennung (Entertainment Identifier Registry) steht für Film- oder Fernsehinhalte. Diese Property ist auf den Entitätsspezifikationen TVSeries, TVSeason, TVEpisode und Movie verfügbar. Beispiel: titleEIDR für den als „Ghostbusters“ bekannten Film ist „10.5240/7EC7-228A-510A-053E-CBB8-J“. Siehe Identifier/EIDR-Beispiel im Abschnitt „Beispiel für Wiedergabeaktionen“. |
editEIDR |
Text | Dringend empfohlen: Eine EIDR-Kennung (Entertainment Identifier Registry) steht für eine bestimmte Bearbeitung/Ausgabe eines Film- oder Fernsehwerks. Diese Property ist auf den Entitätsspezifikationsseiten TVEpisode und Movie verfügbar. Beispiel: Ein Film, der als „Ghostbusters“ bezeichnet wird mit dem TitelEIDR „10.5240/7EC7-228A-510A-053E-CBB8-J“, enthält mehrere Bearbeitungen, z.B. "10.5240/1F2A-E1C5-680A-14C6-E76B-I" und „10.5240/8A35-3BEE-6497-5D12-9E4F-3“. Die Property titleEIDR ist erforderlich, wenn editEIDR angegeben ist.Siehe Identifier/EIDR-Beispiel im Abschnitt mit den Feedbeispielen für Wiedergabeaktionen. |
Agenturen zur Inhaltsbewertung
Verwenden Sie die Werte in dieser Tabelle für BroadcastService.contentRating
, Movie.contentRating
und TVSeries.contentRating
. Die Rating-Agentur sollte dem Rating-Wert vorangestellt werden. Beispiele:
- Ein Film, der mit "R" bewertet wurde in den USA den
Movie.contentRating
-Wert „MPAA R“ haben sollte. - Eine Serie mit der Bewertung „TV-MA“ in den USA sollte für
TVSeries.contentRating
den Wert „TVPG TV-MA“ haben.
Land | TV-Bewertungsagentur | Agentur für Filmbewertungen |
---|---|---|
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/RUSSIA |
Aruba (AW) | Nicht verfügbar | Nicht verfügbar |
Australien (AU) | ACB TV | ACB-Filme |
Österreich (AT) | FSK | FSK |
Aserbaidschan (AZ) | Nicht verfügbar | MKRF/RUSSIA |
Bahrain (BH) | Nicht verfügbar | MPAA |
Belarus (BY) | Nicht verfügbar | MKRF/RUSSIA |
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) | KLASSE | KLASSE |
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 |
Korea (KR) | KMRB | KMRB |
Kuwait (KW) | Nicht verfügbar | MPAA |
Kirgisistan (KG) | Nicht verfügbar | MKRF/RUSSIA |
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 |
Moldawien (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/RUSSIA | MKRF/RUSSIA |
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 (Taiwan) | Nicht verfügbar | MOCTW |
Tadschikistan (TJ) | Nicht verfügbar | MKRF/RUSSIA |
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/RUSSIA |
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/RUSSIA |
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 von Postleitzahlen (z. B. US-amerikanische, kanadische oder andere Postleitzahlen)
- Eine Liste der Kanadischen Vorwärtssortierungsbereiche
- Eine Designated Market Area (DMA)-ID: Eine Kennung für eine Region in den USA, in der Nutzer die gleichen Fernsehkanäle und Programme erhalten.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
@id |
URL | Erforderlich: Die ID der geografischen Region im URI-Format. |
@type |
Text | Erforderlich: muss immer auf GeoShape gesetzt sein. |
addressCountry |
Text | Erforderlich: Der aus zwei Buchstaben bestehende ISO-Wert 3166-1 alpha-2-Ländercode. |
postalCode |
Text | Optional: Liste mit einer oder mehreren Postleitzahlen und/oder FSA-Codes (Forward Sortation Area) |
identifier |
PropertyValue | Optional: A DMA-ID (Designated Market Area), bei der es sich um Kennung der Region in den USA, in der Nutzer das Fernsehsendern und Programmen. |
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 das Objekt GeoShape
, das eine Liste von Postleitzahlen enthält:
{
"@type": "GeoShape",
"@id": "http://example.com/area1",
"addressCountry": "US",
"postalCode": [
"94118",
"94119"
]
}
Beispiel für das Objekt GeoShape
, 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 das Objekt GeoShape
, das eine DMA-ID enthält:
{
"@type": "GeoShape",
"@id": "http://example.com/area3",
"addressCountry": "US",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "DMA_ID",
"value": "501"
}
]
}