Kontingente und Limits

Für Ihr Händlerkonto und Ihre 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 maximal zweimal pro Tag aktualisieren.
• Sie können Datenquellenmethoden für Ihre Unterkonten wie list oder create nur maximal zweimal pro Unterkonto und Tag aufrufen.

Kontingente für Methodenaufrufe

Die Merchant API passt die Aufrufkontingente für Folgendes automatisch an:

• products und accounts basierend auf Ihrer Nutzung.
• datasources für erweiterte Konten basierend auf der Anzahl ihrer Unterkonten.

So verfolgen 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 für 250 Artikel 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 der Ebene des erweiterten Kontos berechnet.
• Für den Dienst datasources gilt die automatische Kontingentskalierung nur für erweiterte Konten basierend auf der Anzahl ihrer Unterkonten. Kontingente für eigenständige Konten und Unterkonten sind statisch und Erhöhungen werden in der Regel nicht unterstützt. Verwenden Sie die accounts.limits Methoden, um die datasourceKontingentlimits zu prüfen.
• Kontingente gelten für die Preisvergleichsportal-Gruppe, das Preisvergleichsportal, das Konto oder die Unterkonten , bei denen Sie sich authentifizieren, wenn Sie den Aufruf ausführen. Wenn Sie sich beispielsweise als erweitertes Konto authentifizieren, werden Aufrufe auf das Kontingent Ihres erweiterten Kontos angerechnet. Wenn Sie sich als eines Ihrer Unterkonten authentifizieren, werden Aufrufe auf das Kontingent des Unterkontos angerechnet.

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

Ä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 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 Einfügeanfragen berechnet.
• Die Kontingentautomatisierung für Konten und Produkte bleibt bestehen.
• Verwenden Sie die Methode Quota.list, um Ihre aktuelle Kontingentnutzung und Ihre aktuellen Kontingentlimits zu ermitteln, einschließlich Automatisierung und Überschreibungen.

Aufrufkontingente prüfen

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

Das automatische Kontingent gilt für die Dienste products, accounts und datasources.

• Für Ressourcen mit automatischen Kontingenten (products, accounts und datasources für erweiterte Konten) : Sie können nur eine vorübergehende Erhöhung für spezielle Szenarien wie die Einführung in einem neuen Markt oder während umsatzstarker Shopping-Saisons beantragen. Wir akzeptieren keine dauerhaften Kontingenterhöhungen für diese Art von Ressourcen.
• Für alle anderen Ressourcen ohne automatische Kontingente:Sie können bei Bedarf Kontingenterhöhungen beantragen.

Verwenden Sie das Problem Quota increase request im Formular Kontakt zum Support und geben Sie die folgenden Informationen an:

• Ihre Merchant Center-ID
• Die Methoden, bei denen 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 Anfrage zur 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 über ein ausreichendes Kontingent für Ihre Implementierung verfügen oder zu sehen, 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 Beantragen 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 beantragen:

• 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 Bereich. 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

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

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.

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