Dieses Dokument enthält Best Practices. Weitere Informationen finden Sie unter Tipps zur Leistung.
Wann sollte die API verwendet werden?
Anfragen programmgesteuert senden
Ganz gleich, ob Sie jeden Teil Ihres Workflows automatisieren oder einen Hook in Ihr ERP-System (Enterprise Resource Planning) einbinden möchten, mit der Content API können Sie Updates senden, sobald sich Ihr Inventar ändert.
Sofortiges Feedback erhalten
Bei der Content API erhalten Sie sofort eine Antwort auf jede Anfrage, anstatt nach der Verarbeitung der Datenfeeds eine E-Mail-Zusammenfassung. Bei großen Batchanfragen ist eine Latenz von fünf bis zehn Sekunden zu erwarten.
Produktdaten häufig ändern
Mit der Content API können Sie Ihr schnell drehendes Produktinventar mehrmals täglich inkrementell aktualisieren. Das Senden des gesamten Datenfeeds ist dagegen nicht praktikabel. Wenn Updates einzeln verfügbar werden, senden Sie sie einzeln. Warten Sie nicht, bis mehrere Updates verfügbar sind, damit Sie sie zusammen senden können. Wenn Updates in Batches verfügbar sind, senden Sie sie auch in Batches und nicht in einzelnen Anfragen.
Mehrere Unterkonten verwalten
Neu erstellte Merchant Center-Konten sind Einzelkonten mit eigenen Produktdaten. Das funktioniert in den meisten Fällen 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 Mehrfachkundenkonto verwenden. Die Verwaltung eines mehrsprachigen Kundencenter-Kontos auf API-Ebene kann über den Kontodienst erfolgen. So können untergeordnete Konten programmatisch hinzugefügt und verwaltet werden. Weitere Informationen zum Erhalt eines MCA-Kontos
Verwendung der API
Die API nicht wie Datenfeeds verwenden
Vermeiden Sie tägliche Aktualisierungen Ihres gesamten Produktfeeds, wenn Sie die products-Ressource verwenden.
Aktualisieren Sie stattdessen nur die Produkte, deren Daten sich tatsächlich geändert haben. Wenn Sie Ihren gesamten Datenfeed über die products-Ressource senden, benötigen Sie sowohl für Google als auch für Sie mehr Zeit und Ressourcen.
Verwenden Sie die API nicht, um regelmäßig von Ihnen hochgeladene Produktinformationen abzurufen.
Wenn Sie für die Pflege der Produktinformationen in einem bestimmten Merchant Center-Konto verantwortlich sind, sollten Sie Produktinformationen nicht regelmäßig über die Methoden products.get oder products.list aus der Content API anfordern. Bei Clients, die Informationen hochladen, können diese Methoden bei der Fehlerbehebung helfen, wenn Sie Lösungen mit der Content API entwerfen. Sie sind jedoch nicht für den regelmäßigen Abruf von Produktinformationen durch solche Kunden gedacht. Sie sollten eine andere Quelle für Ihre Produktinformationen haben, z. B. eine Datenbank mit lokal erhältlichen Produkten. Die Produkte im Merchant Center sollten den Inhalt dieser Quelle widerspiegeln.
Verwenden Sie zum Einreichen von Produktelementen nicht sowohl Datenfeeds als auch die Content API.
Wenn Sie zum Einreichen von Artikeln zur API wechseln möchten, dürfen Sie keine Datenfeeds mehr verwenden. Wenn Sie weiterhin Artikel auf beiden Medien einreichen, kann es zu unerwarteten Ergebnissen kommen.
Kann ich API und Datenfeeds sicher zusammen verwenden?
Sie können Ihre Datenfeeds mit dem Datafeed-Dienst der API bearbeiten. Das erleichtert zwar die Verwaltung von Datenfeeds im großen Maßstab, aber Sie sollten Produkte nicht gleichzeitig über die API und über Feeds einfügen oder aktualisieren, da es sonst zu unerwarteten Ergebnissen kommen kann.
Weitere Beispiele für zulässige Kombinationen von Feeds und APIs:
Ausführen von schreibgeschützten Anfragen (get oder list) über die API: Einige Händler möchten über die API Informationen und Statusaktualisierungen zu ihren Produkten abrufen. Das ist zulässig, da Produktinformationen nur über Feeds aktualisiert werden.
Mit der API können Sie Ihre Unterkonten (AccountsService) und/oder die Steuer- und Versandeinstellungen auf Kontoebene (AccountTaxService und ShippingSettingsService) verwalten. Das sind keine Funktionen, die Datafeeds bereitstellen können. Daher besteht kein Konflikt, wenn Sie diese Funktionen über die API verwalten.
Wie kann ich von der Verwendung von Datenfeeds zur Verwendung der API oder umgekehrt migrieren?
Wenn Sie derzeit Datenfeeds verwenden und zum Aktualisieren von Produkten nur noch die API verwenden möchten, müssen Sie Ihre Produktdaten noch einmal mit der API hochladen. Wenn Sie ein bestimmtes Produkt über den Produktdienst 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. Achten Sie darauf, dass es keine Datenfeed-Aktualisierungen gibt, wenn Sie das Produkt aus dem Datenfeed oder dem Datenfeed selbst entfernen möchten. Andernfalls wird die Inhaberschaft wieder auf den Datenfeed übertragen 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 verwenden möchten, können Sie Ihrem Merchant Center-Konto einfach den neuen Datenfeed hinzufügen. Die aufgeführten Produkte werden dann dem Konto zugeordnet. Wenn Sie Produkte, die ausschließlich über die API hochgeladen wurden, vor Ablauf entfernen möchten, müssen Sie sie entweder über das Merchant Center oder über die API löschen.
Wie kann ich mit der Content API for Shopping meine Produkte auf mehrere Länder ausrichten?
Wenn Sie Anzeigen und Produkteinträge für Produkte, die über die Content API eingereicht wurden, auf mehrere Länder ausrichten möchten, konfigurieren Sie im Merchant Center zusätzliche Länder im Hauptfeed der Content API oder fügen Sie diese über das Feld shipping in der Ressource products hinzu.
Unten findest du ein Beispiel für die Änderung der Einstellungen für den primären Content API-Feed.
Weitere Informationen finden Sie unter Targeting auf Shopping-Anzeigen und Produkteinträge in mehreren Ländern.
Prüfen, ob die Clientbibliotheken auf dem neuesten Stand sind
Wenn Sie eine Google-Clientbibliothek für die Interaktion mit der Content API verwenden, müssen Sie den Paketmanager für die ausgewählte Programmiersprache verwenden und darauf achten, dass die Bibliotheksversion auf dem neuesten Stand ist. Weitere Informationen finden Sie im Entwicklerhandbuch für die von Ihnen ausgewählte Sprache unter Beispiele und Bibliotheken.
Verwenden Sie die Zielattribute, um festzulegen, welche Produkte in den verschiedenen Shopping-Programmen präsentiert werden.
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 aktiviert wurde, z. B. Buy on Google (früher Shopping Actions), 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 Standardfeedeinstellungen im Merchant Center überschrieben und der betreffende Artikel wird nicht in Buy on Google (früher Shopping Actions) angezeigt. Wenn für Ihren Feed kein Programm aktiviert ist, z. B. Shopping, können Sie einzelne Artikel hinzufügen. Verwenden Sie dazu das Attribut includedDestinations und Shopping_ads als Wert. Der Artikel wird dann in Shopping-Anzeigen präsentiert.
Weitere Informationen zu den Produktattributen includedDestinations und excludedDestinations finden Sie in der Hilfe.
Aktualisieren Sie Elemente vor Ablauf
Wenn sich ein Artikel vor Ablauf nicht ändert, aktualisieren Sie ihn 30 Tage nach der letzten Aktualisierung oder am angegebenen Verfallsdatum, falls dieses früher eintritt, um eine Deaktivierung zu vermeiden. Wenn Sie viele Elemente aktualisieren müssen, weil sich keines davon geändert hat oder Sie nicht nachvollziehen können, wann sie zuletzt aktualisiert wurden, sollten Sie nicht alle Elemente gleichzeitig aktualisieren, sondern die Last gleichmäßig auf mehrere Tage verteilen.
Content API-Feed nicht löschen, da sonst Ihre Produkte möglicherweise nicht mehr angezeigt 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 Lokale 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 lokal erhältlichen Produkte entfernt, die Sie dem Merchant Center über die Content API hinzugefügt haben.
Mehrere Anfragen an denselben Dienst mit der Methode „custombatch“ in einem Batch senden
Anstatt viele aufeinanderfolgende oder parallele Anfragen an denselben Dienst zu senden, sollten Sie eine einzelne Anfrage vom Typ „Benutzerdefinierter Batch“ stellen, die alle gewünschten Anfragen enthält. So wird die Latenz für Anfragen an den API-Endpunkt nur einmal für den Aufruf „custombatch“ und nicht für jede einzelne Anfrage berechnet. Das ist besonders wichtig, wenn Sie sequenzielle Anfragen senden.
Senden Sie nicht mehrere Updates für ein einzelnes Element in einem einzigen Batch.
Dies führt aufgrund der Unsicherheit hinsichtlich der Reihenfolge der Aktualisierungen zu unerwarteten Ergebnissen und kann einen Konfliktfehler verursachen.
Keine Updates für unveränderte Elemente senden
Senden Sie nur Anfragen für neue, geänderte oder gelöschte Produktelemente, es sei denn, die Elemente laufen andernfalls ab.
Verwenden Sie ergänzende Feeds, wenn sich Preise und/oder Verfügbarkeit schnell ändern
Wenn Sie Probleme haben, den Preis, die Verfügbarkeit oder die Angebotsinformationen eines Produkts auf dem neuesten Stand zu halten, können Sie die Ergänzenden Feeds in der products-Ressource verwenden, um nur für diese Attribute Aktualisierungen 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 auf Ihren Landingpages besser im Blick behalten.
Eine weitere Möglichkeit, den Produktpreis und die Verfügbarkeit zu aktualisieren, sind automatische Artikelupdates. Sie können dies zusätzlich zu API-Aktualisierungen verwenden, um Abweichungen zwischen den Informationen im Merchant Center und den Informationen auf den Produkt-Landingpages zu vermeiden. Beachten Sie jedoch, dass diese Funktion nur dazu dient, kleine Probleme mit der Richtigkeit von Produktpreisen und -verfügbarkeit zu beheben. Automatische Artikelupdates sind also kein Ersatz dafür, die korrekten Informationen auch über die API bereitzustellen.
Wann ein Aktualisierungstoken verwendet werden sollte
Das Aktualisierungstoken wird im HTTP-Header von Autorisierungsanfragen zurückgegeben. Es enthält viele andere authentifizierungsbezogene Informationen, aber das Aktualisierungstoken ist oft das Element, das Entwickler benötigen, da der Nutzer nicht wiederholt zur Authentifizierung aufgefordert werden muss, da Zugriffstokens nur 60 Minuten lang gültig sind.