Создать фид

Канал мультимедиа — это объект JSON, содержащий набор сущностей, представляющих мультимедийное содержимое в вашем каталоге, например телесериалы, фильмы, песни, альбомы и т. д. Первым шагом в процессе онбординга является разработка фидов. Когда файлы будут готовы, вам необходимо разместить фид, используя один из поддерживаемых методов хостинга, чтобы Google мог регулярно получать его.

Требования к формату файла фида

Ниже приведены требования к файлам каналов:

  • Файл фида должен иметь расширение имени файла .json .
  • Не шифруйте файл фида.
  • Закодируйте файл фида в UTF-8 (проверьте настройки редактора файлов).

    alt_text

  • Разделите файл на несколько файлов, если ваш файл фида больше 1 ГБ (без сжатия).

  • Мы рекомендуем создавать файлы для каждого типа объекта (например, tvseries.json , tvseasons.json , tvepisodes.json , movies.json и т. д.).

    • Если какой-либо из этих файлов превышает 1 ГБ, разделите его сущности на несколько файлов (например, tvepisodes_01.json , tvepisodes_02.json и т. д.).
    • Пока размер файла меньше 1 ГБ, нет ограничений на количество объектов, которые вы можете включить в один файл.
  • Убедитесь, что файл закодирован без спецификации в соответствии со спецификацией JSON . Чтобы проверить на ОС Linux, hexdump file.json | head -n 1 не должен начинаться с BBEF по адресу 0x00.

Типы фидов

Производственный корм

  • Это представляет собой набор файлов фидов json, которые вместе представляют весь ваш каталог, который вы хотите запустить в Google. Вы можете узнать, как создать фид, в разделе ниже.
  • Это единственный канал, который вам нужен, если вы впервые интегрируетесь с Google.
  • После того, как этот фид будет отправлен в Google, он будет тщательно проанализирован и несколько раз повторен, чтобы достичь более высокого качества в отношении объема собираемой информации и ее правильности, прежде чем он будет окончательно принят и запущен.

Промежуточный канал

  • Существуют определенные варианты использования, которые требуют расширения производственного фида. Вот несколько примеров таких сценариев:
    • Расширение фида для включения новых типов сущностей, которые ранее не запускались.
    • Расширение канала для включения огромного количества новых сущностей/метаданных для запуска в новых локалях.
    • Расширение ленты на новые типы платформ. Например, когда производственный канал запускается только в поиске Google, а теперь вы хотите расширить запуск на Google TV.
  • В таких случаях требуется промежуточный фид. Этот фид является копией производственного фида, за исключением того, что он содержит дополнительные метаданные, например ссылки на контент для новой платформы, метаданные для новой локали и т. д.
  • Подобно производственному каналу, он будет тщательно проанализирован и несколько раз повторен для достижения более высокого качества бара в отношении объема собираемой информации и ее правильности. После достижения планки качества этот корм заменяет текущий производственный корм и становится новым производственным кормом.
  • Этот фид позволяет нам отделить первоначальный запуск от дополнительных запусков, провести все необходимые тесты, не затрагивая производственный фид. Это гарантирует отсутствие сбоев в работе конечного пользователя.

Обратитесь к своему представителю Google, чтобы уточнить любые вопросы, которые могут у вас возникнуть по вышеизложенному.

Создать файл фида

При создании фида придерживайтесь следующих рекомендаций:

  1. Создайте образец фида, используя небольшой набор сущностей

    Перед созданием фида, содержащего все содержимое вашего каталога, мы рекомендуем вам создать образец фида с небольшим набором сущностей. Во время работы над своим каналом вы, вероятно, столкнетесь с проблемами. Ограничив размер набора сущностей, вы сможете легче отлаживать эти ошибки и предупреждения.

  2. Проверка образца фида

    Мы предоставляем инструменты, которые гарантируют, что ваш фид соответствует спецификациям. Мы рекомендуем вам использовать эти инструменты для устранения всех ошибок и предупреждений, обнаруженных в вашем образце фида.

  3. Создать производственный фид

    Убедившись, что у вас есть хорошая структура для небольшого набора объектов, разработайте фид для всего каталога.

Создать образец фида

  1. Выберите один репрезентативный объект из вашего каталога. Выберите сущность с достаточно сложной структурой, но все же типичную для сущности в каталоге.
  2. Используйте средство проверки веб-канала данных , чтобы проверить наличие синтаксических ошибок и отсутствие необходимых свойств. (Подробности см. в следующем разделе.)

    Пример фида с одним объектом 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 может проверять все файлы в фиде. Используйте этот инструмент во время разработки фида, чтобы избежать распространенных структурных ошибок. Подробнее об инструменте можно узнать здесь .

Создать производственный фид

  1. Как только все ошибки и предупреждения в образце фида будут устранены, разверните фид, чтобы включить в него все объекты в вашем каталоге.
  2. Часто используйте инструмент проверки фида данных для одновременной проверки небольшого количества объектов в фиде (вставка большого количества объектов в инструмент может привести к зависанию веб-браузера). Убедитесь, что ваш фид включает все объекты в вашем каталоге, сравнив количество объектов в вашем фиде с количеством элементов в вашем каталоге.