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
  ],
  "defaultRule": {
    object (DefaultRule)
  },
  "feedLabel": string,
  "contentLanguage": string
}
Поля
channel

enum ( Channel )

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

countries[]

string

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

defaultRule

object ( DefaultRule )

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

feedLabel

string

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

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

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

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

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

contentLanguage

string

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

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

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

Канал

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

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

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

Правило по умолчанию

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

JSON-представление 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
Поля
takeFromDataSources[]

object ( DataSourceReference )

Необходимый. Список источников данных, связанных в правиле по умолчанию . Этот список упорядочен по приоритету правила по умолчанию для объединения данных. Он может включать отсутствие или несколько ссылок на self и дополнительные источники данных.

Список не должен быть пустым.

Чтобы связать источник данных с правилом по умолчанию, вам необходимо добавить в этот список новую ссылку (в последовательном порядке).

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

Изменение порядка этого списка приведет к изменению приоритета источников данных в правиле по умолчанию.

Например, если предоставить следующий список: [ 1001 , self ] будут принимать значения атрибутов из дополнительного источника данных 1001 и возвращаться к self если атрибут не установлен в 1001 .

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

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

JSON-представление 
{

  // Union field data_source_id can be only one of the following:
  "self": boolean,
  "primaryDataSourceName": string,
  "supplementalDataSourceName": string
  // End of list of possible types for union field data_source_id.
}
Поля

Поле объединения data_source_id .

data_source_id может быть только одним из следующих:

self

boolean

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

primaryDataSourceName

string

Необязательный. Имя основного источника данных. Формат: accounts/{account}/dataSources/{datasource}

supplementalDataSourceName

string

Необязательный. Имя дополнительного источника данных. Формат: accounts/{account}/dataSources/{datasource}

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

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

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

object ( DataSourceReference )

Только вывод. Список (неупорядоченный и дедуплицированный) всех основных источников данных, связанных с этим источником данных в правилах по умолчанию или в настраиваемых правилах. Дополнительный источник данных нельзя удалить, пока не будут удалены все ссылки.

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

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