Фид медиаконтента – это объект JSON, который содержит набор объектов, представляющих медиаконтент в вашем каталоге, например сериалы, фильмы, песни, альбомы и т. д. Первый шаг в процессе адаптации — начать разработку фидов. Когда файлы будут готовы, вам нужно будет разместить фид, используя один из поддерживаемых методов размещения, чтобы Google мог регулярно его получать.
Требования к формату файла фида
Ниже приведены требования к файлам фидов.
- Файл фида должен иметь расширение
.json. - Не шифруйте файл фида.
Используйте кодировку UTF-8 (проверьте настройки редактора файлов).

Если размер файла фида превышает 1 ГБ (в несжатом виде), разделите его на несколько файлов.
Рекомендуем создать по одному файлу для каждого типа объектов (например,
tvseries.json,tvseasons.json,tvepisodes.json,movies.jsonи т. д.).- Если размер какого-либо из этих файлов превышает 1 ГБ, разделите его объекты на несколько файлов (например,
tvepisodes_01.json,tvepisodes_02.jsonи т. д.). - Если размер файла не превышает 1 ГБ, то в него можно добавить любое количество объектов.
- Если размер какого-либо из этих файлов превышает 1 ГБ, разделите его объекты на несколько файлов (например,
Убедитесь, что файл закодирован без BOM, как указано в спецификации JSON. Чтобы проверить ОС Linux,
hexdump file.json | head -n 1не должен начинаться сBBEFпо адресу 0x00.
Типы фидов
Фид товаров
- Это набор файлов фида JSON, которые вместе представляют весь ваш каталог, который вы хотите запустить в Google. Инструкции по созданию фида приведены в разделе ниже.
- Если вы интегрируете свои данные с Google впервые, вам нужен только этот фид.
- После отправки фида в Google он будет тщательно проанализирован и несколько раз доработан, чтобы достичь более высокого уровня качества в отношении объема собираемой информации и ее правильности, прежде чем он будет окончательно принят и запущен.
Тестовый фид
- В некоторых случаях требуется расширение фида товаров. Вот несколько примеров:
- Расширение фида за счет добавления новых типов объектов, которые ранее не использовались.
- Расширение фида, чтобы включить в него большое количество новых объектов и метаданных для запуска в новых регионах.
- Расширение фида на новые типы платформ. Например, если фид товаров запущен только в Google Поиске, а вы хотите запустить его и в Google TV.
- В таких случаях требуется тестовый фид. Этот фид является копией рабочего фида, но содержит дополнительные метаданные, например ссылки на контент для новой платформы, метаданные для нового региона и т. д.
- Как и в случае с фидом товаров для рабочей среды, мы тщательно проанализируем его и выполним несколько итераций, чтобы повысить качество и точность собираемой информации. Когда качество фида товаров достигнет нужного уровня, он заменит текущий рабочий фид товаров и станет новым рабочим фидом товаров.
- Это позволит нам отделить первоначальный запуск от последующих и провести все необходимые тесты, не затрагивая основной фид. Это позволяет избежать сбоев в работе конечных пользователей.
Если у вас возникнут вопросы, обратитесь к представителю Google.
Создайте файл фида
При создании фида следуйте приведенным ниже рекомендациям.
Создайте тестовый фид с небольшим набором объектов
Прежде чем создавать фид со всеми товарами из каталога, рекомендуем создать тестовый фид с небольшим набором объектов. При работе с фидом вы можете столкнуться с проблемами. Ограничив размер набора объектов, вы сможете легче устранять эти ошибки и предупреждения.
-
Мы предоставляем инструменты, которые позволяют убедиться, что фид соответствует спецификации. Рекомендуем использовать эти инструменты, чтобы устранить все ошибки и предупреждения, обнаруженные в вашем образце фида.
-
Убедившись, что структура фида для небольшого набора объектов корректна, разработайте фид для всего каталога.
Создайте пример фида
- Выберите один объект из каталога. Выберите объект с достаточно сложной структурой, но типичный для каталога.
- Используйте инструмент проверки схемы JSON, чтобы найти синтаксические ошибки и отсутствующие обязательные свойства. Подробная информация приведена в следующем разделе.
Пример фида с одним объектом
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" } ] } ] }
Проверьте пример фида
Для проверки фида на соответствие спецификациям структурированных данных Google для фидов медиаконтента можно использовать следующие инструменты:
Инструмент проверки схем JSON
Инструмент JSON Schema Validation проверяет все файлы в фиде локально перед загрузкой. Используйте этот инструмент во время разработки фида, чтобы избежать распространенных ошибок в структуре и типах данных. Подробнее об инструменте…
Ресурсы каталога в Search Console
После того как представитель Google включит ресурс-каталог Search Console и ваш тестовый или промежуточный фид будет обработан, используйте ресурсы-каталоги в Search Console, чтобы проверить ошибки валидации на уровне объектов, предупреждения и диагностику обработки.
Создайте фид товаров
- Когда все структурные ошибки и предупреждения в тестовом фиде будут устранены, расширьте фид, включив в него все объекты из каталога.
- Запустите инструмент проверки схемы JSON для расширенных файлов фида и после загрузки проверьте свойства каталога в Search Console, чтобы убедиться в отсутствии ошибок. Убедитесь, что в фиде есть все объекты из каталога. Для этого сравните количество объектов в фиде с количеством объектов в каталоге.