Merchant Products API – Übersicht

Auf dieser Seite wird erläutert, wie Sie Ihre Produkte programmatisch hochladen und verwalten können. Mit der Merchant Products API können Sie ein Produkt in eine Datenquelle einfügen oder aktualisieren, ein Produkt aus Ihrem Konto abrufen und ein Produkt aus einer Datenquelle löschen.

Die Merchant Products API enthält zwei Ressourcen.

  • productInputs steht für die Eingabeteile Ihrer Produkte.
  • products steht für die verarbeiteten Produkte, die aus Ihren Eingabeteilen erstellt wurden.

productInputs kann primär oder ergänzend sein, je nachdem, ob es in eine primäre Datenquelle oder eine ergänzende Datenquelle hochgeladen wird. Jeder product wird aus einem einzigen primären productInput und einer beliebigen Anzahl von ergänzenden productInputs erstellt.

Mit der Merchant Products API können Sie Online- oder Ladengeschäftskataloge erstellen. Das sind Produkte, die in mehreren Shopping-Zielen erscheinen können. Sie können die productInputs-Ressource verwenden, sobald Sie Ihr Merchant Center-Konto erstellt, Ihre erste Datenquelle eingerichtet und die ersten Produkte über die API hochgeladen haben.

Händler können zwar Produkte über eine Datei hochladen, die PrimaryProductDataSource genannt wird, es gibt jedoch mehrere Vorteile beim Erstellen und Löschen von Produkten mit der Merchant API. Zu diesen Vorteilen gehören eine kürzere Reaktionszeit und die Möglichkeit, Produkte in Echtzeit zu aktualisieren, ohne große Dateien verwalten zu müssen. Es kann einige Stunden dauern, bis Produktänderungen, die über API-Aufrufe vorgenommen wurden, in der Shopping-Datenbank zu sehen sind.

Vorbereitung

Wenn Sie noch keine Datenquelle haben, erstellen Sie eine mit der Merchant DataSources API oder im Merchant Center.

Wenn Sie bereits eine Datenquelle haben, die Sie entweder über die Merchant Center-Benutzeroberfläche oder über die API erstellt haben, können Sie Ihre Produkte mit der Merchant Products API hinzufügen. Wenn Sie Produkte mit der Content API for Shopping hinzufügen, lesen Sie den Leitfaden zur Migration, um zu erfahren, wie Sie mit der Merchant Products API beginnen.

Sie sind dafür verantwortlich, die Richtlinien für Shopping-Anzeigen und Produkteinträge einzuhalten. Shopping Ads behält sich das Recht vor, diese Richtlinien durchzusetzen und entsprechende Maßnahmen zu ergreifen, wenn wir Inhalte oder Verhaltensweisen finden, die gegen diese Richtlinien verstoßen.

Ressourcen

Mit der Ressource products können Sie Produktinformationen aus der Shopping-Datenbank abrufen.

Die Ressource productInput steht für die Eingabedaten, die Sie für ein Produkt einreichen. Außerdem bietet es Methoden, mit denen Sie Produktinformationen einzeln oder im Batch-Modus auf einmal aktualisieren oder löschen können. Eine productInput-Ressource muss die folgenden Felder enthalten:

  • channel: Der Channel des Produkts.
  • offerId: Die eindeutige Kennung für das Produkt.
  • contentLanguage: Der aus zwei Buchstaben bestehende ISO 639-1-Sprachcode für das Produkt.
  • feedLabel: Das Feedlabel für das Produkt.

Produktdaten in Ihr Konto hochladen

Verwenden Sie die Methode accounts.productInputs.insert, um eine Produkteingabe in Ihr Konto hochzuladen. Sie müssen die eindeutige Kennung der primären oder ergänzenden Datenquelle übergeben.

Im folgenden Beispiel wird gezeigt, wie Sie mit der Methode accounts.productInputs.insert einen Produktinput in Ihr Händlerkonto hochladen. In der Anfrage werden der Versandpreis und die Region sowie benutzerdefinierte Attribute wie das Herstellungsdatum und die Größe festgelegt.

POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE}

{
  "name": "{PRODUCT_TITLE}",
  "versionNumber": {VERSION_NUMBER},
  "contentLanguage": "{CONTENT_LANGUAGE}",
  "feedLabel": "{FEED_LABEL}",
  "offerId": "{OFFER_ID}",
  "channel": "ONLINE",
  "attributes": {
    "availability": "in stock",
    "imageLink": "{IMAGE_LINK}",
    "link": "{PRODUCT_LINK}",
    "brand": "{BRAND_NAME}",
    "price": {
      "currencyCode": "{CURRENCY_CODE}",
      "amountMicros": {PRICE}
    },
    "color": "red",
    "productWeight": {
      "value": 320,
      "unit": "g"
    },
    "adult": false,
    "shipping": [
      {
        "country": "GB",
        "price": {
          "amountMicros": {SHIPPING_COST},
          "currencyCode": "{CURRENCY_CODE_SHIPPING}"
        },
        "postalCode": "{SHIPPING_POSTALCODE}",
        "service": "",
        "region": "{SHIPPING_REGION}",
        "maxHandlingTime": "{MAX_HANDLING_TIME}",
        "minHandlingTime": "{MIN_HANDLING_TIME}",
        "maxTransitTime": "{MAX_TRANSIT_TIME}",
        "minTransitTime": "{MIN_TRANSIT_TIME}"
      }
    ],
    "gender": "Female"
  },
  "customAttributes": [
    {
      "name": "size",
      "value": "Large"
    },
    {
      "name": "Date of Manufacturing",
      "value": "2024-05-05"
    }
  ]
}

