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

11 апреля 2024 г.

Изменена видимость LoyaltyPoints

10 апреля 2024 г.

Добавлена LoyaltyProgram

9 апреля 2024 г.

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

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

Добавлены structuredTitle и structuredDescription для предоставления названий и описаний продуктов, созданных искусственным интеллектом.

3 апреля 2024 г.

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

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

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

27 марта 2024 г.

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

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

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

15 марта 2024 г.

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

08 марта 2024 г.

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

В сервис Reports добавлен отчет TopicTrendsView .

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

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

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

11 января 2024 г.

Обслуживание счетов

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

29 ноября 2023 г.

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

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

POS-сервис

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

15 ноября 2023 г.

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

1 ноября 2023 г.

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

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

18 октября 2023 г.

Обслуживание счетов

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

10 октября 2023 г.

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

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 .

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

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

16 февраля 2023 г.

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

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

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

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

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

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

9 февраля 2023 г.

Служба промоакций

Расширьте сервис «Промоакции» до 6 дополнительных параметров targetCountry с поддержкой местного contentLanguage .:

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

12 января 2023 г.

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

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

Добавлен lifestyleImageLinks для предоставления URL-адресов изображений образа жизни.

24 ноября 2022 г.

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

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

15 ноября 2022 г.

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

В сервис отчетов добавлены отчеты 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 г.

Сервис BuyOnGoogleПрограммы

Ресурс BuyOnGoogleProgramStatus

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

Новый метод UpdateBuyOnGoogleProgramStatus.

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

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

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

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

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

30 августа 2021 г.

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

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

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

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

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

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

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

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

9 августа 2021 г.

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

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

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

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

17 мая 2021 г.

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

Добавлено новое поле Product_id в CreateReturnRequest. Продавцы могут указать Product_id или line_item_id, чтобы идентифицировать возвращаемый товар.

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

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

3 мая 2021 г.

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

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

26 апреля 2021 г.

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

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

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

12 апреля 2021 г.

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

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

Новое additionalSizeType полеSizeType для поддержки до двух типов размеров для каждого продукта.

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

28 января 2021 г.

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

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

5 октября 2020 г.

Служба CSSES

CSS-ресурс

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

24 августа 2020 г.

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

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

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

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

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

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

10 августа 2020 г.

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

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

19 июня 2020 г.

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

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

Новые поля

Новые поля productDetails , productHighlights , subscriptionCost и canonicalLink .

2 июня 2020 г.

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

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

27 апреля 2020 г.

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

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

Привязка к Google МБ

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

14 апреля 2020 г.

API отчетов о расчетах

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

9 марта 2020 г.

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

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

2 марта 2020 г.

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

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

3 декабря 2019 г.

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

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

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

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

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

14 августа 2019 г.

Новые услуги

Добавлены новые службы «Политика возврата» и «Адрес возврата» для программы «Купить через Google».

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

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

Новое поле

Новое количество Поле quantityUndeliverable .

7 августа 2019 г.

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

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

Новые поля

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

1 июля 2019 г.

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

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

11 июня 2019 г.

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

Ресурсы Order и TestOrder

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

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

14 февраля 2019 г.

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

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

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

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

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

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

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

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

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

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

Обновлять

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

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

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

AdWords -> Ребрендинг Google Рекламы

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

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

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

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

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

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

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

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

Ресурс подачи данных

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

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

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

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

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

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

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

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

Отменалинейтем

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

CustomBatch

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

InStoreRefundLineItem

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

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

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

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

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

ВозвратRefundLineItem

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

КорабльЛинейкаItem

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

Ресурсы Order и TestOrder

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

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

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

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

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

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

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

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

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

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

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

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

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

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

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

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

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

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

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

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

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

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

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

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

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

Атрибут Destinations заменен на includeDestinations и ExcludedDestinations.

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

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

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

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

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Статусы продукта

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

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

Список

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

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

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

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

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

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