Kontingente und Limits

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

Kontingentrichtlinie

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

Kontingente für Methodenaufrufe

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

So verfolgen wir Ihre Kontingentnutzung:

• Kontingente gelten pro Methode. Die Methode get hat beispielsweise ein separates Kontingent von der Methode update.
• patch-Methoden werden sowohl auf das get- als auch auf das update-Kontingent angerechnet.
• Jeder Methodenaufruf innerhalb einer custombatch wird separat auf das Kontingent dieser Methode angerechnet.
• Aufrufe werden auf das Kontingent des Kontos angerechnet, für das Sie sich beim Aufruf authentifizieren. Wenn Sie sich beispielsweise als erweitertes Konto authentifizieren, 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

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 das Kontingent für Ihre Implementierung ausreicht.

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, schöpfen Sie Ihr Tageskontingent für die Dienste products oder accounts aus oder benötigen eine vorübergehende Erhöhung für accounts oder die Produkte services, kontaktieren Sie uns und geben Sie die folgenden Informationen an:

• Ihre Merchant Center-ID
• Methoden, für die Sie Ihre Kontingentlimits erreicht haben.
• Eine Schätzung der Anzahl von Aufrufen pro Tag, die Sie für diese Methoden benötigen.
• Der Grund, warum Sie eine Kontingenterhöhung benötigen.

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

Unter Kontingente prüfen können Sie Ihre Kontingente und Nutzung einsehen und eine Kontingenterhöhung pro Tag oder pro Minute anfordern.

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

Die folgenden Limits beschreiben wichtige Einschränkungen für bestimmte Stringwerte und Arrayfelder innerhalb der in der Content API verwendeten Ressourcendarstellungen. 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 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 von 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 innerhalb von rowHeaders oder columnHeaders:
  • prices[]
  • weights[]
  • numberOfItems[]
  • postalCodeGroupNames[]
  • locations[]
  • rows[]
  • cells[]