Package google.shopping.merchant.datasources.v1beta

Index

DataSourcesService

Dienst zum Verwalten primärer, ergänzender, Inventar- und anderer Datenquellen. Weitere Informationen finden Sie im Hilfeartikel Merchant Center.

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 unter OAuth 2.0 Overview.
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

Eine Datenquelle wird aus Ihrem Merchant Center-Konto gelöscht.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

Führt den Datenabruf sofort (auch außerhalb des Abrufzeitplans) für eine Datenquelle aus Ihrem Merchant Center-Konto aus. Wenn Sie diese Methode mehrmals täglich aufrufen müssen, sollten Sie stattdessen den Produktdienst verwenden, um Ihre Produktdaten zu aktualisieren. Diese Methode funktioniert nur für Datenquellen mit einer festgelegten Dateieingabe.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

Ruft die Datenquellenkonfiguration für das angegebene Konto ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

Hier werden die Konfigurationen für Datenquellen für das betreffende Konto aufgelistet.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.
UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

FileUploadsService

Dienst zum Verwalten von Uploads von Datenquellendateien.

GetFileUpload

rpc GetFileUpload(GetFileUploadRequest) returns (FileUpload)

Der letzte Dateiupload der Datenquelle. Für einen Dateiupload wird nur der Alias latest akzeptiert.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

CreateDataSourceRequest

Anfragenachricht für die Methode „CreateDataSource“.

Felder
parent

string

Erforderlich. Das Konto, in dem diese 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 in der Merchant Center-Benutzeroberfläche angezeigt wird.
input

Input

Nur Ausgabe. Bestimmt die Art der Eingabe in 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. Erforderlich. Der Datenquellentyp. Für Type ist nur einer der folgenden Werte zulässig:
primary_product_data_source

PrimaryProductDataSource

Die primäre Datenquelle für lokal erhältliche und Onlineprodukte.
supplemental_product_data_source

SupplementalProductDataSource

Die zusätzliche Datenquelle für lokal erhältliche und Onlineprodukte.
local_inventory_data_source

LocalInventoryDataSource

Die Datenquelle für lokales Inventar.
regional_inventory_data_source

RegionalInventoryDataSource

Die Datenquelle für regionales Inventar.
promotion_data_source

PromotionDataSource

Die Datenquelle für Angebote.
product_review_data_source

ProductReviewDataSource

Die Datenquelle Rezensionen.
merchant_review_data_source

MerchantReviewDataSource

Die Datenquelle Rezensionen.

Eingabe

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

Enums
INPUT_UNSPECIFIED Eingabe nicht angegeben.
API Stellt Datenquellen dar, für die die Daten hauptsächlich über die API bereitgestellt werden.
FILE Stellt Datenquellen dar, für die die Daten hauptsächlich über die Dateieingabe 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 erstellt oder aktualisiert werden, sondern nur über die Merchant Center-Benutzeroberfläche.

Dieser Datenquellentyp ist schreibgeschützt.
AUTOFEED Diese werden auch als automatische Feeds bezeichnet und dienen dazu, Produktdaten automatisch zu erstellen. Dieser Datenquellentyp kann über das Konten-Bundle aktiviert oder deaktiviert werden.

DataSourceReference

Mithilfe der Datenquellenreferenz können Sie zugehörige Datenquellen im Datenquellendienst verwalten.

Felder

Union-Feld data_source_id.

Für data_source_id ist nur einer der folgenden Werte zulässig:
self

bool

„Self“ sollte verwendet werden, um auf die primäre Datenquelle selbst zu verweisen.
primary_data_source_name

string

Optional. Der Name der primären Datenquelle. Format: accounts/{account}/dataSources/{datasource}
supplemental_data_source_name

string

Optional. Der Name der zusätzlichen Datenquelle. Format: accounts/{account}/dataSources/{datasource}

DeleteDataSourceRequest

Anfragenachricht für die Methode „DeleteDataSource“.

Felder
name

string

Erforderlich. Der Name der zu löschenden Datenquelle. Format: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

Anfragenachricht für die Methode „FetchDataSource“.

Felder
name

string

Erforderlich. Der Name der Datenquellenressource, die abgerufen werden soll. Format: accounts/{account}/dataSources/{datasource}

FileInput

Daten, die für Dateidatenquellen spezifisch sind. Bei anderen Datenquellen ist dieses Feld leer.

