Latenz ist die Zeit, bis Sie die Antwort auf eine Anfrage erhalten. In diesem Leitfaden finden Sie die ungefähren Latenzen für Merchant API-Anfragen. Verwenden Sie diese Werte, um Zeitlimits festzulegen und den Durchsatz Ihrer Integration zu planen.
Die meisten Merchant API-Anfragen werden in weniger als einer Sekunde abgeschlossen. Die Aktualisierung des lokalen und regionalen Inventars kann einige Sekunden dauern, und einige Berichtsanfragen dauern viel länger.
Typische Latenzen
In der folgenden Tabelle sind die ungefähren Latenzen nach Anfragetyp aufgeführt. Die typische Latenz ist der Median: Die Hälfte der Anfragen wird schneller abgeschlossen. Das langsamste 1% der Anfragen dauert so lange wie in der letzten Spalte angegeben oder länger.
| Art des Sprachbefehls | Beispielmethoden | Typische Latenz | Langsamste 1% der Anfragen |
|---|---|---|---|
| Lese- und Schreibvorgänge für Produkte | products.get, productInputs.insert, productInputs.patch, productInputs.delete |
100 bis 600 Millisekunden | Etwa 2 Sekunden |
| Die meisten anderen Anfragen | products.list, accounts.get, dataSources.list, aggregateProductStatuses.list |
Weniger als 1 Sekunde | Ein paar Sekunden |
| Schreibvorgänge für lokales und regionales Inventar | localInventories.insert, regionalInventories.insert und die entsprechenden delete-Methoden |
Ein paar Sekunden | Mindestens 10 Sekunden |
| Berichtsabfragen | accounts.reports.search |
Etwa eine halbe Sekunde | Mindestens 30 Sekunden |
Berichtsabfragen variieren am stärksten. Die Latenz hängt von der Berichtstabelle, die Sie abfragen, und von der Datenmenge ab, die die Abfrage abdeckt. Etwa 1 von 10 Berichtsabfragen dauert in der Regel länger als 2 Sekunden und ein kleiner Teil kann länger als eine Minute dauern.
Empfehlungen
- Legen Sie Zeitlimits mit Spielraum fest. Wenn Sie in Ihrem Client Zeitlimits für Anfragen festlegen, sollten diese deutlich über den langsamsten Latenzen liegen, die unter Typische Latenzen aufgeführt sind. Ein Zeitlimit von 60 Sekunden bietet beispielsweise ausreichend Spielraum für die meisten Anfragen, aber nicht für alle Berichtsanfragen.
- Unabhängige Anfragen parallel senden. Da jeder Inventarschreibvorgang einige Sekunden dauert, wird der Durchsatz eingeschränkt, wenn sie nacheinander gesendet werden. Senden Sie unabhängige Anfragen parallel oder verwenden Sie Batchanfragen. Wenn Sie mehrere Anfragen senden, beachten Sie die Limits pro Minute und die Tageslimits. Weitere Informationen finden Sie unter Ratenkontingente.
- Beschränken Sie Berichtsabfragen auf die benötigten Daten. Abfragen, die große Datasets abdecken, z. B. lange Zeiträume, dauern länger und können zu einer Zeitüberschreitung führen. Wenn Sie große Datenmengen benötigen, sollten Sie BigQuery verwenden. Weitere Informationen finden Sie unter Google Merchant Center-Daten in BigQuery laden.
- Wiederholungsversuche mit exponentiellem Backoff Wenn eine Anfrage das Zeitlimit überschreitet oder mit einem vorübergehenden Fehler fehlschlägt, versuchen Sie es mit exponentiellem Backoff noch einmal.
Verarbeitungszeit
Bei Anfragen, die Daten ändern, bedeutet eine erfolgreiche Antwort, dass die Merchant API die Änderung akzeptiert hat. Die Verarbeitung wird jedoch nach der Antwort fortgesetzt. Die Verarbeitungszeit ist die Zeit von der Antwort bis zur Sichtbarkeit der Änderung in anderen Ressourcen. Die Verarbeitungszeit ist nicht Teil der Latenz und kann viel länger sein. Es kann beispielsweise einige Minuten dauern, bis das verarbeitete Produkt eine eingefügte Produkteingabe widerspiegelt.
Weitere Informationen zum endgültigen verarbeiteten Status Ihrer Daten finden Sie in den folgenden Leitfäden: