Kontingente und Limits

Die Content API for Shopping legt für einige Funktionen strenge Kontingente und Beschränkungen fest. Alle Kontingente und Limits können jederzeit und ohne Vorankündigung entfernt, reduziert oder geändert werden.

Kontingentrichtlinie

Aktualisieren Sie Ihre Produkte nur zweimal pro Tag und Ihre Unterkonten nicht öfter als einmal pro Tag.

Kontingente für Methodenaufrufe

Die Content API for Shopping passt Ihre Kontingente für products und accounts automatisch anhand Ihrer Nutzung an. Die Nutzung von accounts basiert auf dem Limit für Unterkonten.

So verfolgen wir Ihre Kontingentnutzung:

  • Kontingente gelten pro Methode. Die Methode get hat beispielsweise ein anderes Kontingent als die Methode update.
  • patch-Methoden werden auf Ihre Kontingente get und update angerechnet.
  • Jeder Methodenaufruf innerhalb einer custombatch wird separat auf das Kontingent dieser Methode angerechnet.
  • Aufrufe werden auf das Kontingent des Kontos angerechnet, das Sie beim Ausführen des Aufrufs authentifizieren. Wenn Sie sich beispielsweise als erweitertes Konto authentifizieren, werden Aufrufe auf das Kontingent Ihres erweiterten Kontos angerechnet, aber wenn Sie sich als eines Ihrer Unterkonten authentifizieren, werden Aufrufe auf das Kontingent des Unterkontos angerechnet.

Kontingente prüfen

Rufen Sie quotas.list mit der merchantId des Kontos auf, um das aktuelle Kontingent und die aktuelle Nutzung für ein Konto zu prüfen.

Wir empfehlen Ihnen, Ihre Kontingente regelmäßig zu prüfen, um sicherzustellen, dass Sie ein ausreichendes Kontingent für Ihre Implementierung 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 ausgeschöpft haben oder eine vorübergehende Erhöhung für accounts oder Produkte services benötigen, wenden Sie sich mit den folgenden Informationen an uns:

  • Ihre Merchant Center-ID
  • Bei welchen Methoden Sie Ihre Kontingentlimits erreicht haben.
  • Eine Schätzung, wie viele Anrufe pro Tag für diese Methoden erforderlich sind.
  • Der Grund, warum Sie eine Kontingenterhöhung benötigen.

Fehler

Wenn Sie das Kontingent für die Content API for Shopping überschreiten, werden folgende Fehler zurückgegeben:

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

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

Die folgenden Fehler können nicht durch automatische Kontingenterhöhungen behoben werden und erfordern, dass Sie zusätzliche Kontingente für Artikel, Feeds oder Unterkonten anfordern:

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

Limits für die Ressourcendarstellung

In den folgenden Limits werden wichtige Einschränkungen für bestimmte Stringwerte und Arrayfelder in den in der Content API verwendeten Ressourcendarstellungen beschrieben. Diese Limits gelten für die Content API und die entsprechende Funktion im Merchant Center. Die Liste der Limits ist unter Umständen nicht vollständig und kann nicht erweitert werden.

Ressource Field Limit
shippingsettings

Versandservices pro Land (services).

Versandgruppen pro Versandservice (rateGroups).

Labels pro Versandgruppe (applicableShippingLabels).

Untergeordnete Tabellen 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:

  • Array-Felder in rowHeaders oder columnHeaders:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]