Индекс
-
DataSourcesService
(интерфейс) -
CreateDataSourceRequest
(сообщение) -
DataSource
(сообщение) -
DataSource.Input
(перечисление) -
DeleteDataSourceRequest
(сообщение) -
FetchDataSourceRequest
(сообщение) -
FileInput
(сообщение) -
FileInput.FetchSettings
(сообщение) -
FileInput.FetchSettings.Frequency
(перечисление) -
FileInput.FileInputType
(перечисление) -
GetDataSourceRequest
(сообщение) -
ListDataSourcesRequest
(сообщение) -
ListDataSourcesResponse
(сообщение) -
LocalInventoryDataSource
(сообщение) -
PrimaryProductDataSource
(сообщение) -
PrimaryProductDataSource.Channel
(перечисление) -
PromotionDataSource
(сообщение) -
RegionalInventoryDataSource
(сообщение) -
SupplementalProductDataSource
(сообщение) -
UpdateDataSourceRequest
(сообщение)
Служба источников данных
Сервис для управления первичными, дополнительными, инвентарными и другими источниками данных. Подробную информацию можно найти в справочной статье Merchant Center .
Создать источник данных |
---|
Создает новую конфигурацию источника данных для данной учетной записи.
|
Удалить источник данных |
---|
Удаляет источник данных из вашего аккаунта Merchant Center.
|
FetchDataSource |
---|
Выполняет немедленную выборку данных (даже вне расписания) из источника данных из вашей учетной записи Merchant Center. Если вам нужно вызывать этот метод более одного раза в день, вместо этого вам следует использовать службу «Продукты» для обновления данных о ваших продуктах. Этот метод работает только с источниками данных с набором файловых входных данных.
|
GetDataSource |
---|
Получает конфигурацию источника данных для данной учетной записи.
|
Список источников данных |
---|
Перечисляет конфигурации источников данных для данной учетной записи.
|
Обновление источника данных |
---|
Обновляет существующую конфигурацию источника данных. Поля, заданные в маске обновления, но не предоставленные в ресурсе, будут удалены.
|
Создать запрос источника данных
Сообщение запроса для метода CreateDataSource.
Поля | |
---|---|
parent | Необходимый. Учетная запись, в которой будет создан этот источник данных. Формат: |
data_source | Необходимый. Источник данных, который необходимо создать. |
Источник данных
Источник данных для аккаунта Merchant Center.
Поля | |
---|---|
name | Идентификатор. Имя источника данных. Формат: |
data_source_id | Только вывод. Идентификатор источника данных. |
display_name | Необходимый. Отображаемое имя источника данных в пользовательском интерфейсе Merchant Center. |
input | Только вывод. Определяет тип ввода в источник данных. Судя по введенным данным, некоторые настройки могут не работать. С помощью API можно создавать только общие источники данных. |
file_input | Необязательный. Поле используется только в том случае, если управление данными осуществляется через файл. |
Type поля объединения. Тип источника данных. Type может быть только одним из следующих: | |
primary_product_data_source | Необходимый. Основной источник данных для местных и онлайн-продуктов. |
supplemental_product_data_source | Необходимый. Дополнительный источник данных для местных и онлайн-продуктов. |
local_inventory_data_source | Необходимый. Источник данных о локальных запасах . |
regional_inventory_data_source | Необходимый. Источник данных региональной инвентаризации . |
promotion_data_source | Необходимый. Источник данных о промоакции . |
Вход
Определяет тип ввода в источник данных. Судя по введенным данным, некоторые настройки могут не поддерживаться.
Перечисления | |
---|---|
INPUT_UNSPECIFIED | Ввод не указан. |
API | Представляет источники данных, для которых данные в основном предоставляются через API. |
FILE | Представляет источники данных, для которых данные в основном предоставляются посредством ввода файла. Данные по-прежнему можно предоставлять через API. |
UI | Источник данных для товаров, добавленных непосредственно в Merchant Center. Этот тип источника данных нельзя создать или обновить с помощью этого API, только с помощью пользовательского интерфейса Merchant Center. Этот тип источника данных доступен только для чтения. |
AUTOFEED | Это также известно как автоматические каналы, используемые для автоматического создания данных о ваших продуктах. Этот тип источника данных можно включить или отключить с помощью пакета «Аккаунты». |
УдалитьDataSourceRequest
Сообщение запроса для метода DeleteDataSource.
Поля | |
---|---|
name | Необходимый. Имя источника данных, который требуется удалить. Формат: |
FetchDataSourceRequest
Сообщение запроса для метода FetchDataSource.
Поля | |
---|---|
name | Необходимый. Имя извлекаемого ресурса источника данных. Формат: |
ФилеИнпут
Данные, специфичные для файловых источников данных. Это поле пусто для других входных данных источника данных.
Поля | |
---|---|
fetch_settings | Необязательный. Получите сведения для доставки источника данных. Он содержит настройки для типов ввода файлов |
file_name | Необязательный. Имя файла источника данных. Требуется для типа ввода файла |
file_input_type | Только вывод. Тип ввода файла. |
Получить настройки
Получите сведения для доставки источника данных.
Поля | |
---|---|
enabled | Необязательный. Включает или приостанавливает расписание выборки. |
day_of_month | Необязательный. День месяца, когда должен быть получен файл источника данных (1–31). В этом поле можно установить только ежемесячную частоту. |
time_of_day | Необязательный. Час дня, когда должен быть получен файл источника данных. Минуты и секунды не поддерживаются и будут игнорироваться. |
day_of_week | Необязательный. День недели, когда следует получить файл источника данных. В этом поле можно установить только еженедельную частоту. |
time_zone | Необязательный. Часовой пояс , используемый для расписания. UTC по умолчанию. Например, «Америка/Лос-Анджелес». |
frequency | Необходимый. Частота, описывающая расписание выборки. |
fetch_uri | Необязательный. URL-адрес, по которому можно получить файл источника данных. Google Merchant Center поддерживает автоматическую запланированную загрузку с использованием протоколов HTTP, HTTPS или SFTP, поэтому значение должно быть действительной ссылкой, использующей один из этих трех протоколов. Неизменяемый для файлов Google Таблиц. |
username | Необязательный. Необязательное имя пользователя для [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Используется для отправки источников данных через SFTP . |
password | Необязательный. Необязательный пароль для [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Используется для отправки источников данных через SFTP . |
Частота
Обязательные поля различаются в зависимости от частоты получения. Для ежемесячного расписания получения: [день месяца][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] и [час дня][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day ] необходимы. Для еженедельного расписания загрузки [день недели][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] и [час дня][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day ] необходимы. Для ежедневного расписания получения требуется только [час дня][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day].
Перечисления | |
---|---|
FREQUENCY_UNSPECIFIED | Частота не указана. |
FREQUENCY_DAILY | Загрузка происходит каждый день. |
FREQUENCY_WEEKLY | Загрузка происходит каждую неделю. |
FREQUENCY_MONTHLY | Загрузка происходит каждый месяц. |
ФилеИнпутТип
Способ доставки файлов.
Перечисления | |
---|---|
FILE_INPUT_TYPE_UNSPECIFIED | Тип входного файла не указан. |
UPLOAD | Файл загружается через SFTP, Google Cloud Storage или вручную в Merchant Center. |
FETCH | Файл извлекается из настроенного [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]. |
GOOGLE_SHEETS | Файл извлекается из Google Таблиц, указанных в [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]. |
GetDataSourceRequest
Сообщение запроса для метода GetDataSource.
Поля | |
---|---|
name | Необходимый. Имя источника данных для получения. Формат: |
Запрос ListDataSourcesRequest
Сообщение запроса для метода ListDataSources.
Поля | |
---|---|
parent | Необходимый. Учетная запись, для которой нужно перечислить источники данных. Формат: |
page_size | Необязательный. Максимальное количество возвращаемых источников данных. Служба может возвращать меньшее значение, чем это значение. Максимальное значение — 1000; значения выше 1000 будут приведены к 1000. Если не указано, будет возвращено максимальное количество источников данных. |
page_token | Необязательный. Токен страницы, полученный в результате предыдущего вызова При разбиении на страницы все остальные параметры, предоставляемые |
ListDataSourcesResponse
Ответное сообщение для метода ListDataSources.
Поля | |
---|---|
data_sources[] | Источники данных из указанного аккаунта. |
next_page_token | Токен, который можно отправить как |
ЛокалИнвенторидатасаурце
Источник данных о локальных запасах.
Поля | |
---|---|
feed_label | Необходимый. Неизменный. Ярлык фида предложений, для которых предоставляется местный инвентарь. Должно быть меньше или равно 20 заглавным буквам (AZ), цифрам (0–9) и тире (-). См. также переход на ярлыки фидов . |
content_language | Необходимый. Неизменный. Двухбуквенный язык ISO 639-1 для товаров, для которых предоставляется локальный инвентарь. |
Первичныйпродуктовый источник данных
Основной источник данных для местных и онлайн-продуктов.
Поля | |
---|---|
channel | Необходимый. Неизменный. Указывает тип канала источника данных. |
countries[] | Необязательный. Страны, в которых могут отображаться товары. Представлен в виде кода территории CLDR . |
feed_label | Необязательный. Неизменный. Метка фида, указанная на уровне источника данных. Должно быть меньше или равно 20 заглавным буквам (AZ), цифрам (0–9) и тире (-). См. также переход на ярлыки фидов . Если этот параметр установлен, источник данных будет принимать только продукты, соответствующие этой комбинации. Если этот параметр не установлен, источник данных будет принимать продукты без этого ограничения. |
content_language | Необязательный. Неизменный. Двухбуквенный язык ISO 639-1 для элементов в источнике данных. Если этот параметр установлен, источник данных будет принимать только продукты, соответствующие этой комбинации. Если этот параметр не установлен, источник данных будет принимать продукты без этого ограничения. |
Канал
Канал источника данных.
Канал используется для различения источников данных для разных вертикалей продуктов.
Перечисления | |
---|---|
CHANNEL_UNSPECIFIED | Не указан. |
ONLINE_PRODUCTS | Интернет-продукт. |
LOCAL_PRODUCTS | Местный продукт. |
PRODUCTS | Единый источник данных для локальных и онлайн-продуктов. Примечание. Для этого канала невозможно управление продуктами через API. |
Источник данных по продвижению
Источник данных о промоакции.
Поля | |
---|---|
target_country | Необходимый. Неизменный. Целевая страна используется как часть уникального идентификатора. Представлен в виде кода территории CLDR . Специальные предложения доступны только в некоторых странах . |
content_language | Необходимый. Неизменный. Двухбуквенный язык ISO 639-1 для элементов в источнике данных. |
РегиональныйИнвенториDataSource
Источник данных региональной инвентаризации.
Поля | |
---|---|
feed_label | Необходимый. Неизменный. Ярлык фида предложений, для которых предоставлен региональный инвентарь. Должно быть меньше или равно 20 заглавным буквам (AZ), цифрам (0–9) и тире (-). См. также переход на ярлыки фидов . |
content_language | Необходимый. Неизменный. Двухбуквенный язык ISO 639-1 для товаров, для которых предоставляется региональная инвентаризация. |
Дополнительный источник данных о продукте
Дополнительный источник данных для местных и онлайн-продуктов.
Поля | |
---|---|
feed_label | Необязательный. Неизменный. Метка фида, указанная на уровне источника данных. Должно быть меньше или равно 20 заглавным буквам (AZ), цифрам (0–9) и тире (-). См. также переход на ярлыки фидов . Если этот параметр установлен, источник данных будет принимать только продукты, соответствующие этой комбинации. Если этот параметр не установлен, источник данных будет принимать продукты без этого ограничения. |
content_language | Необязательный. Неизменный. Двухбуквенный язык ISO 639-1 для элементов в источнике данных. Если этот параметр установлен, источник данных будет принимать только продукты, соответствующие этой комбинации. Если этот параметр не установлен, источник данных будет принимать продукты без этого ограничения. |
Запрос обновления источника данных
Сообщение запроса для метода UpdateDataSource.
Поля | |
---|---|
data_source | Необходимый. Ресурс источника данных для обновления. |
update_mask | Необходимый. Список полей источника данных, которые необходимо обновить. Поля, указанные в маске обновления без значения, указанного в теле, будут удалены из источника данных. Предоставление специального значения «*» для полной замены источника данных не поддерживается. |