Эта страница переведена с помощью Cloud Translation API.

Создать фид

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

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

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

Файл фида должен иметь расширение .json .
Не шифруйте файл канала.
Закодируйте файл фида в UTF-8 (проверьте настройки редактора файлов).
Разделите файл на несколько файлов, если размер файла фида превышает 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, чтобы разъяснить любые вопросы, которые могут у вас возникнуть по вышеизложенному.

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

При создании фида следуйте этим рекомендациям:

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

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

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

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

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

Создайте рабочий фид

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

Определите цену

Разместите ленту