Миграция с 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 , чтобы добавить первого администратора учётной записи.