REST Resource: accounts.dataSources

Zasób: DataSource

Źródło danych konta Merchant Center.

Zapis 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.
}
Pola
name

string

Identyfikator. Nazwa źródła danych. Format: {datasource.name=accounts/{account}/dataSources/{datasource}}

dataSourceId

string (int64 format)

Tylko dane wyjściowe. Identyfikator źródła danych.

displayName

string

Wymagane. Wyświetlana nazwa źródła danych w interfejsie Merchant Center.

input

enum (Input)

Tylko dane wyjściowe. Określa typ danych wejściowych do źródła danych. W zależności od danych wejściowych niektóre ustawienia mogą nie działać. Za pomocą interfejsu API można tworzyć tylko ogólne źródła danych.

fileInput

object (FileInput)

Opcjonalnie: To pole jest używane tylko wtedy, gdy danymi zarządzasz za pomocą pliku.

Pole sumy Type. Typ źródła danych. Type może mieć tylko jedną z tych wartości:
primaryProductDataSource

object (PrimaryProductDataSource)

Wymagane. Podstawowe źródło danych produktów dostępnych lokalnie i online.

supplementalProductDataSource

object (SupplementalProductDataSource)

Wymagane. Dodatkowe źródło danych dla produktów dostępnych lokalnie i online.

localInventoryDataSource

object (LocalInventoryDataSource)

Wymagane. Źródło danych lokalny asortyment.

regionalInventoryDataSource

object (RegionalInventoryDataSource)

Wymagane. Źródło danych o asortymencie regionalnym.

promotionDataSource

object (PromotionDataSource)

Wymagane. Źródło danych promocji.

PrimaryProductDataSource

Podstawowe źródło danych dla produktów dostępnych lokalnie i online.

Zapis JSON
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Pola
channel

enum (Channel)

Wymagane. Stały. Określa typ kanału źródła danych.

countries[]

string

Opcjonalnie: Kraje, w których produkty mogą być wyświetlane. Przedstawiany jako kod regionu CLDR.

feedLabel

string

Opcjonalnie: Stały. Etykieta pliku danych określona na poziomie źródła danych.

Może mieć maksymalnie 20 wielkich liter (A–Z), cyfr (0–9) i myślników (-).

Zapoznaj się też z artykułem na temat migracji do etykiet plików danych.

W przypadku źródeł danych z typem treści produktów wartości feedLabel i contentLanguage muszą być skonfigurowane lub nieskonfigurowane. Muszą być one ustawione dla źródeł danych z danymi wejściowymi pliku.

Jeśli jest ustawione, źródło danych będzie akceptować tylko produkty pasujące do tej kombinacji. Jeśli źródło danych nie jest skonfigurowane, będzie akceptować produkty bez tego ograniczenia.

contentLanguage

string

Opcjonalnie: Stały. Dwuliterowy język elementów w źródle danych, zgodny ze standardem ISO 639-1.

Funkcje feedLabel i contentLanguage muszą być skonfigurowane lub nieustawione. Nieskonfigurowanie pól jest możliwe tylko w przypadku źródeł danych, które nie wymagają wprowadzania danych w postaci plików.

Jeśli jest ustawione, źródło danych będzie akceptować tylko produkty pasujące do tej kombinacji. Jeśli źródło danych nie jest skonfigurowane, będzie akceptować produkty bez tego ograniczenia.

Kanał

Kanał źródła danych.

Kanał służy do rozróżniania źródeł danych w przypadku różnych branż produktów.

Wartości w polu enum
CHANNEL_UNSPECIFIED Nie określono.
ONLINE_PRODUCTS Produkt dostępny online.
LOCAL_PRODUCTS Produkt dostępny lokalnie.
PRODUCTS Ujednolicone źródło danych dla produktów lokalnych i online. Uwaga: na tym kanale nie można zarządzać produktami za pomocą interfejsu API.

SupplementalProductDataSource

Dodatkowe źródło danych produktów dostępnych lokalnie i online.

Zapis JSON
{
  "feedLabel": string,
  "contentLanguage": string
}
Pola
feedLabel

string

Opcjonalnie: Stały. Etykieta pliku danych określona na poziomie źródła danych.

Może mieć maksymalnie 20 wielkich liter (A–Z), cyfr (0–9) i myślników (-).

Zapoznaj się też z artykułem na temat migracji do etykiet plików danych.

W przypadku źródeł danych z typem treści produktów wartości feedLabel i contentLanguage muszą być skonfigurowane lub nieskonfigurowane. Muszą być one ustawione dla źródeł danych z danymi wejściowymi pliku.