Felder
fetch_settings

FetchSettings

Optional. Details abrufen, um die Datenquelle zu liefern. Es enthält Einstellungen für die Dateieingabetypen FETCH und GOOGLE_SHEETS. Die erforderlichen Felder variieren je nach Häufigkeit des Abrufs.
file_name

string

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

FileInputType

Nur Ausgabe. Der Dateityp der Eingabe.

FetchSettings

Details abrufen, um die Datenquelle zu liefern.

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 Stunde des Tages, 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. Zeitzone, die für den Zeitplan verwendet wird. Standardmäßig UTC. Beispiel: „Amerika/Los_Angeles“.
frequency

Frequency

Erforderlich. Die Häufigkeit, mit der Daten abgerufen werden.
fetch_uri

string

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

string

Optional. Ein optionaler Nutzername für fetch_uri. Wird zum Einreichen von Datenquellen über SFTP verwendet.
password

string

Optional. Optionales Passwort für fetch_uri. Wird zum Einreichen von Datenquellen über SFTP verwendet.

Häufigkeit

Die erforderlichen Felder variieren je nach Häufigkeit des Abrufens. Für einen monatlichen Abrufzeitplan sind [Tag des Monats][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] und [Uhrzeit des Tages][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] erforderlich. Für einen wöchentlichen Abrufzeitplan sind [Tag der Woche][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] und [Uhrzeit][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 Die Abfrage erfolgt täglich.
FREQUENCY_WEEKLY Die Abfrage erfolgt wöchentlich.
FREQUENCY_MONTHLY Die Abfrage 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 der konfigurierten fetch_uri abgerufen.
GOOGLE_SHEETS Die Datei wird aus Google Tabellen abgerufen, die in der fetch_uri angegeben sind.

FileUpload

Der Dateiupload einer bestimmten Datenquelle, also das Ergebnis des Abrufs der Datenquelle zu einem bestimmten Zeitstempel, der asynchron berechnet wird, wenn die Verarbeitung der Datenquelle abgeschlossen ist. Gilt nur für Dateidatenquellen.

Felder
name

string

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

int64

Nur Ausgabe. Die ID der Datenquelle.
processing_state

ProcessingState

Nur Ausgabe. Der Verarbeitungsstatus der Datenquelle.
issues[]

Issue

Nur Ausgabe. Liste der Probleme in der Datenquelle.
items_total

int64

Nur Ausgabe. Die Anzahl der Elemente in der Datenquelle, die verarbeitet wurden.
items_created

int64

Nur Ausgabe. Die Anzahl der Elemente in der Datenquelle, die erstellt wurden.
items_updated

int64

Nur Ausgabe. Die Anzahl der Elemente in der Datenquelle, die aktualisiert wurden.
upload_time

Timestamp

Nur Ausgabe. Das Datum, an dem die Datei der Datenquelle hochgeladen wurde.

Problem

Ein Fehler in der Datenquelle, z. B. „ungültiger Preis“.

Felder
title

string

Nur Ausgabe. Der Titel des Problems, z. B. „Artikel zu groß“.
description

string

Nur Ausgabe. Die Fehlerbeschreibung, z. B. „Ihre Datenquelle enthält Artikel, die zu viele Attribute aufweisen oder zu groß sind. Diese Elemente werden gelöscht.“
code

string

Nur Ausgabe. Der Fehlercode, z. B. „validation/invalid_value“. Gibt „?“ zurück, wenn der Code unbekannt ist.
count

int64

Nur Ausgabe. Die Häufigkeit, mit der der Fehler beim Hochladen der Datei aufgetreten ist.
severity

Severity

Nur Ausgabe. Schweregrad des Problems
documentation_uri

string

Nur Ausgabe. Link zur Dokumentation, in der das Problem ausführlicher erläutert wird, sofern verfügbar.

Schweregrad

Schweregrad des Problems

Enums
SEVERITY_UNSPECIFIED Schweregrad nicht angegeben.
WARNING Das Problem ist die Warnung.
ERROR Das Problem ist ein Fehler.

ProcessingState

Der Verarbeitungsstatus der Datenquelle.

Enums
PROCESSING_STATE_UNSPECIFIED Verarbeitungsstatus nicht angegeben.
FAILED Die Datenquelle konnte nicht verarbeitet werden oder alle Elemente enthielten Fehler.
IN_PROGRESS Die Datenquelle wird verarbeitet.
SUCCEEDED Die Datenquelle wurde erfolgreich verarbeitet, bei einigen Artikeln sind jedoch möglicherweise Fehler aufgetreten.

GetDataSourceRequest

Anfragenachricht für die Methode „GetDataSource“.

Felder
name

string

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

GetFileUploadRequest

Anfragenachricht für die Methode „GetFileUploadRequest“.

Felder
name

string

Erforderlich. Der Name des Datenquellendateiuploads, der abgerufen werden soll. Format: accounts/{account}/dataSources/{datasource}/fileUploads/latest

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 zurückzugebenden Datenquellen. 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 nicht angegeben, 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 bereitgestellt wird.

Darf maximal 20 Großbuchstaben (A–Z), Ziffern (0–9) und Bindestriche (-) enthalten.

Weitere Informationen finden Sie unter Migration zu Feedlabels.
content_language

string

Erforderlich. Nicht veränderbar. Der zweistellige ISO 639-1-Sprachcode der Artikel, für die das lokale Inventar bereitgestellt wird.

MerchantReviewDataSource

Dieser Typ hat keine Felder.

Die Datenquelle für Händlerrezensionen.

PrimaryProductDataSource

Die Hauptdatenquelle für lokal erhältliche und Onlineprodukte.

Felder
channel

Channel

Erforderlich. Nicht veränderbar. Gibt den Typ des Datenquellenkanals an.
countries[]

string

Optional. Die Länder, in denen die Artikel präsentiert werden können. Wird als CLDR-Regionalcode dargestellt.
default_rule

DefaultRule

Optional. Verwaltung der Standardregeln der Datenquelle. Wenn diese Option aktiviert ist, werden die verknüpften Datenquellen ersetzt.
feed_label

string

Optional. Nicht veränderbar. Das Feedlabel, das auf Datenquellenebene angegeben ist.

Darf maximal 20 Großbuchstaben (A–Z), Ziffern (0–9) und Bindestriche (-) enthalten.

Weitere Informationen finden Sie unter Migration zu Feedlabels.

feedLabel und contentLanguage müssen für Datenquellen mit dem Inhaltstyp „Produkt“ entweder beide festgelegt oder beide nicht festgelegt sein. Sie müssen für Datenquellen mit Dateieingabe festgelegt werden.

Wenn diese Option festgelegt ist, werden in der Datenquelle nur Produkte akzeptiert, die dieser Kombination entsprechen. Wenn diese Option nicht festgelegt ist, werden in der Datenquelle Produkte ohne diese Einschränkung akzeptiert.
content_language

string

Optional. Nicht veränderbar. Der zweistellige ISO 639-1-Sprachcode der Artikel in der Datenquelle.

feedLabel und contentLanguage müssen entweder beide festgelegt oder beide nicht festgelegt sein. Die Felder können nur für Datenquellen ohne Dateieingabe zurückgesetzt werden.

Wenn diese Option festgelegt ist, werden in der Datenquelle nur Produkte akzeptiert, die dieser Kombination entsprechen. Wenn diese Option nicht festgelegt ist, werden in der Datenquelle Produkte ohne diese Einschränkung akzeptiert.

Kanal

Datenquellenkanal

Mit „Channel“ wird zwischen Datenquellen für verschiedene Produktbranchen unterschieden.

Enums
CHANNEL_UNSPECIFIED Nicht angegeben.
ONLINE_PRODUCTS Onlineprodukt
LOCAL_PRODUCTS Lokal erhältliches Produkt.
PRODUCTS Einheitliche Datenquelle für lokal erhältliche und Onlineprodukte. Hinweis: Die Verwaltung von Produkten über die API ist für diesen Kanal nicht möglich.

DefaultRule

Verwaltung der Standardregeln der Datenquelle.

Felder
take_from_data_sources[]

DataSourceReference

Erforderlich. Die Liste der Datenquellen, die in der Standardregel verknüpft sind. Diese Liste ist nach der Standardregelpriorität für das Zusammenführen der Daten sortiert. Er kann keine oder mehrere Verweise auf self und zusätzliche Datenquellen enthalten.

Die Liste darf nicht leer sein.

Wenn Sie die Datenquelle mit der Standardregel verknüpfen möchten, müssen Sie dieser Liste (in sequenzieller Reihenfolge) eine neue Referenz hinzufügen.

Wenn Sie die Verknüpfung der Datenquelle mit der Standardregel aufheben möchten, müssen Sie die entsprechende Referenz aus dieser Liste entfernen.

Wenn Sie die Reihenfolge dieser Liste ändern, ändert sich die Priorität der Datenquellen in der Standardregel.

Wenn Sie beispielsweise die folgende Liste angeben: [1001, self], werden Attributwerte aus der ergänzenden Datenquelle 1001 verwendet. Wenn das Attribut in 1001 nicht festgelegt ist, wird self verwendet.

ProductReviewDataSource

Dieser Typ hat keine Felder.

Die Datenquelle für Rezensionen.

PromotionDataSource

Die Angebotsdatenquelle.

Felder
target_country

string

Erforderlich. Nicht veränderbar. Das Zielland, das als Teil der eindeutigen Kennung verwendet wird. Wird als CLDR-Regionalcode dargestellt.

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

string

Erforderlich. Nicht veränderbar. Der zweistellige ISO 639-1-Sprachcode der Artikel in der Datenquelle.

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.

Darf maximal 20 Großbuchstaben (A–Z), Ziffern (0–9) und Bindestriche (-) enthalten.

Weitere Informationen finden Sie unter Migration zu Feedlabels.
content_language

string

Erforderlich. Nicht veränderbar. Der zweistellige ISO 639-1-Sprachcode der Artikel, für die das regionale Inventar bereitgestellt wird.

SupplementalProductDataSource

Die zusätzliche Datenquelle für lokale und Onlineprodukte. Nach dem Erstellen sollten Sie die ergänzende Produktdatenquelle mit einer oder mehreren primären Produktdatenquellen verknüpfen.

Felder
referencing_primary_data_sources[]

DataSourceReference

Nur Ausgabe. Die (unsortierte und deduplizierte) Liste aller primären Datenquellen, die in Standard- oder benutzerdefinierten Regeln mit dieser Datenquelle verknüpft sind. Die ergänzende Datenquelle kann nicht gelöscht werden, bevor alle Verknüpfungen entfernt wurden.
feed_label

string

Optional. Nicht veränderbar. Das Feedlabel, das auf Datenquellenebene angegeben ist.

Darf maximal 20 Großbuchstaben (A–Z), Ziffern (0–9) und Bindestriche (-) enthalten.

Weitere Informationen finden Sie unter Migration zu Feedlabels.

feedLabel und contentLanguage müssen für Datenquellen mit dem Inhaltstyp „Produkt“ entweder beide festgelegt oder beide nicht festgelegt sein.

Sie müssen für Datenquellen mit einer file input festgelegt werden. Für Datenquellen ohne file input müssen die Felder nicht festgelegt werden.

Wenn diese Option festgelegt ist, werden in der Datenquelle nur Produkte akzeptiert, die dieser Kombination entsprechen. Wenn diese Option nicht festgelegt ist, werden in der Datenquelle Produkte ohne diese Einschränkung akzeptiert.
content_language

string

Optional. Nicht veränderbar. Der aus zwei Buchstaben bestehende ISO 639-1-Sprachcode der Artikel in der Datenquelle.

feedLabel und contentLanguage müssen entweder beide festgelegt oder beide nicht festgelegt sein. Die Felder können nur für Datenquellen ohne Dateieingabe zurückgesetzt werden.

Wenn diese Option festgelegt ist, werden in der Datenquelle nur Produkte akzeptiert, die dieser Kombination entsprechen. Wenn diese Option nicht festgelegt ist, werden in der Datenquelle Produkte ohne diese Einschränkung akzeptiert.

UpdateDataSourceRequest

Anfragenachricht für die Methode „UpdateDataSource“.

Felder
data_source

DataSource

Erforderlich. Die zu aktualisierende Datenquellenressource.
update_mask

FieldMask

Erforderlich. Die Liste der zu aktualisierenden Datenquellenfelder.

Felder, die in der Aktualisierungsmaske angegeben sind, für die aber im Textkörper kein Wert angegeben ist, werden aus der Datenquelle gelöscht.

Der spezielle Wert „*“ für den vollständigen Austausch der Datenquelle wird nicht unterstützt.