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

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

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 .

,

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

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 Service

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

11 января 2024 года

Сервис счетов

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

29 ноября 2023 г.

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

Добавлено VERIFY_IDENTITY_IN_MERCHANT_CENTER Внешнее действие для проверки идентификации, которая должна быть выполнена в торговом центре.

POS Service

Добавлены поля matching_status и matching_status_hint в Posstore , что позволяет пользователям знать сопоставление статуса POS Store с Google Business Store и намек на исправление в случае проблемы.

15 ноября 2023 г.

repricingrules и repricingrules.repricingreports точки.

1 ноября 2023 г.

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

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

18 октября 2023 г.

Сервис счетов

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

10 октября 2023 г.

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

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

Служба настроек LIA

Добавлен метод setOmnichannelExperience , чтобы позволить пользователям установить свой Omnichannel Experience (то есть локальные настройки Storefront и Pickup). К этому времени это доступно только для пользователей, чьи поставщика POS доверяют для включения таких настроек.

7 сентября 2023 года

Купить в Google Tempercation

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

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

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

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

28 августа 2023 г.

Служба акций

Открытый метод list в службе Promotions от ограниченного доступа ко всем.

22 августа 2023 г.

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

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

4 августа 2023 г.

Отчеты Сервис

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

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

25 июля 2023 г.

POS Service

Инвентарный ресурс

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

14 июля 2023 г.

Отчеты Сервис

Добавлены конкурентные отчеты о видимости в службу отчетов.

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

7 июля 2023 г.

Продукция обслуживания

Продукт ресурс

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

4 июля 2023 г.

Продукция обслуживания

Продукт ресурс

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

26 июня 2023 г.

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

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

Добавлено поле no_delivery_post_cutoff , чтобы позволить продавцам отказаться от показания локальной доставки N+1 DAN, когда у них есть служба доставки, настроенная на N-Day Local Delivery.

29 мая 2023 г.

Служба акций

Добавлен метод list для службы Promotions .

Рекомендационная служба

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

9 мая 2023 г.

Облачная розничная торговля

Облачная розничная дополнительная недвижимость

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

22 мая 2023 г.

Служба акций

Добавлен метод list для службы Promotions .

11 апреля 2023 г.

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

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

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

3 апреля

Рекомендации службы

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

20 февр. 2023 г.

Сервис счетов

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

Добавлено новая учетная запись .

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

Добавлено Сервис источников конверсии, которая поддерживает управление источниками конверсии (часть раздела «Настройки конверсии» в торговом центре).

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 года

Отчеты Сервис

Добавлено рыночное понимание отчетов в Service Service.

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

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

7 ноября 2022 г.

Служба DataFeeds

Добавлена ​​поддержка feedLabel для службы DataFeeds.

14 сентября 2022 года

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

9 авг. 2022 г.

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

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

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

Устаревший targetCountry .

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

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

См. Мейбл подачи в блоге заменяет целевую страну в API контента для покупок для получения более подробной информации.

8 декабря 2021 года

Сервис счетов

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

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

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

25 окт. 2021 г.

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

Добавление Получите повышение в API продвижения.

11 окт. 2021 г.

Настройки доставки API

Добавлено новое warehouse поле в ресурсе Shippingstingts, чтобы позволить продавцам управлять складами, которые можно использовать в WarehouseBasedDeliverytime .

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

4 окт. 2021 г.

Сервис счетов

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

Добавлено новое поле «Phone_verification_status» в разделе Accounts.businessinformation . Это поле только для чтения, установленное Accounts.VerifyPhoneNumber .

13 сентября 2021 года

BuyongooglePrograms Service

BuyongoogleProgramStatus resource

Добавлены новые поля в BuyongooglePrograms.buyonProgramStatus resource respresnting: онлайн -каналы продаж, бизнес -модели и телефон обслуживания клиентов.

Новый метод UpdateBuyongoogleProgramStatus

Добавлен новый метод UpdatebuyongoogleProgramStatus, который позволит обновлять расширенные BuyongooglePrograms.buyonProgramStatus resource.

6 сентября 2021 года

Сервис счетов

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

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

30 авг. 2021 г.

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

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

Заказы обслуживания

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

FAILED_TO_CAPTURE_FUNDS отмены нового заказа

Продукция обслуживания

Продукт ресурс

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

9 авг. 2021 г.

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

Тип переоборудования

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

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

17 мая 2021 г.

Заказ возвращает службу метки

Добавлено новое поле Product_id 'в CreateTurnRequest. Торговцы могут указать либо продукт, либо line_item_id, чтобы идентифицировать элемент для возврата.

Продукция обслуживания

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

3 мая 2021 г.

Заказ возвращает службу метки

Добавлены новые методы для загрузки меток для Merchant Manageed Greats (MMR). С новыми orderreturns.labels.create вы можете загрузить ответные метки, чтобы поделиться ими с клиентом.

26 апреля 2021 года

Настройки доставки API

New warehouseBasedDeliveryTimes в времени доставки для поддержки услуг по доставке Расчет расчетной даты поставки на основе местоположения склада и выбранной службы перевозчиков.

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

12 апреля 2021 года

Продукция обслуживания

Продукт ресурс

Новое поле additionalSizeType для поддержки до 2 типов размера на продукт.

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

28 января 2021 года

Сервис счетов

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

5 октября 2020 г.

CSSES Service

CSS Resource

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

24 августа 2020 г.

Продукция обслуживания

Продукты ресурс

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

ProductStatuses Resource

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

New itemLevelIssues.applicableCountries .

10 августа 2020 года

Сервис счетов

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

19 июня 2020 г.

Продукция обслуживания

Продукт ресурс

Новые поля

New productDetails , productHighlights , subscriptionCost и canonicalLink Fields.

2 июня 2020 г.

Заказы обслуживания

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

27 апреля 2020 года

Порядок сервиса

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

Gmb связывание

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

14 апреля 2020 года

Урегулирование отчета API

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

