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