Kontingente und Limits

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

Kontingentrichtlinie

Aktualisieren Sie Ihre Produkte im Durchschnitt nicht mehr als zweimal pro Tag 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 Nutzung von accounts basiert auf dem Limit für Ihre Unterkonten.

So erfassen wir Ihre Kontingentnutzung:

• Kontingente gelten pro Methode. Die Methode get hat beispielsweise ein anderes Kontingent als die Methode update.
• patch-Methoden werden sowohl auf Ihr get- als auch auf Ihr update-Kontingent angerechnet.
• Jeder Methodenaufruf in einem custombatch wird separat auf das Kontingent dieser Methode angerechnet.
• Aufrufe werden auf das Kontingent des Kontos angerechnet, mit dem Sie sich bei der Ausführung des Aufrufs authentifizieren. Wenn Sie sich beispielsweise als ein erweitertes Kontoauthentifizieren, werden Aufrufe auf das Kontingent Ihres erweiterten Kontos angerechnet. Wenn Sie sich jedoch als eines Ihrer Unterkonten authentifizieren, werden Aufrufe auf das Kontingent des Unterkontos angerechnet.

Kontingente prüfen

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

Wir empfehlen, Ihre Kontingente regelmäßig zu prüfen, damit Sie für Ihre Implementierung ausreichend 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 products oder accounts Dienste erreicht haben oder eine vorübergehende Erhöhung für die accounts oder products services benötigen, wenden Sie sich mit den folgenden Informationen an uns:

• Ihre Merchant Center-ID
• Die Methoden, für die Sie Ihre Kontingentlimits erreicht haben
• Eine Schätzung der Anzahl der Aufrufe pro Tag, die Sie für diese Methoden benötigen
• Der 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 Aufrufen 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. Sie müssen ein zusätzliches Kontingent für Artikel, Feeds oder Unterkonten anfordern:

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

Limits bei der Ressourcendarstellung

Die folgenden Limits beschreiben wichtige Einschränkungen, die für bestimmte Stringwerte und Arrayfelder in den Ressourcendarstellungen gelten, 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 unvollständig und die Limits können nicht erweitert werden.

Ressource	Feld	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:

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