REST Resource: accounts.dataSources

Zasób: DataSource

Źródło danych na koncie 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)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // 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. 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: Pole jest używane tylko wtedy, gdy zarządzanie danymi odbywa się za pomocą pliku.
Pole unii Type. Typ źródła danych. Type może być tylko jednym z tych elementów:
primaryProductDataSource

object (PrimaryProductDataSource)

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

object (SupplementalProductDataSource)

Wymagane. Dodatkowe źródło danych o produktach dostępnych lokalnie i online.
localInventoryDataSource

object (LocalInventoryDataSource)

Wymagane. Źródło danych lokalnego asortymentu.
regionalInventoryDataSource

object (RegionalInventoryDataSource)

Wymagane. Źródło danych regionalnego asortymentu.
promotionDataSource

object (PromotionDataSource)

Wymagane. Źródło danych o promocji.
productReviewDataSource

object (ProductReviewDataSource)

Wymagane. Źródło danych opinii o produktach.
merchantReviewDataSource

object (MerchantReviewDataSource)

Wymagane. Źródło danych opinie sprzedawcy.

PrimaryProductDataSource

Podstawowe źródło danych o produktach dostępnych lokalnie i online.

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

enum (Channel)

Wymagane. Niezmienna. Określa typ kanału źródła danych.
countries[]

string

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

object (DefaultRule)

Opcjonalnie: zarządzanie domyślną regułą źródła danych; Jeśli to ustawienie zostanie ustawione, połączone źródła danych zostaną zastąpione.
feedLabel

string

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

Musi zawierać maksymalnie 20 wielkich liter (A–Z), cyfr (0–9) i łączników (-).

Zobacz też migrację do etykiet kanału.

W przypadku źródeł danych o produktach z typem treści produktu atrybuty feedLabel i contentLanguage muszą być ustawione lub nie ustawione. Należy je ustawić w przypadku źródeł danych z danymi wejściowymi w pliku.

Jeśli jest ustawiona, źródło danych akceptuje tylko produkty pasujące do tej kombinacji. Jeśli nie jest skonfigurowana, źródło danych będzie akceptować produkty bez tej restrykcji.
contentLanguage

string

Opcjonalnie: Niezmienna. Dwuliterowy kod języka ISO 639-1 produktów w źródle danych.

Parametry feedLabel i contentLanguage muszą być ustawione lub nie ustawione. Pola można odznaczyć tylko w przypadku źródeł danych bez danych wejściowych w pliku.

Jeśli jest ustawiona, źródło danych akceptuje tylko produkty pasujące do tej kombinacji. Jeśli nie jest skonfigurowana, źródło danych będzie akceptować produkty bez tej restrykcji.

Kanał

Kanał źródła danych.

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

Wartości w polu enum
CHANNEL_UNSPECIFIED Nie określono.
ONLINE_PRODUCTS Produkt online.
LOCAL_PRODUCTS Produkt dostępny lokalnie.
PRODUCTS Zjednoczone źródło danych o produktach dostępnych lokalnie i online. Uwaga: zarządzanie produktami za pomocą interfejsu API nie jest możliwe w przypadku tego kanału.

DefaultRule

zarządzanie domyślną regułą źródła danych;

Zapis JSON 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
Pola
takeFromDataSources[]

object (DataSourceReference)

Wymagane. Lista źródeł danych połączonych w regułach domyślnych. Ta lista jest uporządkowana według domyślnego priorytetu reguły złączania danych. Może ono zawierać 0 lub wiele odwołań do self i uzupełniających źródeł danych.

Lista nie może być pusta.

Aby połączyć źródło danych z regułą domyślną, musisz dodać do tej listy nowe odwołanie (w kolejności numerycznej).

Aby odłączyć źródło danych od reguły domyślnej, musisz usunąć to odwołanie z tej listy.

Zmiana kolejności na tej liście spowoduje zmianę priorytetu źródeł danych w regułach domyślnych.

Jeśli na przykład podasz listę [1001, self], wartości atrybutów będą pobierane ze źródła danych dodatkowych 1001, a jeśli atrybut nie jest ustawiony w 1001, będzie używana wartość z self.

DataSourceReference

Odwołania do źródeł danych można używać do zarządzania powiązanymi źródłami danych w ramach usługi źródła danych.

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

Pole unii data_source_id.

data_source_id może być tylko jednym z tych elementów:
self

boolean

Aby odwoływać się do głównego źródła danych, należy użyć atrybutu self.
primaryDataSourceName

