Примечания к выпуску (v2.1)

18 августа 2025 г.

Content API устарел и будет отключен в августе 2026 года. Переходите на Merchant API.

19 июня 2025 г.

Продукция и услуги

Ресурс продукта

Добавлено поле maximum_retail_price , позволяющее указывать максимальную розничную цену (MRP) в Индии.

Служба поддержки продавцов

26 мая 2025 г.

Бухгалтерское обслуживание

Теперь можно добавлять в учетные записи пользователей с правами только для чтения.

14 апреля 2025 г.

Бухгалтерское обслуживание

Поскольку в будущем это требование отпадет, услуга accounttax была признана устаревшей.

17 марта 2025 г.

В связи с прекращением работы API, связанных с заказами , следующие сервисы были объявлены устаревшими:

  • accounts.verifyphonenumber
  • returnpolicy

Другие услуги

Данная конечная точка больше не требуется и может быть объявлена ​​устаревшей:

  • pubsubnotificationsettings

10 февраля 2025 г.

Добавлены поля prerendered_out_of_court_dispute_settlement в ProductIssue и AccountIssue .

Поля alternate_dispute_resolution из RenderProductIssuesResponse и RenderAccountIssuesResponse устарели.

12 декабря 2024 г.

Продукция и услуги

Добавлено поле sustainability_incentives для указания стимулов устойчивого развития, таких как налоговые льготы или скидки на вашу продукцию. Если значение поля не указано, товар не имеет права на какие-либо стимулы устойчивого развития.

15 ноября 2024 г.

Продукция и услуги

Для LoyaltyProgram добавлено поле shipping_label для указания права на участие. Если поле имеет значение, данное предложение включает в себя доставку в рамках программы лояльности. Если значение поля не указано, товар не подлежит доставке в рамках программы лояльности для данного уровня лояльности.

30 октября 2024 г.

В связи с прекращением работы API, связанных с расчетами, следующие сервисы объявляются устаревшими:

  • settlementreports
  • settlementtranscations

Отключение API, связанных с расчетами, связано с ранее закрытой программой BuyOnGoogle и API, связанными с заказами.

Ожидается, что обращения к указанным выше сервисам завершатся ошибкой Service was not found on the server .

16 октября 2024 г.

update_mask в UpdateConversionSourceRequest теперь имеет OPTIONAL . Если маска обновления не указана, обновляются все поля, имеющие непустое значение.

26 августа 2024 г. (раньше, чем было первоначально сообщено)

В связи с прекращением работы API, связанных с заказами , следующие сервисы были объявлены устаревшими:

  • orderinvoices
  • orderreports
  • orderreturns
  • orderreturns.labels
  • orders

Ожидается, что обращения к указанным выше сервисам завершатся ошибкой Service was not found on the server .

Сервис OrderTrackingSignals не устарел и продолжает оставаться доступным.

10 августа 2024 г.

Купить услуги Google

В рамках функции "Купить через API Google" при завершении работы все методы внутри BuyOnGoogleProgramService завершатся ошибкой service was not found on the server .

19 июля 2024 г.

Продукция и услуги

Добавлено поле member_price_effective_date . Это обновление позволяет указать, если применимо, диапазон дат, в течение которых действует цена для участников программы лояльности. Если значение поля не указано, цена для участников будет действовать всегда.

20 мая 2024 г.

Продукция и услуги

Добавлено LoyaltyPrograms . Это обновление позволяет указывать несколько уровней с различными бонусными баллами, ценами и т. д. для одного продукта. Это поле следует использовать вместо поля LoyaltyProgram в единственном числе.

Служба отчетов

Устаревшая функция отображения показателей «Покупка в Google» в таблице MerchantPerformanceView . После этого обновления получение любого показателя «Покупка в Google» будет возвращать 0. Это также относится к историческим значениям за прошлые даты.

Для получения дополнительной информации см. раздел «Устаревание функции «Покупка на Google»» .

13 мая 2024 г.

Продукция и услуги

Ресурс продукта

Изменения в поле «Сертификаты»: в поле «Сертификация продукта» добавлен certificationValue позволяющий указывать значение сертификата (также известное как класс, уровень или категория), что дает пользователям возможность загружать информацию о сертификате, даже если центр сертификации не выдает код или номер сертификата.

