Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Für die Merchant API-Funktionen gelten strenge Kontingente und Limits.
Richtlinie aktualisieren
Für die Merchant API gelten die folgenden Richtlinien für Aktualisierungen:
Sie können Ihre Produkte nur bis zu zweimal täglich aktualisieren.
Sie können Ihre Unterkonten nur einmal pro Tag aktualisieren.
Kontingentbezogene Änderungen zwischen der Merchant API und der Content API for Shopping
Das Kontingent wird pro Ressource und nicht pro Methode gezählt. Das bedeutet, dass einige Dienste jetzt verknüpft sind.
Das Fehlen benutzerdefinierter Batches hat keine Auswirkungen auf die Kontingentberechnung. Eine Batchanfrage mit 500 Eintragsanfragen wird beispielsweise als 500 einzelne Anfragen für die Methode „insert“ berechnet.
Die Automatisierung von Kontingenten für Konten und Produkte bleibt unverändert.
Mit der Methode „Quota.list“ können Sie die aktuelle Kontingentnutzung und die Limits ermitteln, einschließlich Automatisierung und Überschreibungen.
Kontingente für Methodenaufrufe
Die Merchant API passt die Anrufkontingente für Ihre products und accounts automatisch an Ihre Nutzung an.
So wird Ihre Kontingentnutzung erfasst:
Kontingente gelten pro Methode. Beispielsweise hat die Methode get ein anderes Kontingent als die Methode update.
Jede Anfrage wird unabhängig von ihrem Typ einmal gezählt. Eine list-Anfrage mit 250 Elementen wird beispielsweise nur einmal gezählt, nicht als 250 get-Anfragen.
Das Kontingent wird dem Nutzer in Rechnung gestellt, der die API-Anfrage stellt. Wenn der Nutzer direkt Mitglied eines erweiterten Kontos ist, wird das Kontingent auf Ebene des erweiterten Kontos berechnet.
Die Kontingente gelten für die Preisvergleichsportal-Gruppe, das Preisvergleichsportal, das Konto oder die untergeordneten Konten, mit denen Sie sich bei der Aufrufung authentifizieren. Wenn Sie sich beispielsweise mit einem erweiterten Konto authentifizieren, werden Anrufe auf das Kontingent des erweiterten Kontos angerechnet. Wenn Sie sich jedoch mit einem Ihrer Unterkonten authentifizieren, werden Anrufe auf das Kontingent des Unterkontos angerechnet.
Das Diagramm zeigt die Hierarchie von Preisvergleichsportal-Gruppen, Preisvergleichsportalen, Konten und Unterkonten.
Kontingente prüfen
Wenn Sie das aktuelle Kontingent und die aktuelle Nutzung für ein Konto prüfen möchten, rufen Sie quotas.list mit der 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 Tageskontingent für die Dienste products oder accounts erreicht ist oder Sie eine vorübergehende Erhöhung für accounts oder die Produkte services benötigen, wenden Sie sich an uns. Geben Sie dabei die folgenden Informationen an:
Ihre Merchant Center-ID
Die Methoden, für die Sie das Kontingentlimit erreicht haben
Eine Schätzung der Anzahl der Anrufe pro Tag, die Sie für diese Methoden benötigen
Grund für die Kontingenterhöhung
Ob es sich um einen vorübergehenden oder dauerhaften Anstieg handelt
Wir empfehlen Ihnen, Ihre Kontingente regelmäßig zu prüfen, um sicherzustellen, dass Sie für Ihre Implementierung ein ausreichendes Kontingent haben, oder um zu sehen, wie Ihr Kontingent automatisch angepasst wird.
Fehler
Wenn Sie die Kontingente überschreiten, erhalten Sie die folgenden Fehler:
Pro Minute: quota/request_rate_too_high
Pro Tag: quota/daily_limit_exceeded
Informationen zum Ansehen Ihrer Kontingente und zur Nutzung sowie zum Anfordern einer Erhöhung des Kontingents pro Tag oder pro Minute finden Sie unter Kontingente prüfen.
too_many_subaccounts: Maximum number of sub-accounts reached
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 werden nicht verlängert.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-08 (UTC)."],[[["\u003cp\u003eMerchant API utilizes automatic quota adjustments for \u003ccode\u003eproducts\u003c/code\u003e and \u003ccode\u003eaccounts\u003c/code\u003e services based on usage, tracking requests per-method and applying quotas to specific CSS groups or accounts.\u003c/p\u003e\n"],["\u003cp\u003eUpdates are limited to twice per day for products and once per day for sub-accounts.\u003c/p\u003e\n"],["\u003cp\u003eYou can request quota increases for services other than \u003ccode\u003eproducts\u003c/code\u003e and \u003ccode\u003eaccounts\u003c/code\u003e, exceeding daily quotas, or requiring temporary increases by contacting Google Merchant Center support.\u003c/p\u003e\n"],["\u003cp\u003eExceeding quotas results in specific errors, such as \u003ccode\u003equota/request_rate_too_high\u003c/code\u003e (per minute) and \u003ccode\u003equota/daily_limit_exceeded\u003c/code\u003e (per day), with instructions for checking and requesting increases.\u003c/p\u003e\n"],["\u003cp\u003eResource representations have inherent limits, notably affecting \u003ccode\u003eshippingsettings\u003c/code\u003e with restrictions on shipping services, groups, labels, and table dimensions.\u003c/p\u003e\n"]]],[],null,["# Quotas and limits\n\nMerchant API features carry strict quotas and limits.\n| **Note:** Quotas and limits are subject to elimination, reduction, or change at any time, without notice.\n\nUpdate policy\n-------------\n\nMerchant API enforces the following policies in terms of updates:\n\n- You can only update your products up to twice per day.\n- You can only update your sub-accounts once per day.\n\nQuota-related changes between Merchant API and Content API for Shopping\n-----------------------------------------------------------------------\n\n- Quota will be counted per resource, not per method. This means some services are now linked.\n- The absence of custom batching doesn't affect quota calculation. For example, a batch request containing 500 insert requests will be charged as 500 individual insert method requests.\n- Quota automation for accounts and products remains in place.\n- To determine your current quota usage and limits, including automation and overrides, use the [Quota.list method](/merchant/api/reference/rest/quota_v1/accounts.quotas/list).\n\n| **Note:** For the `accounts.list` method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. To list several sub-accounts, you should use the `accounts.listSubaccounts` method, which is more suitable for advanced accounts use case.\n\nMethod call quotas\n------------------\n\nMerchant API automatically adjusts call quotas for your\n[`products`](/merchant/api/guides/products/overview) and\n[`accounts`](/merchant/api/guides/accounts/overview) based on your usage.\n\nHere's how we track your quota usage:\n\n- Quotas are per-method. For example, the `get` method has a separate quota from the `update` method.\n- Each request counts once, regardless of its type. For example, we count a `list` request of 250 items once, not as 250 `get` requests.\n- Quota is charged based on the user who makes the API request. If the user is a direct member of an advanced account, the quota will be charged at the level of the advanced account.\n- Quotas apply to the Comparison Shopping Services (CSS) group, CSS, account, or [sub-accounts](/merchant/api/guides/accounts/sub-accounts) against which you authenticate when you make the call. For example, if you authenticate as an [advanced account](https://support.google.com/merchants/answer/188487), calls count against your advanced account's quota, but if you authenticate as one of your sub-accounts, calls count against the sub-account's quota.\n\n\u003cbr /\u003e\n\nThe diagram shows the hierarchy of CSS groups, CSS, accounts, and sub-accounts.\n\n### Check your quotas\n\nTo check the current quota and usage for an account, call\n[`quotas.list`](/merchant/api/reference/rest/quota_v1/accounts.quotas/list)\nwith the `name` of the account.\n\nAutomatic quota only applies to the `products` and `accounts` services. If you\nneed an increased quota for any other service, you're hitting your daily quota\nfor the `products` or `accounts` services, or you need a temporary increase for\nthe `accounts` or products `services`, [contact\nus](/merchant/api/support/get-help) with the following information:\n\n- Your Merchant Center ID\n- The methods you've reached your quota limits on\n- An estimate of the number of calls per day you need for those methods\n- The reason you need a quota increase\n- Whether it's a temporary or permanent increase\n\nWe recommend checking your quotas periodically to ensure you have sufficient\nquota for your implementation, or how your quota is adjusted automatically.\n\n### Errors\n\nIf you exceed the quotas, you receive the following errors:\n\n- Per minute: `quota/request_rate_too_high`\n- Per day: `quota/daily_limit_exceeded`\n\nTo view your quotas and usage, and request a per-day or per-minute quota\nincrease, see [Check your quotas](#check_your_quotas).\n\nThe following errors can't be resolved by automatic quota increases, and require\nyou to [request additional quota of items, feeds or\nsub-accounts](//support.google.com/merchants/contact/additional_items):\n\n- `too_many_items: Merchant quota exceeded`\n- `too_many_subaccounts: Maximum number of sub-accounts reached`\n\nResource representation limits\n------------------------------\n\nThe following limits describe notable restrictions for certain string values and\narray fields within the resource representations used in the Merchant API. These\nlimits are the same for both the Merchant API and their corresponding feature in\nthe Merchant Center.\n\nNote that this list of limits may not be complete. We won't extend these limits.\n\n| Resource | Field | Limit |\n|------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------|\n| [`shippingsettings`](/merchant/api/reference/rest/accounts_v1/accounts.shippingSettings) | Shipping services per country (`services`). Shipping groups per shipping service (`rateGroups`). Labels per shipping group (`applicableShippingLabels`). Subtables per shipping group (`subtables`). Number of rows or columns in a single [rate table](#note2). Length of shipping labels. | 20 20 30 100 150 100 |\n\nThe number of rows or columns in a rate table affects the following array fields:\n\n- Array fields within `rowHeaders` or `columnHeaders`:\n - `prices[]`\n - `weights[]`\n - `numberOfItems[]`\n - `postalCodeGroupNames[]`\n - `locations[]`\n - `rows[]`\n - `cells[]`"]]
