Dieses Dokument enthält Best Practices. Weitere Informationen finden Sie unter Tipps zur Leistung.
Wann sollte die API verwendet werden?
So senden Sie Anfragen programmatisch
Unabhängig davon, ob Sie jeden Teil Ihres Workflows automatisieren oder eine Verknüpfung in Ihrem ERP-System (Enterprise Resource Planning) erstellen möchten, können Sie mit der Content API Aktualisierungen senden, sobald sich Ihr Inventar ändert.
Um sofortiges Feedback zu erhalten
In der Content API erhalten Sie sofort eine Antwort auf jede Anfrage und nicht über eine Zusammenfassung per E-Mail, nachdem die Datenfeeds verarbeitet wurden. Bei großen Batchanfragen ist eine Latenz von fünf bis zehn Sekunden zu erwarten.
Um Ihre Produktdaten häufig zu ändern
Mit der Content API können Sie Ihr sich schnell veränderndes Produktinventar mehrmals am Tag schrittweise aktualisieren, während es nicht möglich ist, jederzeit Ihren gesamten Datenfeed zu senden. Wenn Updates einzeln verfügbar sind, senden Sie sie einzeln. Warten Sie nicht, bis mehrere Updates vorhanden sind, damit Sie sie in einem Batch zusammenfassen können. Ebenso sollten Sie Updates, die in Batches verfügbar sind, in Batches senden und nicht in einzelne Anfragen aufteilen.
So verwalten Sie mehrere Unterkonten
Neu erstellte Merchant Center-Konten sind Einzelkonten, die ihre eigenen Produktdaten beibehalten. Dies 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. Wenn dies bei Ihnen der Fall ist, sollten Sie ein Mehrfachkundenkonto oder MCA verwenden. Die Verwaltung eines MCA-Kontos auf API-Ebene kann über den Kontodienst erfolgen und ermöglicht das programmatische Hinzufügen und Verwalten von Unterkonten. Weitere Informationen zum Erhalt eines MCA-Kontos finden Sie hier.
Verwendung der API
Verwenden Sie nicht die API, wie Sie es mit Datenfeeds tun würden.
Vermeiden Sie tägliche Aktualisierungen des gesamten Produktfeeds, wenn Sie die Ressource products verwenden.
Aktualisieren Sie stattdessen nur die Produkte, deren Daten sich tatsächlich geändert haben. Das Senden Ihres gesamten Datenfeeds über die Ressource products kostet sowohl Google als auch Sie mehr Zeit und Ressourcen.
Verwenden Sie die API nicht, um von Ihnen hochgeladene Produktinformationen regelmäßig abzurufen
Wenn du für die Verwaltung der Produktinformationen in einem bestimmten Merchant Center-Konto verantwortlich bist, solltest du Produktinformationen nicht regelmäßig über die Methoden products.get oder products.list von der Content API anfordern. Bei Clients, die Daten hochladen, können Sie mit diesen Methoden Probleme beim Entwerfen von Lösungen für die Content API beheben. Sie sind jedoch nicht dafür gedacht, Produktinformationen durch solche Clients regelmäßig abzurufen. 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.
Verwenden Sie zum Einreichen von Produktartikeln nicht sowohl Datenfeeds als auch die Content API
Wenn Sie einen Wechsel zur API für das Einreichen von Artikeln in Betracht ziehen, achten Sie darauf, dass Sie zum Einreichen von Artikelartikeln keine Datenfeeds mehr verwenden. Wenn Sie weiterhin Artikel auf beiden 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 mithilfe des Datafeed-Dienstes der API bearbeiten. Das erleichtert die Verwaltung von großen Datenfeeds in großem Umfang. Sie sollten jedoch keine Produkte über die API gleichzeitig mit Feeds einfügen oder aktualisieren, da es zu unerwarteten Ergebnissen kommen kann.
Weitere Beispiele für zulässige Möglichkeiten zur gemeinsamen Verwendung von Feeds und der API:
Schreibgeschützte Anfragen (get oder list) über die API ausführen: Einige Händler möchten die API verwenden, um Informationen und Statusaktualisierungen zu ihren Produkten abzurufen. Das ist akzeptabel, da Produktinformationen nur über Feeds aktualisiert werden.
Ihre Unterkonten (Kontendienst) und/oder Steuer- und Versandeinstellungen auf Kontoebene (Accounttax Service und Shippingsettings Service) mit der API verwalten. Dies sind keine Funktionen, die Datenfeeds bereitstellen können. Es besteht also kein Konflikt mit der API zur Verwaltung dieser Funktionen.
Wie migriere ich von der Verwendung von Datenfeeds zur reinen API-Nutzung oder umgekehrt?
Wenn Sie derzeit Datenfeeds verwenden und Produkte nur mithilfe der API aktualisieren möchten, müssen Sie Ihre Produktdaten über die API noch einmal hochladen. Wenn Sie den Produktdienst zum Aktualisieren eines bestimmten Produkts verwenden, übernimmt die API die Kontrolle der Produktinformationen. Wenn Sie das Produkt aus dem Datenfeed löschen oder den Datenfeed selbst löschen, werden die Produktinformationen nicht mehr aus Ihrem Merchant Center-Konto entfernt. Falls Sie das Produkt aus dem Datenfeed oder aus dem Datenfeed selbst entfernen möchten, darf der Datenfeed nicht aktualisiert sein. Andernfalls übernimmt der Datenfeed wieder die Inhaberschaft und das Produkt wird entfernt, wenn das Produkt aus dem Datenfeed entfernt wird.
Wenn Sie derzeit nur die API für Produktinformationen verwenden und Datenfeeds als Hauptquelle für Produktinformationen verwenden möchten, können Sie den neuen Datenfeed einfach Ihrem Merchant Center-Konto hinzufügen. Der Inhaber der aufgeführten Produkte übernimmt dann die Inhaberschaft. Wenn Sie Produkte entfernen möchten, die ausschließlich aus der API hochgeladen wurden, müssen Sie sie entweder über das Merchant Center oder über die API löschen.
Wie kann ich Produkte über die Content API for Shopping 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, müssen Sie im Merchant Center im Hauptfeed der Content API zusätzliche Länder konfigurieren oder diese über das Feld shipping der Ressource products hinzufügen.
Unten sehen Sie ein Beispiel für das Ändern der Einstellungen des Hauptfeeds der Content API.
Weitere Informationen finden Sie unter Shopping-Anzeigen und Produkteinträge auf mehrere Länder ausrichten.
Achten Sie darauf, dass Ihre Clientbibliotheken auf dem neuesten Stand sind.
Wenn Sie eine Google-Clientbibliothek für die Interaktion mit der Content API verwenden, achten Sie darauf, den Paketmanager für Ihre gewählte Programmiersprache zu verwenden und die Bibliotheksversion auf dem neuesten Stand zu halten. Weitere Informationen finden Sie im Entwicklerhandbuch für Ihre ausgewählte Sprache unter Beispiele und Bibliotheken.
Mithilfe der Attribute für Zielanwendungen können Sie steuern, welche Produkte in den verschiedenen Shopping-Programmen angezeigt werden.
Die Content API übernimmt automatisch die Standardeinstellungen für Ihren Content API-Feed, so wie er im Merchant Center konfiguriert wurde. Mit den Produktattributen includedDestinations und 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 vorliegen, werden dadurch die Standardfeedeinstellungen im Merchant Center überschrieben und der jeweilige Artikel wird in Buy on Google (früher „Shopping Actions“) nicht angezeigt. Wenn Ihr Feed jedoch nicht für ein Programm aktiviert wurde (z. B. Shopping), können Sie einzelne Artikel einschließen, indem Sie das Attribut includedDestinations und Shopping_ads als Wert verwenden. Der Artikel erscheint dann in Shopping-Anzeigen.
Weitere Informationen zu den Produktattributen includedDestinations und excludedDestinations findest du in der Hilfe.
Artikel aktualisieren, bevor sie ablaufen
Wenn ein Element vor Ablauf nicht geändert wird, also 30 Tage nach der letzten Aktualisierung oder bis zum angegebenen Ablaufdatum, falls früher, aktualisieren Sie das Element, um eine Deaktivierung zu vermeiden. Wenn Sie viele Elemente aktualisieren müssen, weil sich keines geändert hat oder Sie den Zeitpunkt der letzten Aktualisierung nicht verfolgen können, aktualisieren Sie nicht alle Elemente gleichzeitig, sondern verteilen Sie die Last gleichmäßig auf mehrere Tage.
Löschen Sie den Content API-Feed nicht, da Ihre Produkte sonst möglicherweise entfernt 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 Zwischenüberschrift Lokal erhältliche Produkte angezeigt. Achten Sie darauf, nicht versehentlich den Online-Feed oder den lokalen Content API-Feed zu 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 mit der benutzerdefinierten Methode an denselben Dienst in Batches zusammenfassen
Anstatt viele sequenzielle oder parallele Anfragen an denselben Dienst zu senden, können Sie eine einzige Anfrage für benutzerdefinierte Batches erstellen, die alle gewünschten Anfragen enthält. Auf diese Weise tritt die Latenz bei Anfragen an den API-Endpunkt nur einmal für den Custombatch-Aufruf und nicht für jede einzelne Anfrage auf. Dies ist besonders wichtig, wenn Sie sequenzielle Anfragen stellen.
Senden Sie nicht mehrere Updates für einen Artikel in einem Batch
Dies führt zu unerwarteten Ergebnissen aufgrund der Unsicherheit in der Reihenfolge der Aktualisierungen und kann zu Konflikten führen.
Keine Updates für unveränderte Elemente senden
Stellen Sie sicher, dass Sie nur Anfragen für neue, geänderte oder gelöschte Produktartikel senden, es sei denn, die Artikel laufen anderweitig ab.
Verwenden Sie Subfeeds, wenn sich Preise und/oder Verfügbarkeit schnell ändern.
Wenn du Schwierigkeiten hast, die Informationen zu Preis, Verfügbarkeit oder Angebot eines Produkts auf dem neuesten Stand zu halten, kannst du Aktualisierungen nur für diese Attribute über Subfeeds in der Ressource products senden. Da Subfeedaktualisierungen sehr klein sind, können Sie in einem bestimmten Zeitraum wesentlich mehr Aktualisierungen als bei vollständigen Produktaktualisierungen vornehmen. Dies trägt dazu bei, dass Preise und Verfügbarkeit Ihrer Produkte an die Angaben auf Ihren Landingpages angepasst werden.
Eine weitere Möglichkeit zum Aktualisieren von Produktpreis und -verfügbarkeit sind automatische Artikelupdates. Dies kann zusätzlich zu API-Aktualisierungen verwendet werden, um Abweichungen zwischen den Informationen im Merchant Center und den Informationen auf den Produkt-Landingpages zu vermeiden. Beachten Sie jedoch, dass damit kleine Probleme mit der Genauigkeit von Produktpreis und -verfügbarkeit behoben werden sollen. Automatische Artikelupdates sind daher kein Ersatz dafür, auch die richtigen Informationen über die API bereitzustellen.
Wann wird ein Aktualisierungstoken verwendet?
Das Aktualisierungstoken wird im HTTP-Header der Autorisierungsanfragen zurückgegeben. Es enthält viele weitere Informationen zur Authentifizierung, aber das Aktualisierungstoken ist oft das Element, das Entwickler in die Hand nehmen möchten, da es den Nutzer nicht wiederholt zur Authentifizierung auffordern muss, da Zugriffstokens nur 60 Minuten vor Ablauf gültig sind.