Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Plik danych z multimediami to obiekt JSON zawierający zbiór elementów reprezentujących treści multimedialne w Twoim katalogu, np. seriale, filmy, piosenki, albumy itp. Pierwszym krokiem w procesie rejestracji jest rozpoczęcie tworzenia plików danych. Gdy pliki będą gotowe, musisz hostować kanał za pomocą jednej z obsługiwanych metod hostowania, aby Google mogło regularnie pobierać pliki.
Wymagania dotyczące formatu pliku danych
Oto wymagania dotyczące plików danych:
Plik danych musi mieć rozszerzenie .json.
Nie szyfruj pliku danych.
Zakoduj plik danych w formacie UTF-8 (sprawdź ustawienia edytora plików).
Jeśli plik pliku danych jest większy niż 1 GB (nieskompresowany), podziel go na kilka plików.
Zalecamy utworzenie osobnego pliku dla każdego typu encji (np. tvseries.json, tvseasons.json, tvepisodes.json, movies.json itd.).
Jeśli którykolwiek z tych plików przekracza 1 GB, podziel jego elementy na kilka plików (na przykład tvepisodes_01.json, tvepisodes_02.json itp.).
Dopóki rozmiar pliku nie przekracza 1 GB, nie ma limitu liczby elementów, które możesz umieścić w jednym pliku.
Upewnij się, że plik jest zakodowany bez BOM zgodnie ze specyfikacją JSON. W systemie operacyjnym Linux hexdump file.json | head -n 1 nie może zaczynać się od BBEF na adresie 0x00.
Rodzaje plików danych
Plik danych produkcyjnych
Jest to zbiór plików plików danych w formacie JSON, które razem stanowią cały katalog, który chcesz wprowadzić na Google. W sekcji poniżej dowiesz się, jak utworzyć plik danych.
Jeśli integracja z Google jest przeprowadzana po raz pierwszy, potrzebujesz tylko tego pliku danych.
Gdy ten plik danych zostanie przesłany do Google, zostanie dokładnie przeanalizowany i kilkakrotnie powtórzony, aby osiągnąć wyższy poziom jakości pod względem ilości uchwycionych informacji i ich poprawności, zanim zostanie ostatecznie przetworzony i uruchomiony.
Plik danych w wersji testowej
W niektórych przypadkach konieczne jest rozszerzenie pliku danych produkcyjnych. Oto kilka przykładów takich sytuacji:
Rozszerzenie pliku danych o nowe typy elementów, które nie były wcześniej dostępne.
Rozszerzenie pliku danych o ogromną liczbę nowych jednostek i metadanych, które mają być dostępne w nowych lokalizacjach.
Rozszerzenie pliku danych na nowe typy platform. Może to być na przykład sytuacja, gdy plik danych produkcyjnych jest dostępny tylko w wyszukiwarce Google, a teraz chcesz go udostępnić w Google TV.
W takich przypadkach wymagany jest plik danych w wersji testowej. Ten plik danych jest kopią wersji produkcyjnej, ale zawiera dodatkowe metadane, takie jak precyzyjne linki do nowej platformy, metadane dla nowego regionu itp.
Podobnie jak w przypadku pliku danych produkcyjnych, zostanie on dokładnie przeanalizowany i kilkakrotnie powtórzony, aby osiągnąć wyższą jakość pod względem ilości uchwycionych informacji i ich poprawności.
Gdy osiągniesz wymagany poziom jakości, ten plik danych zastąpi obecny plik danych w wersji produkcyjnej i stanie się nowym plikiem danych w wersji produkcyjnej.
Ten plik danych pozwala nam oddzielić początkowe wdrożenie od dodatkowych wdrożeń i przeprowadzić wszystkie wymagane testy bez wpływu na plik danych w wersji produkcyjnej. Zapewnia to płynne działanie aplikacji.
Jeśli masz pytania dotyczące powyższych informacji, skontaktuj się z przedstawicielem Google.
Tworzenie pliku danych
Podczas tworzenia pliku danych postępuj zgodnie z tymi sprawdzonymi metodami:
Przed utworzeniem pliku danych zawierającego wszystkie treści z katalogu zalecamy utworzenie przykładowego pliku danych z małym zestawem elementów. Podczas pracy nad kanałem możesz napotkać problemy. Ograniczenie rozmiaru zbioru jednostek ułatwi Ci debugowanie tych błędów i ostrzeżeń.
Udostępniamy narzędzia, które zapewniają zgodność pliku danych z wymaganiami. Zalecamy użycie tych narzędzi do naprawienia wszystkich błędów i ostrzeżeń znalezionych w próbnym pliku danych.
Po sprawdzeniu, czy masz odpowiednią strukturę dla małego zbioru jednostek, utwórz plik danych dla całego katalogu.
Tworzenie przykładowego pliku danych
Wybierz jeden reprezentatywny element z katalogu. Wybierz element o dość złożonej strukturze, ale nadal typowej dla elementu w katalogu.
Użyj narzędzia do sprawdzania pliku danych, aby sprawdzić, czy nie występują w nim błędy składni ani brak wymaganych właściwości. (szczegóły znajdziesz w następnej sekcji).
Przykład pliku danych z jednym elementem Movie
{"@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"}]}]}
Sprawdzanie poprawności przykładowego pliku danych
Aby sprawdzić, czy przykładowy plik danych jest zgodny ze specyfikacją uporządkowanych danych Google dotyczącą plików danych z multimediami, możesz użyć tych narzędzi.
Narzędzie do weryfikacji pliku danych
Narzędzie do weryfikacji pliku danych może weryfikować tylko jeden element naraz. Użyj tego narzędzia, aby sprawdzić, czy w przykładowym elemencie z katalogu nie ma błędów strukturalnych i typowych błędów treści. Więcej informacji o tym narzędziu znajdziesz tutaj.
Narzędzie do walidacji schematu JSON
Narzędzie do weryfikacji schematu JSON może weryfikować wszystkie pliki w kanale danych. Używaj tego narzędzia podczas tworzenia pliku danych, aby uniknąć typowych błędów strukturalnych. Więcej informacji o tym narzędziu znajdziesz tutaj.
Tworzenie pliku danych produkcyjnego
Gdy wszystkie błędy i ostrzeżenia w przykładowym pliku danych zostaną naprawione, rozszerz plik danych, aby uwzględnić wszystkie elementy w katalogu.
Często używaj narzędzia do weryfikacji pliku danych, aby weryfikować w jednym czasie niewielką liczbę encji w pliku danych (wklejanie dużej liczby encji w narzędziu może spowodować zawieszenie przeglądarki). Sprawdź, czy Twój plik danych zawiera wszystkie elementy w katalogu, porównując liczbę elementów w pliku danych z liczbą elementów w katalogu.
[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."]]