Ersetzen Sie Folgendes:

  • {ACCOUNT_ID}: Die eindeutige Kennung Ihres Merchant Center-Kontos.
  • {DATASOURCE}: Die eindeutige Kennung der Datenquelle. Er sollte das Format accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} haben.
  • {PRODUCT_TITLE}: Der Name des Produkts.
  • {VERSION_NUMBER}: Die Versionsnummer des Produkts. Optional.
  • {CONTENT_LANGUAGE}: Der aus zwei Buchstaben bestehende ISO 639-1-Sprachcode für das Produkt. Erforderlich.
  • {FEED_LABEL}: Der CLDR-Regionencode für die Region, in der Sie das Produkt verkaufen möchten. Wenn der für feedLabel angegebene Wert ungültig ist, wird das Feld targetCountry nicht ausgefüllt.
  • {OFFER_ID}: Die eindeutige Kennung des Produkts. Erforderlich.
  • {IMAGE_LINK}: Der Link zum Bild des Produkts auf Ihrer Website. Optional.
  • {PRODUCT_LINK}: Der Link zum Produkt auf Ihrer Website. Optional.
  • {CURRENCY_CODE}: Die Währung des Preises mit dreistelligen Akronymen gemäß ISO 4217. Optional.
  • {PRICE}: Der Preis des Produkts als Zahl in Mikros. Optional.
  • {SHIPPING_COST}: Der feste Versandpreis als Zahl. Optional.
  • {SHIPPING_POSTALCODE}: Der Postleitzahlenbereich, für den der Versandpreis gilt. Optional.
  • {MAX_HANDLING_TIME}: Die maximale Bearbeitungszeit in Arbeitstagen zwischen dem Eingang der Bestellung und dem Versand. Optional.
  • {MIN_HANDLING_TIME}: Die minimale Bearbeitungszeit in Arbeitstagen zwischen dem Eingang der Bestellung und dem Versand. Der Wert „0“ bedeutet, dass die Bestellung am selben Tag geliefert wird, an dem sie eingegangen ist. Optional.
  • {MAX_TRANSIT_TIME}: Die maximale Laufzeit in Arbeitstagen zwischen dem Versand und der Zustellung der Bestellung. Optional.
  • {MIN_TRANSIT_TIME}: Die minimale Lieferdauer in Arbeitstagen zwischen dem Versand und der Zustellung der Bestellung. Der Wert 0 bedeutet, dass die Bestellung am selben Tag geliefert wird, an dem sie versendet wird. Optional.

Wenn die Anfrage erfolgreich ausgeführt wurde, wird die folgende Antwort angezeigt:

{
  "name": "{PRODUCT_NAME}",
  "product": "{PRODUCT_ID}",
  "channel": "ONLINE",
  "offerId": "{OFFER_ID}",
  "contentLanguage": "{CONTENT_LANGUAGE}",
  "feedLabel": "{FEED_LABEL}",
  "versionNumber": "{VERSION_NUMBER}",
  "attributes": {
    "link": "{PRODUCT_LINK}",
    "imageLink": "{IMAGE_LINK}",
    "adult": false,
    "availability": "in stock",
    "brand": "{BRAND_NAME}",
    "color": "red",
    "gender": "Female",
    "price": {
      "amountMicros": "{PRICE}",
      "currencyCode": "{CURRENCY_CODE}"
    },
    "shipping": [
      {
        "price": {
          "amountMicros": "{SHIPPING_COST}",
          "currencyCode": "{CURRENCY_CODE}"
        },
        "country": "{SHIPPING_COUNTRY}",
        "region": "{SHIPPING_REGION}",
        "postalCode": "{SHIPPING_POSTALCODE}",
        "minHandlingTime": "{MIN_HANDLING_TIME}",
        "maxHandlingTime": "{MAX_HANDLING_TIME}",
        "minTransitTime": "{MIN_TRANSIT_TIME}",
        "maxTransitTime": "{MAX_TRANSIT_TIME}"
      }
    ],
    "productWeight": {
      "value": 320,
      "unit": "g"
    }
  },
  "customAttributes": [
    {
      "name": "Size",
      "value": "Large"
    },
    {
      "name": "Date of Manufacturing",
      "value": "2024-05-05"
    }
  ]
}

Ein verarbeitetes Produkt aus Ihrem Konto abrufen

Wenn Sie ein verarbeitetes Produkt aus Ihrem Konto abrufen möchten, verwenden Sie die Methode accounts.products.get. Es kann einige Minuten dauern, bis das verarbeitete Produkt nach dem Einfügen angezeigt wird.

Sie können den Ressourcennamen des verarbeiteten Produkts aus dem Feld product in der Antwort von accounts.productInputs.insert abrufen.

Produkteingabe aus Ihrem Konto löschen

Wenn Sie eine Produkteingabe aus Ihrem Konto löschen möchten, verwenden Sie die Methode accounts.productInputs.delete. Wenn Sie ein Produkt mit der Merchant Products API löschen möchten, müssen Sie die eindeutige Kennung der primären oder ergänzenden Datenquelle angeben, zu der das Produkt gehört.

Produkte aus Ihrem Konto auflisten

Verwenden Sie die Methode accounts.products.list, um die verarbeiteten Produkte in Ihrem Konto aufzulisten.