Последние сведения

Узнавайте о новых функциях, исправленных ошибках и обновлениях.

Октябрь 2026 г.

Октябрь 2026 г.

Что нового:

  • Правила в отношении отчетов и разработчиков в партнерской программе YouTube Покупок (v1alpha)

  • URI главной страницы магазина в дополнительном API Accounts. В ресурс accounts добавлено поле homePageUri, доступное только для чтения. В нем возвращается URI главной страницы магазина.

  • Добавление атрибутов в Products sub-API

    • Ссылки на сертификацию по продукту и перечисления энергоэффективности в Великобритании. Добавлены поля certificationDocumentLink и certificationLabelLink, а также перечисления для органа сертификации Department for Energy Security & Net Zero (DESNZ) и названия сертификата GB_ENERGY_INFORMATION в ProductCertification в ProductAttributes. Подробнее о сертификации…
    • Допустимый пробег для рассрочки платежей за автомобиль. В ProductInstallment вложен атрибут ProductAttributes, в который добавлен атрибут mileageAllowance, позволяющий указывать допустимый пробег для договоров лизинга.
    • Ссылки на видео на уровне предложения. В ProductAttributes добавлен атрибут videoLinks, чтобы вы могли добавлять видео на уровне предложения в больших масштабах.

  • Новая документация для сторонних поставщиков услуг

  • Новые примеры кода Java для управления пакетной обработкой регионов:

  • Отчеты об эффективности агентных действий UCP (v1alpha). В accounts.reports.search в Reports sub-API (v1alpha) добавлены два новых представления отчетов, которые позволяют получать показатели эффективности оформления покупок и конверсий UCP в сервисах Google, включая режим ИИ в Поиске и Gemini:

Вот что изменилось:

  • Расширенная поддержка атрибута "гарантия". Атрибут warranty в ProductAttributes теперь можно использовать не только для автомобилей, но и для всех товаров. Срок гарантии можно указывать в месяцах или годах.
  • Денормализация проблем с аккаунтом на уровне предложения. Теперь проблемы, связанные с блокировкой аккаунта, показываются непосредственно в затронутых предложениях, а не в виде общего сообщения ACCOUNT_DISAPPROVAL. Это позволяет точнее диагностировать проблемы на уровне предложения, метода маркетинга и страны.
  • Прекращение поддержки YoutubeProductPerformanceView (v1alpha). Прекращена поддержка YoutubeProductPerformanceView в Reports sub-API (v1alpha). Вместо него используйте YoutubeProductSoldStatsView и YoutubeProductTaggedStatsView.
  • Стандартизированная разбивка на страницы в Notifications sub-API и новые руководства. Мы стандартизировали разбивку на страницы в accounts.notificationsubscriptions.list с необязательным параметром pageSize, значение которого по умолчанию равно 100 (максимум – 200). Также мы опубликовали новое руководство по настройке push-уведомлений об изменениях в сервисах аккаунта.
  • Реорганизация справочной документации и руководства по квотам и лимитам. С сайта для разработчиков удалены все справочные страницы REST и RPC для версии 1beta, поддержка которой прекращена. Квоты и лимиты реорганизованы в отдельные руководства по квотам API и лимитам в аккаунтах.

Август 2026 г.

Август 2026 г.

Что нового:

  • Поддержка Content API for Shopping прекратилась 18 августа 2026 г. Всем разработчикам необходимо как можно скорее перенести существующие интеграции в Merchant API. Подробную информацию вы найдете в статье Прекращение поддержки и удаление.
  • Интеграция аккаунта с Universal Commerce Protocol (UCP). В ресурс Account Service добавлен тип сервиса UcpCheckoutManagement, а также поддержка программы ucp-integration и условий использования ucp_integration с ограниченным доступом.
  • Переопределение правил возврата на уровне предложения. Добавлен атрибут returns в ProductAttributes, чтобы настраивать и переопределять правила возврата (например, страну, срок возврата, комиссии за возврат, состояние) непосредственно на уровне товара.
  • Атрибуты для аренды недвижимости. Добавлены основные атрибуты для объявлений, в том числе leaseTerm и ProductAttributes, для отправки данных о рекламе аренды.
  • Улучшения в Inventories sub-API:
    • Добавлен атрибут localShippingLabel в LocalInventoryAttributes для настройки правил доставки для отдельных магазинов.
    • Добавлен атрибут customAttributes в LocalInventoryAttributes для поддержки специальных метаданных в местном ассортименте.
  • Уведомления о сервисах аккаунта. В под-API Notifications добавлено значение ACCOUNT_SERVICE для NotificationEventType, чтобы отслеживать изменения статуса сервисов аккаунта. Подробнее о push-уведомлениях об изменениях в сервисах аккаунта…
  • Представления отчетов о партнерской программе YouTube Покупок (v1alpha)
  • Конечная точка списков электронных адресов участников программы лояльности. Загружайте данные о клиентах, участвующих в программе лояльности, и управляйте ими, чтобы показывать преимущества уровней (например, цены для участников) в результатах обычного поиска. Подробнее о списках электронных адресов участников программы лояльности…
  • Общедоступное хранилище альфа-версий клиентских библиотек. Альфа-версии библиотек для дополнительного API отзывов на Python, Java, PHP, C#, Ruby, Node.js и Go теперь доступны в общедоступном хранилище GitHub.