Для получения более подробной информации см. наши руководства по продукции .

6 мая 2024 г.

Служба отчетов

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

24 апреля 2024 г.

Продукция и услуги

Ресурс продукта

Добавлены необязательные поля downpayment и creditType для платежей в рассрочку :

  • downpayment представляет собой сумму, которую покупатель должен внести единовременно.
  • creditType указывает тип платежа в рассрочку ( finance или lease ). Это поле применимо только к объявлениям о продаже автомобилей.

11 апреля 2024 г.

Продукция и услуги

Ресурс продукта

  • Добавлен атрибут «Порог бесплатной доставки» ( FreeShippingThreshold ) для доставки на уровне предложения. Этот атрибут позволяет продавцам указывать минимальную цену товара, при которой доставка становится бесплатной.
  • Изменена видимость LoyaltyPoints

10 апреля 2024 г.

Продукция и услуги

Ресурс продукта

Добавлена LoyaltyProgram

9 апреля 2024 г.

Продукция и услуги

Ресурс продукта

Добавлены поля structuredTitle и structuredDescription для генерации заголовков и описаний товаров с помощью искусственного интеллекта.

3 апреля 2024 г.

Служба поддержки продавцов

Добавлено поле user_input_action_option , позволяющее партнерам запрашивать новый тип действия: BuiltInUserInputAction . Это действие позволяет партнерам создавать сложные функции самообслуживания для продавцов непосредственно в их приложении, вместо перенаправления их в Merchant Center.

Добавлен новый метод TriggerAction для BuiltInUserInputAction . Чтобы получить доступ к этому методу, отправьте запрос на добавление в список разрешенных в форме поддержки Shopping API в разделе «В чем проблема/вопрос?».

27 марта 2024 г.

Продукция и услуги

Ресурс продукта

В проектах «Автоматические скидки» и «Динамические акции» добавлена AutoPricingMinPrice в качестве гарантии того, что скидки на предложения продавцов не снизят цену товара ниже этого значения. Таким образом, сохраняется ценность и прибыльность предложения.

15 марта 2024 г.

Функция «Закрыть покупку» в Google для поиска и покупок больше недоступна. Вы можете продолжать просматривать существующие заказы до 31 октября 2024 года, используя orders.list и orders.get .

8 марта 2024 г.

Служба отчетов

В службу Reports добавлен отчет TopicTrendsView .

Для получения более подробной информации см. наши руководства по составлению отчетов .

6 марта 2024 г.

Служба отчетов

Добавлена ​​категория потенциального клика и ранжирования для товаров.

Для получения более подробной информации см. наши руководства по составлению отчетов .

19 февраля 2024 г.

Сервис ConversionSources

Из списка допустимых источников преобразования удалены следующие значения:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

Удалили варианты 60 и 90 в качестве дней для ретроспективного анализа и добавили 40 в качестве допустимого варианта.

17 января 2024 г.

POS-сервис

В поле matching_status_hint в PosStore добавлены новые значения, позволяющие пользователям получать более подробную информацию о причинах неудачного сопоставления данных с магазином.

11 января 2024 г.

Бухгалтерское обслуживание

Добавлены localProductManager и localProductManagement в качестве типа ссылки и сервиса соответственно для метода link . Это позволяет связывать учетные записи с целью управления локальными данными о продуктах.

29 ноября 2023 г.

Служба поддержки продавцов

Добавлен внешний тип действия VERIFY_IDENTITY_IN_MERCHANT_CENTER для проверки личности, которую необходимо выполнить в Merchant Center.

POS-сервис

В PosStore добавлены поля matching_status и matching_status_hint , которые позволяют пользователям узнать статус соответствия Pos Store магазину Google Business Profile Store и дают подсказку для исправления в случае возникновения проблемы.

15 ноября 2023 г.

Конечные точки repricingrules и repricingrules.repricingreports больше не поддерживаются.

1 ноября 2023 г.

Служба настроек доставки

shipment_type=pickup больше не поддерживается.

18 октября 2023 г.

Бухгалтерское обслуживание

Добавлено поле Business Identity , позволяющее продавцам самостоятельно определять свои потребительские ценности .

