In diesem Dokument sind die Kontingente für die Merchant API aufgeführt.
Die Merchant API verwendet Kontingente, um eine stabile und faire Umgebung für alle Nutzer zu gewährleisten. Kontingente verhindern, dass ein einzelner API-Nutzer das System übermäßig belastet, und sorgen so für eine hohe Leistung. Um Ihre Produktdaten optimal zu verwalten und Ihren Umsatz auf Google zu steigern, sollten Sie sich mit diesen Kontingenten vertraut machen.
Allgemeine Konzepte
Merchant API-Kontingente werden über Kontingentgruppen verwaltet.
API-Methoden werden Kontingentgruppen zugeordnet. Die Struktur dieser Zuordnung kann variieren:
- Einzelne Methode pro Gruppe: Einige Kontingentgruppen gelten für eine einzelne API-Methode.
Die Methode
accounts.dataSources.listzum Auflisten von Datenquellen hat beispielsweise eine eigene Kontingentgruppe. - Mehrere Methoden pro Gruppe (Bündelung): Häufig werden verwandte Methoden in einer einzigen Kontingentgruppe zusammengefasst. Für alle Methoden innerhalb dieser Gruppe gelten dieselben Tages- und Minutenlimits. Hier einige Beispiele:
- Gruppierung aller Lesevorgänge für zugehörige Methoden und Ressourcen, z. B.
merchant-accounts-read-methods. - Gruppierung aller Schreibvorgänge für zugehörige Methoden und Ressourcen, z. B.
merchant-accounts-write-methods.
- Gruppierung aller Lesevorgänge für zugehörige Methoden und Ressourcen, z. B.
Jeder Methodenaufruf wird einmal gezählt, unabhängig vom Typ. Eine list-Anfrage mit 250 Elementen wird nur einmal gezählt, nicht als 250 get-Anfragen.
Das integrierte HTTP-Batching hat keinen Einfluss auf das Kontingent. Jede einzelne Anfrage innerhalb eines Batches wird auf das Kontingent angerechnet. Eine Batchanfrage mit 500 insert-Anfragen wird beispielsweise als 500 einzelne insert-Methodenanfragen abgerechnet.
Ausnahme für Batching in dedizierten Regionen: Spezielle Batchmethoden für Regionen (batchCreate, batchUpdate, batchDelete) werden als ein einzelner API-Aufruf für die Kontingentgruppe merchant_regions gezählt, unabhängig von der Anzahl der Regionsvorgänge in der Nutzlast.
Um Ihre Integration effektiv zu verwalten, sollten Sie die spezifische Kontingentgruppe prüfen, die jeder API-Methode zugeordnet ist, die Sie verwenden möchten. Diese Details finden Sie in der Methode „quotas list“. Weitere Informationen finden Sie unter Monitoring und Sichtbarkeit.
Richtlinie aktualisieren
Die Merchant API setzt die folgenden Richtlinien für Aktualisierungen durch:
- Standardmäßig können Sie Ihre Produkte bis zu zweimal pro Tag aktualisieren. Sie sollten die Aufrufe gleichmäßig über den Tag verteilen, um das Kontingent pro Minute einzuhalten.
- Standardmäßig können Sie Ihre Unterkonten nur bis zu zweimal pro Tag aktualisieren. Ihr tägliches Kontingent für die Aktualisierung von Unterkonten ist ein Gesamtlimit, das auf der Gesamtzahl der zulässigen Unterkonten basiert.
- Standardmäßig können Sie Datenquellenmethoden für Ihre Unterkonten wie
listodercreatenur bis zu zweimal pro Unterkonto und Tag aufrufen.
Ratenkontingente
Für jede Kontingentgruppe gibt es zwei Arten von Limits (und täglicher Nutzung):
- Tageslimit (
quotaLimit): Die maximal zulässige Anzahl von Anfragen pro Tag. Die täglichen Kontingentlimits werden um 12:00 Uhr UTC zurückgesetzt. - Limit pro Minute (
quotaMinuteLimit): Die maximale Anzahl von Anfragen, die pro Minute zulässig sind. Damit wird die Rate der Anfragen gesteuert. Für die Kontingentlimits pro Minute wird ein rollierendes Zeitfenster verwendet. Der Zeitraum für die Durchsetzung beginnt mit dem ersten API-Aufruf für diese Methode und Ressource. Wenn Sie beispielsweise um 10:01:30 Uhr einen Aufruf ausführen, läuft das Kontingentfenster pro Minute für diese Methode bis 10:02:30 Uhr. - Tägliche Nutzung (
quotaUsage): Die Anzahl der Anfragen, die bereits gestellt und auf das Tageslimit für den aktuellen Tag angerechnet wurden. Wenn das Feld fehlt, wurde für diese Gruppe noch kein Kontingent verbraucht.
Die drei zuvor beschriebenen Felder (quotaLimit, quotaMinuteLimit und quotaUsage) finden Sie in der Antwort der Methode quotas.list.
Die spezifischen Tages- und Minutenlimits variieren erheblich zwischen den verschiedenen Kontingentgruppen. Vorgänge mit einem höheren erwarteten Volumen oder niedrigeren Systemkosten, z. B. das Lesen von Produktdaten, haben in der Regel höhere Limits. Für intensivere oder sensiblere Vorgänge wie Kontoänderungen gelten möglicherweise niedrigere Limits.
Kontingentzuweisung und -hierarchie
In diesem Abschnitt wird erläutert, in wessen Namen die Merchant API die Kontingentnutzung erfasst und anwendet:
Im Allgemeinen wird das Kontingent basierend auf dem Nutzer berechnet, der die API-Anfrage stellt.
- Eigenständige Konten: Bei eigenständigen Konten, die einen API-Aufruf authentifizieren, wird diese Anfrage auf das Kontingent dieses Kontos angerechnet.
- Beispiel: Der Händler Schuhgeschäft A (Konto-ID: 12345) authentifiziert sich mit seinem eigenen Dienstkonto, um
products.insertfür sein eigenes Konto (accounts/12345) aufzurufen. Das Kontingent wird aus dem Kontingentpool von Schuhgeschäft A verbraucht.
- Beispiel: Der Händler Schuhgeschäft A (Konto-ID: 12345) authentifiziert sich mit seinem eigenen Dienstkonto, um
- Erweiterte Konten: Bei der Authentifizierung als erweitertes Konto wird Kontingent aus dem Pool des erweiterten Kontos verbraucht, auch wenn ein Unterkonto als Ziel verwendet wird.
- Beispiel: Über das Einzelhandelsverwaltungskonto einer Agentur (ID des erweiterten Kontos: 12345) wird das Unterkonto Bekleidungsgeschäft B (Konto-ID: 11111) verwaltet.
Die Agentur authentifiziert sich mit ihren eigenen Anmeldedaten und ruft
products.insertauf, wobei sie Bekleidungsgeschäft B (accounts/11111) als Ziel festlegt. Das Kontingent wird aus dem Pool der übergeordneten Agentur (ID des erweiterten Kontos: 12345) und nicht aus dem Pool des Unterkontos verbraucht.
- Beispiel: Über das Einzelhandelsverwaltungskonto einer Agentur (ID des erweiterten Kontos: 12345) wird das Unterkonto Bekleidungsgeschäft B (Konto-ID: 11111) verwaltet.
Die Agentur authentifiziert sich mit ihren eigenen Anmeldedaten und ruft
- Unterkonten: Wenn API-Aufrufe mit den Anmeldedaten eines Unterkontos authentifiziert werden, wird das Kontingent dem individuellen Pool dieses Unterkontos belastet. Es funktioniert genauso wie ein eigenständiges Konto, obwohl es von einem übergeordneten erweiterten Konto verwaltet wird.
- Beispiel: Wenn sich Bekleidungsgeschäft B (Konto-ID: 11111) mit den speziell für sein Unterkonto eingerichteten Anmeldedaten authentifiziert, um
products.insertfür das eigene Konto (accounts/11111) aufzurufen, wird das Kontingent aus dem individuellen Kontingentpool von Bekleidungsgeschäft B verbraucht. Der Pool der übergeordneten Agentur bleibt unberührt.
- Beispiel: Wenn sich Bekleidungsgeschäft B (Konto-ID: 11111) mit den speziell für sein Unterkonto eingerichteten Anmeldedaten authentifiziert, um
Ausnahmen von den allgemeinen Regeln
Es gibt einige Ausnahmen von den allgemeinen Regeln für die Kontingentzuweisung:
- Accounts.list:
Das Kontingent für diese Methode wird dem authentifizierten Nutzer oder Dienstkonto in Rechnung gestellt, das den Aufruf ausführt, nicht der Merchant Center-Konto-ID.
Die Kontingentnutzung wird nicht auf der standardmäßigen Merchant Center API-Diagnoseseite angezeigt.
Wenn Sie ein erweitertes Konto haben, empfehlen wir die Verwendung der Methode
accounts.listSubaccounts, die auf Ihr Kontingent für erweiterte Konten angerechnet wird. - Methoden zur Problembehebung: Diese Methoden werden immer auf das Kontingent des Kontos angerechnet, dessen Probleme angefordert werden, auch wenn die Anfrage von einem anderen Konto authentifiziert wird.
Hierarchie der Zuweisung
Preisvergleichsportale (Comparison Shopping Services, CSS): Preisvergleichsportale sind Websites, die Produktangebote zusammenfassen und Nutzer zum Kauf auf die Websites von Einzelhändlern weiterleiten. Bei API-Aufrufen werden Kontingente auf die jeweilige Preisvergleichsportal-Gruppe, die Preisvergleichsportal-Domain, das Konto oder das Unterkonto angewendet, für das Sie sich authentifizieren.
Beispiele:
- Eine Preisvergleichsportal-Gruppe mit dem Namen Europe Shopping Group (Konto-ID: 10001) möchte die mit ihr verknüpften Preisvergleichsportal-Domains auflisten. Durch die Authentifizierung mit den eigenen Anmeldedaten für diesen API-Aufruf wird das Kontingent direkt aus dem Kontingentpool der Europe Shopping Group verbraucht.
- Eine Preisvergleichsportal-Domain TopDeals CSS (Konto-ID: 20002) authentifiziert sich, um eine Methode aufzurufen, die auf eines ihrer verknüpften Händlerkonten (
accounts/30003) abzielt, um ein Label zuzuweisen. Das Kontingent wird vom Kontingentpool des TopDeals-Preisvergleichsportals und nicht vom Pool des Händlerkontos abgezogen.
Marktplätze: Marktplätze sind Onlineplattformen, auf denen mehrere einzelne Händler ihre Produkte verkaufen können. Sie fungieren als spezielle erweiterte Konten, mit denen Sie für jeden Ihrer Verkäufer einzelne Unterkonten erstellen können.
Das folgende Diagramm zeigt die Hierarchie von Preisvergleichsportal-Gruppen, Preisvergleichsportalen, Marktplätzen, erweiterten Konten, eigenständigen Konten und Unterkonten.