9 марта 2020 г.

Местный инвентарь API

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

2 марта 2020 г.

API уведомления PubSub

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

3 декабря 2019 г.

Продукция обслуживания

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

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

Заказы обслуживания

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

14 августа 2019 г.

Новые услуги

Добавлен новые услуги returnpolicy и returnaddress для покупки в Google.

Заказы обслуживания

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

Новое поле

Новое quantityUndeliverable поля.

7 августа 2019 г.

Заказы обслуживания

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

Новые поля

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

1 июля 2019 г.

Продукция обслуживания

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

11 июня 2019 года

Заказы обслуживания

Заказ и ресурсы теста

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

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

14 февраля 2019 года

Изменения, введенные в этой версии

Сухие пробежки больше не поддерживаются

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

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

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

  • Счета
  • Accounttax
  • DATAFEEDS
  • LiaSettings
  • Переключатели

Удаление методов партий HTTP

Все методы BATCH HTTP были удалены из V2.1. Вместо этого используйте customBatch . Пострадавшие услуги являются следующими:

  • Счета
  • AccountStatuses
  • DATAFEEDS
  • DataFeedStatuses
  • LiaSettings
  • OrderReports
  • Поз.
  • Продукция
  • Продукты
  • Переключатели

Сервис счетов

Обновлять

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

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

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

AdWords -> Rebranding Google Ads

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

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

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

AccountStatuses Service

AccountStatus Resource

Удаление данных

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

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

DataFeed Resource

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

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

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

Подачи product inventory update типа были удалены.

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

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

Заказы обслуживания

Uncellineitem

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

CustomBatch

CustomBatch был удален с V2.1.

InstorereFundlineItem

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

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

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

Returnlineitem

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

ReturnRefundlineitem

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

Shiplineitem

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

Заказ и ресурсы теста

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

В V2.1 появился новый формат продвижения. Вы не можете создавать тестовые заказы с помощью рекламных акций.

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

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

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

Устаревший полевой customer.email .

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

Орден нагрузки

Эта услуга была удалена из V2.1.

Продукция обслуживания

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

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

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

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

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

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

Продукт ресурс

Пользовательские группы заменены на рекурсивные Customattributes

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

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

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

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

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

ProductTypes заменяет ProductType и дополнительные продукты

Ранее типы продуктов хранились в двух полях с первым типом в единственном полевом productType и оставшихся в повторном поле additionalProductTypes . В v2.1 два поля были заменены одним повторным полевым productTypes .

Атрибут назначений заменен на включенные предприятия и исключающие

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

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

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

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

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

ProductStatuses Service

Получить и перечислить

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

Список

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

ProductStatus Resource

Наблюдения

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

Удаление данных

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

,

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

26 мая 2025 г.

Сервис счетов

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

14 апреля 2025 года

Сервис счетов

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

17 марта 2025 г.

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

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

В рамках отключения APIS, связанных с расчетом, устанавливаются следующие услуги:

  • settlementreports
  • settlementtranscations

Остановка APIS, связанные с расчетами, связано с ранее закрытой программой Buyongoogle и API-интерфейсом, связанными с заказом.

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

16 октября 2024 г.

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

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

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

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

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

Служба OrderTrackingSignals не устарела и продолжает доступна.

10 августа 2024 года

Купить в Google Services

В рамках Buy on Google APIS выключение все методы в рамках BuyOnGoogleProgramService , с помощью service was not found on the server .

19 июля 2024 г.

Продукция обслуживания

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

20 мая 2024 года

Продукция обслуживания

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

Отчеты Сервис

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

Для получения дополнительной информации см. Купите в Google Tempercation .

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 для обеспечения названий и описаний продуктов, сгенерированных AI.

3 апреля 2024 г.

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

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

Добавлен новый метод TriggerAction для BuiltInUserInputAction . Чтобы получить доступ к этому методу, отправьте запрос в эту форму .

27 марта 2024 г.

Продукция обслуживания

Продукт ресурс

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

15 марта 2024 г.

Sunset Buy в Google для поиска и покупок. Вы можете продолжать просматривать существующие заказы до 31 октября 2024 года, используя orders.list и orders.get .

08 марта 2024 года

Отчеты Сервис

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

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

6 марта 2024 г.

Отчеты Сервис

Добавлен клик Потенциальный ведро и ранга для продуктов.

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

19 февраля 2024 года

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

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

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

Удалили варианты 60 и 90 в качестве дни оконного оконного окна и добавили 40 в качестве действительной опции.

17 января 2024 г.

POS Service

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

11 января 2024 года

Сервис счетов

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

29 ноября 2023 г.

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

Добавлено VERIFY_IDENTITY_IN_MERCHANT_CENTER Внешнее действие для проверки идентификации, которая должна быть выполнена в торговом центре.

POS Service

Добавлены поля matching_status и matching_status_hint в Posstore , что позволяет пользователям знать сопоставление статуса POS Store с Google Business Store и намек на исправление в случае проблемы.

15 ноября 2023 г.

repricingrules и repricingrules.repricingreports точки.

1 ноября 2023 г.

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

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

18 октября 2023 г.

Сервис счетов

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

10 октября 2023 г.

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

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

Служба настроек LIA

Добавлен метод setOmnichannelExperience , чтобы позволить пользователям установить свой Omnichannel Experience (то есть локальные настройки Storefront и Pickup). К этому времени это доступно только для пользователей, чьи поставщика POS доверяют для включения таких настроек.

7 сентября 2023 года

Купить в Google Tempercation

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

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

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

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

28 августа 2023 г.

Служба акций

Открытый метод list в службе Promotions от ограниченного доступа ко всем.

22 августа 2023 г.

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

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

4 августа 2023 г.

Отчеты Сервис

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

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

25 июля 2023 г.

POS Service

Инвентарный ресурс

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

14 июля 2023 г.

Отчеты Сервис

Добавлены конкурентные отчеты о видимости в службу отчетов.

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

