Package google.shopping.merchant.datasources.v1beta

Index

DataSourcesService

Dienst zur Verwaltung von primären, ergänzenden Inventar- und anderen Datenquellen. Weitere Informationen finden Sie im Merchant Center-Hilfeartikel.

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

Erstellt die neue Datenquellenkonfiguration für das angegebene Konto.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

Löscht eine Datenquelle aus Ihrem Merchant Center-Konto.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

Der Datenabruf für eine Datenquelle aus Ihrem Merchant Center-Konto wird sofort – auch außerhalb des Abrufzeitplans – durchgeführt. Wenn Sie diese Methode mehr als einmal pro Tag aufrufen müssen, sollten Sie stattdessen den Produktfeed verwenden, um Ihre Produktdaten zu aktualisieren. Diese Methode funktioniert nur bei Datenquellen mit einem Dateieingabesatz.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

Ruft die Konfiguration der Datenquelle für das angegebene Konto ab

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

Listet die Konfigurationen für Datenquellen für das angegebene Konto auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

Aktualisiert die Konfiguration der vorhandenen Datenquelle. Die Felder, die in der Aktualisierungsmaske festgelegt, aber nicht in der Ressource bereitgestellt werden, werden gelöscht.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

CreateDataSourceRequest

Anfragenachricht für die Methode "CreateDataSource".

Felder
parent

string

Erforderlich. Das Konto, in dem die Datenquelle erstellt wird. Format: accounts/{account}
data_source

DataSource

Erforderlich. Die zu erstellende Datenquelle.

DataSource

Die Datenquelle für das Merchant Center-Konto.

Felder
name

string

Kennung. Der Name der Datenquelle. Format: {datasource.name=accounts/{account}/dataSources/{datasource}}
data_source_id

int64

Nur Ausgabe. Die ID der Datenquelle.
display_name

string

Erforderlich. Der Name der Datenquelle, der auf der Merchant Center-Benutzeroberfläche angezeigt wird.
input

Input

Nur Ausgabe. Bestimmt die Art der Eingabe für die Datenquelle. Je nach Eingabe funktionieren einige Einstellungen möglicherweise nicht. Über die API können nur generische Datenquellen erstellt werden.
file_input

FileInput

Optional. Das Feld wird nur verwendet, wenn Daten über eine Datei verwaltet werden.
Union-Feld Type. Der Typ der Datenquelle. Für Type ist nur einer der folgenden Werte zulässig:
primary_product_data_source

PrimaryProductDataSource

Erforderlich. Die primäre Datenquelle für lokale und Onlineprodukte.
supplemental_product_data_source

SupplementalProductDataSource

Erforderlich. Die ergänzende Datenquelle für lokale und Onlineprodukte.
local_inventory_data_source

LocalInventoryDataSource

Erforderlich. Die Datenquelle für lokales Inventar.
regional_inventory_data_source

RegionalInventoryDataSource

Erforderlich. Die Datenquelle für regionales Inventar
promotion_data_source

PromotionDataSource

Erforderlich. Die Datenquelle Angebot.

Eingabe

Bestimmt die Art der Eingabe für die Datenquelle. Je nach Eingabe werden einige Einstellungen möglicherweise nicht unterstützt.

Enums
INPUT_UNSPECIFIED Eingabe nicht angegeben.
API Datenquellen, für die die Daten hauptsächlich über die API bereitgestellt werden.
FILE Datenquellen, für die die Daten hauptsächlich über Dateieingaben bereitgestellt werden. Daten können weiterhin über die API bereitgestellt werden.
UI

Die Datenquelle für Produkte, die direkt im Merchant Center hinzugefügt wurden.

Dieser Datenquellentyp kann nicht über diese API, sondern nur über die Merchant Center-UI erstellt oder aktualisiert werden.

Diese Art von Datenquelle ist schreibgeschützt.
AUTOFEED Dies wird auch als automatische Feeds bezeichnet. Sie werden verwendet, um Ihre Produktdaten automatisch zu erstellen. Dieser Datenquellentyp kann über das Kontoset aktiviert oder deaktiviert werden.

DeleteDataSourceRequest

Anfragenachricht für die Methode DeleteDataSource.

Felder
name

string

Erforderlich. Der Name der Datenquelle, die gelöscht werden soll. Format: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

Anfragenachricht für die Methode "FetchDataSource".

Felder
name

string

Erforderlich. Der Name der abzurufenden Datenquellenressource. Format: accounts/{account}/dataSources/{datasource}

FileInput

Die spezifischen Daten für Dateidatenquellen. Bei anderen Datenquelleneingaben ist dieses Feld leer.

Felder
fetch_settings

FetchSettings

Optional. Rufen Sie Details ab, um die Datenquelle bereitzustellen. Sie enthält Einstellungen für die Dateieingabetypen FETCH und GOOGLE_SHEETS. Die erforderlichen Felder variieren je nach Häufigkeit der Abrufe.
file_name

string

Optional. Der Dateiname der Datenquelle. Erforderlich für den Dateieingabetyp UPLOAD.
file_input_type