Automatische Kontingentanpassung
Die Merchant API verfügt über ein automatisches Kontingentverwaltungssystem für bestimmte Dienste, das die Kontingentlimits für wachsende Händler basierend auf Ihrer Nutzung, Ihrem Angebot und Ihrer Kontogröße anpasst. Die Merchant API berechnet diese Kontingente täglich neu.
Die folgenden Kontingentgruppen sind in der automatischen Kontingentanpassung enthalten:
Produkte und Dienstleistungen
- Alle Kontingentgruppen von Methoden, die sich auf die Ressourcen
productsundproductInputsbeziehen. - Das tägliche Aufrufkontingent ist in der Regel auf das Doppelte der Anzahl an Angeboten festgelegt, die der Händler hat. Dabei wird davon ausgegangen, dass ein Händler jedes seiner Produkte bis zu zweimal pro Tag aktualisieren muss.
- Einzelne Produkte können mehr als zweimal aktualisiert werden, aber die Gesamtzahl der täglichen API-Aufrufe darf das tägliche Gesamtkontingent nicht überschreiten.
Kontodienste
- Alle Kontingentgruppen von Methoden, die sich auf die verschiedenen detaillierten kontobezogenen Ressourcen in der Merchant API beziehen.
- Das tägliche Aufrufkontingent ist auf die maximale Anzahl von Unterkonten festgelegt, die für dieses Konto zulässig sind. Dies ermöglicht bis zu zwei Leseaufrufe pro Unterkonto und Tag.
Datenquellendienste
- Alle Kontingentgruppen von Methoden, die sich auf die mit der Datenquelle verbundenen Ressourcen in der Merchant API beziehen, z. B.
listodercreate, die ein erweitertes Konto für seine Unterkonten ausführt. - Das tägliche Aufrufkontingent ist in der Regel auf das Doppelte der Anzahl der Unterkonten des erweiterten Kontos festgelegt. Dabei wird davon ausgegangen, dass ein Händler die Datenquellen jedes seiner Unterkonten bis zu zweimal pro Tag aktualisieren kann.
Nur für die zuvor beschriebenen Dienste werden Kontingente automatisch angepasst. Andere Dienste haben ein Standardkontingent und alle Erhöhungen müssen manuell angefordert werden. Weitere Informationen finden Sie im Abschnitt Kontingenterhöhung.
Was passiert, wenn Kontingente überschritten werden?
Wenn ein Kontingent überschritten wurde, werden Fehler in den API-Antworten und auf der Diagnoseseite in Ihrem Merchant Center-Konto angezeigt:
- Pro Minute:
quota/request_rate_too_high
{
"error": {
"code": 429,
"message": "Quota per minute exceeded. Please distribute your requests over a longer time period. For more information check https://developers.google.com/merchant/api/guides/quotas-limits",
"status": "RESOURCE_EXHAUSTED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "quotaExceeded",
"domain": "merchantapi.googleapis.com",
"metadata": {
"HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/quotas-limits",
"REASON": "QUOTA_REQUEST_RATE_TOO_HIGH"
}
}
]
}
}
- Pro Tag:
quota/daily_limit_exceeded
{
"error": {
"code": 429,
"message": "Daily request quota exceeded. Please reduce number of requests. For more information check https://developers.google.com/merchant/api/guides/quotas-limits",
"status": "RESOURCE_EXHAUSTED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "quotaExceeded",
"domain": "merchantapi.googleapis.com",
"metadata": {
"HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/quotas-limits",
"REASON": "QUOTA_TOO_MANY_REQUESTS"
}
}
]
}
}
Die folgenden Fehler sind Merchant Center-Limits und stehen nicht im Zusammenhang mit Merchant API-Kontingenten. Sie können versuchen, ein zusätzliches Kontingent an Artikeln, Feeds oder Unterkonten zu beantragen:
too_many_items: Händlerkontingent überschrittentoo_many_subaccounts: Maximale Anzahl von Unterkonten erreicht
Monitoring und Sichtbarkeit
Wenn Sie die aktuellen Aufrufkontingente und die Nutzung für ein Konto prüfen möchten, rufen Sie quotas.list mit dem Namen des Kontos auf.
POST https://merchantapi.googleapis.com/quota/v1/accounts/{ACCOUNT_ID}/quotas
Content-Type: application/json
Authorization: Bearer {ACCESS_TOKEN}
Ersetzen Sie Folgendes:
ACCOUNT_ID: Ihre Merchant Center-IDACCESS_TOKEN: das Autorisierungstoken für den API-Aufruf
Bei einer erfolgreichen Anfrage gibt die API eine Liste von quotaGroups-Ressourcen zurück, die die Ressource name der Kontingentgruppe, die verschiedenen Kontingente und die Methoden enthalten, für die das Gruppenkontingent gilt.
{
"quotaGroups": [
{
"name": "accounts/{ACCOUNT_ID}/quotas/merchant-quota-listquotagroups",
"quotaUsage": "2",
"quotaLimit": "1000",
"methodDetails": [
{
"method": "quotaservice.listquotagroups",
"version": "v1",
"subapi": "quota",
"path": "quota/v1/quotaservice.listquotagroups"
}
],
"quotaMinuteLimit": "10"
},
{
"name": "accounts/{ACCOUNT_ID}/quotas/merchant-commission-group-list",
"quotaLimit": "10000",
"methodDetails": [
{
"method": "commissiongroupservice.listcommissiongroups",
"version": "v1",
"subapi": "youtube",
"path": "youtube/v1/commissiongroupservice.listcommissiongroups"
}
],
"quotaMinuteLimit": "60"
},
{
"name": "accounts/{ACCOUNT_ID}/quotas/merchant-merchantreviews-list",
"quotaLimit": "20000000",
"methodDetails": [
{
"method": "merchantreviewsservice.listmerchantreviews",
"version": "v1",
"subapi": "reviews",
"path": "reviews/v1/merchantreviewsservice.listmerchantreviews"
}
],
"quotaMinuteLimit": "60000"
}
]
}
Kontingenterhöhung
Wenn Sie ein zusätzliches Kontingent beantragen möchten, öffnen Sie das Formular zur Kontaktaufnahme mit dem Support, wählen Sie im Pflichtfeld „Was ist das Problem/die Frage?“ die Option „Anfrage zur Kontingenterhöhung“ aus und füllen Sie alle Pflichtfelder aus, einschließlich Ihrer Merchant Center-ID, der Zielmethoden und der geschäftlichen Begründung.
- Für Ressourcen mit automatischen Kontingenten (
products,accountsunddatasourcesfür erweiterte Konten): Sie können nur eine vorübergehende Erhöhung für besondere Szenarien beantragen, z. B. für die Einführung in einem neuen Markt oder während der Haupteinkaufszeiten. Wir akzeptieren keine dauerhaften Kontingenterhöhungen für diese Ressourcentypen. - Für alle anderen Ressourcen ohne automatische Kontingente: Fordern Sie bei Bedarf Kontingenterhöhungen an.
Wir empfehlen, Ihre Kontingente regelmäßig zu überprüfen, um sicherzustellen, dass Sie genügend Kontingent für Ihre Implementierung haben, und um zu sehen, wie Ihr Kontingent automatisch angepasst wird.
Mit der Methode quotas.list können Sie das aktuelle tägliche Kontingentlimit, das Minutenlimit und die aktuelle tägliche Nutzung für jede API-Methodengruppe aufrufen.
Best Practices
Wenn Sie diese Best Practices implementieren, können Sie dafür sorgen, dass Ihre Integration reibungslos funktioniert, unerwartete Kontingentfehler vermieden werden und Merchant Center-Ressourcen effizient genutzt werden.
Anfrageverteilung optimieren
- Anfragen gleichmäßig verteilen: Vermeiden Sie es, große Mengen an Anfragen auf einmal zu senden. Verteilen Sie Ihre täglichen API-Aufrufe gleichmäßig über den Tag, um die Kontingentlimits pro Minute (
quotaMinuteLimit) nicht zu überschreiten. - Proaktive Drosselung: Implementieren Sie in Ihrer Anwendung eine clientseitige Ratenbegrenzung (Drosselung). Verlassen Sie sich nicht nur darauf, dass die Google-Server übermäßigen Traffic ablehnen. Steuern Sie die Anforderungsrate an der Quelle.
Reibungslose Fehlerbehandlung
- HTTP 429 verarbeiten: Ihre Anwendung muss auf die Verarbeitung von 429-Fehlern (Too Many Requests) vorbereitet sein (
quota/request_rate_too_high). - Exponentieller Backoff mit Jitter: Wenn Sie fehlgeschlagene Anfragen wiederholen (insbesondere nach einem 429-Fehler), verwenden Sie exponentiellen Backoff (zunehmende Wartezeiten) und fügen Sie „Jitter“ (zufällige Verzögerung) hinzu. Jitter verhindert „Wiederholungsstürme“, bei denen mehrere Clientinstanzen gleichzeitig versuchen, die Anfrage zu wiederholen, was den Server erneut überlastet.
- Wiederholungshinweise beachten: Wenn die API-Antwort Wiederholungsdetails oder Header enthält, verwenden Sie diese, um zu bestimmen, wann Aufrufe fortgesetzt werden sollen.
Redundante Aufrufe minimieren
- Veraltete Aufrufe verhindern (404 NOT_FOUND): Vermeiden Sie das Anfordern oder Löschen von Ressourcen, die nicht mehr vorhanden sind. Auch fehlgeschlagene Aufrufe verbrauchen API-Kontingent. Beobachten Sie
NOT_FOUND-Fehler in der Merchant Center API-Diagnose, um veraltete Statusverfolgungen oder unnötige Abfragen zu erkennen. - Vor dem Aktualisieren prüfen: Prüfen Sie vor dem Senden einer Aktualisierungsanfrage, ob sich die Daten tatsächlich geändert haben. Vermeiden Sie das Senden von Updates, die dieselben Werte schreiben.
- Caching verwenden: Speichern Sie Leseantworten (z.B. Produktdetails, Einstellungen) bei Bedarf lokal im Cache, um wiederholte
get- oderlist-Aufrufe für unveränderte Daten zu vermeiden.
Kontingenthierarchie und Ausnahmen
- Erweiterte Konten und Unterkonten: Wenn Sie ein erweitertes Konto haben, authentifizieren Sie sich auf der Ebene des erweiterten Kontos, wenn Sie möchten, dass Aufrufe auf den gemeinsamen Pool des erweiterten Kontos angerechnet werden.
- Verwenden Sie
listSubaccounts: Verwenden Sie für erweiterte Kontenaccounts.listSubaccountsanstelle vonaccounts.list. Dasaccounts.list-Kontingent wird dem aufrufenden Nutzer (nicht der MC-ID) in Rechnung gestellt und ist in der Standarddiagnose nicht sichtbar.listSubaccountswird auf Ihr MCA-Kontingent angerechnet.