Подинтерфейс API «Продукты» позволяет программно управлять ассортиментом товаров в Google Merchant Center. Вы можете создавать, извлекать, обновлять и удалять товары, что обеспечивает гибкую интеграцию ваших систем напрямую с Google.
Ключевой концепцией Merchant API является различие между отправляемыми вами данными и конечным продуктом, который использует Google. Такое разделение обеспечивает более чёткую модель жизненного цикла данных о товаре и более точный контроль над информацией о нём. API отражает это двумя основными ресурсами:
ProductInput
: представляет собой необработанные данные о товарах, которые вы отправляете в определенный источник данных. Представьте себе строку, загружаемую в файл фида, или данные, отправляемые с помощью вызова API до обработки Merchant Center. Этот ресурс используется для всех операций записи (insert
,patch
,delete
).Product
: это ресурс, доступный только для чтения, который представляет собой конечный обработанный продукт, отображаемый в Merchant Center и на поверхностях Google. Он формируется из одного основного ресурсаProductInput
и нуля или более дополнительных ресурсовProductInput
после применения всех правил фида и обработки. Этот ресурс содержит информацию о конечном статусе продукта и любых проблемах с качеством данных. Этот ресурс используется для всех операций чтения (get
,list
).
Формат и требования ко всем атрибутам продукта, отправляемым с использованием ресурса ProductInput
, определены в спецификации данных о продукте .
Что можно делать с помощью подAPI «Продукты»
Подпрограмма API «Продукты» позволяет выполнять следующие ключевые задачи. Ознакомьтесь с руководствами, чтобы получить подробные инструкции и примеры кода для каждого варианта использования.
- Добавление и управление продуктами : узнайте, как добавлять новые продукты в свою учетную запись, предоставлять дополнительные данные по существующим и удалять продукты, которые вы больше не продаете.
- Регулярно обновляйте свои продукты : узнайте, как эффективно выполнять частичные обновления часто меняющихся атрибутов продукта, таких как цена и доступность.
- Перечислите данные о ваших продуктах и проблемы с ними : узнайте, как получить доступ к обработанным продуктам, проверить статус их утверждения для разных пунктов назначения и выявить любые проблемы с качеством данных, которые могут повлиять на их видимость.
Прежде чем начать
Перед использованием под-API «Продукты» необходимо создать хотя бы один источник данных API в вашей учётной записи Merchant Center. Под-API «Продукты» позволяет добавлять и обновлять товары только в источниках данных типа API
. Инструкции см. в руководстве «Управление источниками данных API для загрузки товаров» .