7 июля 2023 г.

Продукция обслуживания

Продукт ресурс

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

4 июля 2023 г.

Продукция обслуживания

Продукт ресурс

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

26 июня 2023 г.

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

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

Добавлено поле no_delivery_post_cutoff , чтобы позволить продавцам отказаться от показания локальной доставки N+1 DAN, когда у них есть служба доставки, настроенная на N-Day Local Delivery.

29 мая 2023 г.

Служба акций

Добавлен метод list для службы Promotions .

Рекомендационная служба

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

9 мая 2023 г.

Облачная розничная торговля

Облачная розничная дополнительная недвижимость

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

22 мая 2023 г.

Служба акций

Добавлен метод list для службы Promotions .

11 апреля 2023 г.

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

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

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

3 апреля

Рекомендации службы

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

20 февр. 2023 г.

Сервис счетов

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

Добавлено новая учетная запись .

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

Добавлено Сервис источников конверсии, которая поддерживает управление источниками конверсии (часть раздела «Настройки конверсии» в торговом центре).

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 года

Отчеты Сервис

Добавлено рыночное понимание отчетов в Service Service.

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

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

7 ноября 2022 г.

Служба DataFeeds

Добавлена ​​поддержка feedLabel для службы DataFeeds.

14 сентября 2022 года

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

9 авг. 2022 г.

Added feedLabel for products.

You can now use feedLabel instead of targetCountry to specify the country for offer IDs. Offer IDs are now constructed as online:language:feedLabel:offerId .

feedLabel has been automatically populated with your targetCountry value for existing feeds for backwards compatibility.

Deprecated targetCountry .

To support global offers, the Content API for Shopping has deprecated the targetCountry field. Instead, we recommend using the shipping field to specify your target countries.

targetCountry is now automatically populated with the value you provide in feedLabel .

See the blog post Feed label replaces target country in Content API for Shopping for more details.

Dec 8, 2021

Accounts Service

Account Resource

Added a new section Account.AutomaticImprovements in the Accounts resource.

This new section will allow merchants to automatically update items, improve images and shipping settings.

25 окт. 2021 г.

Promotion Service

Adding Get Promotion to the Promotion API.

11 окт. 2021 г.

Shipping Settings API

Added new warehouse field in ShippingSettings resource to allow merchants to manage the warehouses which can be used in WarehouseBasedDeliveryTime .

Add new warehouseName field in WarehouseBasedDeliveryTime to refer to warehouse by warehouse name.

4 окт. 2021 г.

Accounts Service

Account Resource

Added a new field 'phone_verification_status' in the Accounts.BusinessInformation section. This is a read-only field, set by Accounts.VerifyPhoneNumber .

Sept 13, 2021

BuyOnGooglePrograms service

BuyOnGoogleProgramStatus resource

Added new fields in the BuyOnGooglePrograms.BuyOnProgramStatus resource respresnting: online sales channels, business models and customer service phone.

New UpdateBuyOnGoogleProgramStatus method

Added a new UpdateBuyOnGoogleProgramStatus method which will allow to update extended BuyOnGooglePrograms.BuyOnProgramStatus resource.

Sept 6, 2021

Accounts Service

Account Resource

Added a new field 'korean_business_registration_number' in the Accounts.BusinessInformation section. This field will only be cleared if explicitly set to an empty string.

30 авг. 2021 г.

Promotion Service

Added a new Promotion Service with Insert Promotion available.

Orders Service

Added a new method orders/captureOrder to capture funds before shipment.

New order cancellation reason FAILED_TO_CAPTURE_FUNDS

Products Service

Product Resource

Added productLength , productHeight , productWidth and productWeight to provide product dimensions and weight.

9 авг. 2021 г.

RepricingRule Service

RepricingRule Type

New enum value for RepricingRuleType field.

Added TYPE_SALES_VOLUME_BASED and TYPE_COMPETITIVE_PRICE .

17 мая 2021 г.

Order Returns Label Service

Added a new 'product_id' field in the CreateReturnRequest. Merchants can specify either the product_id or line_item_id to identify the item to return.

Products Service

Added a new method to update existing products . You can update a product by only providing the fields that need to be updated instead of the whole product.

3 мая 2021 г.

Order Returns Label Service

Added new methods to upload labels for Merchant Managed Returns (MMR). With the new orderreturns.labels.create , you can upload the return labels, to share them with the customer.

April 26, 2021

Shipping Settings API

New warehouseBasedDeliveryTimes field in DeliveryTime to support shipping services calculating the estimated delivery date based on the warehouse location and the chosen carrier service.

New eddServices field in CarriersCarrier object to return names of the services applicable for calculating the estimated delivery date.

April 12, 2021

Products Service

Product Resource

New additionalSizeType field to support up to 2 size types per product.

Changes to shipping field: Added minHandlingTime , maxHandlingTime , minTransitTime and maxTransitTime to ProductShipping to provide offer level shipping speed.

January 28, 2021

Accounts Service

Added automatic labels support to AccountLabel and Account resources. For more information, see CSS Label types section in the CSS Label management guide.

5 октября 2020 г.

CSSES Service

CSS Resource

Added a new csses service for retrieving information about CSS domains and assigning labels to them. The AccountLabel resource can now also be used for creating and listing CSS group level labels. For more information, see CSS Label Management .

24 августа 2020 г.

Products Service

Products Resource

New shoppingAdsExcludedCountries field to exclude offers from advertising in certain countries.

Productstatuses Resource

New approvedCountries , pendingCountries and disapprovedCountries fields in destinationStatuses object which provide for offer status information beyond targetCountry .

New itemLevelIssues.applicableCountries field.

August 10, 2020

Accounts Service

Added a new AccountLabel resource for managing Merchant Center account labels for CSS Center. CSS Center users can now also list their Merchant Center accounts and assign labels to them with accounts.list , accounts.get and accounts.updatelabels methods. For more information, see CSS Label Management .

19 июня 2020 г.

Products Service