FileInputType

Nur Ausgabe. Der Typ der Dateieingabe.

FetchSettings

Rufen Sie Details ab, um die Datenquelle bereitzustellen.

Felder
enabled

bool

Optional. Aktiviert oder pausiert den Abrufzeitplan.
day_of_month

int32

Optional. Der Tag des Monats, an dem die Datenquellendatei abgerufen werden soll (1–31). Dieses Feld kann nur für die monatliche Häufigkeit festgelegt werden.
time_of_day

TimeOfDay

Optional. Die Tageszeit, zu der die Datenquellendatei abgerufen werden soll. Minuten und Sekunden werden nicht unterstützt und ignoriert.
day_of_week

DayOfWeek

Optional. Der Wochentag, an dem die Datenquellendatei abgerufen werden soll. Dieses Feld kann nur für die wöchentliche Häufigkeit festgelegt werden.
time_zone

string

Optional. Für den Zeitplan verwendete Zeitzone Standardmäßig UTC. Beispiel: „America/Los_Angeles“.
frequency

Frequency

Erforderlich. Die Häufigkeit, mit der der Abrufzeitplan beschrieben wird.
fetch_uri

string

Optional. Die URL, unter der die Datenquellendatei abgerufen werden kann. Das Google Merchant Center unterstützt automatische geplante Uploads mit dem HTTP-, HTTPS- oder SFTP-Protokoll. Der Wert muss also ein gültiger Link sein, der eines dieser drei Protokolle verwendet. Unveränderlich für Google Tabellen-Dateien.
username

string

