REST Resource: accounts.dataSources

Ресурс: Источник данных

Источник данных для аккаунта Merchant Center.

JSON-представление
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  }
  // End of list of possible types for union field Type.
}
Поля
name

string

Идентификатор. Имя источника данных. Формат: {datasource.name=accounts/{account}/dataSources/{datasource}}

dataSourceId

string ( int64 format)

Только вывод. Идентификатор источника данных.

displayName

string

Необходимый. Отображаемое имя источника данных в пользовательском интерфейсе Merchant Center.

input

enum ( Input )

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

fileInput

object ( FileInput )

Необязательный. Поле используется только в том случае, если управление данными осуществляется через файл.

Type поля объединения. Тип источника данных. Type может быть только одним из следующих:
primaryProductDataSource

object ( PrimaryProductDataSource )

Необходимый. Основной источник данных для местных и онлайн-продуктов.

supplementalProductDataSource

object ( SupplementalProductDataSource )

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

localInventoryDataSource

object ( LocalInventoryDataSource )

Необходимый. Источник данных о локальных запасах .

regionalInventoryDataSource

object ( RegionalInventoryDataSource )

Необходимый. Источник данных региональной инвентаризации .

promotionDataSource

object ( PromotionDataSource )

Необходимый. Источник данных о промоакции .

Первичныйпродуктовый источник данных

Основной источник данных для местных и онлайн-продуктов.

JSON-представление
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Поля
channel

enum ( Channel )

Необходимый. Неизменный. Указывает тип канала источника данных.

countries[]

string

Необязательный. Страны, в которых могут отображаться товары. Представлен в виде кода территории CLDR .

feedLabel

string

Необязательный. Неизменный. Метка фида, указанная на уровне источника данных.

Должно быть меньше или равно 20 заглавным буквам (AZ), цифрам (0–9) и тире (-).

См. также переход на ярлыки фидов .

feedLabel и contentLanguage должны быть либо установлены, либо не установлены для источников данных с типом контента «продукт». Их необходимо задать для источников данных с файловым вводом.

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

contentLanguage

string

Необязательный. Неизменный. Двухбуквенный язык ISO 639-1 для элементов в источнике данных.

feedLabel и contentLanguage должны быть либо установлены, либо не установлены. Поля можно сбросить только для источников данных без ввода файла.

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

Канал

Канал источника данных.

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

Перечисления
CHANNEL_UNSPECIFIED Не указан.
ONLINE_PRODUCTS Интернет-продукт.
LOCAL_PRODUCTS Местный продукт.
PRODUCTS Единый источник данных для локальных и онлайн-продуктов.

Дополнительный источник данных о продукте

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

JSON-представление
{
  "feedLabel": string,
  "contentLanguage": string
}
Поля
feedLabel

string

Необязательный. Неизменный. Метка фида, указанная на уровне источника данных.

Должно быть меньше или равно 20 заглавным буквам (AZ), цифрам (0–9) и тире (-).

См. также переход на ярлыки фидов .

feedLabel и contentLanguage должны быть либо установлены, либо не установлены для источников данных с типом контента «продукт». Их необходимо задать для источников данных с файловым вводом.

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

contentLanguage

string

Необязательный. Неизменный. Двухбуквенный язык ISO 639-1 для элементов в источнике данных.

feedLabel и contentLanguage должны быть либо установлены, либо не установлены. Поля можно сбросить только для источников данных без ввода файла.

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

Локальинвенторидатасаурце

Источник данных о локальных запасах.

JSON-представление
{
  "feedLabel": string,
  "contentLanguage": string
}
Поля
feedLabel

string

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

Должно быть меньше или равно 20 заглавным буквам (AZ), цифрам (0–9) и тире (-).

См. также переход на ярлыки фидов .

contentLanguage

string

Необходимый. Неизменный. Двухбуквенный язык ISO 639-1 для товаров, для которых предоставляется локальный инвентарь.

РегиональныйИнвенториDataSource

Источник данных региональной инвентаризации.

JSON-представление
{
  "feedLabel": string,
  "contentLanguage": string
}
Поля
feedLabel

string

Необходимый. Неизменный. Ярлык фида предложений, для которых предоставлен региональный инвентарь.

Должно быть меньше или равно 20 заглавным буквам (AZ), цифрам (0–9) и тире (-).

См. также переход на ярлыки фидов .

contentLanguage

string

Необходимый. Неизменный. Двухбуквенный язык ISO 639-1 для товаров, для которых предоставляется региональная инвентаризация.

Источник данных по продвижению

Источник данных о промоакции.

JSON-представление
{
  "targetCountry": string,
  "contentLanguage": string
}
Поля
targetCountry

