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

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 .

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

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

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

13 мая 2024 г.

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

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

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

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

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 on Google for Search and Shopping. Вы можете продолжать просматривать существующие заказы до 31 октября 2024 года с помощью orders.list и orders.get .

08 марта 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-сервис

Добавлены поля matching_status и matching_status_hint в PosStore , которые позволяют пользователям узнать статус соответствия 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

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

22 мая 2023 г.

Промо-акции

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

11 апреля 2023 г.

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

Местное исполнение

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

3 апреля

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

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

20 февр. 2023 г.

Служба учета

Ресурс аккаунта

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

Служба ConversionSources

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

16 февр. 2023 г.

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

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

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

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

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

  • 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 г.

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

Добавлены новые методы загрузки этикеток для Merchant Managed Returns (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 Label Management .

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 г.

Заказы Службы

Ресурсы заказа и тестирования заказа

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

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

14 февраля 2019 г.

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

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

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

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

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

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

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

Все методы HTTP BATCH были удалены из v2.1. Вместо этого используйте customBatch . Затронутые службы следующие:

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

Служба учета

Обновлять

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

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

Ресурс аккаунта

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

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

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

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

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

Ресурс AccountStatus

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

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

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

Ресурс Datafeed

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

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

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

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

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

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

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

Заказы Службы

ОтменитьПунктЛинии

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

Пользовательская партия

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

InStoreRefundLineItem

Поля amountPretax и amountTax были заменены на priceAmount и taxAmount соответственно. Поле priceAmount может быть pre-tax или post-tax в зависимости от местоположения заказа.

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

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

ReturnLineItem

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

ВозвратВозвратЛинииЭлемент

Поля amountPretax и amountTax были заменены на priceAmount и taxAmount соответственно. Поле priceAmount может быть pre-tax или post-tax в зависимости от местоположения заказа.

ShipLineItem

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

Ресурсы заказа и тестирования заказа

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

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

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

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

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

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

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

Служба заказовплатежей

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

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

Ответ от insert будет содержать только следующие атрибуты:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пункты назначения были введены как список пар имени пункта назначения и намерения в v2 в повторяющемся поле 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 .