string

Opcjonalnie: Nazwa podstawowego źródła danych. Format: accounts/{account}/dataSources/{datasource}
supplementalDataSourceName

string

Opcjonalnie: Nazwa dodatkowego źródła danych. Format: accounts/{account}/dataSources/{datasource}

SupplementalProductDataSource

dodatkowe źródło danych o produktach dostępnych lokalnie i online, Po utworzeniu dodatkowego źródła danych o produktach należy je połączyć z co najmniej jednym podstawowym źródłem danych o produktach.

Zapis JSON 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Pola
referencingPrimaryDataSources[]

object (DataSourceReference)

Tylko dane wyjściowe. (nieuporządkowana i bez duplikatów) lista wszystkich podstawowych źródeł danych połączonych z tym źródłem danych w regułach domyślnych lub niestandardowych. Uzupełniającego źródła danych nie można usunąć, dopóki nie zostaną usunięte wszystkie linki.
feedLabel

string

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

Musi zawierać maksymalnie 20 wielkich liter (A–Z), cyfr (0–9) i łączników (-).

Zobacz też migrację do etykiet kanału.

W przypadku źródeł danych o produktach z typem treści produktu atrybuty feedLabel i contentLanguage muszą być ustawione lub nie ustawione.

Trzeba je ustawić w przypadku źródeł danych z wartością file input. W przypadku źródeł danych bez file input pola muszą być puste.

Jeśli jest ustawiona, źródło danych akceptuje tylko produkty pasujące do tej kombinacji. Jeśli nie zostanie ustawiony, źródło danych będzie akceptować produkty bez tej restrykcji.
contentLanguage

string

Opcjonalnie: Niezmienna. Dwuliterowy kod języka ISO 639-1 produktów w źródle danych.

Parametry feedLabel i contentLanguage muszą być ustawione lub nie ustawione. Pola można odznaczyć tylko w przypadku źródeł danych bez danych wejściowych w pliku.

Jeśli jest ustawiona, źródło danych akceptuje tylko produkty pasujące do tej kombinacji. Jeśli nie zostanie ustawiony, źródło danych będzie akceptować produkty bez tej restrykcji.

LocalInventoryDataSource

Źródło danych lokalnego asortymentu.

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

string

Wymagane. Niezmienna. Etykieta pliku danych ofert, do których jest dostarczany lokalny asortyment.

Musi zawierać maksymalnie 20 wielkich liter (A–Z), cyfr (0–9) i łączników (-).

Zobacz też migrację do etykiet kanału.
contentLanguage

string

Wymagane. Niezmienna. Dwuliterowy kod języka ISO 639-1 produktów, do których jest dostępny lokalny asortyment.

RegionalInventoryDataSource

Źródło danych o asortymencie regionalnym.

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

string

Wymagane. Niezmienna. Etykieta pliku danych ofert, do których jest dostarczany asortyment regionalny.

Musi zawierać maksymalnie 20 wielkich liter (A–Z), cyfr (0–9) i łączników (-).

Zobacz też migrację do etykiet kanału.
contentLanguage

string

Wymagane. Niezmienna. Dwuliterowy kod języka ISO 639-1 produktów, dla których udostępniono regionalny asortyment.

PromotionDataSource

Źródło danych o promocji.

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

string

Wymagane. Niezmienna. Kraj docelowy używany jako część unikalnego identyfikatora. Wyrażony jako kod regionu CLDR.

Promocje są dostępne tylko w wybranych krajach.
contentLanguage

string

Wymagane. Niezmienna. Dwuliterowy kod języka ISO 639-1 produktów w źródle danych.

ProductReviewDataSource

Ten typ nie ma pól.

Źródło danych opinii o produktach.

MerchantReviewDataSource

Ten typ nie ma pól.

Źródło danych opinii sprzedawcy.

Dane wejściowe

Określa typ danych wejściowych do źródła danych. Niektóre ustawienia mogą nie być obsługiwane.

Wartości w polu enum
INPUT_UNSPECIFIED Dane wejściowe nie zostały określone.
API Reprezentuje źródła danych, które są dostarczane głównie przez interfejs API.
FILE Reprezentuje źródła danych, w których przypadku dane są dostarczane głównie przez plik wejściowy. Dane można nadal przesyłać za pomocą interfejsu API.
UI

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

Tego typu źródła danych nie można utworzyć ani zaktualizować za pomocą tego interfejsu API. Można to zrobić tylko w interfejsie Merchant Center.

