Kontingente und Limits

Für Ihr Händlerkonto und die Nutzung der Merchant API gelten Kontingente und Limits.

Richtlinie aktualisieren

Für die Merchant API gelten in Bezug auf Aktualisierungen die folgenden Richtlinien:

• Sie können Ihre Produkte nur zweimal pro Tag aktualisieren.
• Sie können Ihre untergeordneten Konten nur einmal pro Tag aktualisieren.

Kontingente für Methodenaufrufe

Die Merchant API passt die Anrufkontingente für Ihre products und accounts automatisch an Ihre Nutzung an.

So erfassen wir Ihre Kontingentnutzung:

• Kontingente gelten pro Methode. Die Methode get hat beispielsweise ein separates Kontingent von der Methode update.
• Jede Anfrage wird einmal gezählt, unabhängig von ihrem Typ. Eine list-Anfrage mit 250 Elementen wird beispielsweise einmal gezählt, nicht als 250 get-Anfragen.
• Das Kontingent wird basierend auf dem Nutzer berechnet, der die API-Anfrage stellt. Wenn der Nutzer ein direktes Mitglied eines erweiterten Kontos ist, wird das Kontingent auf Ebene des erweiterten Kontos abgerechnet.
• Kontingente gelten für die Preisvergleichsportal-Gruppe, das Preisvergleichsportal, das Konto oder die Unterkonten, für die Sie sich bei der Ausführung des Aufrufs authentifizieren. Wenn Sie sich beispielsweise als erweitertes Konto authentifizieren, werden die Aufrufe auf das Kontingent Ihres erweiterten Kontos angerechnet. Wenn Sie sich als eines Ihrer untergeordneten Konten authentifizieren, werden die Aufrufe auf das Kontingent des untergeordneten Kontos angerechnet.

Das Diagramm zeigt die Hierarchie von Preisvergleichsportal-Gruppen, Preisvergleichsportalen, Konten und Unterkonten.

Änderungen bei Kontingenten für Methodenaufrufe in der Content API for Shopping

Wenn Sie die Content API for Shopping verwendet haben, beachten Sie die folgenden Änderungen bei den Kontingenten für Methodenaufrufe in der Merchant API:

• Das Fehlen von benutzerdefiniertem Batching hat keine Auswirkungen auf die Kontingentberechnung. Eine Batchanfrage mit 500 Einfügeanfragen wird beispielsweise als 500 einzelne Anfragen für die Einfügemethode abgerechnet.
• Die Kontingentautomatisierung für Konten und Produkte bleibt bestehen.
• Mit der Methode „Quota.list“ können Sie Ihre aktuelle Kontingentnutzung und Ihre aktuellen Kontingentlimits ermitteln, einschließlich Automatisierung und Überschreibungen.

Anrufkontingente prüfen

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

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 tägliches Kontingent für die Dienste products oder accounts überschritten wird oder Sie eine vorübergehende Erhöhung für die Produkte accounts oder services benötigen, wenden Sie sich mit den folgenden Informationen an uns:

• Ihre Merchant Center-ID
• Die Methoden, für die Sie das Kontingentlimit erreicht haben
• Eine Schätzung der Anzahl der API-Aufrufe pro Tag, die für diese Methoden erforderlich sind
• Der Grund, warum Sie eine Kontingenterhöhung benötigen
• Ob es sich um eine vorübergehende oder dauerhafte Erhöhung handelt

Wir empfehlen, Ihre Kontingente regelmäßig zu prüfen, um sicherzustellen, dass Sie genügend Kontingent für Ihre Implementierung haben oder wie Ihr Kontingent automatisch angepasst wird.

Fehler

Wenn Sie die Kontingente überschreiten, erhalten Sie die folgenden Fehlermeldungen:

• 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 für Aufrufe 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

Kontolimits

Mit den Methoden accounts.limits.get und accounts.limits.list können Sie Limits für Entitäten auf Kontoebene prüfen. Mit diesen Methoden können Sie die Produktlimits prüfen.

Wenn Sie ein bestimmtes Produktlimit abrufen möchten, z. B. das EWR-Kontingent für Anzeigen eines Kontos, müssen Sie die Konto-ID und die Limit-ID in Ihrem Aufruf von accounts.limits.get angeben. Die Limit-ID ist eine Kombination aus Limittyp und ‑bereich. Beispiel: products~ADS_EEA für Produkte, für die Anzeigen im EWR geschaltet werden, und products~ADS_NON_EEA für Produkte, für die Anzeigen außerhalb des EWR geschaltet werden.

Hier ist ein Beispiel für eine Anfrage zum Abrufen des products~ADS_EEA-Limits für ein bestimmtes Konto:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

Verwenden Sie accounts.limits.list mit einem Filter für type="products", um die verfügbaren Limit-IDs für Ihr Konto abzurufen:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

Weitere Informationen zu Produktkontingenten

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 Merchant API verwendet werden. Diese Limits gelten sowohl für die Merchant API als auch für die entsprechende Funktion im Merchant Center.

Diese Liste der Limits ist möglicherweise unvollständig. Diese Limits können nicht erhöht werden.

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[]