10 октября 2023 г.

Добавлен Collection Point в качестве нового типа доставки в настройках доставки. Доставка в пункт выдачи — это услуга, предоставляемая третьей стороной (например, не принадлежащей продавцу) для доставки товара в пункт выдачи, связанный с третьей стороной (например, пункты выдачи UPS Access Points), вместо прямой доставки на дом.

18 сентября 2023 г.

сервис настроек LIA

Добавлен метод setOmnichannelExperience , позволяющий пользователям настраивать многоканальный режим работы (то есть, параметры локального магазина и самовывоза). На данный момент эта функция доступна только пользователям, чей поставщик POS-систем имеет право разрешать такие настройки.

7 сентября 2023 г.

Покупка на Google, амортизация

Добавление нового статуса DEPRECATED в метод GetBuyOnGoogleProgramStastus . Повторная активация или приостановка программы из такого состояния невозможна.

4 сентября 2023 г.

Служба поддержки продавцов

Добавлено встроенное действие FIX_ACCOUNT_ISSUE для проблем с продуктом, которые необходимо решить на уровне учетной записи. Добавлено встроенное действие SHOW_ADDITIONAL_CONTENT , которое будет использоваться для предоставления обоснования от национального органа.

28 августа 2023 г.

Рекламная служба

В сервисе Promotions метод открытия list ограничен для всех пользователей.

22 августа 2023 г.

Служба поддержки продавцов

Запущена служба поддержки продавцов. Эта служба предоставляет справочную информацию по вопросам, связанным с учетными записями и продуктами.

4 августа 2023 г.

Служба отчетов

В службу отчетов добавлен отчет «Конкурентная прозрачность по ближайшим конкурентам».

Для получения более подробной информации см. наши руководства по составлению отчетов .

25 июля 2023 г.

POS-сервис

Инвентарь ресурсов

Добавьте поля pickup_method и pickup_sla , чтобы у продавцов была возможность отправлять информацию о самовывозе вместе со своими запасами.

14 июля 2023 г.

Служба отчетов

В службу отчетов добавлены отчеты по конкурентной прозрачности.

Для получения более подробной информации см. наши руководства по составлению отчетов .

7 июля 2023 г.

Продукция и услуги

Ресурс продукта

Добавлена virtualModelLink для предоставления URL-адресов изображениям 3D-модели.

4 июля 2023 г.

Продукция и услуги

Ресурс продукта

Добавьте поле certifications для указания сертификатов на продукцию, например, для маркировки энергоэффективности продукции на основе базы данных ЕС EPREL .

26 июня 2023 г.

Служба настроек доставки

Локальная доставка

Добавлено поле no_delivery_post_cutoff , позволяющее продавцам отказаться от отображения доставки в течение n+1 дня, если у них настроена доставка в течение n дней.

29 мая 2023 г.

Рекламная служба

Добавлен метод list для сервиса Promotions .

Сервис рекомендаций

Включите возможность закрытия взаимодействия в методе ReportInteraction службы рекомендаций.

9 мая 2023 г.

Облачный центр розничной торговли

Дополнительные объекты облачной розничной торговли

Добавьте поле «Дополнительные свойства облачной розничной торговли». Это повторяющееся поле, предназначенное для использования клиентами, использующими целевое приложение Cloud Retail. При использовании этого поля оно будет доступно при работе с программой облачной розничной торговли. Оно будет сопоставлено с полем «Атрибуты» в модели продукта Google Cloud Retail .

22 мая 2023 г.

Рекламная служба

Добавлен метод list для сервиса Promotions .

11 апреля 2023 г.

Служба настроек доставки

Локальная доставка

Добавлена ​​опция локальной доставки для продавцов, создающих новые настройки доставки. Они могут настроить параметры для местных магазинов в новом поле storeConfig . Это включает радиус обслуживания, время окончания приема заказов и коды магазинов, предлагающих локальную доставку.

3 апреля

Сервис рекомендаций

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

20 февраля 2023 г.

Бухгалтерское обслуживание

Ресурс учетной записи

В ресурс «Учетные записи» добавлен новый раздел Account.ConversionSettings .

Сервис ConversionSources

