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

18 августа 2025 г.

API контента устарел и будет закрыт в августе 2026 года. Переход на 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 «Buy on 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 г.

Продукты Сервис

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

Изменения в поле сертификации: В поле ProductCertification добавлено 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 . Чтобы получить доступ к этому методу, отправьте запрос через эту форму .

27 марта 2024 г.

Продукты Сервис

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

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

15 марта 2024 г.

Sunset Buy в 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 г.

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

Метод открытого list в сервисе Promotions с ограниченным доступом для всех.

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 в ресурс Accounts .

Служба 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 г.

Продвижение услуг

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

15 ноября 2022 г.

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

В службу отчетов добавлены отчеты Market Insights.

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

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

7 ноября 2022 г.

Служба каналов данных

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

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

Обновлен feedLabel для принятия любой строки.

9 августа 2022 г.

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

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

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

Устаревшее значение targetCountry .

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

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

Более подробную информацию см. в записи блога Метка фида заменяет целевую страну в Content API for Shopping .

8 декабря 2021 г.

Служба учета

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

Добавлен новый раздел Account.AutomaticImprovements в ресурс Accounts .

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

25 октября 2021 г.

Продвижение услуг

Добавление Get Promotion в Promotion API.

11 октября 2021 г.

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

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

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

4 октября 2021 г.

Служба учета

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

Добавлено новое поле «phone_verification_status» в раздел Accounts.BusinessInformation . Это поле доступно только для чтения и устанавливается с помощью Accounts.VerifyPhoneNumber .

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

Сервис BuyOnGooglePrograms

Ресурс BuyOnGoogleProgramStatus

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

Новый метод UpdateBuyOnGoogleProgramStatus

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

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

Служба учета

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

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

30 августа 2021 г.

Продвижение услуг

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

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

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

Новая причина отмены заказа FAILED_TO_CAPTURE_FUNDS

Продукты Сервис

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

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

9 августа 2021 г.

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

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

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

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

17 мая 2021 г.

Заказ услуги возврата этикеток

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

Продукты Сервис

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

3 мая 2021 г.

Заказ услуги возврата этикеток

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

26 апреля 2021 г.

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

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

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

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 для исключения предложений из рекламы в определенных странах.

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

Новые поля approvedCountries , pendingCountries и disapprovedCountries в объекте destinationStatuses , которые предоставляют информацию о статусе предложения за пределами 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 , а также новые фильтры и поля для методов чтения ( list , get ).

Ссылка на GMB

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

14 апреля 2020 г.

API отчетов по расчетам

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

9 марта 2020 г.

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

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

2 марта 2020 г.

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

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

3 декабря 2019 г.

Продукты Сервис

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

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

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

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

14 августа 2019 г.

Новые услуги

Добавлены новые услуги Returnpolicy и Returnaddress для Buy on Google.

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

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

Новое поле

Новое quantityUndeliverable .

7 августа 2019 г.

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

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

Новые поля

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

1 июля 2019 г.

Продукты Сервис

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

11 июня 2019 г.

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

Ресурсы Order и TestOrder

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

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

14 февраля 2019 г.

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

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

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

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

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

  • Счета
  • Accounttax
  • Потоки данных
  • Настройки
  • Настройки доставки

Удаление 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 удалено. Кроме того, для adsLinks , googleMyBusinessLink и youtubeChannelLinks удален статус ссылки inactive .

Служба статусов аккаунтов

Ресурс AccountStatus

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

Они были заменены itemLevelIssues .

Служба передачи данных

Ресурс Datafeed

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

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

Удаление обновления инвентаризации продукции

Каналы product inventory update были удалены.

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

Служба inventory v2 была удалена и заменена двумя новыми функциями в v2.1:

  • Используйте новые дополнительные каналы для частичных обновлений продуктов.
  • Используйте новую службу localinventory для получения локальных обновлений продуктов.

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

ОтменаЛинии

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

CustomBatch

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

InStoreRefundLineItem

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

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

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

ReturnLineItem

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

ReturnRefundLineItem

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

ShipLineItem

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

Ресурсы Order и TestOrder

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

В версии 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 .

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

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

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

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

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

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

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

Удаление типа и единицы измерения в customAttributes

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

ProductTypes заменяет productType и additionalProductTypes

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

Атрибут Destinations заменен на enabledDestinations и testedDestinations

В версии 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 .