Вот что изменилось:

  • Фильтр уровня доступа ListAccounts. Добавлен параметр access, поддерживающий значения DIRECT, INDIRECT и ALL, для фильтрации аккаунтов на основе разрешений вызывающего абонента. Это позволяет различать расширенные и дочерние аккаунты.
  • Проверка квот и правил DataSources
    • Добавлено автоматическое управление квотами для источников данных в расширенных аккаунтах. Подробнее о квотах и ограничениях…
    • Добавлена проверка правил, согласно которой правила по умолчанию в основных источниках данных о товарах должны содержать ровно одну ссылку на self или основной источник данных.
    • Прекращена поддержка primaryDataSourceName в DataSourceReference в пользу self.
  • Уменьшение задержки. Снижены накладные расходы API на вызовы для добавления, обновления и удаления товаров.

Что планируется в будущем

  • Прекращение поддержки и отключение Content API for Shopping. Напоминание о переходе на новый Merchant API. Чтобы стимулировать переход до полного прекращения поддержки и убедиться, что разработчики видят уведомления о прекращении поддержки в журналах своих приложений, с 1 сентября 2026 года Google начнет постепенно ухудшать работу сервиса. Дополнительную информацию можно найти в разделе График прекращения поддержки.

Май 2026 г.

Май 2026 г.

Что нового:

Вот что изменилось:

  • Поддержка Merchant API v1beta прекращена. Все вызовы API теперь должны направляться в версии v1 или v1alpha. Инструкции по переходу вы найдете в статье Переход с версии v1beta на v1.
  • Теперь вы можете чаще обновлять атрибуты price и availability с помощью метода patch в Products sub-API. Эта функция позволяет повысить актуальность данных, обновляя определенные атрибуты с меньшей задержкой. В настоящее время эта функция доступна только продавцам из белого списка. Чтобы узнать больше или запросить доступ, обратитесь к представителю Google.

Что планируется в будущем

  • Аналитика эффективности агентов с помощью UCP в Reports API.

Январь 2026 г.

Январь 2026 г.

Что нового:

Вот что изменилось:

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

Что планируется в будущем

  • Прекращение поддержки Merchant API v1beta 28 февраля 2026 года. До прекращения поддержки v1beta перенаправьте все вызовы API на версии v1 и v1alpha соответственно.
  • Возможность включать и отключать программу "Отзывы о товарах" через Reviews API v1alpha, что упрощает отправку отзывов и управление ими.

Ноябрь 2025 г.

Ноябрь 2025 г.

Что нового:

  • Новые данные для аналитики партнерской программы YouTube Покупок (v1alpha) в дополнительном API Reports для получения аналитики об авторах, контенте и товарах, представленных на YouTube. Они аналогичны отчетам, доступным в Google Merchant Center.
  • Обновленный инструмент диагностики API, который поможет перейти на Merchant API(v1).
  • В дочерний API Accounts добавлено новое поле product_filters. С его помощью продавцы могут делиться с аккаунтами Google Рекламы только частью фида, отфильтрованной по атрибутам товаров. Эта функция доступна только ограниченному числу продавцов.
  • Добавлена поддержка создания отдельных аккаунтов для продавцов на платформах электронной торговли.
  • Добавлены два новых метода, accounts.limits.get и accounts.limits.list, для запроса лимитов аккаунта в Quota API.

Вот что изменилось:

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

Что планируется в будущем

Сентябрь 2025 г.

Сентябрь 2025 г.

Что нового:

  • Доступен первый сервис Model Context Protocol (MCP) для Merchant API.
    • Новый сервис MCP интегрирует официальную документацию по API Google в помощника по написанию кода из интегрированной среды разработки (IDE). Это позволяет ускорить интеграцию Merchant API и повысить точность рабочих процессов переноса.
  • Новый метод getAccountForGcpRegistration в Accounts sub-API для получения аккаунта продавца, зарегистрированного в Google Cloud.

Вот что изменилось:

Что планируется в будущем

  • Новые отчеты для аналитики партнерской программы YouTube Покупок, например v1alpha в дополнительном API Reports, для получения аналитики об авторах, контенте и товарах, представленных на YouTube, которые обеспечивают паритет с отчетами, доступными в Google Merchant Center.
  • Более частое обновление атрибутов "наличие" и "цена".
  • Упрощенный анализ ошибок API благодаря расширенным метаданным и ErrorInfo.