Добавлена ​​служба «Источники конверсии», которая позволяет управлять источниками конверсии (является частью раздела «Настройки конверсии» в Merchant Center).

16 февраля 2023 г.

Служба настроек доставки

Проверка кода магазина

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

Проверка продавца LIA

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

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

9 февраля 2023 г.

Служба продвижения

Расширьте сервис «Акции», добавив еще 6 вариантов targetCountry с поддержкой местного contentLanguage .

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

12 января 2023 г.

Продукция и услуги

Ресурс продукта

Добавлена lifestyleImageLinks для предоставления URL-адресов к изображениям, отражающим образ жизни.

24 ноября 2022 г.

Рекламная служба

В раздел Promotions.PromotionStatus добавлено новое поле `promotionStatus`. Это поле доступно только для чтения.

15 ноября 2022 г.

Служба отчетов

В раздел «Отчеты» добавлены отчеты «Анализ рынка».

Теперь вы можете запрашивать у службы отчетов следующую информацию:

Для получения более подробной информации см. наши руководства по составлению отчетов .

7 ноября 2022 г.

Сервис потоков данных

Добавлена ​​поддержка feedLabel для сервиса Datafeeds.

14 сентября 2022 г.

Обновлена feedLabel , теперь она принимает любую строку.

9 августа 2022 г.

Добавлена feedLabel для товаров.

Теперь вместо targetCountry можно использовать feedLabel для указания страны для идентификаторов предложений. Идентификаторы предложений теперь формируются в online:language:feedLabel:offerId .

Для обеспечения обратной совместимости feedLabel автоматически заполняется значением targetCountry для существующих фидов.

Устаревшая targetCountry .

Для поддержки глобальных предложений API контента для покупок отказался от поля targetCountry . Вместо него мы рекомендуем использовать поле shipping для указания целевых стран.

Теперь targetCountry автоматически заполняется значением, которое вы указываете в feedLabel .

Подробнее см. в статье блога «Метки в ленте заменяют целевую страну в Content API для покупок» .

8 декабря 2021 г.

Бухгалтерское обслуживание

Ресурс учетной записи

В ресурс «Учетные записи» добавлен новый раздел Account.AutomaticImprovements .

Этот новый раздел позволит продавцам автоматически обновлять товары, улучшать изображения и настройки доставки.

25 октября 2021 г.

Рекламная служба

Добавление функции «Получить продвижение» в API продвижения.

11 октября 2021 г.

API настроек доставки

В ресурс ShippingSettings добавлено новое поле warehouse , позволяющее продавцам управлять складами, которые можно использовать в параметре WarehouseBasedDeliveryTime .

Добавьте новое поле warehouseName в WarehouseBasedDeliveryTime , чтобы ссылаться на склад по его названию.

4 октября 2021 г.

Бухгалтерское обслуживание

Ресурс учетной записи

В раздел Accounts.BusinessInformation добавлено новое поле 'phone_verification_status'. Это поле только для чтения, значение устанавливается параметром Accounts.VerifyPhoneNumber .

13 сентября 2021 г.

Сервис BuyOnGooglePrograms

Ресурс BuyOnGoogleProgramStatus

В ресурс BuyOnGooglePrograms.BuyOnProgramStatus добавлены новые поля, представляющие: каналы онлайн-продаж, бизнес-модели и номер телефона службы поддержки клиентов.

Новый метод обновления UpdateBuyOnGoogleProgramStatus

Добавлен новый метод UpdateBuyOnGoogleProgramStatus, который позволит обновлять расширенный ресурс BuyOnGooglePrograms.BuyOnProgramStatus .

6 сентября 2021 г.

Бухгалтерское обслуживание

Ресурс учетной записи

В раздел Accounts.BusinessInformation добавлено новое поле 'korean_business_registration_number'. Это поле будет очищено только в том случае, если в него явно задано пустое значение.

30 августа 2021 г.

Рекламная служба

Добавлена ​​новая услуга продвижения с возможностью добавления рекламной акции.

Служба обработки заказов

Добавлен новый метод orders/captureOrder для списания средств перед отправкой.

Причина отмены нового заказа: FAILED_TO_CAPTURE_FUNDS

Продукция и услуги

Ресурс продукта

