Indeks
DataSourcesService
(interfejs)CreateDataSourceRequest
(komunikat)DataSource
(komunikat)DataSource.Input
(wyliczenie)DeleteDataSourceRequest
(komunikat)FetchDataSourceRequest
(komunikat)FileInput
(komunikat)FileInput.FetchSettings
(komunikat)FileInput.FetchSettings.Frequency
(wyliczenie)FileInput.FileInputType
(wyliczenie)GetDataSourceRequest
(komunikat)ListDataSourcesRequest
(komunikat)ListDataSourcesResponse
(komunikat)LocalInventoryDataSource
(komunikat)PrimaryProductDataSource
(komunikat)PrimaryProductDataSource.Channel
(wyliczenie)PromotionDataSource
(komunikat)RegionalInventoryDataSource
(komunikat)SupplementalProductDataSource
(komunikat)UpdateDataSourceRequest
(komunikat)
DataSourcesService
Usługa do zarządzania podstawowymi, dodatkowymi, zasobami reklamowymi i innymi źródłami danych. Więcej informacji znajdziesz w artykule pomocy Merchant Center.
CreateDataSource |
---|
Tworzy nową konfigurację źródła danych dla danego konta.
|
DeleteDataSource |
---|
Usuwa źródło danych z Twojego konta Merchant Center.
|
FetchDataSource |
---|
Natychmiastowe pobieranie danych (nawet poza harmonogramem pobierania) do źródła danych z Twojego konta Merchant Center. Jeśli musisz wywoływać tę metodę więcej niż raz dziennie, do aktualizowania danych produktów użyj usługi Products. Ta metoda działa tylko w przypadku źródeł danych ze zbiorem danych wejściowych plików.
|
GetDataSource |
---|
Pobiera konfigurację źródła danych dla danego konta.
|
ListDataSources |
---|
Zawiera listę konfiguracji źródeł danych dla danego konta.
|
UpdateDataSource |
---|
Aktualizuje dotychczasową konfigurację źródła danych. Pola ustawione w masce aktualizacji, które nie zostały podane w zasobie, zostaną usunięte.
|
CreateDataSourceRequest
Komunikat żądania dla metody CreateDataSource.
Pola | |
---|---|
parent |
Wymagane. Konto, na którym zostanie utworzone to źródło danych. Format: |
data_source |
Wymagane. Źródło danych do utworzenia. |
DataSource
Źródło danych konta Merchant Center.
Pola | |
---|---|
name |
Identyfikator. Nazwa źródła danych. Format: |
data_source_id |
Tylko dane wyjściowe. Identyfikator źródła danych. |
display_name |
Wymagane. Wyświetlana nazwa źródła danych w interfejsie Merchant Center. |
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. |
file_input |
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: |
|
primary_product_data_source |
Wymagane. Podstawowe źródło danych produktów dostępnych lokalnie i online. |
supplemental_product_data_source |
Wymagane. Dodatkowe źródło danych dla produktów dostępnych lokalnie i online. |
local_inventory_data_source |
Wymagane. Źródło danych lokalny asortyment. |
regional_inventory_data_source |
Wymagane. Źródło danych o asortymencie regionalnym. |
promotion_data_source |
Wymagane. Źródło danych promocji. |
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. |
DeleteDataSourceRequest
Komunikat żądania dotyczący metody DeleteDataSource.
Pola | |
---|---|
name |
Wymagane. Nazwa źródła danych do usunięcia. Format: |
FetchDataSourceRequest
Komunikat żądania dotyczący metody FetchDataSource.
Pola | |
---|---|
name |
Wymagane. Nazwa zasobu źródła danych do pobrania. Format: |
FileInput
Dane specyficzne dla źródeł danych plików. To pole jest puste w przypadku danych wejściowych innych źródeł danych.
Pola | |
---|---|
fetch_settings |
Opcjonalnie: Pobierz szczegóły, aby dostarczyć źródło danych. Zawiera ustawienia typów wejściowych plików: |
file_name |
Opcjonalnie: Nazwa pliku źródła danych. Wymagane w przypadku typu wejściowego pliku |
file_input_type |
Tylko dane wyjściowe. Typ pliku wejściowego. |
FetchSettings
Pobierz szczegóły, aby dostarczyć źródło danych.
Pola | |
---|---|
enabled |
Opcjonalnie: Włącza lub wstrzymuje harmonogram pobierania. |
day_of_month |
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ą. |
time_of_day |
Opcjonalnie: Godzina, o której należy pobrać plik źródła danych. Minuty i sekundy nie są obsługiwane i będą ignorowane. |
day_of_week |
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. |
time_zone |
Opcjonalnie: Strefa czasowa używana w harmonogramie. Domyślnie UTC. Przykład: „Ameryka/Los_Angeles”. |
frequency |
Wymagane. Częstotliwość opisująca harmonogram pobierania. |
fetch_uri |
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 |
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 |
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. |
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 jest pobierany ze skonfigurowanego pliku [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]. |
GOOGLE_SHEETS |
Plik jest pobierany z Arkuszy Google określonych w pliku [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]. |
GetDataSourceRequest
Komunikat żądania dla metody GetDataSource.
Pola | |
---|---|
name |
Wymagane. Nazwa źródła danych do pobrania. Format: |
ListDataSourcesRequest
Komunikat żądania dla metody ListDataSources.
Pola | |
---|---|
parent |
Wymagane. Konto, dla którego chcesz wyświetlić listę źródeł danych. Format: |
page_size |
Opcjonalnie: Maksymalna liczba źródeł danych do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Maksymalna wartość to 1000. wartości powyżej 1000 zostaną zmienione na 1000. Jeśli nie określono inaczej, zostanie zwrócona maksymalna liczba źródeł danych. |
page_token |
Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu |
ListDataSourcesResponse
Komunikat odpowiedzi dla metody ListDataSources.
Pola | |
---|---|
data_sources[] |
Źródła danych z określonego konta. |
next_page_token |
Token, który może zostać wysłany jako |
LocalInventoryDataSource
Źródło danych o lokalnym asortymencie.
Pola | |
---|---|
feed_label |
Wymagane. Stała. 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. |
content_language |
Wymagane. Stała. Dwuliterowy język produktów, do których dostępny jest lokalny asortyment, zgodny ze standardem ISO 639-1. |
PrimaryProductDataSource
Podstawowe źródło danych dla produktów dostępnych lokalnie i online.
Pola | |
---|---|
channel |
Wymagane. Stała. Określa typ kanału źródła danych. |
countries[] |
Opcjonalnie: Kraje, w których produkty mogą być wyświetlane. Przedstawiany jako kod regionu CLDR. |
feed_label |
Opcjonalnie: Stała. 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 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. |
content_language |
Opcjonalnie: Stała. Dwuliterowy język elementów w źródle danych, zgodny ze standardem ISO 639-1. Funkcje 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. |
PromotionDataSource
Źródło danych promocji.
Pola | |
---|---|
target_country |
Wymagane. Stała. Kraj docelowy używany jako część unikalnego identyfikatora. Przedstawiany jako kod regionu CLDR. Promocje są dostępne tylko w wybranych krajach. |
content_language |
Wymagane. Stały. Dwuliterowy język elementów w źródle danych, zgodny ze standardem ISO 639-1. |
RegionalInventoryDataSource
Źródło danych o asortymencie regionalnym.
Pola | |
---|---|
feed_label |
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. |
content_language |
Wymagane. Stały. Dwuliterowy język produktów, do których jest dostarczany asortyment regionalny, w formacie ISO 639-1. |
SupplementalProductDataSource
Dodatkowe źródło danych produktów dostępnych lokalnie i online.
Pola | |
---|---|
feed_label |
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 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. |
content_language |
Opcjonalnie: Stała. Dwuliterowy język elementów w źródle danych, zgodny ze standardem ISO 639-1. Funkcje 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. |
UpdateDataSourceRequest
Komunikat żądania dla metody UpdateDataSource.
Pola | |
---|---|
data_source |
Wymagane. Zasób źródła danych do zaktualizowania. |
update_mask |
Wymagane. Lista pól źródła danych do zaktualizowania. Pola określone w masce aktualizacji bez wartości określonej w treści zostaną usunięte ze źródła danych. Znak „*” Wartość pełnego zastąpienia źródła danych nie jest obsługiwana. |