string

Необходимый. Неизменный. Целевая страна используется как часть уникального идентификатора. Представлен в виде кода территории CLDR .

Специальные предложения доступны только в некоторых странах .

contentLanguage

string

Необходимый. Неизменный. Двухбуквенный язык ISO 639-1 для элементов в источнике данных.

Вход

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

Перечисления
INPUT_UNSPECIFIED Ввод не указан.
API Представляет источники данных, для которых данные в основном предоставляются через API.
FILE Представляет источники данных, для которых данные в основном предоставляются посредством ввода файла. Данные по-прежнему можно предоставлять через API.
UI

Источник данных для товаров, добавленных непосредственно в Merchant Center.

Этот тип источника данных нельзя создать или обновить с помощью этого API, только с помощью пользовательского интерфейса Merchant Center.

Этот тип источника данных доступен только для чтения.

AUTOFEED Это также известно как автоматические каналы, используемые для автоматического создания данных о ваших продуктах. Этот тип источника данных можно включить или отключить с помощью пакета «Аккаунты».

ФилеИнпут

Данные, специфичные для файловых источников данных. Это поле пусто для других входных данных источника данных.

JSON-представление
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
Поля
fetchSettings

object ( FetchSettings )

Необязательный. Получите сведения для доставки источника данных. Он содержит настройки для типов ввода файлов FETCH и GOOGLE_SHEETS . Обязательные поля различаются в зависимости от частоты получения.

fileName

string

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

fileInputType

enum ( FileInputType )

Только вывод. Тип ввода файла.

Получить настройки

Получите сведения для доставки источника данных.

JSON-представление
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
Поля
enabled

boolean

Необязательный. Включает или приостанавливает расписание выборки.

dayOfMonth

integer

Необязательный. День месяца, когда должен быть получен файл источника данных (1–31). В этом поле можно установить только ежемесячную частоту.

timeOfDay

object ( TimeOfDay )

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

dayOfWeek

enum ( DayOfWeek )

Необязательный. День недели, когда следует получить файл источника данных. В этом поле можно установить только еженедельную частоту.

timeZone

string

Необязательный. Часовой пояс , используемый для расписания. UTC по умолчанию. Например, «Америка/Лос-Анджелес».

frequency

enum ( Frequency )

Необходимый. Частота, описывающая расписание выборки.

fetchUri

string

Необязательный. URL-адрес, по которому можно получить файл источника данных. Google Merchant Center поддерживает автоматическую запланированную загрузку с использованием протоколов HTTP, HTTPS или SFTP, поэтому значение должно быть действительной ссылкой, использующей один из этих трех протоколов. Неизменяемый для файлов Google Таблиц.

username

string

Необязательный. Необязательное имя пользователя для [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Используется для отправки источников данных через SFTP .

password

string

Необязательный. Необязательный пароль для [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Используется для отправки источников данных через SFTP .

ВремяДня

Обозначает время суток. Дата и часовой пояс либо не имеют значения, либо указаны в другом месте. API может разрешить високосные секунды. Связанные типы: google.type.Date и google.protobuf.Timestamp .

JSON-представление
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Поля
hours

integer

Часы суток в 24-часовом формате. Должно быть от 0 до 23. API может разрешить использование значения «24:00:00» для таких сценариев, как время закрытия предприятия.

minutes

integer

Минуты часа дня. Должно быть от 0 до 59.

seconds

integer

Секунды минут времени. Обычно должно быть от 0 до 59. API может допускать значение 60, если он допускает дополнительные секунды.

nanos

integer

Доли секунды в наносекундах. Должно быть от 0 до 999 999 999.

День недели

Представляет день недели.

Перечисления
DAY_OF_WEEK_UNSPECIFIED День недели не указан.
MONDAY Понедельник
TUESDAY Вторник
WEDNESDAY Среда
THURSDAY Четверг
FRIDAY Пятница
SATURDAY Суббота
SUNDAY Воскресенье

Частота

Обязательные поля различаются в зависимости от частоты получения. Для ежемесячного графика получения: [день месяца][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 Файл извлекается из настроенного [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri].
GOOGLE_SHEETS Файл извлекается из Google Таблиц, указанных в [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri].

Методы

create

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

delete

 Удаляет источник данных из вашего аккаунта Merchant Center.

fetch

 Выполняет немедленную выборку данных (даже вне расписания) из источника данных из вашей учетной записи Merchant Center.

get

 Получает конфигурацию источника данных для данной учетной записи.

list

 Перечисляет конфигурации источников данных для данной учетной записи.

patch

 Обновляет существующую конфигурацию источника данных.