Product Resource

New fields

New productDetails , productHighlights , subscriptionCost , and canonicalLink fields.

2 июня 2020 г.

Orders Service

Added new methods to initiate refunds without returns. With the new orders.refunditem and orders.refundorder , you can initiate refunds on orders even if they are not returned by the customer.

April 27, 2020

Orderreturns Service

Added new methods acknowledge and process , and new filters and fields for read methods ( list , get ).

GMB linking

Added the ability to link Merchant Center accounts to a GMB account using the GMB account ID .

April 14, 2020

Settlement Report APIs

Added a new service for getting settlement reports .

9 марта 2020 г.

Local inventory API

Added a new service for submitting local inventory data.

2 марта 2020 г.

Pubsub notification settings API

Added a new service for managing settings for pubsub notifications .

3 декабря 2019 г.

Products Service

Added support for multi-client account supplemental Content API feeds.

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

Orders Service

Added support for pickup shipments in orders and corresponding sandbox features.

14 августа 2019 г.

New services

Added new Returnpolicy and Returnaddress services for Buy on Google.

Orders Service

Order Resource

Новое поле

New quantityUndeliverable field.

7 августа 2019 г.

Orders Service

Order Resource

New fields

Added new loyaltyInfo and invoiceReceivingEmail fields to Order resource.

1 июля 2019 г.

Products Service

Support for supplemental Content API feeds added in the Products service.

June 11, 2019

Orders Service

Order and TestOrder Resources

Addition of price adjustment

Added new lineItem[].adjustments field that contains adjustment to original line item price and tax caused by applying promotions.

February 14, 2019

Changes introduced in this version

Dry runs no longer supported

The parameter dryRun has been removed from v2.1. This applies to all API calls.

Patch methods no longer supported

The following services no longer support the patch method:

  • Счета
  • Accounttax
  • Datafeeds
  • Liasettings
  • Shippingsettings

Removal of HTTP BATCH methods

All HTTP BATCH methods have been removed from v2.1. Use customBatch instead. The affected services are the following:

  • Счета
  • Accountstatuses
  • Datafeeds
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • Поз.
  • Продукция
  • Productstatuses
  • Shippingsettings

Accounts Service

Обновлять

The fields businessInformation and googleMyBusinessLink in the request were introduced after the initial launch of Content API v2. Due to this, there is a safeguard that prevents merchants from unintentionally deleting information in these two fields with update if they are not provided.

In v2, merchants must explicitly provide these fields with an empty body ( {} ) to delete them. In v2.1, fields are deleted if you provide an empty body, or if you don't provide them.

Account Resource

AdWords -> Google Ads rebranding

With AdWords becoming Google Ads , the following AdWords-related fields have been renamed:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
Removal of deprecated fields and values

The deprecated field reviewsUrl has been removed. In addition, the link status inactive has been removed for adsLinks , googleMyBusinessLink , and youtubeChannelLinks .

Accountstatuses Service

AccountStatus Resource

Removal of dataQualityIssues

These have been superseded by itemLevelIssues .

Datafeed Service

Datafeed Resource

Removal of deprecated fields

The fields contentLanguage , targetCountry , and intendedDestinations have been removed and replaced by country , language , includedDestinations , and excludedDestinations in targets .

Removal of product inventory update

Feeds of type product inventory update have been removed.

Inventory Service

The v2 inventory service has been removed and replaced by two new features in v2.1:

Orders Service

CancelLineItem

The fields amount , amountPretax , and amountTax in the request have been removed. The refunded amount is now calculated automatically.

CustomBatch

CustomBatch has been removed from v2.1.

InStoreRefundLineItem

The fields amountPretax and amountTax have been replaced by priceAmount and taxAmount , respectively. The field priceAmount may be pre-tax or post-tax depending on the location of the order.

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

This method has been removed. Use returnRefundLineItem instead.

ReturnLineItem

This method has been removed. Use returnRefundLineItem without providing a refund amount instead.

ReturnRefundLineItem

The fields amountPretax and amountTax have been replaced by priceAmount and taxAmount , respectively. The field priceAmount may be pre-tax or post-tax depending on the location of the order.

ShipLineItem

The fields carrier , shipmentId , and trackingId in the request have been moved to shipmentInfos .

Order and TestOrder Resources

New promotion format

There is a new promotion format in v2.1. You can't create test orders with promotions.

Removal of deprecated fields

The field paymentMethod has been removed, and billingAddress and predefinedBillingAddress are now top-level fields in Order and TestOrder , respectively.

Furthermore, customer.explicitMarketingPreference has been removed and replaced by customer.marketingRightsInfo in both Order and TestOrder .

The deprecated field customer.email has been removed.

The format of the promotions field has changed in the Order resource.

Orderpayments Service

This service has been removed from v2.1.

Products Service

Response from an insert will contain only the following attributes:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

Nonfatal warnings and errors are no longer returned in the response. This allows for better integration with feed rules and other advanced feed management features.

There is now a delay of a few minutes before an inserted product can be retrieved by get or list .

The returned offer ID is no longer guaranteed to be the same as the input offer ID.

Prices are now validated before product insertion. Only the following characters are allowed in the value string: + , - , . , and digits ( 0 - 9 ). Commas are no longer accepted.

Product Resource

CustomGroups replaced by recursive customAttributes

Previously, custom attributes could be grouped together by adding custom attributes under the same custom group in v2. Custom attributes are now recursive in v2.1, so this removes the need for custom groups.

Custom attributes now have an additional groupValues field in addition to the original value field; exactly one of them must be set, meaning they cannot be simultaneously set or left out.

As merchants may switch between v2 and v2.1, it is possible for products to have recursive custom attributes which cannot be represented in v2 as custom groups have a maximum of two levels. In this case, the custom attribute group will be truncated.

Removal of type and unit in customAttributes

In v2.1, custom attributes will no longer contain a type and unit . Instead, units are to be appended to the value (if present), and types should be automatically detected. For exammple, use "1.23 EUR" or "5.6 cm" as the value in v2.1.

