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.
Теперь вы можете запрашивать в службе отчетов следующее:
- Отчеты о бестселлерах с использованием таблиц
BestSellersProductClusterView
иBestSellersBrandView
. - Отчет о конкурентоспособности цен с использованием таблицы
PriceCompetitivenessProductView
. - Отчет о ценах с использованием таблицы
PriceInsightsProductView
.
Более подробную информацию можно найти в наших руководствах по отчетности .
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, были переименованы:
-
adwordsLinks
->adsLinks
-
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
После того, как 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
.