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)
  }
  // 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 auf der Merchant Center-Benutzeroberfläche angezeigt wird.
input

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

object (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:
primaryProductDataSource

object (PrimaryProductDataSource)

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

object (SupplementalProductDataSource)

Erforderlich. Die ergänzende Datenquelle für lokale 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.

PrimaryProductDataSource

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

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

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

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

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

SupplementalProductDataSource

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

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

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

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.

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 angeboten wird.

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

Siehe auch Migration zu Feedlabels.
contentLanguage

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.

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.

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

Siehe auch Migration zu Feedlabels.
contentLanguage

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.

PromotionDataSource

Die Datenquelle des Angebots.

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

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

string

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

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.

FileInput

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

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

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

string

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

enum (FileInputType)

Nur Ausgabe. Der Typ der Dateieingabe.

FetchSettings

Rufen Sie Details ab, um die Datenquelle bereitzustellen.

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 Tageszeit, 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. Für den Zeitplan verwendete Zeitzone Standardmäßig UTC. Beispiel: „America/Los_Angeles“.
frequency

enum (Frequency)

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

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.

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 im 24-Stunden-Format. Sollte zwischen 0 und 23 liegen. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.
minutes

integer

Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen.
seconds

integer

Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

integer

Sekundenbruchteile in Nanosekunden. Muss zwischen 0 und 999.999.999 liegen.

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

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 [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] abgerufen.
GOOGLE_SHEETS Die Datei wird aus Google Tabellen abgerufen, die in [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] angegeben sind.

Methoden

create

 Erstellt die neue Datenquellenkonfiguration für das angegebene Konto.

delete

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

fetch

 Der Datenabruf für eine Datenquelle aus Ihrem Merchant Center-Konto wird sofort – auch außerhalb des Abrufzeitplans – durchgeführt.

get

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

list

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

patch

 Aktualisiert die Konfiguration der vorhandenen Datenquelle.