ProductTypes supersedes productType and additionalProductTypes

Previously, product types were stored in two fields with the first type in the singular field productType and the remaining in the repeated field additionalProductTypes . In v2.1, the two fields have been replaced by a single repeated field productTypes .

Destinations attribute replaced by includedDestinations and excludedDestinations

Destinations were input as a list of destination name and intention pairs in v2 in the repeated field destinations . This field has been replaced by the following two repeated fields: includedDestinations and excludedDestinations . Destinations enabled by default need not be included in includedDestinations. This will match the configuration of destination overrides in feeds.

With AdWords becoming Google Ads , the following AdWords-related fields have been renamed:

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
Removal of deprecated fields

The following deprecated fields have been removed:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Productstatuses Service

Get and List

The product attribute was removed, along with the includeAttributes parameter. To retrieve attributes of the product corresponding to a status, use the Products service and the value of the new productId field.

Список

The parameter includeInvalidInsertedItems has been removed. All products are now returned regardless of whether they are valid, meaning list now behaves as if includeInvalidInsertedItems is always set to true .

ProductStatus Resource

DestinationsStatuses

The fields intention , approvalStatus , and approvalPending in destinationStatuses have been replaced by status , which is a string that can be one of approved , disapproved , or pending .

Removal of dataQualityIssues

These have been superseded by itemLevelIssues .

,

Merchant Support Service

26 мая 2025 г.

Accounts service

It is now possible to add read-only users to accounts.

Apr 14, 2025

Accounts service

As this will no longer being a requirement in the future, the accounttax service has been deprecated.

17 марта 2025 г.

As part of the Orders-related APIs shutdown , the following services have been deprecated:

  • accounts.verifyphonenumber
  • returnpolicy

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

This endpoint is no longer required and can be deprecated:

  • pubsubnotificationsettings

10 февр. 2025 г.

Added prerendered_out_of_court_dispute_settlement fields to ProductIssue and to AccountIssue .

Deprecated alternate_dispute_resolution fields from RenderProductIssuesResponse and RenderAccountIssuesResponse .

12 дек. 2024 г.

Products Service

Added the sustainability_incentives field to specify sustainability incentives such as tax credit or price discount for your products. If the field value isn't provided, the item is not eligible for any sustainability incentives.

15 ноября 2024 г.

Products Service

For LoyaltyProgram , added the shipping_label field to specify eligibility. If the field has value, this offer has loyalty shipping benefit. If the field value isn't provided, the item is not eligible for loyalty shipping for the given loyalty tier.

30 октября 2024 г.

As part of the Settlement-related APIs shutdown, the following services are deprecated:

  • settlementreports
  • settlementtranscations

The Settlement-related APIs shutdown is related to the previously shut down BuyOnGoogle program and Orders-related APIs.

Calls to the aforementioned services are expected to fail with a Service was not found on the server response.

16 октября 2024 г.

update_mask in UpdateConversionSourceRequest is now OPTIONAL . If no update mask is specified, all fields that have a non-empty value are updated.

August 26, 2024 (sooner than originally communicated)

As part of the Orders-related APIs shutdown , the following services have been deprecated:

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

Calls to the aforementioned services are expected to fail with a Service was not found on the server response.

The OrderTrackingSignals service is not deprecated and continues to be available.

August 10, 2024

Buy on Google services

As part of Buy on Google APIs shutdown all the methods within BuyOnGoogleProgramService will fail with service was not found on the server .

19 июля 2024 г.

Products Service

Added the member_price_effective_date field. This update lets you specify, if applicable, the date range during which the loyalty member price is effective. If the field value isn't provided, the member price is always effective.

May 20, 2024

Products Service

Added LoyaltyPrograms . This update lets you provide multiple tiers with different loyalty points, prices, etc. for a single product. You should use this field in place of the singular LoyaltyProgram field.

Reports Service

Deprecated Buy on Google metrics in the MerchantPerformanceView table. After this update, retrieving any Buy on Google metric returns 0. This also applies to historical values for past dates.

For more information, see Buy on Google deprecation .

13 мая 2024 г.

Products Service

Product Resource

Changes to certifications field: Added certificationValue to the ProductCertification field to provide certification value (also known as class, level, or grade), which lets users upload certification information even if the certification authority doesn't issue certification code or number.

For more information, see our Products guides .

6 мая 2024 г.

Reports Service

Added effectiveness bucket to the PriceInsightsProductView table. Effectiveness indicates which products would benefit most from price changes. This rating takes into consideration the performance boost predicted by adjusting the sale price and the difference between your current price and the suggested price.

24 апреля 2024 г.

Products Service

Product Resource

Added optional downpayment and creditType fields for Installment payments :

  • downpayment provides the amount the buyer has to pay upfront as a one-time payment.
  • creditType provides the type of installment payment ( finance or lease ). This field is only applicable to Vehicle Ads.

11 апреля 2024 г.

Products Service

Product Resource

  • Added free shipping threshold attribute ( FreeShippingThreshold ) for offer-level shipping. This attribute lets merchants input a minimum product price for the shipping cost to become free.
  • Changed the visibility of LoyaltyPoints

April 10, 2024

Products Service

Product Resource

Added LoyaltyProgram

9 апреля 2024 г.

Products Service

Product Resource

Added structuredTitle and structuredDescription to provide AI-generated product titles and descriptions.

3 апреля 2024 г.

Merchant Support Service

Added user_input_action_option field that lets partners request a new type of action: BuiltInUserInputAction . This action lets partners build complex self-serve functionality for merchants, directly in their application instead of redirecting them to the Merchant Center.

Added a new TriggerAction method for BuiltInUserInputAction . To access this method, submit a request to this form .

27 марта 2024 г.

Products Service

Product Resource

Added AutoPricingMinPrice as a safeguard in the "Automated Discounts" and "Dynamic Promotions" projects, ensuring that discounts on merchants' offers don't reduce the product price to lower than this value. Thereby, preserving the offer's value and profitability.

