Реестр v1 представляет собой иерархическую структуру объектов фида в формате JSON-LD. Эта схема позволила партнерам программы раннего доступа использовать ее для интеграции с Ordering End-to-End. Схема инвентаризации v1 устарела.
Последняя версия спецификации канала данных, v2 Inventory, имеет плоскую структуру и использует модель реляционной схемы. Это позволяет партнерам более простым способом извлекать и преобразовывать объекты из своей реляционной базы данных для создания каналов данных. Реестр v2 находится в формате NDJSON, который представляет собой формат JSON с разделителями-новой строкой.
Почему вам следует перейти с версии 1 на версию 2
Несмотря на то, что мы продолжаем предоставлять техническую поддержку партнерам с интеграцией схемы инвентаризации Ordering End-to-End v1, все новые партнерские интеграции должны использовать инвентаризацию v2.
Новые функции в инвентаре версии 2 могут быть недоступны в инвентаре версии 1. Пример см. в разделе Сделка .
Этапы миграции
Для использования инвентаря версии 2 требуется отдельный проект сквозного заказа и новая интеграция. Следующий процесс объясняет, как перенести инвентаризацию версии 1 в инвентарь версии 2.
- Чтобы создать новый проект версии 2, сначала выполните шаги интеграции.
- Чтобы реализовать каналы данных, используйте схему реляционной инвентаризации.
- Если применимо, повторно используйте конечную точку выполнения из проекта версии 1.
- Когда ваш проект v2 будет готов к запуску, выполните следующие действия:
- Убедитесь, что ваш проект версии 2 соответствует контрольному списку готовности к запуску.
- Чтобы предотвратить предоставление конечным пользователям схемы инвентаризации версии 1 и версии 2, отмените развертывание рабочей версии из проекта версии 1. Ресурсы вашего проекта версии 1 перестанут использоваться в рабочей среде через несколько минут после этого шага.
- Создайте производственную версию для своего проекта версии 2 и сообщите об этом своему консультанту Google.
Шаги отката
Если вы хотите вернуться к версии 1 после развертывания проекта версии 2 в рабочей среде, вы можете отменить развертывание рабочей версии в проекте версии 2, а затем повторно развернуть производственную версию проекта версии 1.
Влияние на данные партнеров и рейтинг поставщиков
Ниже приведены потенциальные последствия для данных о партнерах и рейтинга поставщиков.
- Журналы транзакций и аналитические данные из вашего проекта версии 1 не переносятся в проект версии 2.
- Показатели производительности, такие как коэффициенты конверсии и показатели API из вашего проекта версии 1, не переносятся в проект версии 2. Это сбросит ваш рейтинг поставщика услуг в сквозном заказе.