Обзор API источников данных о продавцах

На этой странице показано, как программно создавать и обновлять источники данных, позволяющие вставлять продукты. Автоматизированные источники данных упрощают отправку данных о ваших продуктах в Google. Автоматизированные источники данных гарантируют, что самая актуальная информация о соответствующих продуктах с вашего сайта попадет в Google.

Content API for Shopping позволяет создавать только первичные источники данных. С помощью API источников данных торговцев вы можете создавать следующие типы источников данных:

• Основные источники данных о продукте
• Дополнительные источники данных о продуктах
• Источники данных о местных запасах
• Источники данных региональной инвентаризации
• Источники данных о промоакции

Content API for Shopping позволял управлять источниками данных только с помощью файлового ввода. Merchant API позволяет управлять источниками данных как с помощью файлов, так и входных данных API.

Используя API источников данных о продавцах, вы можете делать следующее:

• Создайте новый основной источник данных с определенными feedLabel и contentLanguage .
• Создайте источник данных с подстановочными знаками. В источнике данных с подстановочными знаками не установлены feedLabel и contentLanguage . Источники данных с подстановочными знаками позволяют вставлять в источник данных продукты с различными комбинациями feedLabel и contentLanguage .
• Создайте дополнительный источник данных для связи с существующим основным источником данных.
• Настройте расписание для файлового источника данных.
• Зарегистрируйте свою учетную запись для автоматического управления источниками данных.
• Управляйте источниками данных API.
• Управляйте правилом источников данных по умолчанию, используя основные источники данных о продуктах.
• Используйте другие типы источников данных, например рекламные акции.

Предварительные условия

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

• Чтобы убедиться, что учетная запись уже перенесена в целевое разделение данных, используйте список источников данных или методы get. Если вы не имеете на это права, вы получите следующее сообщение об исключении и вам следует обратиться в службу поддержки.

  This account is in the data sources migration process and can't be used with
  this API yet. Contact support for more info on when this account will be able
  to use the data sources endpoint.
  

Создайте новый источник данных

Чтобы создать новый основной источник данных с определенными feedLabel и contentLanguage , задайте поля feedLabel и contentLanguage в конфигурации для конкретного типа. Например, PrimaryProductDataSource .

Чтобы просмотреть вновь созданный источник данных, создайте запрос GET или LIST .

Создайте новый основной источник данных с подстановочными знаками.

Чтобы создать новый основной фид с подстановочными знаками, настройте источник данных с помощью PrimaryProductDataSource и не устанавливайте поля feedLabel и contentLanguage .

При использовании Content API for Shopping для вас создается только один источник данных API. Используя API источников данных о продавцах, вы можете иметь несколько источников данных API, некоторые из которых могут быть подстановочными знаками.

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

Создайте дополнительный источник данных и свяжите его с основным источником данных.

Вы можете использовать дополнительные источники данных для частичного обновления данных о продуктах, добавляя уникальный идентификатор источника данных в качестве параметра запроса при вызовах методов accounts.productInputs.insert accounts.productInputs.delete . Вы можете использовать дополнительные источники данных только для обновления существующих продуктов.

Чтобы создать дополнительный источник данных, настройте свой источник данных с помощью SupplementalProductDataSource , а затем свяжите его, обновив поле defaultRule в основном источнике данных.

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

Настройте расписание для источника данных файла

Чтобы настроить расписание для вашего фида файлов, настройте источник данных как источник данных файла, используя поле FileInput , а затем настройте fetchsettings используя поле FileInput.FetchSettings .

Удаление источника данных

Чтобы удалить существующий источник данных из вашей учетной записи, используйте метод accounts.dataSources.delete .

Получить источник данных

Чтобы получить файл, настроенный в источнике данных, используйте метод accounts.dataSources.fetch . Этот метод выполняет немедленную выборку данных из источника данных из вашей учетной записи. Этот метод работает только с источниками данных с набором файловых входных данных.

Получить источник данных

Чтобы получить конфигурацию источника данных для вашей учетной записи, используйте метод accounts.dataSources.get .

Список источников данных

Чтобы получить список конфигураций источников данных для вашей учетной записи, используйте метод accounts.dataSources.list .

Исправить источник данных

Чтобы обновить конфигурацию существующего источника данных, используйте метод accounts.dataSources.patch .

Связать источники данных

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

Следующий пример конфигурации гарантирует, что все атрибуты сначала берутся из источника данных с уникальным идентификатором 1001 . Затем недостающие атрибуты добавляются из первичного источника данных. В конце концов, остальные атрибуты будут взяты из дополнительного источника данных с уникальным идентификатором 1002 если он еще не указан ни в одном другом источнике данных. Если один и тот же атрибут указан в нескольких источниках данных, выбирается значение выше в списке.

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

Примечание. Пользовательские правила нельзя изменить через API.

Автоматическое управление фидами

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

• Проверьте, имеет ли ваша учетная запись право на регистрацию, вызвав метод Accounts.AutofeedSettings.Get .
• Убедитесь, что ваша учетная запись не является учетной записью торговой площадки .

После того как ваша учетная запись будет иметь право на регистрацию, вы можете использовать метод Accounts.AutofeedSettings.Update , чтобы включить автоматическое управление источниками данных. Включение автоматического управления источниками данных позволяет Google автоматически добавлять ваши продукты из вашего интернет-магазина и гарантировать их актуальность на платформах Google.

Получить статус загрузки файла

Чтобы получить статус источника данных с помощью файла, выборки или электронной таблицы, вы можете вызвать метод GET службы FileUpload . Чтобы получить результат последнего извлечения источника данных, вычисленный асинхронно после завершения обработки источника данных, используйте идентификатор имени latest .

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

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

Обратите внимание: статус загрузки файла может отсутствовать, если файл никогда не был загружен. Статус загрузки файла может быть в состоянии обработки, если запрос будет сделан вскоре после загрузки файла.