Добавлены поля productLength , productHeight , productWidth и productWeight для указания размеров и веса товара.

9 августа 2021 г.

Сервис правил переоценки

Тип правила переоценки

Новое значение перечисления для поля RepricingRuleType .

Добавлены TYPE_SALES_VOLUME_BASED и TYPE_COMPETITIVE_PRICE .

17 мая 2021 г.

Услуга по предоставлению этикеток для возврата заказов

В форму CreateReturnRequest добавлено новое поле 'product_id'. Продавцы могут указать либо product_id, либо line_item_id для идентификации возвращаемого товара.

Продукция и услуги

Добавлен новый метод для обновления существующих товаров . Теперь вы можете обновить товар, указав только те поля, которые необходимо обновить, а не весь товар целиком.

3 мая 2021 г.

Услуга по предоставлению этикеток для возврата заказов

Добавлены новые методы для загрузки этикеток для возвратов, управляемых продавцом (Merchant Managed Returns, MMR). С помощью нового метода orderreturns.labels.create вы можете загрузить этикетки для возврата, чтобы поделиться ими с клиентом.

26 апреля 2021 г.

API настроек доставки

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

В объекте CarriersCarrier добавлено новое поле eddServices , которое будет возвращать названия услуг, используемых для расчета предполагаемой даты доставки.

12 апреля 2021 г.

Продукция и услуги

Ресурс продукта

Добавлено новое поле additionalSizeType , позволяющее поддерживать до 2 типов размеров для каждого товара.

Изменения в поле доставки: добавлены minHandlingTime , maxHandlingTime , minTransitTime и maxTransitTime в ProductShipping для обеспечения скорости доставки на уровне предложения.

28 января 2021 г.

Бухгалтерское обслуживание

Добавлена ​​поддержка автоматического добавления меток к ресурсам AccountLabel и Account . Для получения дополнительной информации см. раздел «Типы меток CSS» в руководстве по управлению метками CSS.

5 октября 2020 г.

Сервис CSSES

Ресурс CSS

Добавлена ​​новая служба csses для получения информации о доменах CSS и присвоения им меток. Ресурс AccountLabel теперь также можно использовать для создания и отображения меток групп CSS. Для получения дополнительной информации см. раздел «Управление метками CSS» .

24 августа 2020 г.

Продукция и услуги

Ресурсы продуктов

В поле shoppingAdsExcludedCountries добавлена ​​возможность исключения предложений из показа рекламы в определенных странах.

Ресурс статусов продуктов

В объекте destinationStatuses появились новые поля approvedCountries , pendingCountries и disapprovedCountries , которые предоставляют информацию о статусе предложения, выходящую за рамки targetCountry .

Новое поле itemLevelIssues.applicableCountries .

10 августа 2020 г.

Бухгалтерское обслуживание

Добавлен новый ресурс AccountLabel для управления метками учетных записей Merchant Center в CSS Center. Теперь пользователи CSS Center также могут отображать список своих учетных записей Merchant Center и назначать им метки с помощью методов accounts.list , accounts.get и accounts.updatelabels . Для получения дополнительной информации см. раздел «Управление метками CSS» .

19 июня 2020 г.

Продукция и услуги

Ресурс продукта

Новые поля

Добавлены новые поля productDetails , productHighlights , subscriptionCost и canonicalLink .

2 июня 2020 г.

Служба обработки заказов

Добавлены новые методы для инициирования возврата средств без возврата товара. С помощью новых методов orders.refunditem и orders.refundorder вы можете инициировать возврат средств по заказам, даже если они не были возвращены покупателем.

27 апреля 2020 г.

Служба возврата заказов

Добавлены новые методы acknowledge и process , а также новые фильтры и поля для методов read ( list , get ).

Ссылки Google My Business

Добавлена ​​возможность связывать учетные записи Merchant Center с учетной записью GMB, используя идентификатор учетной записи GMB .

14 апреля 2020 г.

API для отчетов о расчетах

Добавлена ​​новая услуга для получения отчетов о расчетах .

9 марта 2020 г.

API локального инвентаря

Добавлена ​​новая услуга для отправки данных о локальном инвентаре.

2 марта 2020 г.

API настроек уведомлений Pubsub