Optional. Ein optionaler Nutzername für [Abruf-URL][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Wird zum Senden von Datenquellen über SFTP verwendet.
password

string

Optional. Ein optionales Passwort für [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Wird zum Senden von Datenquellen über SFTP verwendet.

Frequenz

Die erforderlichen Felder variieren je nach Häufigkeit der Abrufe. Für einen monatlichen Abrufzeitplan sind [day of month][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] und [hour of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] erforderlich. Für einen wöchentlichen Abrufzeitplan sind [day of week][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] und [hour of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] erforderlich. Für einen täglichen Abrufzeitplan ist nur eine [Stunde des Tages][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] erforderlich.

Enums
FREQUENCY_UNSPECIFIED Häufigkeit nicht angegeben.
FREQUENCY_DAILY Der Abruf erfolgt täglich.
FREQUENCY_WEEKLY Der Abruf erfolgt jede Woche.
FREQUENCY_MONTHLY Der Abruf erfolgt jeden Monat.

FileInputType

Die Methode der Dateiübermittlung.

Enums
FILE_INPUT_TYPE_UNSPECIFIED Dateieingabetyp nicht angegeben.
UPLOAD Die Datei wird über SFTP, Google Cloud Storage oder manuell in das Merchant Center hochgeladen.
FETCH Die Datei wird von dem konfigurierten [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] abgerufen.
GOOGLE_SHEETS Die Datei wird aus Google Tabellen abgerufen, die in [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] angegeben sind.

GetDataSourceRequest

Anfragenachricht für die Methode "GetDataSource".

Felder
name

string

Erforderlich. Der Name der abzurufenden Datenquelle. Format: accounts/{account}/dataSources/{datasource}

ListDataSourcesRequest

Anfragenachricht für die Methode "ListDataSources".

Felder
parent

string

Erforderlich. Das Konto, für das Datenquellen aufgelistet werden sollen. Format: accounts/{account}
page_size

int32

Optional. Die maximale Anzahl der Datenquellen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt. Wenn kein Wert angegeben ist, wird die maximale Anzahl von Datenquellen zurückgegeben.
page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListDataSources-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListDataSources bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListDataSourcesResponse

Antwortnachricht für die Methode "ListDataSources".

Felder
data_sources[]

DataSource

Die Datenquellen aus dem angegebenen Konto.
next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

LocalInventoryDataSource

Die Datenquelle für lokales Inventar.

Felder
feed_label

string

Erforderlich. Nicht veränderbar. Das Feedlabel der Angebote, für die das lokale Inventar angeboten wird.

Muss kleiner oder gleich 20 Großbuchstaben (A–Z), Ziffern (0–9) und Bindestriche (-) sein.

Siehe auch Migration zu Feedlabels.
content_language

string

Erforderlich. Nicht veränderbar. Die aus zwei Buchstaben bestehende Sprache gemäß ISO 639-1 der Artikel, für die das lokale Inventar angeboten wird.

PrimaryProductDataSource

Die primäre Datenquelle für lokale und Onlineprodukte.

Felder
channel

Channel

Erforderlich. Nicht veränderbar. Gibt den Typ des Datenquellen-Channels an.
countries[]

string

Optional. Die Länder, in denen die Artikel präsentiert werden können. Dargestellt als CLDR-Gebietscode.
feed_label

string

Optional. Nicht veränderbar. Das Feedlabel, das auf Ebene der Datenquelle angegeben wird.

Muss kleiner oder gleich 20 Großbuchstaben (A–Z), Ziffern (0–9) und Bindestriche (-) sein.

Siehe auch Migration zu Feedlabels.

Für Datenquellen mit Produktinhaltstyp müssen „feedLabel“ und „contentLanguage“ entweder festgelegt oder nicht konfiguriert sein. Sie müssen für Datenquellen mit einer Dateieingabe festgelegt werden.

Wenn dies festgelegt ist, akzeptiert die Datenquelle nur Produkte, die mit dieser Kombination übereinstimmen. Wenn die Richtlinie nicht konfiguriert ist, werden in der Datenquelle Produkte ohne diese Einschränkung akzeptiert.
content_language

string

Optional. Nicht veränderbar. Die aus zwei Buchstaben bestehende Sprache der Elemente in der Datenquelle gemäß ISO 639-1.

feedLabel und contentLanguage müssen entweder festgelegt oder nicht festgelegt sein. Die Festlegung der Felder kann nur für Datenquellen ohne Dateieingabe aufgehoben werden.

Wenn dies festgelegt ist, akzeptiert die Datenquelle nur Produkte, die mit dieser Kombination übereinstimmen. Wenn die Richtlinie nicht konfiguriert ist, werden in der Datenquelle Produkte ohne diese Einschränkung akzeptiert.

Kanal

Datenquellenkanal.

Der Channel wird verwendet, um zwischen Datenquellen für verschiedene Produktbranchen zu unterscheiden.

Enums
CHANNEL_UNSPECIFIED Nicht angegeben.
ONLINE_PRODUCTS Onlineprodukt.
LOCAL_PRODUCTS Lokal erhältliches Produkt
PRODUCTS Einheitliche Datenquelle für lokale und Onlineprodukte

PromotionDataSource

Die Datenquelle des Angebots.

Felder
target_country

string

Erforderlich. Nicht veränderbar. Das Zielland, das als Teil der eindeutigen Kennung verwendet wird. Dargestellt als CLDR-Gebietscode.

Angebote sind nur in ausgewählten Ländern verfügbar.
content_language

string

Erforderlich. Nicht veränderbar. Die aus zwei Buchstaben bestehende Sprache der Elemente in der Datenquelle gemäß ISO 639-1.

RegionalInventoryDataSource

Die Datenquelle für regionales Inventar.

Felder
feed_label

string

Erforderlich. Nicht veränderbar. Das Feedlabel der Angebote, für die das regionale Inventar bereitgestellt wird.

Muss kleiner oder gleich 20 Großbuchstaben (A–Z), Ziffern (0–9) und Bindestriche (-) sein.

Siehe auch Migration zu Feedlabels.
content_language

string

Erforderlich. Nicht veränderbar. Die aus zwei Buchstaben bestehende Sprache gemäß ISO 639-1 der Artikel, für die das regionale Inventar bereitgestellt wird.

SupplementalProductDataSource

Die ergänzende Datenquelle für lokale und Onlineprodukte.

Felder
feed_label

string

Optional. Nicht veränderbar. Das Feedlabel, das auf Ebene der Datenquelle angegeben wird.

Muss kleiner oder gleich 20 Großbuchstaben (A–Z), Ziffern (0–9) und Bindestriche (-) sein.

Siehe auch Migration zu Feedlabels.

Für Datenquellen mit Produktinhaltstyp müssen „feedLabel“ und „contentLanguage“ entweder festgelegt oder nicht konfiguriert sein. Sie müssen für Datenquellen mit einer Dateieingabe festgelegt werden.

Wenn dies festgelegt ist, akzeptiert die Datenquelle nur Produkte, die mit dieser Kombination übereinstimmen. Wenn die Richtlinie nicht konfiguriert ist, akzeptiert die Datenquelle Produkte ohne diese Einschränkung.
content_language

string

Optional. Nicht veränderbar. Die aus zwei Buchstaben bestehende Sprache der Elemente in der Datenquelle gemäß ISO 639-1.

feedLabel und contentLanguage müssen entweder festgelegt oder nicht festgelegt sein. Die Festlegung der Felder kann nur für Datenquellen ohne Dateieingabe aufgehoben werden.

Wenn dies festgelegt ist, akzeptiert die Datenquelle nur Produkte, die mit dieser Kombination übereinstimmen. Wenn die Richtlinie nicht konfiguriert ist, akzeptiert die Datenquelle Produkte ohne diese Einschränkung.

UpdateDataSourceRequest

Anfragenachricht für die Methode "UpdateDataSource".

Felder
data_source

DataSource

Erforderlich. Die zu aktualisierende Datenquellenressource.
update_mask

FieldMask

Erforderlich. Die Liste der Datenquellenfelder, die aktualisiert werden sollen.

Felder, die in der Aktualisierungsmaske angegeben sind und im Text keinen Wert enthalten, werden aus der Datenquelle gelöscht.

Die Angabe eines speziellen Werts „*“ für das vollständige Ersetzen der Datenquelle wird nicht unterstützt.