Dieses Dokument enthält Richtlinien für Best Practices. Weitere Informationen finden Sie unter Tipps zur Leistungsoptimierung.
Wann sollte die API verwendet werden?
Anfragen programmatisch senden
Unabhängig davon, ob Sie jeden Teil Ihres Workflows automatisieren oder einen Hook in Ihr ERP-System (Enterprise Resource Planning) einbinden möchten, können Sie mit der Content API Updates senden, sobald sich Ihr Inventar ändert.
Um sofortiges Feedback zu erhalten
In der Content API erhalten Sie sofort eine Antwort auf jede Anfrage anstatt in einer E-Mail-Zusammenfassung, 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 mehrmals täglich inkrementelle Aktualisierungen an Ihrem sich schnell ändernden Produktinventar vornehmen. Es ist jedoch nicht möglich, Ihren gesamten Datenfeed jedes Mal zu senden. Wenn Updates einzeln verfügbar werden, senden Sie sie einzeln. Warten Sie nicht, bis mehrere Updates verfügbar sind, damit Sie sie im Batch zusammenfassen können. Wenn Aktualisierungen in Batches verfügbar sind, senden Sie sie ebenfalls in Batches und teilen Sie sie nicht in einzelne Anfragen auf.
Um mehrere Unterkonten zu verwalten
Neu erstellte Merchant Center-Konten sind einzelne Konten, die einen eigenen Satz von Produktdaten enthalten. Das funktioniert in den meisten Fällen gut, aber wenn Ihr Konto wächst, benötigen Sie möglicherweise ein komplexeres Verwaltungssystem für Ihre Produkte. Ziehen Sie in diesem Fall die Verwendung eines Mehrfachkundenkontos (Multi-Client Account, MCA) in Betracht. Die Verwaltung eines MCA-Kontos auf API-Ebene kann über den Kontendienst erfolgen. Damit können Unterkonten programmatisch hinzugefügt und verwaltet werden. Weitere Informationen zum Erhalt eines MCA-Kontos finden Sie hier.
Verwendung der API
API nicht wie Datenfeeds verwenden
Vermeiden Sie tägliche Aktualisierungen Ihres gesamten Produktfeeds, wenn Sie die Ressource products verwenden.
Aktualisieren Sie stattdessen gezielt nur die Produkte, deren Daten sich tatsächlich geändert haben. Das Senden Ihres gesamten Datenfeeds über die Ressource products verbraucht sowohl für Google als auch für Sie mehr Zeit und Ressourcen.
Nutzen Sie die API nicht, um von Ihnen hochgeladene Produktinformationen regelmäßig abzurufen.
Wenn Sie für die Verwaltung der Produktinformationen in einem bestimmten Merchant Center-Konto verantwortlich sind, sollten Sie nicht regelmäßig über die Methode products.get oder products.list Produktinformationen von der Content API anfordern. Kunden, die Daten hochladen, können mit diesen Methoden Probleme beim Entwerfen von Lösungen beheben, für die die Content API verwendet wird. 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, und die Produkte im Merchant Center sollten den Inhalt dieser Quelle widerspiegeln.
Verwenden Sie zum Einreichen von Produktartikeln nicht gleichzeitig Datenfeeds und die Content API.
Wenn Sie erwägen, zum Einreichen von Artikeln zur API zu wechseln, achten Sie darauf, dass Sie zum Einreichen von Artikeln keine Datenfeeds mehr verwenden. Wenn Sie weiterhin Artikel über beide Medien einreichen, kann es zu unerwarteten Ergebnissen kommen.
Gibt es eine Möglichkeit, die API und Datenfeeds sicher zusammen zu verwenden?
Sie können Ihre Datenfeeds mithilfe des Datafeed Service der API bearbeiten. Dies vereinfacht die Verwaltung umfangreicher Datenfeeds erheblich. Es sollten jedoch keine Produkte mit der API gleichzeitig mit Feeds eingefügt oder aktualisiert werden, 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) von der 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 von Feeds aktualisiert werden.
Mit der API Ihre Unterkonten (Konten-Dienst) und/oder Steuer- und Versandeinstellungen auf Kontoebene (Accounttax-Dienst und Versandeinstellungen-Dienst) verwalten. Dabei handelt es sich nicht um Funktionen, die über Datenfeeds bereitgestellt werden können. Es besteht also kein Konflikt bei der Verwaltung dieser Funktionen mit der API.
Wie migriere ich von Datenfeeds zur API oder umgekehrt?
Wenn Sie derzeit Datenfeeds verwenden und zum Aktualisieren von Produkten nur die API verwenden möchten, müssen Sie Ihre Produktdaten noch einmal über die API hochladen. Wenn Sie ein bestimmtes Produkt mit dem Produktfeed aktualisieren, übernimmt die API die Kontrolle über die Produktinformationen. Durch das Löschen des Produkts aus dem Datenfeed oder das Löschen des Datenfeeds werden die Produktinformationen nicht mehr aus Ihrem Merchant Center-Konto entfernt. Wenn Sie das Produkt aus dem Datenfeed oder dem Datenfeed selbst entfernen möchten, darf der Datenfeed nicht aktualisiert werden. Andernfalls übernimmt der Datenfeed die Inhaberschaft wieder 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 den neuen Datenfeed einfach Ihrem Merchant Center-Konto hinzufügen, woraufhin diese die Inhaberschaft für die aufgeführten Produkte übernehmen. Wenn Produkte vor ihrem Ablauf entfernt werden sollen und nur über die API hochgeladen wurden, müssen Sie sie entweder über das Merchant Center oder die API löschen.
Wie kann ich meine 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, konfigurieren Sie im Content API-Hauptfeed im Merchant Center zusätzliche Länder oder fügen Sie diese zusätzlichen Länder über das Feld shipping der Ressource products hinzu.
Unten sehen Sie ein Beispiel für das Ändern der Einstellungen des Hauptfeeds der Content API.
Weitere Informationen finden Sie unter Ausrichtung von Shopping-Anzeigen und Produkteinträgen in mehreren Ländern.
Clientbibliotheken aktualisieren
Wenn Sie eine Google-Clientbibliothek für die Interaktion mit der Content API verwenden, müssen Sie den Paketmanager für die von Ihnen gewählte Programmiersprache verwenden und darauf achten, dass die Version der Bibliothek auf dem neuesten Stand ist. Weitere Informationen finden Sie im Entwicklerhandbuch für die von Ihnen gewählte Sprache unter Beispiele und Bibliotheken.
Verwenden Sie die Attribute „Zielanwendungen“, um zu steuern, welche Produkte in den verschiedenen Shopping-Programmen erscheinen.
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 innerhalb eines Feeds oder über die Content API steuern.
Wenn Ihr API-Feed für ein Programm wie Buy on Google (früher Shopping Actions) aktiviert ist, Sie aber bestimmte Produkte ausschließen möchten, verwenden Sie das Attribut excludedDestinations und geben Sie Shopping Actions als Wert an. Sofern keine Fehler vorhanden sind, werden die Standardfeedeinstellungen im Merchant Center überschrieben und der betreffende Artikel wird nicht in Buy on Google (früher Shopping Actions) angezeigt. Wenn Ihr Feed jedoch nicht für ein Programm wie Shopping aktiviert ist, können Sie einzelne Artikel mithilfe des Attributs includedDestinations und Shopping_ads als Wert angeben. Der Artikel wird dann in Shopping-Anzeigen angezeigt.
Weitere Informationen zu den Produktattributen includedDestinations und excludedDestinations finden Sie in der Hilfe.
Artikel aktualisieren, bevor sie ablaufen
Wenn sich ein Element vor seinem Ablauf nicht ändert, 30 Tage nach der letzten Aktualisierung oder zum angegebenen Ablaufdatum, falls früher, aktualisieren Sie das Element, um seine Deaktivierung zu verhindern. 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 über mehrere Tage verteilen.
Löschen Sie den Content API-Feed nicht, da Ihre Produkte sonst möglicherweise verschwinden
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 mit der Zwischenüberschrift Lokale Produkte angezeigt. Achte darauf, nicht versehentlich den Onlinefeed oder den lokalen Content API-Feed zu löschen. Je nachdem, welchen Feed Sie löschen, werden die Online- oder lokal erhältlichen Produkte, die Sie dem Merchant Center über die Content API hinzugefügt haben, entfernt.
Mehrere Anfragen an denselben Dienst mithilfe der Methode „custombatch“ in einem Batch ausführen
Anstatt viele sequenzielle oder parallele Anfragen an denselben Dienst zu senden, können Sie eine einzelne benutzerdefinierte Batchanfrage senden, die alle gewünschten Anfragen enthält. Auf diese Weise tritt die Latenz für Anfragen an den API-Endpunkt nur einmal für den benutzerdefinierten Batch-Aufruf und nicht für jede einzelne Anfrage ein. Dies ist besonders wichtig bei sequenziellen Anfragen.
Senden Sie nicht mehrere Aktualisierungen in einem Batch an einen einzelnen Artikel.
Da die Reihenfolge der Aktualisierungen unklar ist, führt dies zu unerwarteten Ergebnissen und es kann zu einem Konfliktfehler kommen.
Keine Updates für unveränderte Artikel senden
Senden Sie nur Anfragen für neue, geänderte oder gelöschte Produktelemente, es sei denn, die Artikel laufen ansonsten ab.
Verwenden Sie Subfeeds, wenn sich Preise und/oder Verfügbarkeit schnell ändern.
Wenn es Probleme gibt, den Preis, die Verfügbarkeit oder die Angebotsinformationen eines Produkts auf dem neuesten Stand zu halten, können Sie Aktualisierungen nur für diese Attribute über Subfeeds in der Ressource products senden. Da Subfeedaktualisierungen klein sind, können Sie in einem bestimmten Zeitraum viel mehr Subfeedaktualisierungen vornehmen als vollständige Produktaktualisierungen. Dadurch können die Preise und die Verfügbarkeit Ihrer Produkte mit Ihren Landingpages übereinstimmen.
Eine weitere Möglichkeit, Preis und Verfügbarkeit von Produkten zu aktualisieren, 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 dies dazu dient, kleine Probleme mit der Genauigkeit von Produktpreis und ‐verfügbarkeit zu beheben. Automatische Artikelupdates sind also kein Ersatz für die Bereitstellung korrekter Informationen über die API.
Wann sollte ein Aktualisierungstoken verwendet werden?
Das Aktualisierungstoken wird im HTTP-Header von Autorisierungsanfragen zurückgegeben. Es enthält viele andere Informationen zur Authentifizierung, aber das Aktualisierungstoken ist häufig das, was Entwickler in die Hände bekommen möchten, da der Nutzer nicht wiederholt zur Authentifizierung aufgefordert werden muss, da Zugriffstokens nur 60 Minuten gültig sind, bevor sie ablaufen.