Jeśli jest ustawione, źródło danych będzie akceptować tylko produkty pasujące do tej kombinacji. Jeśli źródło danych nie jest skonfigurowane, będzie akceptować produkty bez tego ograniczenia.

contentLanguage

string

Opcjonalnie: Stały. Dwuliterowy język elementów w źródle danych, zgodny ze standardem ISO 639-1.

Funkcje feedLabel i contentLanguage muszą być skonfigurowane lub nieustawione. Nieskonfigurowanie pól jest możliwe tylko w przypadku źródeł danych, które nie wymagają wprowadzania danych w postaci plików.

Jeśli jest ustawione, źródło danych będzie akceptować tylko produkty pasujące do tej kombinacji. Jeśli źródło danych nie jest skonfigurowane, będzie akceptować produkty bez tego ograniczenia.

LocalInventoryDataSource

Źródło danych o lokalnym asortymencie.

Zapis JSON
{
  "feedLabel": string,
  "contentLanguage": string
}
Pola
feedLabel

string

Wymagane. Stały. Etykieta pliku danych ofert, do których przesłano lokalny asortyment.

Może mieć maksymalnie 20 wielkich liter (A–Z), cyfr (0–9) i myślników (-).

Zapoznaj się też z artykułem na temat migracji do etykiet plików danych.

contentLanguage

string

Wymagane. Stały. Dwuliterowy język produktów, do których dostępny jest lokalny asortyment, zgodny ze standardem ISO 639-1.

RegionalInventoryDataSource

Źródło danych o asortymencie regionalnym.

Zapis JSON
{
  "feedLabel": string,
  "contentLanguage": string
}
Pola
feedLabel

string

Wymagane. Stały. Etykieta pliku danych ofert, do których przesłano asortyment regionalny.

Może mieć maksymalnie 20 wielkich liter (A–Z), cyfr (0–9) i myślników (-).

Zapoznaj się też z artykułem na temat migracji do etykiet plików danych.

contentLanguage

string

Wymagane. Stały. Dwuliterowy język produktów, do których jest dostarczany asortyment regionalny, w formacie ISO 639-1.

PromotionDataSource

Źródło danych promocji.

Zapis JSON
{
  "targetCountry": string,
  "contentLanguage": string
}
Pola
targetCountry

string

Wymagane. Stały. Kraj docelowy używany jako część unikalnego identyfikatora. Przedstawiany jako kod regionu CLDR.

Promocje są dostępne tylko w wybranych krajach.

contentLanguage

string

Wymagane. Stały. Dwuliterowy język elementów w źródle danych, zgodny ze standardem ISO 639-1.

Dane wejściowe

Określa typ danych wejściowych do źródła danych. W zależności od danych wejściowych niektóre ustawienia mogą nie być obsługiwane.

Wartości w polu enum
INPUT_UNSPECIFIED Dane wejściowe nieokreślone.
API Reprezentuje źródła danych, w przypadku których dane są dostarczane głównie przez interfejs API.
FILE Reprezentuje źródła danych, w przypadku których dane są dostarczane głównie przez dane wejściowe z pliku. Dane możesz nadal przekazywać przez interfejs API.
UI

Źródło danych dla produktów dodanych bezpośrednio w Merchant Center.

Tego typu źródła danych nie można tworzyć ani aktualizować za pomocą tego interfejsu API. Tylko w interfejsie Merchant Center.

Ten typ źródła danych jest tylko do odczytu.

AUTOFEED Jest to tzw. automatyczne pliki danych, które służy do automatycznego tworzenia danych produktów. Ten typ źródła danych można włączyć lub wyłączyć za pomocą pakietu kont.

FileInput

Dane specyficzne dla źródeł danych plików. To pole jest puste w przypadku danych wejściowych innych źródeł danych.

Zapis JSON
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
Pola
fetchSettings

object (FetchSettings)

Opcjonalnie: Pobierz szczegóły, aby dostarczyć źródło danych. Zawiera ustawienia typów wejściowych plików: FETCH i GOOGLE_SHEETS. Pola wymagane różnią się w zależności od częstotliwości pobierania.

fileName

string

Opcjonalnie: Nazwa pliku źródła danych. Wymagane w przypadku typu wejściowego pliku UPLOAD.

fileInputType

enum (FileInputType)

Tylko dane wyjściowe. Typ pliku wejściowego.

FetchSettings

Pobierz szczegóły, aby dostarczyć źródło danych.

Zapis JSON
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
Pola
enabled

boolean

Opcjonalnie: Włącza lub wstrzymuje harmonogram pobierania.

dayOfMonth

integer

Opcjonalnie: Dzień miesiąca, w którym należy pobrać plik źródła danych (1–31). W tym polu można ustawić tylko częstotliwość miesięczną.

