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 maximal zweimal pro Tag aktualisieren. Die täglichen Aufrufe sollten gleichmäßig über den Tag verteilt werden, um das Kontingent pro Minute einzuhalten.
  • Sie können Ihre Unterkonten nur einmal pro Tag aktualisieren.

Kontingente für Methodenaufrufe

Die Merchant API passt die Aufrufkontingente 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 anderes Kontingent als die Methode update.
  • Jede Anfrage wird einmal gezählt, unabhängig von ihrem Typ. Eine list-Anfrage mit 250 Artikeln wird beispielsweise einmal gezählt und 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 berechnet.
  • Kontingente gelten für die Preisvergleichsportal-Gruppe, das Preisvergleichsportal, das Konto oder die Unterkonten, für die Sie sich bei der Anforderung authentifizieren. Wenn Sie sich beispielsweise als ein erweitertes Konto authentifizieren, werden die Aufrufe auf das Kontingent Ihres erweiterten Kontos angerechnet. Wenn Sie sich als eines Ihrer Unterkonten authentifizieren, werden die Aufrufe auf das Kontingent des Unterkontos angerechnet.

Das Diagramm zeigt die Hierarchie von Preisvergleichsportal-Gruppen, Preisvergleichsportalen, Konten und Unterkonten. Eine Preisvergleichsportal-Gruppe ist die übergeordnete Authentifizierungsebene. Sie kann einzelne Preisvergleichsportale, Konten und Unterkonten als unterste Ebene enthalten.

Änderungen bei Kontingenten für Methodenaufrufe im Vergleich zur 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 benutzerdefinierten Batch-Anfragen hat keine Auswirkungen auf die Kontingentberechnung. Eine Batch-Anfrage mit 500 Einfügeanfragen wird beispielsweise als 500 einzelne Anfragen der Methode „insert“ berechnet.
  • 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.

Aufrufkontingente prüfen

Wenn Sie die aktuellen Aufrufkontingente und die Nutzung für ein Konto prüfen möchten, rufen Sie quotas.list mit dem name des Kontos auf.

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 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
  • 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 ausreichend Kontingent für Ihre Implementierung haben oder zu erfahren, wie Ihr Kontingent automatisch angepasst wird.

Fehler

Wenn Sie das Kontingent überschreiten, erhalten Sie die folgenden Fehler:

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

Informationen zum Aufrufen Ihres Kontingents und Ihrer Nutzung sowie zum Anfordern einer Kontingenterhöhung pro Tag oder pro Minute finden Sie unter Aufrufkontingente prüfen.

Die folgenden Fehler können nicht durch automatische Kontingenterhöhungen behoben werden, und 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

Kontolimits

Mit den accounts.limits.get und accounts.limits.list Methoden können Sie Limits für Entitäten auf Kontoebene prüfen. Sie können diese Methoden verwenden, um Produktlimits zu 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 dem Limit-Typ und dem Umfang. Beispiele: products~ADS_EEA für Produkte, die auf Anzeigen im EWR ausgerichtet sind, und products~ADS_NON_EEA für Produkte, die auf Anzeigen außerhalb des EWR ausgerichtet sind.

Hier sehen Sie eine Beispielanfrage zum Abrufen des Limits products~ADS_EEA für ein bestimmtes Konto:

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

Informationen zu den verfügbaren Limit-IDs für Ihr Konto erhalten Sie mit accounts.limits.list und einem Filter für type="products":

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

Weitere Informationen zu Produktkontingenten finden Sie unter Kontingente im Google Merchant Center.

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.

Beachten Sie, dass diese Liste der Limits möglicherweise unvollständig ist. Wir werden diese Limits nicht erweitern.

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[]
Zurück
Manage conversion sources
Weiter
Track usage metrics