15 марта 2024 г.

Sunset Buy on Google for Search and Shopping. You can continue to view existing orders until October 31, 2024 using orders.list and orders.get .

March 08, 2024

Reports Service

Added TopicTrendsView report to the Reports service.

For more information, see our Reporting guides .

6 марта 2024 г.

Reports service

Added click potential bucket and rank for products.

For more information, see our Reporting guides .

February 19, 2024

ConversionSources Service

Removed the following values as valid conversion sources:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

Removed the options of 60 and 90 as lookback window days and added 40 as a valid option.

17 января 2024 г.

POS service

Added new values for the matching_status_hint field in PosStore , which lets users to have more details about why their store matching has failed.

January 11, 2024

Accounts service

Added localProductManager and localProductManagement as link type and service respectively for the link method. These allow for accounts to link with the purpose of managing local product data.

29 ноября 2023 г.

Merchant Support Service

Added VERIFY_IDENTITY_IN_MERCHANT_CENTER external action type for identity verification that needs to be performed in the Merchant Center.

POS service

Added matching_status and matching_status_hint fields to PosStore which lets users to know matching status of Pos Store with Google Business Profile Store and hint to fix in case of an issue.

15 ноября 2023 г.

repricingrules and repricingrules.repricingreports endpoints are no longer supported.

1 ноября 2023 г.

Shipping Settings service

The shipment_type=pickup is no longer supported.

18 октября 2023 г.

Accounts service

Added Business Identity field that allows merchants to self-identify to certain consumer values .

10 октября 2023 г.

Added Collection Point as a new shipment type of shipping settings service. A collection point delivery is a service provided by a third party (eg not merchant owned) to deliver the item to a third party affiliated location (like UPS Access Points), instead of delivering directly to the home.

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

LIA settings service

Added setOmnichannelExperience method to allow users to set their omnichannel experience (that is, local storefront and pick-up settings). By this time, this is only available for users whose POS provider is trusted to enable such settings.

September 7, 2023

Buy on Google deprecation

Adding a new DEPRECATED status into the GetBuyOnGoogleProgramStastus method. Reactivating or pausing the program from such a state is not possible.

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

Merchant Support Service

Added FIX_ACCOUNT_ISSUE built-in action for product issues that needs to be resolved on the account level. Added SHOW_ADDITIONAL_CONTENT built-in action that will be used to deliver a justification from a national authority.

28 августа 2023 г.

Promotions service

Open list method in Promotions service from limited access to all.

22 августа 2023 г.

Merchant Support Service

Launched Merchant Support Service. This service provides a support content for account issues and product issues.

4 августа 2023 г.

Reports Service

Added Close Competitors Competitive Visibility report to Reports service.

For more information, see our Reporting guides .

25 июля 2023 г.

POS Service

Inventory Resource

Add pickup_method and pickup_sla fields to provide an ability for merchants to submit pickup information along with their inventory.

14 июля 2023 г.

Reports Service

Added Competitive Visibility reports to Reports service.

For more information, see our Reporting guides .

7 июля 2023 г.

Products Service

Product Resource

Added virtualModelLink to provide URLs to 3D model image.

4 июля 2023 г.

Products Service

Product Resource

Add certifications field to provide product certifications, for example for energy efficiency labeling of products based on the EU EPREL database.

26 июня 2023 г.

Shipping Settings service

Local Fulfillment

Added no_delivery_post_cutoff field to allow merchants to opt-out of showing n+1 day local delivery when they have a shipping service configured to n day local delivery.

29 мая 2023 г.

Promotions service

Added list method for the Promotions service.

Recommendation service

Enable interaction dismiss in the ReportInteraction method of the Recommendations service.

9 мая 2023 г.

Cloud Retail Destination

Cloud Retail Additional Properties

Add the cloud retail additional properties field. This is a repeated field intended to be used by customers using the Cloud Retail destination. When this field is used it will be available when using the cloud retail program. This will be mapped to the attributes field in the Google Cloud Retail product model.

22 мая 2023 г.

Promotions service

Added list method for the Promotions service.

11 апреля 2023 г.

Shipping Settings service

Local Fulfillment

Added the local delivery fulfillment option for merchants creating a new shipping setting. They can configure their settings for local stores in the new storeConfig field. This includes the service radius, cutoff time, and store codes for the stores offering local delivery.

3 апреля

Recommendations Service

Launched Recommendations Service. This service provides suggested ways to improve the performance of your merchant account and lets you report merchant clicks on helpful recommendations.

20 февр. 2023 г.

Accounts Service

Account Resource

Added a new section Account.ConversionSettings in the Accounts resource.

ConversionSources Service

Added the Conversion Sources service, which supports managing conversion sources (part of the Conversion Settings section in Merchant Center).

16 февр. 2023 г.

Shipping Settings service

Store code validation

Store codes are now validated to ensure that they belong to the merchant before shipping settings are updated.

LIA merchant validation

Programs a Merchant ID is enrolled in are now validated before shipping settings are updated. Merchants must be in one of the following programs:

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

9 февр. 2023 г.

Promotions Service

Expand Promotions service to 6 additional targetCountry options with local contentLanguage support.:

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

12 января 2023 г.

Products Service

Product Resource

Added lifestyleImageLinks to provide URLs to lifestyle images.

24 ноября 2022 г.

Promotion Service

