Package google.shopping.merchant.datasources.v1beta

Indeks

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

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

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 z zestawem danych wejściowych pliku.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

Aktualizuje istniejącą konfigurację źródła danych. Pola ustawione w masce aktualizacji, które nie zostały podane w zasobie, zostaną usunięte.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

CreateDataSourceRequest

Komunikat żądania dla metody CreateDataSource.

Pola
parent

string

Wymagane. Konto, na którym zostanie utworzone to źródło danych. Format: accounts/{account}
data_source

DataSource

Wymagane. Źródło danych do utworzenia.

DataSource

Źródło danych konta Merchant Center.

Pola
name

string

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

int64

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

string

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

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

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:
primary_product_data_source

PrimaryProductDataSource

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

SupplementalProductDataSource

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

LocalInventoryDataSource

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

RegionalInventoryDataSource

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

PromotionDataSource

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

string

Wymagane. Nazwa źródła danych do usunięcia. Format: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

Komunikat żądania dotyczący metody FetchDataSource.

Pola
name

string

Wymagane. Nazwa zasobu źródła danych do pobrania. Format: accounts/{account}/dataSources/{datasource}

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

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.
file_name

string

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

FileInputType

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

FetchSettings

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

Pola
enabled

bool

Opcjonalnie. Włącza lub wstrzymuje harmonogram pobierania.
day_of_month

int32

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

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.
day_of_week

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.
time_zone

string

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

Frequency

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

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.

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

string

Wymagane. Nazwa źródła danych do pobrania. Format: accounts/{account}/dataSources/{datasource}

ListDataSourcesRequest

Komunikat żądania dla metody ListDataSources.

Pola
parent

string

Wymagane. Konto, dla którego chcesz wyświetlić listę źródeł danych. Format: accounts/{account}
page_size

int32

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

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListDataSources. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListDataSources muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListDataSourcesResponse

Komunikat odpowiedzi dla metody ListDataSources.

Pola
data_sources[]

DataSource

Źródła danych z określonego konta.
next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

LocalInventoryDataSource

Źródło danych o lokalnym asortymencie.

Pola
feed_label

string

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

string

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

Channel

Wymagane. Stała. 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.
feed_label

string

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 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.
content_language

string

Opcjonalnie. Stała. 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.

PromotionDataSource

Źródło danych promocji.

Pola
target_country

string

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

string

Wymagane. Stała. 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

string

Wymagane. Stała. 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

string

Wymagane. Stała. 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

string

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 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.
content_language

string

Opcjonalnie. Stała. 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.

UpdateDataSourceRequest

Komunikat żądania dla metody UpdateDataSource.

Pola
data_source

DataSource

Wymagane. Zasób źródła danych do zaktualizowania.
update_mask

FieldMask

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.

Nie można podać specjalnej wartości „*” umożliwiającej pełne zastąpienie źródła danych.