Добавлена ​​новая служба для управления настройками уведомлений PUBG .

3 декабря 2019 г.

Продукция и услуги

Добавлена ​​поддержка дополнительных каналов Content API для нескольких учетных записей клиентов.

11 сентября 2019 г.

Служба обработки заказов

Добавлена ​​поддержка самовывоза заказов и соответствующих функций тестовой среды.

14 августа 2019 г.

Новые услуги

Добавлены новые сервисы «Политика возврата» и «Адрес возврата» для функции «Покупка в Google».

Служба обработки заказов

Заказать ресурс

Новое поле

Новое поле quantityUndeliverable .

7 августа 2019 г.

Служба обработки заказов

Заказать ресурс

Новые поля

В ресурс Order добавлены новые поля loyaltyInfo и invoiceReceivingEmail .

1 июля 2019 г.

Продукция и услуги

В сервисе «Продукты» добавлена ​​поддержка дополнительных каналов Content API.

11 июня 2019 г.

Служба обработки заказов

Ресурсы для оформления и тестирования заказов

Добавление корректировки цены

Добавлено новое поле lineItem[].adjustments , содержащее корректировку исходной цены позиции и налога, вызванную применением акций.

14 февраля 2019 г.

Изменения, внесенные в эту версию

Пробные запуски больше не поддерживаются.

Параметр dryRun был удален из версии 2.1. Это относится ко всем вызовам API.

Методы установки патчей больше не поддерживаются.

Следующие сервисы больше не поддерживают метод patch :

  • Счета
  • Бухгалтерский налог
  • Потоки данных
  • Связи
  • Настройки доставки

Удаление методов HTTP BATCH

Все методы HTTP BATCH были удалены из версии 2.1. Вместо них используйте customBatch . Затронутые сервисы:

  • Счета
  • Статусы учетных записей
  • Потоки данных
  • Статусы фидов данных
  • Связи
  • Отчеты о заказах
  • Поз
  • Продукты
  • Статусы продукта
  • Настройки доставки

Бухгалтерское обслуживание

Обновлять

Поля businessInformation и googleMyBusinessLink в запросе были введены после первоначального запуска Content API v2. Благодаря этому существует защита, предотвращающая непреднамеренное удаление информации в этих двух полях при update , если они не указаны.

В версии 2 продавцам необходимо явно указывать эти поля с пустым телом ( {} ), чтобы удалить их. В версии 2.1 поля удаляются, если вы указываете пустое тело, или если вы их не указываете.

Ресурс учетной записи

Ребрендинг AdWords -> Google Ads

В связи с преобразованием AdWords в Google Ads , следующие поля, связанные с AdWords, были переименованы:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
Удаление устаревших полей и значений

Устаревшее поле reviewsUrl удалено. Кроме того, удален статус ссылки inactive для adsLinks , googleMyBusinessLink и youtubeChannelLinks .

Служба статусов учетных записей

Ресурс AccountStatus

Удаление проблем качества данных

Эти параметры были заменены на itemLevelIssues .

Сервис передачи данных

Ресурс потока данных

Удаление устаревших полей

Поля contentLanguage , targetCountry и intendedDestinations были удалены и заменены на country , language , includedDestinations и excludedDestinations в targets .

Удаление обновления товарных запасов

Удалены данные об product inventory update .

Служба инвентаризации

В версии 2.1 служба inventory v2 была удалена и заменена двумя новыми функциями:

  • Для частичного обновления информации о товарах используйте новые дополнительные каналы .
  • Воспользуйтесь новой службой localinventory для обновления информации о товарах на локальном уровне.

Служба обработки заказов

Отменить строку

Поля amount , amountPretax и amountTax в запросе удалены. Сумма возврата теперь рассчитывается автоматически.

CustomBatch

CustomBatch была удалена из версии 2.1.

InStoreRefundLineItem

Поля amountPretax и amountTax заменены на priceAmount и taxAmount соответственно. Поле priceAmount может содержать сумму до или после уплаты налогов в зависимости от местоположения заказа.

Возвращать деньги

Этот метод был удалён. Используйте вместо него returnRefundLineItem .

Возвратная строка