timeOfDay

object (TimeOfDay)

Opcjonalnie: Godzina, o której należy pobrać plik źródła danych. Minuty i sekundy nie są obsługiwane i będą ignorowane.

dayOfWeek

enum (DayOfWeek)

Opcjonalnie: Dzień tygodnia, w którym ma zostać pobrany plik źródła danych. To pole można ustawić tylko dla częstotliwości tygodniowej.

timeZone

string

Opcjonalnie: Strefa czasowa używana w harmonogramie. Domyślnie UTC. Przykład: „Ameryka/Los_Angeles”.

frequency

enum (Frequency)

Wymagane. Częstotliwość opisująca harmonogram pobierania.

fetchUri

string

Opcjonalnie: Adres URL, z którego można pobrać plik źródła danych. Google Merchant Center obsługuje automatyczne przesyłanie zaplanowane za pomocą protokołów HTTP, HTTPS i SFTP, więc wartością musi być prawidłowy link korzystający z jednego z tych 3 protokołów. Niezmienna w przypadku plików Arkuszy Google.

username

string

Opcjonalnie: Opcjonalna nazwa użytkownika [pobierania adresu URL][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Służy do przesyłania źródeł danych za pomocą SFTP.

password

string

Opcjonalnie: Opcjonalne hasło do [pobierania adresu URL][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Służy do przesyłania źródeł danych za pomocą SFTP.

TimeOfDay

Przedstawia porę dnia. Data i strefa czasowa są nieistotne lub zostały określone w innym miejscu. Interfejs API może zezwolić na sekundy przestępne. Podobne typy to google.type.Date i google.protobuf.Timestamp.

Zapis JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Pola
hours

integer

Godziny dnia w formacie 24-godzinnym. Wartość powinna mieścić się w zakresie od 0 do 23. Interfejs API może zezwolić na wartość „24:00:00” w takich sytuacjach jak zamknięcie firmy.

minutes

integer

Minuty dnia. Wartość musi mieścić się w przedziale od 0 do 59.

seconds

integer

Sekundy czasu trwania. Zwykle musi mieścić się w zakresie od 0 do 59. Interfejs API może akceptować wartość 60, jeśli zezwala na użycie sekund przestępnych.

nanos

integer

Ułamki sekund w nanosekundach. Musi mieścić się w przedziale od 0 do 999 999 999.

DzieńTygodnia

Przedstawia dzień tygodnia.

Wartości w polu enum
DAY_OF_WEEK_UNSPECIFIED Dzień tygodnia nie jest określony.
MONDAY Poniedziałek
TUESDAY Tuesday (wtorek)
WEDNESDAY Wednesday (środa)
THURSDAY Thursday (czwartek)
FRIDAY Friday (piątek)
SATURDAY Saturday (sobota)
SUNDAY niedziela

Częstotliwość

Pola wymagane różnią się w zależności od częstotliwości pobierania. W przypadku miesięcznego harmonogramu pobierania wymagane są [dzień miesiąca][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] oraz [godzina dnia][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]. W przypadku tygodniowego harmonogramu pobierania wymagane są [dzień tygodnia][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] oraz [godzina dnia][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]. W przypadku dziennego harmonogramu pobierania wymagana jest tylko [godzina dnia][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day].

Wartości w polu enum
FREQUENCY_UNSPECIFIED Częstotliwość nieokreślona.
FREQUENCY_DAILY Pobieranie odbywa się codziennie.
FREQUENCY_WEEKLY Pobieranie odbywa się co tydzień.
FREQUENCY_MONTHLY Pobieranie odbywa się co miesiąc.

FileInputType

Metoda przesyłania plików.

Wartości w polu enum
FILE_INPUT_TYPE_UNSPECIFIED Nieokreślony typ danych wejściowych pliku.
UPLOAD Plik jest przesyłany przez SFTP, Google Cloud Storage lub ręcznie do Merchant Center.
FETCH Plik zostanie pobrany ze skonfigurowanego identyfikatora [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri].
GOOGLE_SHEETS Plik jest pobierany z Arkuszy Google określonych w atrybucie [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri].

Metody

create

Tworzy nową konfigurację źródła danych dla danego konta.

delete

Usuwa źródło danych z Twojego konta Merchant Center.

fetch

Natychmiastowe pobieranie danych (nawet poza harmonogramem pobierania) do źródła danych z Twojego konta Merchant Center.

get

Pobiera konfigurację źródła danych dla danego konta.

list

Zawiera listę konfiguracji źródeł danych dla danego konta.

patch

Aktualizuje istniejącą konfigurację źródła danych.