REST Resource: accounts.dataSources

Ressource: DataSource

Die Datenquelle für das Merchant Center-Konto.

JSON-Darstellung 
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // End of list of possible types for union field Type.
}
Felder
name

string

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

string (int64 format)

Nur Ausgabe. Die ID der Datenquelle.
displayName

string

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

enum (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.
fileInput

object (FileInput)

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

object (PrimaryProductDataSource)

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

object (SupplementalProductDataSource)

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

object (LocalInventoryDataSource)

Erforderlich. Die Datenquelle für lokales Inventar.
regionalInventoryDataSource

object (RegionalInventoryDataSource)

Erforderlich. Die Datenquelle für regionales Inventar.
promotionDataSource

object (PromotionDataSource)

Erforderlich. Die Datenquelle Angebot.
productReviewDataSource

object (ProductReviewDataSource)

Erforderlich. Die Datenquelle Rezensionen.
merchantReviewDataSource

object (MerchantReviewDataSource)

Erforderlich. Die Datenquelle Rezensionen.

PrimaryProductDataSource

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

JSON-Darstellung 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "defaultRule": {
    object (DefaultRule)
  },
  "feedLabel": string,
  "contentLanguage": string
}
Felder
channel

enum (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.
defaultRule

object (DefaultRule)

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

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

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.

JSON-Darstellung 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
Felder
takeFromDataSources[]

object (DataSourceReference)

Erforderlich. Die Liste der Datenquellen, die in der Standardregel verknüpft sind. Diese Liste ist nach der Standardregelpriorität für die Zusammenführung 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) einen neuen Verweis 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.

DataSourceReference

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

JSON-Darstellung 
{

  // Union field data_source_id can be only one of the following:
  "self": boolean,
  "primaryDataSourceName": string,
  "supplementalDataSourceName": string
  // End of list of possible types for union field data_source_id.
}
Felder

Union-Feld data_source_id.

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

boolean

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

string

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

string

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

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.

JSON-Darstellung 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Felder
referencingPrimaryDataSources[]

object (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.
feedLabel

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 Produkte ohne diese Einschränkung in der Datenquelle akzeptiert.
contentLanguage

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 Produkte ohne diese Einschränkung in der Datenquelle akzeptiert.

LocalInventoryDataSource

Die Datenquelle für lokales Inventar.

JSON-Darstellung 
{
  "feedLabel": string,
  "contentLanguage": string
}
Felder
feedLabel

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

string

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

RegionalInventoryDataSource

Die Datenquelle für regionales Inventar.

JSON-Darstellung 
{
  "feedLabel": string,
  "contentLanguage": string
}
Felder
feedLabel

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

string

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

PromotionDataSource

Die Angebotsdatenquelle.

JSON-Darstellung 
{
  "targetCountry": string,
  "contentLanguage": string
}
Felder
targetCountry

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

string

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

ProductReviewDataSource

Dieser Typ hat keine Felder.

Die Datenquelle für Rezensionen.

MerchantReviewDataSource

Dieser Typ hat keine Felder.

Die Datenquelle für Händlerrezensionen.

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.

Diese Art von Datenquelle 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.

FileInput

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

JSON-Darstellung 
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
Felder
fetchSettings

object (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 Abrufens.
fileName

string

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

enum (FileInputType)

Nur Ausgabe. Der Dateityp der Eingabe.

FetchSettings

Details abrufen, um die Datenquelle zu liefern.

JSON-Darstellung 
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
Felder
enabled

boolean

Optional. Aktiviert oder pausiert den Abrufzeitplan.
dayOfMonth

integer

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

object (TimeOfDay)

Optional. Die Stunde des Tages, zu der die Datenquellendatei abgerufen werden soll. Minuten und Sekunden werden nicht unterstützt und ignoriert.
dayOfWeek

enum (DayOfWeek)

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

string

Optional. Zeitzone, die für den Zeitplan verwendet wird. Standardmäßig UTC. Beispiel: „Amerika/Los_Angeles“.
frequency

enum (Frequency)

Erforderlich. Die Häufigkeit, mit der der Abrufzeitplan ausgeführt wird.
fetchUri

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 fetchUri. Wird zum Einreichen von Datenquellen über SFTP verwendet.
password

string

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

TimeOfDay

Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date und google.protobuf.Timestamp.

JSON-Darstellung 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Felder
hours

integer

Stunden eines Tages im 24-Stunden-Format. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 23 sein. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.
minutes

integer

Minuten einer Stunde. Muss größer oder gleich 0 und kleiner oder gleich 59 sein.
seconds

integer

Sekunden einer Minute. Muss größer oder gleich 0 und normalerweise kleiner oder gleich 59 sein. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

integer

Sekundenbruchteile in Nanosekunden. Muss größer oder gleich 0 und kleiner oder gleich 999.999.999 sein.

DayOfWeek

Steht für einen Wochentag.

Enums
DAY_OF_WEEK_UNSPECIFIED Der Wochentag ist nicht angegeben.
MONDAY Montag
TUESDAY Dienstag
WEDNESDAY Mittwoch
THURSDAY Donnerstag
FRIDAY Freitag
SATURDAY Samstag
SUNDAY Sonntag

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 fetchUri abgerufen.
GOOGLE_SHEETS Die Datei wird aus Google Tabellen abgerufen, die in der fetchUri angegeben sind.

Methoden

create

 Erstellt die neue Datenquellenkonfiguration für das angegebene Konto.

delete

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

fetch

 Führt den Datenabruf sofort (auch außerhalb des Abrufzeitplans) für eine Datenquelle aus Ihrem Merchant Center-Konto aus.

get

 Ruft die Datenquellenkonfiguration für das angegebene Konto ab.

list

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

patch

 Aktualisiert die vorhandene Datenquellenkonfiguration.