Dieses Dokument enthält Richtlinien für Best Practices. Weitere Informationen finden Sie unter Leistungstipps.
Wann sollte die API verwendet werden?
Anfragen programmgesteuert senden
Mit der Content API können Sie Updates senden, sobald sich Ihr Inventar ändert. Das ist praktisch, wenn Sie jeden Teil Ihres Workflows automatisieren oder eine Verknüpfung zu Ihrem ERP-System (Enterprise Resource Planning) erstellen möchten.
Sofortiges Feedback erhalten
In der Content API erhalten Sie sofort eine Antwort auf jede Anfrage und nicht erst nach der Verarbeitung der Datenfeeds per E‑Mail. Bei großen Batchanfragen ist mit einer Latenz von fünf bis zehn Sekunden zu rechnen.
Produktdaten häufig ändern
Mit der Content API können Sie Ihr schnelllebiges Produktinventar mehrmals täglich inkrementell aktualisieren. Es ist nicht praktikabel, jedes Mal den gesamten Datenfeed zu senden. Wenn Updates einzeln verfügbar sind, senden Sie sie einzeln. Warten Sie nicht, bis mehrere Updates vorhanden sind, um sie zusammenzufassen. Wenn Updates in Batches verfügbar sind, senden Sie sie in Batches und teilen Sie sie nicht in einzelne Anfragen auf.
Mehrere Unterkonten verwalten
Neu erstellte Merchant Center-Konten sind Einzelkonten mit eigenen Produktdaten. In den meisten Fällen funktioniert das gut. Wenn Ihr Konto jedoch wächst, benötigen Sie möglicherweise ein komplexeres Verwaltungssystem für Ihre Produkte. In diesem Fall sollten Sie ein Mehrkundenkonto (MCA) verwenden. Die Verwaltung eines MCA-Kontos auf API-Ebene kann über den Dienst „Konten“ erfolgen. So lassen sich Unterkonten programmgesteuert hinzufügen und verwalten. Weitere Informationen zum Erstellen eines MCA Kontos finden Sie hier.
Verwendung der API
Die API nicht wie Datenfeeds verwenden
Vermeiden Sie tägliche Updates Ihres gesamten Produktfeeds, wenn Sie die Ressource products verwenden.
Aktualisieren Sie stattdessen nur die Produkte, deren Daten sich tatsächlich geändert haben. Wenn Sie Ihren gesamten Datenfeed über die Ressource products senden, verbrauchen Sie mehr Zeit und Ressourcen – sowohl für Google als auch für Sie.
Die API nicht verwenden, um regelmäßig hochgeladene Produktinformationen abzurufen
Wenn Sie für die Pflege der Produktinformationen in einem
bestimmten Merchant Center-Konto verantwortlich sind, sollten Sie nicht regelmäßig Produktinformationen über die Content API mit den
products.get
oder
products.list
Methoden anfordern. Für Kunden, die Informationen hochladen, können diese Methoden hilfreich sein, um Probleme bei der Entwicklung von Lösungen zu beheben, die die Content API verwenden. Sie sind jedoch nicht für den regelmäßigen Abruf von Produktinformationen durch diese Kunden gedacht. Sie sollten eine andere Quelle für Ihre Produktinformationen haben, z. B. eine lokale Produktdatenbank. Die Produkte im Merchant Center sollten den Inhalt dieser Quelle widerspiegeln.
Nicht sowohl Datenfeeds als auch die Content API verwenden, um Produktartikel einzureichen
Wenn Sie zur API wechseln möchten, um Artikel einzureichen, dürfen Sie keine Datenfeeds mehr verwenden, um Produktartikel einzureichen. Wenn Sie Artikel weiterhin über beide Medien einreichen, kann es zu unerwarteten Ergebnissen kommen.
Gibt es eine Möglichkeit, API und Datenfeeds sicher zusammen zu verwenden?
Sie können Ihre Datenfeeds mit dem Datafeed-Dienst der API bearbeiten. Dadurch wird die Verwaltung von Datenfeeds im großen Maßstab erheblich vereinfacht. Sie sollten jedoch keine Produkte mit der API gleichzeitig mit Feeds einfügen oder aktualisieren, da dies zu unerwarteten Ergebnissen führen kann.
Weitere Beispiele für akzeptable Möglichkeiten, Feeds und API gemeinsam zu verwenden:
Schreibgeschützte Anfragen (Abrufen oder Auflisten) über die API ausführen: Einige Händler möchten die API verwenden, um Informationen und Statusupdates zu ihren Produkten abzurufen. Das ist akzeptabel, da Produktinformationen nur über Feeds aktualisiert werden.
Die API verwenden, um Ihre Unterkonten (Konten Dienst) und/oder Steuer- und Versandeinstellungen auf Kontoebene (Kontosteuern Dienst und Versandeinstellungen Dienst) zu verwalten. Diese Funktionen können nicht über Datenfeeds bereitgestellt werden. Es gibt also keinen Konflikt mit der Verwendung der API zur Verwaltung dieser Funktionen.
Wie migriere ich von der Verwendung von Datenfeeds zur ausschließlichen Verwendung der API oder umgekehrt?
Wenn Sie derzeit Datenfeeds verwenden und nur noch die API zum Aktualisieren von Produkten nutzen möchten, müssen Sie Ihre Produktdaten mit der API noch einmal hochladen. Wenn Sie den Dienst Produkte verwenden, um ein bestimmtes Produkt zu aktualisieren, übernimmt die API die Kontrolle über die Produktinformationen. Wenn Sie das Produkt aus dem Datenfeed oder den Datenfeed selbst löschen, werden die Produktinformationen nicht mehr aus Ihrem Merchant Center-Konto entfernt. Wenn Sie das Produkt aus dem Datenfeed oder den Datenfeed selbst entfernen möchten, dürfen keine Datenfeed-Updates vorhanden sein. Andernfalls übernimmt der Datenfeed wieder die Kontrolle und das Entfernen des Produkts aus dem Datenfeed führt dazu, dass das Produkt entfernt wird.
Wenn Sie derzeit nur die API für Produktinformationen verwenden und Datenfeeds als primäre Quelle für Produktinformationen nutzen möchten, können Sie einfach den neuen Datenfeed zu Ihrem Merchant Center-Konto hinzufügen. Die Datenfeeds übernehmen dann die Kontrolle über die aufgeführten Produkte. Wenn Sie Produkte entfernen möchten, bevor sie ablaufen, die nur über die API hochgeladen wurden, müssen Sie sie entweder über das Merchant Center oder über die API löschen.
Wie richte ich mit der Content API for Shopping die Ausrichtung auf mehrere Länder für Produkte ein?
Wenn Sie mit Anzeigen und Produkteinträgen für Produkte, die über die Content API eingereicht wurden, mehrere Länder ansprechen möchten, konfigurieren Sie im Merchant Center zusätzliche Länder für den Hauptfeed der Content API oder fügen Sie diese Länder über das shipping
Feld in der products Ressource hinzu.
Im Folgenden finden Sie ein Beispiel für das Ändern der Einstellungen für den Hauptfeed der Content API.
Weitere Informationen finden Sie unter: Shopping-Anzeigen und Produkteinträge in mehreren Ländern ausrichten.
Achten Sie darauf, dass Ihre Clientbibliotheken auf dem neuesten Stand sind
Wenn Sie eine Google-Clientbibliothek verwenden, um mit der Content API zu interagieren, verwenden Sie den Paketmanager für die ausgewählte Programmiersprache und achten Sie darauf, dass die Bibliotheksversion auf dem neuesten Stand ist. Weitere Informationen finden Sie im Entwicklerleitfaden für die ausgewählte Sprache unter Beispiele und Bibliotheken.
Mit den Attributen für Ziele festlegen, welche Produkte in den verschiedenen Shopping-Programmen präsentiert werden sollen
Die Content API übernimmt automatisch die Standardeinstellungen für Ihren Content API-Feed, wie sie im Merchant Center konfiguriert wurden. Mit den Produktattributen includedDestinations oder excludedDestinations können Sie die Programmteilnahme auf Produktebene in einem Feed oder über die Content API steuern.
Wenn Ihr API-Feed für ein Programm wie Buy on Google (früher Shopping Actions) aktiviert wurde, Sie aber bestimmte Produkte ausschließen möchten, verwenden Sie das Attribut excludedDestinations und geben Sie Shopping Actions als Wert an. Sofern keine Fehler auftreten, werden die Standardeinstellungen für den Feed im Merchant Center überschrieben und der betreffende Artikel wird nicht in Buy on Google (früher Shopping Actions) präsentiert. Wenn Ihr Feed hingegen nicht für ein Programm wie Shopping aktiviert wurde, können Sie einzelne Artikel einbeziehen, indem Sie das Attribut includedDestinations und Shopping_ads als Wert verwenden. Der Artikel wird dann in Shopping-Anzeigen präsentiert.
Weitere Informationen zu den includedDestinations und
excludedDestinations Produktattributen finden Sie in der
Hilfe.
Artikel vor dem Ablaufdatum aktualisieren
Wenn sich ein Artikel vor dem Ablaufdatum nicht ändert, aktualisieren Sie ihn 30 Tage nach der letzten Aktualisierung oder am angegebenen Ablaufdatum, falls dieses früher liegt, um die Deaktivierung zu vermeiden. Wenn Sie viele Artikel aktualisieren müssen, weil sich keiner von ihnen geändert hat oder Sie nicht nachverfolgen können, wann sie zuletzt aktualisiert wurden, aktualisieren Sie nicht alle Artikel gleichzeitig, sondern verteilen Sie die Last gleichmäßig auf mehrere Tage.
Den Content API-Feed nicht löschen, da sonst Ihre Produkte möglicherweise nicht mehr präsentiert werden
Wenn Sie zum ersten Mal ein Produkt mit channel:online über die Content API hochladen, wird im Merchant Center ein neuer Feed mit dem Titel Content API angezeigt. Wenn Sie zum ersten Mal ein Produkt mit channel:local über die Content API hochladen, wird im Merchant Center ein neuer Feed mit dem Titel Content API und der Unterüberschrift Lokal erhältliche Produkte angezeigt. Achten Sie darauf, dass Sie den Online- oder den lokalen Content API-Feed nicht versehentlich löschen. Je nachdem, welchen Feed Sie löschen, werden die Online- oder lokalen Produkte entfernt, die Sie über die Content API im Merchant Center hinzugefügt haben.
Mehrere Anfragen an denselben Dienst mit der Methode „custombatch“ zusammenfassen
Anstatt viele sequenzielle oder parallele Anfragen an denselben Dienst zu senden, sollten Sie eine einzelne „custombatch“-Anfrage senden, die alle gewünschten Anfragen enthält. So tritt die Latenz für Anfragen an den API-Endpunkt nur einmal für den „custombatch“-Aufruf auf und nicht bei jeder einzelnen Anfrage. Das ist besonders wichtig, wenn Sie sequenzielle Anfragen senden.
Nicht mehrere Updates für einen einzelnen Artikel in einem Batch senden
Das führt zu unerwarteten Ergebnissen, da die Reihenfolge der Updates unklar ist, und kann einen Konfliktfehler verursachen.
Keine Updates für unveränderte Artikel senden
Senden Sie nur Anfragen für neue, geänderte oder gelöschte Produktartikel, es sei denn, die Artikel laufen sonst ab.
Subfeeds verwenden, wenn sich Preise und/oder Verfügbarkeit schnell ändern
Wenn Sie Probleme haben, Preis-, Verfügbarkeits- oder Angebots
informationen für ein Produkt auf dem neuesten Stand zu halten, können Sie die
Subfeeds in der products Ressource
verwenden, um nur Updates für diese Attribute zu senden. Da Subfeed-Updates klein sind, können Sie in einem bestimmten Zeitraum viel mehr Subfeed-Updates als vollständige Produktupdates vornehmen. So können Sie die Preise und Verfügbarkeit Ihrer Produkte mit Ihren Landingpages in Einklang bringen.
Eine weitere Möglichkeit, Produktpreise und Verfügbarkeit zu aktualisieren, sind automatische Artikelupdates. Diese können zusätzlich zu API-Updates verwendet werden, um Abweichungen zwischen den Informationen im Merchant Center und den Informationen auf den Produkt-Landingpages zu vermeiden. Diese Funktion ist jedoch nur dazu gedacht, kleinere Probleme mit der Genauigkeit von Produktpreisen und Verfügbarkeit zu beheben. Automatische Artikelupdates ersetzen also nicht die Bereitstellung der richtigen Informationen über die API.
Wann ist ein Aktualisierungstoken sinnvoll?
Das Aktualisierungstoken wird im HTTP-Header von Autorisierungsanfragen zurückgegeben. Es enthält viele andere Informationen zur Authentifizierung. Das Aktualisierungstoken ist jedoch oft das, was Entwickler benötigen, da es die Notwendigkeit beseitigt, den Nutzer wiederholt zur Authentifizierung aufzufordern. Zugriffstokens sind nur 60 Minuten lang gültig.