Миграция с v1beta на v1

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

Ключевые отличия

Вот наиболее важные изменения, о которых следует знать при переходе с v1beta на v1 :

  • Однократная регистрация как минимум одного разработчика API для использования Merchant API: вам потребуется вызвать метод registerGcp (только один раз для каждого проекта Google Cloud, используемого для аутентификации), чтобы предоставить свои контактные данные, которые позволят вам использовать API и получать обновления и объявления, связанные с Merchant API. Вы не сможете использовать API v1 или v1alpha , пока не завершите этот шаг. Инструкции см. в разделе «Регистрация как разработчика».
  • Product.attributes переименовано : Поле Product.attributes было переименовано в Product.productAttributes .
  • Удаление информации о налогах на уровне товара: поля taxes и taxCategory удалены из объекта Product.productAttributes . Подробнее см. в статье справки Google Merchant Center о налогах.
  • Изменения в поле GTIN: Поле gtin в объекте Product.productAttributes переименовано в gtins , чтобы лучше отразить возможность хранения нескольких значений. Поле gtin в объекте OrderTrackingSignals.lineItemDetails теперь является array и также переименовано в gtins .
  • Удаление поля «Канал»: Поле channel было удалено из товаров, входных данных товаров и источников данных. Добавлено новое логическое поле legacyLocal для чёткого обозначения товаров, продаваемых исключительно в физических магазинах. Примечание: Поле legacyLocal — это вспомогательное поле, облегчающее миграцию, и в конечном итоге будет упразднено, как только методы онлайн-маркетинга и локального маркетинга станут полностью целевыми с использованием одного источника товаров. Дополнительную информацию см. в таблице в следующем разделе.
  • Новые поля для атрибутов регионального и местного инвентаря :
    • Все поля объекта RegionalInventory , за исключением name , account и region , теперь объединены в новый объект regionalInventoryAttributes . Например, атрибут RegionalInventory.price теперь находится в объекте RegionalInventory.regionalInventoryAttributes.price .
    • Все поля LocalInventory за исключением name , account и storeCode , теперь заключены в новый объект localInventoryAttributes . Например, атрибут LocalInventory.price теперь находится в LocalInventory.localInventoryAttributes.price .
  • Удаление customAttributes из региональных и локальных инвентарей: Поле customAttributes было удалено из ресурсов RegionalInventory и LocalInventory .
  • Усовершенствованное создание учётных записей: избыточное поле users удалено из CreateAndConfigureAccountRequest . Используйте единственное поле user , чтобы связать первоначального пользователя с новой учётной записью.
  • Некоторые типы атрибутов были изменены со строк на перечисления: некоторые поля в ресурсах Product и Inventory с определенным кратким списком значений были изменены со string типа на enum для лучшей проверки данных (например, поле Product.ProductAttributes.condition теперь является enum ).
  • Удаление метода обновления политики возврата онлайн: Метод onlineReturnPolicy.update удалён в v1 Создайте политику возврата онлайн с помощью метода onlineReturnPolicy.create .

Как мигрировать

Версия v1beta API Merchant должна прекратиться 28 февраля 2026 года. Дополнительную информацию о графике прекращения поддержки см. в руководстве по управлению версиями API Merchant .

  • Первым шагом при миграции является однократная регистрация разработчика (см. раздел Регистрация разработчика ). Для того чтобы методы v1 заработали, необходимо вызвать метод registerGcp для каждого проекта Google Cloud, используемого для аутентификации.

  • Независимо от того, как вы вызываете API (через REST, gRPC или с помощью клиентских библиотек ), миграция может быть поэтапной. Это означает, что вы можете обновлять и переносить код по одному API за раз (например, перенести API Products на v1 , сохранив API Accounts на v1beta ), без необходимости обновлять всю интеграцию сразу.

Подробные изменения полей

В этой таблице представлено подробное сравнение полей, которые изменились между версиями v1beta и v1 .

v1beta v1 Описание
Product.gtin Product.gtins Поле для GTIN-номеров было переименовано.
Product.taxes Удаленный Поле taxes было удалено.
Product.taxCategory Удаленный Поле taxCategory было удалено.
Product.channel Удаленный Поле channel удалено. Для локального использования используйте поле legacyLocal .
Product.attributes Product.productAttributes Поле attributes переименовано в productAttributes .
availability , condition , gender , includedDestinations и excludedDestinations в полях Product представлены в виде strings (или array strings ). Эти поля теперь являются enums (или array enums ). Поля с определенным кратким списком значений были изменены со string типа на enum .
price , salePrice , salePriceEffectiveDate и availability в RegionalInventory Перемещено в RegionalInventory.regionalInventoryAttributes Эти поля перемещены в regionalInventoryAttributes .
Поле RegionalInventory.availability — это string RegionalInventory.regionalInventoryAttributes.availability теперь является enums Доступность изменила тип со string на enum .
price , salePrice , salePriceEffectiveDate , availability , quantity , pickupMethod , pickupSla и instoreProductLocation в LocalInventory Перенесено в LocalInventory.localInventoryAttributes Эти поля перемещены в localInventoryAttributes .
Поле LocalInventory.availability — это string LocalInventory.localInventoryAttributes.availability теперь является enums Доступность изменила тип со string на enum .
LocalInventory.customAttributes Удаленный Пользовательские атрибуты больше не поддерживаются для локального инвентаря.
RegionalInventory.customAttributes Удаленный Пользовательские атрибуты больше не поддерживаются для регионального инвентаря.
ProductInput.channel Удаленный Поле channel удалено. Для локального использования используйте поле legacyLocal .
DataSource.channel Удаленный Поле channel удалено. Для локального использования используйте поле legacyLocal .
Нет в наличии ProductInput.legacyLocal Новое логическое поле, указывающее, что продукт может быть ориентирован только на локальные методы маркетинга. Идентификатор ресурса продукта будет иметь префикс «local~».
Нет в наличии Product.legacyLocal Новое логическое поле, указывающее, что товар продается только в местных магазинах и недоступен для покупки онлайн.
Нет в наличии DataSource.legacyLocal Новое логическое поле, указывающее, что источник данных содержит товары, продаваемые только в местных магазинах.
OrderTrackingSignals.LineItemDetails.gtin OrderTrackingSignals.LineItemDetails.gtins Поле gtin было переименовано в gtins и теперь представляет собой массив строк (вместо строки).
CreateAndConfigureAccountRequest.users Удаленный Поле users удалено. Используйте поле user , чтобы добавить первого администратора учётной записи.

Назад
Refactor code for concurrent requests
Далее
Overview