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)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // End of list of possible types for union field Type.
}
Поля
name

string

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

data Source Id

string ( int64 format)

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

display Name

string

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

input

enum ( Input )

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

file Input

object ( FileInput )

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

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

object ( PrimaryProductDataSource )

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

supplemental Product Data Source

object ( SupplementalProductDataSource )

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

local Inventory Data Source

object ( LocalInventoryDataSource )

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

regional Inventory Data Source

object ( RegionalInventoryDataSource )

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

promotion Data Source

object ( PromotionDataSource )

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

product Review Data Source

object ( ProductReviewDataSource )

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

merchant Review Data Source

object ( MerchantReviewDataSource )

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

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

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

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

enum ( Channel )

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

countries[]

string

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

default Rule

object ( DefaultRule )

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

feed Label

string

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

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

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

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

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

content Language

string

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

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

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

Канал

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

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

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

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

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

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

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 следует использовать для ссылки на сам основной источник данных.

primary Data Source Name

string

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

supplemental Data Source Name

string

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

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

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

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

object ( DataSourceReference )

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

feed Label

string

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

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

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

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

Их необходимо задать для источников данных с file input . Поля должны быть отключены для источников данных без file input .

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

content Language

string

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

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

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

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

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

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

string

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

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

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

content Language

string

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

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

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

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

string

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

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

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

content Language

string

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

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

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

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

string

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

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

content Language

string

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

Обзор продуктаИсточник данных

Этот тип не имеет полей.

Источник данных обзора продукта.

ПродавецОбзорDataSource

Этот тип не имеет полей.

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

Вход

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

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

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

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

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

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

ФилеИнпут

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

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

object ( FetchSettings )

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

file Name

string

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

file Input Type

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

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

day Of Month

integer

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

time Of Day

object ( TimeOfDay )

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

day Of Week

enum ( DayOfWeek )

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

time Zone

string

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

frequency

enum ( Frequency )

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

fetch Uri

string

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

username

string

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

password

string

Необязательный. Необязательный пароль для fetchUri . Используется для отправки источников данных через 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_SHEETS Файл извлекается из Google Таблиц, указанных в fetchUri .

Методы

create

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

delete

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

fetch

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

get

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

list

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

patch

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