Added a new field `promotionStatus' in the Promotions.PromotionStatus section. This is a read only field.

Nov 15, 2022

Reports Service

Added Market Insights reports to Reports service.

You can now query Reports service for the following:

For more information, see our Reporting guides .

7 ноября 2022 г.

Datafeeds Service

Added feedLabel support for Datafeeds service.

Sept 14, 2022

Updated feedLabel to accept any string.

9 авг. 2022 г.

Added feedLabel for products.

You can now use feedLabel instead of targetCountry to specify the country for offer IDs. Offer IDs are now constructed as online:language:feedLabel:offerId .

feedLabel has been automatically populated with your targetCountry value for existing feeds for backwards compatibility.

Deprecated targetCountry .

To support global offers, the Content API for Shopping has deprecated the targetCountry field. Instead, we recommend using the shipping field to specify your target countries.

targetCountry is now automatically populated with the value you provide in feedLabel .

See the blog post Feed label replaces target country in Content API for Shopping for more details.

Dec 8, 2021

Accounts Service

Account Resource

Added a new section Account.AutomaticImprovements in the Accounts resource.

This new section will allow merchants to automatically update items, improve images and shipping settings.

25 окт. 2021 г.

Promotion Service

Adding Get Promotion to the Promotion API.

11 окт. 2021 г.

Shipping Settings API

Added new warehouse field in ShippingSettings resource to allow merchants to manage the warehouses which can be used in WarehouseBasedDeliveryTime .

Add new warehouseName field in WarehouseBasedDeliveryTime to refer to warehouse by warehouse name.

4 окт. 2021 г.

Accounts Service

Account Resource

Added a new field 'phone_verification_status' in the Accounts.BusinessInformation section. This is a read-only field, set by Accounts.VerifyPhoneNumber .

Sept 13, 2021

BuyOnGooglePrograms service

BuyOnGoogleProgramStatus resource

Added new fields in the BuyOnGooglePrograms.BuyOnProgramStatus resource respresnting: online sales channels, business models and customer service phone.

New UpdateBuyOnGoogleProgramStatus method

Added a new UpdateBuyOnGoogleProgramStatus method which will allow to update extended BuyOnGooglePrograms.BuyOnProgramStatus resource.

Sept 6, 2021

Accounts Service

Account Resource

Added a new field 'korean_business_registration_number' in the Accounts.BusinessInformation section. This field will only be cleared if explicitly set to an empty string.

30 авг. 2021 г.

Promotion Service

Added a new Promotion Service with Insert Promotion available.

Orders Service

Added a new method orders/captureOrder to capture funds before shipment.

New order cancellation reason FAILED_TO_CAPTURE_FUNDS

Products Service

Product Resource

Added productLength , productHeight , productWidth and productWeight to provide product dimensions and weight.

9 авг. 2021 г.

RepricingRule Service

RepricingRule Type

New enum value for RepricingRuleType field.

Added TYPE_SALES_VOLUME_BASED and TYPE_COMPETITIVE_PRICE .

17 мая 2021 г.

Order Returns Label Service

Added a new 'product_id' field in the CreateReturnRequest. Merchants can specify either the product_id or line_item_id to identify the item to return.

Products Service

Added a new method to update existing products . You can update a product by only providing the fields that need to be updated instead of the whole product.

3 мая 2021 г.

Order Returns Label Service

Added new methods to upload labels for Merchant Managed Returns (MMR). With the new orderreturns.labels.create , you can upload the return labels, to share them with the customer.

April 26, 2021

Shipping Settings API

New warehouseBasedDeliveryTimes field in DeliveryTime to support shipping services calculating the estimated delivery date based on the warehouse location and the chosen carrier service.

New eddServices field in CarriersCarrier object to return names of the services applicable for calculating the estimated delivery date.

April 12, 2021

Products Service

Product Resource

New additionalSizeType field to support up to 2 size types per product.

Changes to shipping field: Added minHandlingTime , maxHandlingTime , minTransitTime and maxTransitTime to ProductShipping to provide offer level shipping speed.

January 28, 2021

Accounts Service

Added automatic labels support to AccountLabel and Account resources. For more information, see CSS Label types section in the CSS Label management guide.

5 октября 2020 г.

CSSES Service

CSS Resource

Added a new csses service for retrieving information about CSS domains and assigning labels to them. The AccountLabel resource can now also be used for creating and listing CSS group level labels. For more information, see CSS Label Management .

24 августа 2020 г.

Products Service

Products Resource

New shoppingAdsExcludedCountries field to exclude offers from advertising in certain countries.

Productstatuses Resource

New approvedCountries , pendingCountries and disapprovedCountries fields in destinationStatuses object which provide for offer status information beyond targetCountry .

New itemLevelIssues.applicableCountries field.

August 10, 2020

Accounts Service

Added a new AccountLabel resource for managing Merchant Center account labels for CSS Center. CSS Center users can now also list their Merchant Center accounts and assign labels to them with accounts.list , accounts.get and accounts.updatelabels methods. For more information, see CSS Label Management .

19 июня 2020 г.

Products Service

Product Resource

New fields

New productDetails , productHighlights , subscriptionCost , and canonicalLink fields.

2 июня 2020 г.

Orders Service

Added new methods to initiate refunds without returns. With the new orders.refunditem and orders.refundorder , you can initiate refunds on orders even if they are not returned by the customer.

April 27, 2020

Orderreturns Service

Added new methods acknowledge and process , and new filters and fields for read methods ( list , get ).

GMB linking

Added the ability to link Merchant Center accounts to a GMB account using the GMB account ID .

April 14, 2020

Settlement Report APIs

Added a new service for getting settlement reports .

9 марта 2020 г.

Local inventory API

Added a new service for submitting local inventory data.

2 марта 2020 г.

Pubsub notification settings API

Added a new service for managing settings for pubsub notifications .

3 декабря 2019 г.

Products Service

Added support for multi-client account supplemental Content API feeds.

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

Orders Service

Added support for pickup shipments in orders and corresponding sandbox features.

14 августа 2019 г.

New services

Added new Returnpolicy and Returnaddress services for Buy on Google.

Orders Service

Order Resource

Новое поле

New quantityUndeliverable field.

7 августа 2019 г.

Orders Service

Order Resource

New fields

Added new loyaltyInfo and invoiceReceivingEmail fields to Order resource.

1 июля 2019 г.

Products Service

Support for supplemental Content API feeds added in the Products service.

June 11, 2019

Orders Service

Order and TestOrder Resources

Addition of price adjustment

Added new lineItem[].adjustments field that contains adjustment to original line item price and tax caused by applying promotions.

February 14, 2019

Changes introduced in this version

Dry runs no longer supported

The parameter dryRun has been removed from v2.1. This applies to all API calls.

Patch methods no longer supported

The following services no longer support the patch method:

  • Счета
  • Accounttax
  • Datafeeds
  • Liasettings
  • Shippingsettings

Removal of HTTP BATCH methods

All HTTP BATCH methods have been removed from v2.1. Use customBatch instead. The affected services are the following:

  • Счета
  • Accountstatuses
  • Datafeeds
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • Поз.
  • Продукция
  • Productstatuses
  • Shippingsettings

Accounts Service

Обновлять

The fields businessInformation and googleMyBusinessLink in the request were introduced after the initial launch of Content API v2. Due to this, there is a safeguard that prevents merchants from unintentionally deleting information in these two fields with update if they are not provided.

In v2, merchants must explicitly provide these fields with an empty body ( {} ) to delete them. In v2.1, fields are deleted if you provide an empty body, or if you don't provide them.

Account Resource

AdWords -> Google Ads rebranding

With AdWords becoming Google Ads , the following AdWords-related fields have been renamed:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
Removal of deprecated fields and values

The deprecated field reviewsUrl has been removed. In addition, the link status inactive has been removed for adsLinks , googleMyBusinessLink , and youtubeChannelLinks .

Accountstatuses Service

AccountStatus Resource

Removal of dataQualityIssues

These have been superseded by itemLevelIssues .

Datafeed Service

Datafeed Resource

Removal of deprecated fields

The fields contentLanguage , targetCountry , and intendedDestinations have been removed and replaced by country , language , includedDestinations , and excludedDestinations in targets .

Removal of product inventory update

Feeds of type product inventory update have been removed.

Inventory Service

The v2 inventory service has been removed and replaced by two new features in v2.1:

Orders Service

CancelLineItem

The fields amount , amountPretax , and amountTax in the request have been removed. The refunded amount is now calculated automatically.

CustomBatch

CustomBatch has been removed from v2.1.

InStoreRefundLineItem

The fields amountPretax and amountTax have been replaced by priceAmount and taxAmount , respectively. The field priceAmount may be pre-tax or post-tax depending on the location of the order.

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

This method has been removed. Use returnRefundLineItem instead.

ReturnLineItem

This method has been removed. Use returnRefundLineItem without providing a refund amount instead.

ReturnRefundLineItem

The fields amountPretax and amountTax have been replaced by priceAmount and taxAmount , respectively. The field priceAmount may be pre-tax or post-tax depending on the location of the order.

ShipLineItem

The fields carrier , shipmentId , and trackingId in the request have been moved to shipmentInfos .

Order and TestOrder Resources

New promotion format

There is a new promotion format in v2.1. You can't create test orders with promotions.

Removal of deprecated fields

The field paymentMethod has been removed, and billingAddress and predefinedBillingAddress are now top-level fields in Order and TestOrder , respectively.

Furthermore, customer.explicitMarketingPreference has been removed and replaced by customer.marketingRightsInfo in both Order and TestOrder .

The deprecated field customer.email has been removed.

The format of the promotions field has changed in the Order resource.

Orderpayments Service

This service has been removed from v2.1.

Products Service

Response from an insert will contain only the following attributes:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

Nonfatal warnings and errors are no longer returned in the response. This allows for better integration with feed rules and other advanced feed management features.

There is now a delay of a few minutes before an inserted product can be retrieved by get or list .

The returned offer ID is no longer guaranteed to be the same as the input offer ID.

Prices are now validated before product insertion. Only the following characters are allowed in the value string: + , - , . , and digits ( 0 - 9 ). Commas are no longer accepted.

Product Resource

CustomGroups replaced by recursive customAttributes

Previously, custom attributes could be grouped together by adding custom attributes under the same custom group in v2. Custom attributes are now recursive in v2.1, so this removes the need for custom groups.

Custom attributes now have an additional groupValues field in addition to the original value field; exactly one of them must be set, meaning they cannot be simultaneously set or left out.

As merchants may switch between v2 and v2.1, it is possible for products to have recursive custom attributes which cannot be represented in v2 as custom groups have a maximum of two levels. In this case, the custom attribute group will be truncated.

Removal of type and unit in customAttributes

In v2.1, custom attributes will no longer contain a type and unit . Instead, units are to be appended to the value (if present), and types should be automatically detected. For exammple, use "1.23 EUR" or "5.6 cm" as the value in v2.1.

ProductTypes supersedes productType and additionalProductTypes

Previously, product types were stored in two fields with the first type in the singular field productType and the remaining in the repeated field additionalProductTypes . In v2.1, the two fields have been replaced by a single repeated field productTypes .

Destinations attribute replaced by includedDestinations and excludedDestinations

Destinations were input as a list of destination name and intention pairs in v2 in the repeated field destinations . This field has been replaced by the following two repeated fields: includedDestinations and excludedDestinations . Destinations enabled by default need not be included in includedDestinations. This will match the configuration of destination overrides in feeds.

With AdWords becoming Google Ads , the following AdWords-related fields have been renamed:

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
Removal of deprecated fields

The following deprecated fields have been removed:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Productstatuses Service

Get and List

The product attribute was removed, along with the includeAttributes parameter. To retrieve attributes of the product corresponding to a status, use the Products service and the value of the new productId field.

Список

The parameter includeInvalidInsertedItems has been removed. All products are now returned regardless of whether they are valid, meaning list now behaves as if includeInvalidInsertedItems is always set to true .

ProductStatus Resource

DestinationsStatuses

The fields intention , approvalStatus , and approvalPending in destinationStatuses have been replaced by status , which is a string that can be one of approved , disapproved , or pending .

Removal of dataQualityIssues

These have been superseded by itemLevelIssues .