Этот метод был удалён. Вместо него используйте returnRefundLineItem , не указывая сумму возврата.

Возвратная строка

Поля amountPretax и amountTax заменены на priceAmount и taxAmount соответственно. Поле priceAmount может содержать сумму до или после уплаты налогов в зависимости от местоположения заказа.

ShipLineItem

Поля carrier , shipmentId и trackingId в запросе перемещены в shipmentInfos .

Ресурсы для оформления и тестирования заказов

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

В версии 2.1 появился новый формат акций. Теперь нельзя создавать тестовые заказы с акциями.

Удаление устаревших полей

Поле paymentMethod было удалено, и теперь billingAddress и predefinedBillingAddress являются полями верхнего уровня в Order и TestOrder соответственно.

Кроме того, customer.explicitMarketingPreference было удалено и заменено на customer.marketingRightsInfo как в Order , так и TestOrder .

Устаревшее поле customer.email удалено.

В ресурсе Order изменился формат поля promotions .

Сервис платежей по заказам

Данная услуга была удалена из версии 2.1.

Продукция и услуги

В ответе на запрос insert будут содержаться только следующие атрибуты:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

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

Теперь перед получением добавленного товара с помощью get или list возникает задержка в несколько минут.

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

Цены теперь проверяются перед добавлением товара. В строке значения допускаются только следующие символы: + , - , . , и цифры ( 0 9 . Запятые больше не принимаются.

Ресурс продукта

CustomGroups заменены рекурсивными customAttributes

Ранее, в версии 2, пользовательские атрибуты можно было группировать, добавляя их в одну и ту же пользовательскую группу. В версии 2.1 пользовательские атрибуты теперь рекурсивно генерируются, поэтому необходимость в пользовательских группах отпадает.

В дополнение к исходному полю value пользовательские атрибуты теперь имеют дополнительное поле groupValues ; необходимо задать ровно одно из них, то есть они не могут быть заданы одновременно или пропущены.

Поскольку продавцы могут переключаться между версиями v2 и v2.1, возможно наличие у товаров рекурсивных пользовательских атрибутов, которые не могут быть представлены в версии v2, так как пользовательские группы имеют максимум два уровня. В этом случае группа пользовательских атрибутов будет усечена.

Удаление типа и единицы измерения в пользовательских атрибутах

В версии 2.1 пользовательские атрибуты больше не будут содержать type и unit . Вместо этого к value будут добавляться единицы измерения (если они присутствуют), а типы должны определяться автоматически. Например, в версии 2.1 используйте в качестве value «1.23 EUR» или «5.6 cm».

ProductTypes имеет приоритет над productType и additionalProductTypes.

Ранее типы товаров хранились в двух полях: первый тип находился в единственном числе в поле productType , а остальные — в повторяющемся поле additionalProductTypes . В версии 2.1 эти два поля были заменены одним повторяющимся полем productTypes .

Атрибут Destinations заменен на includedDestinations и excludedDestinations.

В версии 2 адреса назначения вводились в виде списка пар «название назначения — намерение» в повторяющемся поле destinations . Это поле было заменено двумя следующими повторяющимися полями: includedDestinations и excludedDestinations . Адреса назначения, включенные по умолчанию, не обязательно должны быть включены в includedDestinations. Это будет соответствовать конфигурации переопределений адресов назначения в лентах.

В связи с преобразованием AdWords в Google Ads , следующие поля, связанные с AdWords, были переименованы:

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
Удаление устаревших полей

Следующие устаревшие поля были удалены:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Сервис статусов товаров

Получить и составить список

Атрибут product был удален, как и параметр includeAttributes . Для получения атрибутов продукта, соответствующих статусу, используйте службу Products и значение нового поля productId .

Список

Параметр includeInvalidInsertedItems был удален. Теперь возвращаются все товары независимо от того, являются ли они действительными, то есть list теперь ведет себя так, как если бы includeInvalidInsertedItems всегда был установлен в true .

Ресурс ProductStatus

НаправленияСтатусы

Поля intention , approvalStatus и approvalPending в destinationStatuses заменены на status , представляющее собой строку, которая может принимать одно из значений approved , disapproved или pending .

Удаление проблем качества данных

Эти параметры были заменены на itemLevelIssues .