Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Der Medienfeed ist ein JSON-Objekt, das eine Sammlung von Entitäten enthält, die die Medieninhalte in deinem Katalog repräsentieren, z. B. Serien, Filme, Songs und Alben. Der erste Schritt beim Onboarding besteht darin, Ihre Feeds zu entwickeln. Sobald die Dateien fertig sind, müssen Sie den Feed mit einer der unterstützten Hostingmethoden hosten, damit Google ihn regelmäßig abrufen kann.
Formatanforderungen an Feeddateien
Für die Feeddatei(en) gelten die folgenden Anforderungen:
Die Feeddatei muss die Dateiendung .json haben.
Verschlüsseln Sie Ihre Feeddatei nicht.
Codieren Sie Ihre Feeddatei in UTF-8 (prüfen Sie die Einstellung Ihres Dateieditors).
Wenn die Feeddatei größer als 1 GB ist (unkomprimiert), teilen Sie sie in mehrere Dateien auf.
Wir empfehlen, eine Datei pro Entitätstyp zu erstellen (z. B. tvseries.json, tvseasons.json, tvepisodes.json, movies.json usw.).
Wenn eine dieser Dateien 1 GB überschreitet, teilen Sie die Entitäten in mehrere Dateien auf (z. B. tvepisodes_01.json, tvepisodes_02.json usw.).
Solange die Dateigröße unter 1 GB liegt, ist die Anzahl der Entitäten, die in einer einzelnen Datei enthalten sein können, nicht begrenzt.
Die Datei muss gemäß der JSON-Spezifikationohne BOM codiert sein. Unter Linux darf hexdump file.json | head -n 1 nicht mit BBEF an der Adresse 0x00 beginnen.
Feedarten
Produktionsfeed
Dies ist die JSON-Feeddatei bzw. die JSON-Feeddateien, die zusammen Ihren gesamten Katalog darstellen, den Sie auf Google veröffentlichen möchten. Im folgenden Abschnitt erfahren Sie, wie Sie einen Feed erstellen.
Dieser Feed ist der einzige, den Sie benötigen, wenn Sie Google zum ersten Mal einbinden.
Nachdem dieser Feed an Google gesendet wurde, wird er ausführlich analysiert und mehrmals iteriert, um eine höhere Qualität in Bezug auf die Menge der erfassten Informationen und deren Richtigkeit zu erreichen, bevor er endgültig aufgenommen und veröffentlicht wird.
Staging-Feed
Für bestimmte Anwendungsfälle ist die Erweiterung des Produktionsfeeds erforderlich. Beispiele für solche Szenarien:
Der Feed wurde um neue Entitätstypen erweitert, die bisher nicht eingeführt wurden.
Der Feed wurde um eine große Anzahl neuer Entitäten/Metadaten erweitert, die in neuen Sprachen eingeführt werden.
Ausweitung des Feeds auf neue Plattformtypen Beispiel: Der Produktionsfeed wird nur in der Google Suche veröffentlicht und Sie möchten die Einführung auf Google TV ausweiten.
In solchen Fällen ist ein Staging-Feed erforderlich. Dieser Feed ist eine Kopie des Produktionsfeeds, enthält aber zusätzliche Metadaten, z. B. Deeplinks für eine neue Plattform oder Metadaten für eine neue Sprache.
Ähnlich wie beim Produktionsfeed wird dieser Feed ausführlich analysiert und mehrmals iteriert, um eine höhere Qualität hinsichtlich der erfassten Informationen und ihrer Richtigkeit zu erreichen.
Sobald die Qualitätsstufe erreicht ist, ersetzt dieser Feed den aktuellen Produktionsfeed und wird zum neuen Produktionsfeed.
Mit diesem Feed können wir die erste Einführung von den zusätzlichen Einführungen trennen und alle erforderlichen Tests durchführen, ohne den Produktionsfeed zu beeinträchtigen. So wird sichergestellt, dass die Nutzererfahrung nicht beeinträchtigt wird.
Wenden Sie sich an Ihren Google-Ansprechpartner, um eventuelle Fragen zu den oben genannten Punkten zu klären.
Feeddatei erstellen
Beachten Sie beim Erstellen des Feeds die folgenden Best Practices:
Bevor Sie einen Feed erstellen, der alle Inhalte in Ihrem Katalog enthält, empfehlen wir Ihnen, einen Beispielfeed mit nur wenigen Entitäten zu erstellen. Bei der Arbeit an Ihrem Feed werden Sie wahrscheinlich auf Probleme stoßen. Wenn Sie die Größe der Entitätsgruppe begrenzen, können Sie diese Fehler und Warnungen leichter beheben.
Wir stellen Tools zur Verfügung, mit denen Sie dafür sorgen können, dass Ihr Feed den Spezifikationen entspricht. Wir empfehlen Ihnen, diese Tools zu verwenden, um alle Fehler und Warnungen in Ihrem Beispielfeed zu beheben.
Nachdem Sie überprüft haben, dass Sie eine gute Struktur für die kleine Gruppe Ihrer Entitäten haben, erstellen Sie einen Feed für Ihren gesamten Katalog.
Beispielfeed erstellen
Wählen Sie eine repräsentative Entität aus Ihrem Katalog aus. Wählen Sie eine Entität mit einer relativ komplexen Struktur aus, die aber dennoch für eine Entität im Katalog typisch ist.
Verwenden Sie das Tool zur Datenfeed-Validierung, um Syntaxfehler und fehlende erforderliche Properties zu prüfen. (Details hierzu finden Sie im nächsten Abschnitt.)
Beispiel für einen Feed mit einer einzelnen Movie-Entität
{"@context":"http://schema.org","@type":"DataFeed","dateModified":"2018-07-20T00:44:51Z","dataFeedElement":[{"@context":["http://schema.org",{"@language":"en"}],"@type":"Movie","@id":"http://www.example.com/my_favorite_movie","url":"http://www.example.com/my_favorite_movie","name":"My Favorite Movie","potentialAction":{"@type":"WatchAction","target":{"@type":"EntryPoint","urlTemplate":"http://www.example.com/my_favorite_movie?autoplay=true","inLanguage":"en","actionPlatform":["http://schema.org/DesktopWebPlatform","http://schema.org/MobileWebPlatform","http://schema.org/AndroidPlatform","http://schema.org/AndroidTVPlatform","http://schema.org/IOSPlatform","http://schema.googleapis.com/GoogleVideoCast"]},"actionAccessibilityRequirement":{"@type":"ActionAccessSpecification","category":"subscription","requiresSubscription":{"@type":"MediaSubscription","name":"Example Package","commonTier":true,"@id":"[partner determined string]"},"availabilityStarts":"2018-07-21T10:35:29Z","availabilityEnds":"2019-10-21T10:35:29Z","eligibleRegion":[{"@type":"Country","name":"US"},{"@type":"Country","name":"CA"}]}},"sameAs":"https://en.wikipedia.org/wiki/my_favorite_movie","releasedEvent":{"@type":"PublicationEvent","startDate":"2008-01-20","location":{"@type":"Country","name":"US"}},"description":"This is my favorite movie.","actor":[{"@type":"Person","name":"John Doe","sameAs":"https://en.wikipedia.org/wiki/John_Doe"},{"@type":"Person","name":"Jane Doe","sameAs":"https://en.wikipedia.org/wiki/Jane_Doe"}],"identifier":[{"@type":"PropertyValue","propertyID":"IMDB_ID","value":"tt0123456"}]}]}
Beispielfeed validieren
Mit den folgenden Tools können Sie einen Beispielfeed anhand der Spezifikationen für strukturierte Daten von Google für Medienfeeds validieren.
Datenfeed-Validierungstool
Mit dem Datenfeed-Validierungstool können Sie jeweils nur eine Entität validieren. Mit diesem Tool können Sie eine Beispielentität aus Ihrem Katalog auf strukturelle Fehler und häufige Inhaltsfehler prüfen. Weitere Informationen zum Tool
JSON Schema Validation Tool
Mit dem JSON-Schema-Validierungstool können alle Dateien in einem Feed validiert werden. Verwenden Sie dieses Tool während der Entwicklung des Feeds, um häufige strukturelle Fehler zu vermeiden. Weitere Informationen zum Tool
Produktionsfeed erstellen
Sobald alle Fehler und Warnungen im Beispielfeed behoben sind, erweitern Sie den Feed, um alle Entitäten in Ihrem Katalog aufzunehmen.
Verwenden Sie das Datenfeed-Validierungstool häufig, um jeweils eine kleine Anzahl von Entitäten in Ihrem Feed zu validieren. Wenn Sie eine große Anzahl von Entitäten in das Tool einfügen, kann der Webbrowser einfrieren. Prüfen Sie, ob Ihr Feed alle Entitäten in Ihrem Katalog enthält, indem Sie die Anzahl der Entitäten in Ihrem Feed mit der Anzahl der Artikel in Ihrem Katalog vergleichen.
[null,null,[],[[["\u003cp\u003eThe Media feed is a JSON object that contains media content, and onboarding begins with developing and hosting these feeds.\u003c/p\u003e\n"],["\u003cp\u003eFeed files must be in \u003ccode\u003e.json\u003c/code\u003e format, UTF-8 encoded without BOM, unencrypted, and potentially split into multiple files if exceeding 1GB.\u003c/p\u003e\n"],["\u003cp\u003eTwo types of feeds exist: Production feed for initial launch of your entire catalog and Staging feed for subsequent expansions or new platform integrations.\u003c/p\u003e\n"],["\u003cp\u003eBefore creating a full production feed, it is recommended to start with a sample feed, validate it using provided tools, and then expand it to include your entire catalog.\u003c/p\u003e\n"]]],["The initial step in onboarding is developing media feeds, which are JSON files representing your catalog's content. Once developed, these files must be hosted for regular Google fetching. Feed files must be in `.json` format, UTF-8 encoded, unencrypted, and under 1GB (uncompressed); splitting larger files is recommended. Two types exist: production (for initial launch) and staging (for expansion), both are validated and iterated. You should start with a small sample feed for validation, then use tools to validate it, and expand to a production feed.\n"],null,["# Create a feed\n\nThe Media feed is a JSON object that contains a collection of entities that represent the\nmedia content in your catalog, such as TV Series, Movies, Songs, Albums, and more. The first step in\nthe onboarding process is to start developing your feeds. Once the files are ready, you need to [host](./host-the-feed)\nthe feed using one of the supported hosting methods for Google to fetch regularly.\n| **Note:** If you haven't gathered all the required information for your content, see the [Collect Information](../collect-information/) section.\n\nFeed file format requirements\n-----------------------------\n\nThe following are the requirements for the feed file(s):\n\n- Feed file must have the filename extension `.json`.\n- Don't encrypt your feed file.\n- Encode your feed file in UTF-8 (check your file editor setting).\n\n- Split the file into multiple files if your feed file is larger than 1 GB (uncompressed).\n\n- We recommend you create a file per entity type (for example, `tvseries.json`, `tvseasons.json`, `tvepisodes.json`, `movies.json`, etc).\n\n - If any of these files exceeds 1GB, split its entities into multiple files (for example, `tvepisodes_01.json`, `tvepisodes_02.json`, etc).\n - As long as the file size is less than 1 GB, there is no limitation on how many entities you can include in a single file.\n- Ensure that the file is encoded **without** BOM, as per [JSON specification](https://tools.ietf.org/html/rfc7159#section-8.1). To check on a linux OS, `hexdump file.json | head -n 1` must not start with `BBEF` at address 0x00.\n\nTypes of feeds\n--------------\n\n### Production feed\n\n- This represents the set of json feed file(s) that together represent your entire catalog you want to launch on Google. You can learn how to create a feed in the section below.\n- This is the only feed you need if you are integrating with Google for the first time.\n- Once this feed is submitted to Google, it will be extensively analyzed and iterated on a few times to achieve a higher quality bar w.r.t the amount of information being captured and its correctness before it is finally ingested and launched.\n\n### Staging feed\n\n- There are certain use cases that require the expansion of the production feed. A few examples of such scenarios are:\n - Expansion of the feed to include new entity types, not previously launched.\n - Expansion of the feed to include a huge number of new entities/metadata to launch in new locales.\n - Expansion of the feed to new platform types. For example, when the production feed is only launched on Google Search and now you want to expand the launch to Google TV.\n- In such cases, a staging feed is required. This feed is a copy of the production feed except that it has additional metadata, for example, deep links for a new platform, metadata for a new locale and so on.\n- Similar to the production feed, this will be extensively analyzed and iterated on a few times to achieve a higher quality bar w.r.t the amount of information being captured and its correctness. Once the quality bar is achieved, this feed replaces the current production feed to become the new production feed.\n- This feed allows us to separate the initial launch from the additional launches, perform all required testing, without affecting the production feed. This ensures no disruptions to the end user experience.\n\nWork with your Google representative to clarify any questions you may have on the above.\n\nCreate a feed file\n------------------\n\nFollow these best practices when creating the feed:\n\n1. [Create a sample feed using a small set of entities](#create_a_sample_feed)\n\n Before building a feed that contains all the content in your catalog, we recommend you create a\n sample feed with only a small set of entities. While working on your feed, you're likely to run into\n issues. By limiting your the size of the set of entities, you will be able to debug these errors and\n warnings more easily.\n2. [Validate the sample feed](#validate_the_sample_feed)\n\n We provide tools that ensure that your feed is compliant with the specifications. We recommend\n you use these tools to resolve all the errors and warnings found in your sample feed.\n3. [Create a production feed](#create_a_production_feed)\n\n After you've verified that you have a good structure for the small set of your entities, develop a feed for your entire catalog.\n\n### Create a sample feed\n\n1. Select one representative entity from your catalog. Choose an entity with a reasonably complex structure, but is still typical for an entity in the catalog.\n 2. Use the [Data Feed Validation tool](https://actions.google.com/tools/feed-validator/u/0/) to check for syntax errors and missing required properties. (See the next section for details.) Example of a feed with a single `Movie` entity \n\n ```carbon\n {\n \"@context\": \"http://schema.org\",\n \"@type\": \"DataFeed\",\n \"dateModified\": \"2018-07-20T00:44:51Z\",\n \"dataFeedElement\": [\n {\n \"@context\": [\"http://schema.org\", {\"@language\": \"en\"}],\n \"@type\": \"Movie\",\n \"@id\": \"http://www.example.com/my_favorite_movie\",\n \"url\": \"http://www.example.com/my_favorite_movie\",\n \"name\": \"My Favorite Movie\",\n \"potentialAction\": {\n \"@type\": \"WatchAction\",\n \"target\": {\n \"@type\": \"EntryPoint\",\n \"urlTemplate\": \"http://www.example.com/my_favorite_movie?autoplay=true\",\n \"inLanguage\": \"en\",\n \"actionPlatform\": [\n \"http://schema.org/DesktopWebPlatform\",\n \"http://schema.org/MobileWebPlatform\",\n \"http://schema.org/AndroidPlatform\",\n \"http://schema.org/AndroidTVPlatform\",\n \"http://schema.org/IOSPlatform\",\n \"http://schema.googleapis.com/GoogleVideoCast\"\n ]\n },\n \"actionAccessibilityRequirement\": {\n \"@type\": \"ActionAccessSpecification\",\n \"category\": \"subscription\",\n \"requiresSubscription\": {\n \"@type\": \"MediaSubscription\",\n \"name\": \"Example Package\",\n \"commonTier\": true,\n \"@id\": \"[partner determined string]\"\n },\n \"availabilityStarts\": \"2018-07-21T10:35:29Z\",\n \"availabilityEnds\": \"2019-10-21T10:35:29Z\",\n \"eligibleRegion\": [\n {\n \"@type\": \"Country\",\n \"name\": \"US\"\n },\n {\n \"@type\": \"Country\",\n \"name\": \"CA\"\n }\n ]\n }\n },\n \"sameAs\": \"https://en.wikipedia.org/wiki/my_favorite_movie\",\n \"releasedEvent\": {\n \"@type\": \"PublicationEvent\",\n \"startDate\": \"2008-01-20\",\n \"location\": {\n \"@type\": \"Country\",\n \"name\": \"US\"\n }\n },\n \"description\": \"This is my favorite movie.\",\n \"actor\": [\n {\n \"@type\": \"Person\",\n \"name\": \"John Doe\",\n \"sameAs\": \"https://en.wikipedia.org/wiki/John_Doe\"\n },\n {\n \"@type\": \"Person\",\n \"name\": \"Jane Doe\",\n \"sameAs\": \"https://en.wikipedia.org/wiki/Jane_Doe\"\n }\n ],\n \"identifier\": [\n {\n \"@type\": \"PropertyValue\",\n \"propertyID\": \"IMDB_ID\",\n \"value\": \"tt0123456\"\n }\n ]\n }\n ]\n }\n ```\n\n### Validate the sample feed\n\nThe following tools are available to help you validate a sample feed with Google's structured data\nspecifications for media feeds.\n\n- **Data Feed Validation tool**\n\n The Data Feed Validation tool can validate a single entity at a time. Use this tool to validate a sample\n entity from your catalog for structural errors and common content errors. You can find more\n details about the tool [here](../tools/troubleshoot-using-the-data-feed-validation-tool).\n- **JSON Schema Validation tool**\n\n The JSON Schema Validation tool can validate all files in a feed. Use this tool during the\n development of the feed to avoid common structural errors. You can find more details about the\n tool [here](../tools/jsonschemas).\n\n### Create a production feed\n\n1. Once all the errors and warnings in the sample feed are resolved, expand the feed to include all the entities in your catalog.\n2. Use the [Data Feed Validation tool](https://actions.google.com/tools/feed-validator/u/0/) frequently to validate a small number of entities in your feed at a time (Pasting a large number of entities on the tool may freeze the web browser). Confirm that your feed includes all the entities in your catalog by comparing the number of entities in your feed with the number of items in your catalog."]]