Июль 2025 г.

Июль 2025 г.

Что нового:

  • Merchant API (v1) – официальная замена Content API for Shopping – теперь доступен всем.

    Это значит, что в Merchant API останутся только дочерние API v1alpha и v1, а большинство версий v1beta будут преобразованы в v1. Следите за новостями.

  • Доступны новые ресурсы.

    • Ресурс Image в Product Studio API (альфа-версия) использует генеративный ИИ, чтобы создавать новые фоны для товаров, удалять фон и повышать разрешение изображений.
    • Оформление покупки в магазине продавца в дочернем API Accounts позволяет создавать, обновлять, удалять и получать настройки оформления покупки.
    • Правила возврата товаров, купленных онлайн, в дочернем API Accounts перенесены, а функции для пользователей остались без изменений. Для единообразия были удалены некоторые устаревшие поля и переименованы существующие.
    • AccountIdAlias в ресурсе AccountRelationship в дочернем API Accounts использует заданный пользователем псевдоним вместо внутреннего идентификатора (идентификатора аккаунта). Это упрощает управление сложными структурами аккаунтов, например когда вместо внутреннего идентификатора используется псевдоним торговой площадки, заданный пользователем.

  • Пользователи Apps Script теперь могут получить доступ к Merchant API.

  • В Issue resolution API теперь доступен новый метод AggregateProductStatuses, который позволяет запрашивать объединенную статистику по статусам товаров.

Вот что изменилось:

  • Возможность создавать отдельные аккаунты для конструкторов магазинов и ССЦ. Раньше аккаунты продавцов создавались в рамках одного расширенного аккаунта.

  • Рейтинги вероятности клика в таблице productView в Reports sub-API. Теперь рейтинг товаров на основе clickPotential нормализуется до значений от 1 до 1000. Товары с низким значением clickPotentialRank по-прежнему имеют самое высокое значение click potential среди товаров продавца, соответствующих условиям поискового запроса.

Что планируется в будущем

  • Доступ через сервер Model Context Protocol (MCP) (v1alpha).

Май 2025 г.

Май 2025 г.

Что нового:

  • Мы запустили два новых дополнительных API.
  • В Accounts sub-API доступны новые ресурсы.
    • OmnichannelSettings управляет настройками аккаунта для многоканального показа, например бесплатных местных предложений и рекламы местного ассортимента.
    • LfpProviders подключается к партнерам программы "Фиды товаров местного ассортимента" (LFP) для получения данных об ассортименте.
    • GbpAccounts подключается к профилю компании в Google, чтобы получать данные о местных магазинах.
    • OnlineReturnPolicy позволяет создавать, удалять и обновлять правила.
  • В Products sub-API доступен новый метод.
    • ProductsUpdate позволяет обновлять отдельные товары без необходимости указывать все поля, необходимые для ProductInput.

Вот что изменилось:

  • Максимальное значение pageSize увеличено с 250 до 1000 строк на вызов API.
  • Исправлена задержка, которая возникала при добавлении товаров, промоакций, отзывов о товарах и продавцах после создания DataSources.

Что планируется в будущем

  • Прекращение поддержки и удаление поля channel для DataSources и товаров.
  • Обновлено определение clickPotentialRank в таблице productView в разделе Reports sub-API:
    • Рейтинг товаров на основе clickPotential нормализуется до значений от 1 до 1000.
    • Товары с низким значением clickPotentialRank по-прежнему имеют самую высокую вероятность клика среди товаров продавца, соответствующих условиям поискового запроса. Это некритическое изменение, которое может быть запущено 1 июля 2025 г.
  • Поле AccountIdAlias в ресурсе AccountRelationship позволяет эффективнее управлять сложными структурами аккаунтов. Например, торговые площадки используют псевдоним, заданный пользователем, вместо внутреннего идентификатора продавца, такого как идентификатор аккаунта.

Апрель 2025 г.

Апрель 2025 г.

Что нового:

Вот что изменилось:

  • Теперь в Data Sources sub-API поддерживаются целевые сервисы, которые в Merchant Center называются методами маркетинга.
  • Мы внесли в ресурс несколько изменений. Подробную информацию о них вы найдете в примечаниях к выпуску Accounts API.
  • Поля taxes и tax_category в дополнительном API товаров больше не поддерживаются, поскольку в Content API прекращена поддержка поля accounttax.

Что планируется в будущем

  • Мы учли ваши отзывы и работаем над улучшением документации для разработчиков API.
  • Следите за новостями и не забывайте делиться с нами своим мнением.
Назад
YouTube Shopping developer policies
Далее
Design