Package google.shopping.merchant.datasources.v1beta

Indeks

DataSourcesService

Usługa do zarządzania podstawowymi, dodatkowymi, asortymencie 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 na danym koncie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

Przeprowadza pobieranie danych natychmiast (nawet poza harmonogramem pobierania) z źródła danych na koncie Merchant Center. Jeśli musisz wywoływać tę metodę więcej niż raz dziennie, do aktualizowania danych o produktach użyj usługi Products. Ta metoda działa tylko w przypadku źródeł danych z ustawionym zestawem danych wejściowych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

Zaktualizuje konfigurację dotychczasowego źródła danych. Pola, które są ustawione w masce aktualizacji, ale nie są 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 OAuth 2.0 Overview.

FileUploadsService

Usługa do zarządzania przesyłaniem plików źródeł danych.

GetFileUpload

rpc GetFileUpload(GetFileUploadRequest) returns (FileUpload)

Pobiera najnowszy przesłany plik źródła danych. Do przesyłania plików akceptowany jest tylko alias latest.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

CreateDataSourceRequest

wiadomość z prośbą o wykonanie 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 na koncie 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. 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: Pole jest używane tylko wtedy, gdy zarządzanie danymi odbywa się za pomocą pliku.
Pole unii Type. Wymagane. Typ źródła danych. Type może być tylko jednym z tych elementów:
primary_product_data_source

PrimaryProductDataSource

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

SupplementalProductDataSource

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

LocalInventoryDataSource

Źródło danych lokalnego asortymentu.
regional_inventory_data_source

RegionalInventoryDataSource

Źródło danych regionalnego asortymentu.
promotion_data_source

PromotionDataSource

Źródło danych o promocji.
product_review_data_source

ProductReviewDataSource

Źródło danych opinii o produktach.
merchant_review_data_source

MerchantReviewDataSource

Źródło danych opinie 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 automatyczne, które służą do automatycznego tworzenia danych produktów. Ten typ źródła danych można włączać i wyłączać w pakiecie Konta.

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.

Pola

Pole unii data_source_id.

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

bool

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

string

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

string

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

DeleteDataSourceRequest

wiadomość z prośbą o wykonanie metody DeleteDataSource,

Pola
name

string

Wymagane. Nazwa źródła danych, które chcesz usunąć. Format: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

Komunikat żądania dla metody FetchDataSource.

Pola
name

string

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

FileInput

Dane dotyczące źródeł danych plików. W przypadku innych źródeł danych to pole jest puste.

Pola
fetch_settings

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

string

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

FileInputType

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

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

TimeOfDay

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

DayOfWeek

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

string

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

Frequency

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

string

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

string

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

string

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

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 fetch_uri.
GOOGLE_SHEETS Plik jest pobierany z Arkuszy Google określonych w fetch_uri.

FileUpload

Przesyłanie pliku z konkretnego źródła danych, czyli wynik pobierania źródła danych w określonym czasie zliczonym asynchronicznie po zakończeniu przetwarzania. Dotyczy tylko źródeł danych plików.

Pola
name

string

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

int64

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

ProcessingState

Tylko dane wyjściowe. Stan przetwarzania źródła danych.
issues[]

Issue

Tylko dane wyjściowe. Lista problemów występujących w źródle danych.
items_total

int64

Tylko dane wyjściowe. Liczba elementów w źródle danych, które zostały przetworzone.
items_created

int64

Tylko dane wyjściowe. Liczba utworzonych elementów w źródle danych.
items_updated

int64

Tylko dane wyjściowe. Liczba elementów w źródle danych, które zostały zaktualizowane.
upload_time

Timestamp

Tylko dane wyjściowe. Data przesłania pliku źródła danych.

Problem

błąd w źródle danych, np. „nieprawidłowa cena”.

Pola
title

string

Tylko dane wyjściowe. Tytuł problemu, np. „Produkt jest za duży”.
description

string

Tylko dane wyjściowe. Opis błędu, np. „Twoje źródło danych zawiera produkty, które mają za dużo atrybutów lub są za duże. Te elementy zostaną usunięte”.
code

string

Tylko dane wyjściowe. Kod błędu, np. „validation/invalid_value”. Zwraca „?”, jeśli kod jest nieznany.
count

int64

Tylko dane wyjściowe. Liczba wystąpień błędu w przesyłanym pliku.
severity

Severity

Tylko dane wyjściowe. Waga problemu.
documentation_uri

string

Tylko dane wyjściowe. link do dokumentacji, w której znajdziesz więcej informacji o problemie (jeśli jest dostępny);

Poziom ważności

Waga problemu.

Wartości w polu enum
SEVERITY_UNSPECIFIED Poziom ważności nieokreślony.
WARNING Problem dotyczy ostrzeżenia.
ERROR Wystąpił błąd.

ProcessingState

Stan przetwarzania źródła danych.

Wartości w polu enum
PROCESSING_STATE_UNSPECIFIED Stan przetwarzania jest nieokreślony.
FAILED Nie udało się przetworzyć źródła danych lub wszystkie elementy zawierały błędy.
IN_PROGRESS Źródło danych jest przetwarzane.
SUCCEEDED Źródło danych zostało przetworzone, ale niektóre elementy mogą zawierać błędy.

GetDataSourceRequest

Komunikat o prośbie o wykonanie metody GetDataSource.

Pola
name

string

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

GetFileUploadRequest

Komunikat żądania dla metody GetFileUploadRequest.

Pola
name

string

Wymagane. Nazwa przesłanego pliku źródła danych, który chcesz pobrać. Format: accounts/{account}/dataSources/{datasource}/fileUploads/latest

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ą skonwertowane na 1000. Jeśli nie zostanie podana, zwrócona zostanie maksymalna liczba źródeł danych.
page_token

string

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

Podczas podziału na strony wszystkie inne parametry przekazywane do funkcji ListDataSources muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListDataSourcesResponse

Odpowiedź na metodę ListDataSources.

Pola
data_sources[]

DataSource

Źródła danych z wybranego konta.
next_page_token

string

token, który może być wysył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 lokalnego asortymentu.

Pola
feed_label

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

string

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

MerchantReviewDataSource

Ten typ nie ma pól.

Źródło danych o opiniach sprzedawców.

PrimaryProductDataSource

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

Pola
channel

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

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

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 parametry feedLabel i contentLanguage muszą być ustawione lub nie. Należy je ustawić w przypadku źródeł danych z danymi wejściowymi w pliku.

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

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 dla produktów 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.

Pola
take_from_data_sources[]

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 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 uzupełniających 1001, a jeśli atrybut nie jest ustawiony w 1001, będzie używana wartość z atrybutu self.

ProductReviewDataSource

Ten typ nie ma pól.

Źródło danych opinii o produktach.

PromotionDataSource

Źródło danych o promocjach.

Pola
target_country

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

string

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

RegionalInventoryDataSource

Źródło danych o asortymencie regionalnym.

Pola
feed_label

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

string

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

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.

Pola
referencing_primary_data_sources[]

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

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 z typem treści produktu parametry feedLabel i contentLanguage muszą być ustawione lub nie.

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

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 będzie akceptować tylko produkty pasujące do tej kombinacji. Jeśli nie zostanie ustawiony, źródło danych będzie akceptować produkty bez tej restrykcji.

UpdateDataSourceRequest

Wiadomość żą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, które mają zostać zaktualizowane.

Pola określone w masce aktualizacji bez wartości określonej w treści zostaną usunięte ze źródła danych.

Podanie specjalnej wartości „*” w celu zastąpienia całego źródła danych nie jest obsługiwane.