Ten typ źródła danych jest tylko do odczytu.
AUTOFEED Jest to też znane jako pliki danych automatycznych, które służą do automatycznego tworzenia danych produktów. Ten typ źródła danych można włączyć lub wyłączyć w pakiecie Konta.

FileInput

Dane specyficzne dla źródeł danych plików. W przypadku innych źródeł danych to pole jest puste.

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 danych wejściowych plików FETCH i GOOGLE_SHEETS. Wymagane pola różnią się w zależności od częstotliwości pobierania.
fileName

string

Opcjonalnie: Nazwa pliku źródła danych. Wymagany w przypadku typu danych wejściowych UPLOAD.
fileInputType

enum (FileInputType)

Tylko dane wyjściowe. Typ danych wejściowych w pliku.

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 ma zostać pobrany plik źródła danych (1–31). To pole można ustawić tylko w przypadku częstotliwości miesięcznej.
timeOfDay

object (TimeOfDay)

Opcjonalnie: Godzina, o której ma zostać pobrany plik źródłowy danych. Minuty i sekundy nie są obsługiwane i zostaną zignorowane.
dayOfWeek

enum (DayOfWeek)

Opcjonalnie: Dzień tygodnia, w którym ma być pobierany plik źródła danych. To pole można ustawić tylko w przypadku częstotliwości co tydzień.
timeZone

string

Opcjonalnie: Strefa czasowa używana w harmonogramie. Domyślnie jest to czas UTC. Na przykład „Ameryka/Los_Angeles”.
frequency

enum (Frequency)

Wymagane. Częstotliwość określająca harmonogram pobierania.
fetchUri

string

Opcjonalnie: Adres URL, z którego można pobrać plik źródłowy danych. Google Merchant Center obsługuje automatyczne przesyłanie według harmonogramu za pomocą protokołów HTTP, HTTPS lub SFTP, więc wartość musi być prawidłowym linkiem korzystającym z jednego z tych trzech protokołów. Nie można zmienić plików Arkuszy Google.
username

string

Opcjonalnie: Opcjonalna nazwa użytkownika aplikacji fetchUri. Służy do przesyłania źródeł danych za pomocą SFTP.
password

string

Opcjonalnie: Opcjonalne hasło do fetchUri. Służy do przesyłania źródeł danych za pomocą SFTP.

TimeOfDay

Oznacza porę dnia. Strefa czasowa i data są nieistotne lub są określone gdzie indziej. Interfejs API może zezwalać na sekundy przesunięte. Powiązane typy to google.type.Date i google.protobuf.Timestamp.

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

integer

Godziny w formacie 24-godzinnym. Musi być większa niż lub równa 0 i zazwyczaj nie większa niż 23. Interfejs API może zezwolić na wartość „24:00:00” w przypadku scenariuszy takich jak godziny zamknięcia firmy.
minutes

integer

minuty w godzinie. Musi być równa lub większa niż 0 i nie może być większa niż 59.
seconds

integer

sekundy. Musi być większa niż lub równa 0 i zazwyczaj nie większa niż 59. Interfejs API może zezwalać na wartość 60, jeśli zezwala na sekundy przestępne.
nanos

integer

Ułamki sekundy w nanosekundach. Musi być równa lub większa niż 0 i nie mniejsza niż 999 999 999.

DzieńTygodnia

Reprezentuje dzień tygodnia.

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

Częstotliwość

Wymagane pola różnią się w zależności od częstotliwości pobierania. W przypadku harmonogramu pobierania miesięcznego wymagane są parametry [day of month][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] i [hour of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]. W przypadku tygodniowego harmonogramu pobierania wymagane są parametry [day of week][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] i [hour of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]. W przypadku harmonogramu pobierania codziennego wymagany jest tylko element [hour of day][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 w Merchant Center.
FETCH Plik jest pobierany z konfigurowanego fetchUri.
GOOGLE_SHEETS Plik jest pobierany z Arkuszy Google określonych w fetchUri.

Metody

create

 Tworzy nową konfigurację źródła danych na danym koncie.

delete

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

fetch

 Przeprowadza pobieranie danych natychmiast (nawet poza harmonogramem) z źródła danych na koncie Merchant Center.

get

 Pobiera konfigurację źródła danych na danym koncie.

list

 Wyświetla listę konfiguracji źródeł danych na danym koncie.

patch

 Zaktualizuje konfigurację dotychczasowego źródła danych.