Kontingente und Limits

Für einige Funktionen der Content API for Shopping gelten strenge Kontingente und Limits. Alle Kontingente und Limits können jederzeit und ohne Vorankündigung aufgehoben, reduziert oder geändert werden.

Kontingentrichtlinie

Aktualisieren Sie Ihre Produkte durchschnittlich nicht mehr als zweimal und Ihre Unterkonten nicht mehr als einmal pro Tag.

Kontingente für Methodenaufrufe

Die Content API for Shopping passt Ihre products- und accounts-Kontingente automatisch an Ihre Nutzung an. Die accounts-Nutzung basiert auf dem Grenzwert für Unterkonten.

So wird Ihre Kontingentnutzung erfasst:

  • Kontingente gelten pro Methode. Beispielsweise hat die Methode get ein anderes Kontingent als die Methode update.
  • patch-Methoden werden sowohl auf Ihr get- als auch auf Ihr update-Kontingent angerechnet.
  • Jeder Methodenaufruf innerhalb einer custombatch wird separat auf das Kontingent dieser Methode angerechnet.
  • Anrufe werden auf das Kontingent des Kontos angerechnet, mit dem Sie sich authentifizieren, wenn Sie den Anruf starten. Wenn Sie sich beispielsweise mit einem erweiterten Konto authentifizieren, werden die Aufrufe auf das Kontingent des erweiterten Kontos angerechnet. Wenn Sie sich jedoch mit einem Ihrer Unterkonten authentifizieren, werden die Aufrufe auf das Kontingent des Unterkontos angerechnet.

Kontingente prüfen

Wenn Sie das aktuelle Kontingent und die aktuelle Nutzung für ein Konto prüfen möchten, rufen Sie quotas.list mit der merchantId des Kontos auf.

Wir empfehlen Ihnen, Ihre Kontingente regelmäßig zu prüfen, um sicherzustellen, dass Sie für Ihre Implementierung ein ausreichendes Kontingent haben.

Das automatische Kontingent gilt nur für die Dienste products und accounts. Wenn Sie ein höheres Kontingent für einen anderen Dienst benötigen, Ihr Tageskontingent für die Dienste products oder accounts erreicht ist oder Sie eine vorübergehende Erhöhung für accounts oder die Produkte services benötigen, wenden Sie sich bitte an uns und geben Sie dabei die folgenden Informationen an:

  • Ihre Merchant Center-ID
  • Für welche Methoden Sie die Kontingentlimits erreicht haben.
  • Eine Schätzung, wie viele Aufrufe pro Tag für diese Methoden erforderlich sind.
  • Den Grund für die Kontingenterhöhung.

Fehler

Wenn Sie die Kontingente der Content API for Shopping überschreiten, erhalten Sie die folgenden Fehler:

  • Pro Minute: quota/request_rate_too_high
  • Pro Tag: quota/daily_limit_exceeded

Informationen zum Ansehen Ihrer Kontingente und zur Nutzung sowie zum Anfordern einer Erhöhung des Kontingents pro Tag oder pro Minute finden Sie unter Kontingente prüfen.

Die folgenden Fehler können nicht durch automatische Kontingenterhöhungen behoben werden. Sie müssen ein zusätzliches Kontingent an Artikeln, Feeds oder Unterkonten anfordern:

  • too_many_items: Merchant quota exceeded
  • too_many_subaccounts: Maximum number of sub-accounts reached

Limits für die Ressourcendarstellung

Die folgenden Limits beschreiben wichtige Einschränkungen für bestimmte Stringwerte und Arrayfelder in den Ressourcendarstellungen, die in der Content API verwendet werden. Diese Limits gelten sowohl für die Content API als auch für die entsprechende Funktion im Merchant Center. Diese Liste der Limits ist möglicherweise nicht vollständig und die Limits können nicht erweitert werden.

Ressource Feld Limit
shippingsettings

Versandservices nach Land (services)

Versandgruppen pro Versandservice (rateGroups)

Labels pro Versandgruppe (applicableShippingLabels)

Untertabellen pro Versandgruppe (subtables)

Anzahl der Zeilen oder Spalten in einer einzelnen Preistabelle.

Länge der Versandlabels.

20

20

30

100

150

100

Die Anzahl der Zeilen oder Spalten in einer Preistabelle wirkt sich auf die folgenden Arrayfelder aus:

  • Arrayfelder in rowHeaders oder columnHeaders:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]